본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

권한 부여 및 인증

기여자

NetApp Service Engine REST API는 HTTP 요청을 보낼 수 있는 웹 브라우저 또는 프로그래밍 플랫폼을 사용하여 액세스할 수 있습니다. NetApp 서비스 엔진은 기본 HTTP 인증 메커니즘 및 JWT(Java Web Token) 베어러 인증을 지원합니다. API를 호출하기 전에 사용자를 인증해야 합니다.

HTTP 상태 코드입니다

API를 실행하거나 문제를 해결하는 동안 NetApp Service Engine API에서 사용되는 다양한 HTTP 상태 코드 및 오류 코드를 알고 있어야 합니다.

다음 표에는 인증과 관련된 오류 코드가 나와 있습니다.

HTTP 상태 코드입니다 상태 코드 제목 설명

200

좋습니다

동기 API 호출이 성공적으로 실행될 때 반환됩니다.

201

작성됨

Active Directory 구성과 같은 동기 호출을 통해 새 리소스 생성

202

수락됨

LUN 및 파일 공유 생성과 같은 프로비저닝 기능에 대한 비동기 호출을 성공적으로 실행할 때 반환됩니다.

400

잘못된 요청입니다

입력 유효성 검사 실패를 나타냅니다. 사용자는 요청 본문의 유효한 키와 같은 입력을 수정해야 합니다.

401

승인되지 않은 요청

리소스를 볼 수 있는 권한이 없습니다.

403

금지된 요청

연결하려는 리소스에 대한 액세스는 금지됩니다.

404

리소스를 찾을 수 없습니다

연결하려는 리소스를 찾을 수 없습니다.

405

메서드가 허용되지 않습니다

메서드가 허용되지 않습니다.

412

전제 조건 실패

하나 이상의 전제 조건이 충족되지 않았습니다.

500입니다

내부 서버 오류입니다

내부 서버 오류입니다. 서버에서 응답을 가져오지 못했습니다. 이 내부 서버 오류는 영구적이거나 그렇지 않을 수 있습니다. 예를 들어, 모든 가져오기 또는 가져오기 작업을 실행하고 이 오류를 수신하는 경우 최소 5회 이상 이 작업을 반복하는 것이 좋습니다. 영구적인 오류인 경우 반환되는 상태 코드는 계속 500입니다. 작업이 성공하면 반환되는 상태 코드는 200입니다.

API 사용을 위한 권장 사항

API를 사용할 때는 다음과 같은 몇 가지 권장 방법을 따라야 합니다.

  • 올바른 실행을 위해서는 모든 응답 콘텐츠 형식이 다음 형식인지 확인하십시오.

    application/json
  • 배열 값을 업데이트하는 동안 값의 전체 문자열을 업데이트해야 합니다. 배열에 값을 추가할 수 없습니다. 기존 배열만 바꿀 수 있습니다.

  • 필터 연산자 와일드카드(*')와 파이프('|')를 조합하여 개체를 쿼리하지 마십시오. 잘못된 개체 수를 검색할 수 있습니다.