ONTAP Select Deploy API 기본 작동 특성
REST는 공통된 기술과 모범 사례를 제시하지만, 각 API의 세부 사항은 설계 선택에 따라 달라질 수 있습니다. ONTAP Select Deploy API를 사용하기 전에 해당 API의 세부 사항과 운영 특성을 숙지해야 합니다.
하이퍼바이저 호스트와 ONTAP Select 노드
_하이퍼바이저 호스트_는 ONTAP Select 가상 머신을 호스팅하는 핵심 하드웨어 플랫폼입니다. ONTAP Select 가상 머신이 하이퍼바이저 호스트에 배포되어 활성화되면 해당 가상 머신은 _ONTAP Select 노드_로 간주됩니다. 배포 REST API 버전 3부터는 호스트와 노드 객체가 분리되어 있습니다. 이를 통해 하나 이상의 ONTAP Select 노드가 동일한 하이퍼바이저 호스트에서 실행될 수 있는 일대다 관계가 가능해집니다.
객체 식별자
각 리소스 인스턴스 또는 객체는 생성될 때 고유 식별자가 할당됩니다. 이러한 식별자는 ONTAP Select Deploy의 특정 인스턴스 내에서 전역적으로 고유합니다. 새 객체 인스턴스를 생성하는 API 호출을 실행하면 관련 ID 값이 HTTP 응답의 location 헤더에 포함되어 호출자에게 반환됩니다. 이 식별자를 추출하여 이후 호출에서 해당 리소스 인스턴스를 참조할 때 사용할 수 있습니다.
|
|
객체 식별자의 내용 및 내부 구조는 언제든지 변경될 수 있습니다. 따라서 관련 객체를 참조할 때는 필요에 따라 해당 API 호출에서만 식별자를 사용해야 합니다. |
요청 식별자
모든 성공적인 API 요청에는 고유 식별자가 할당됩니다. 이 식별자는 관련 HTTP 응답의 request-id 헤더에 반환됩니다. 요청 식별자를 사용하여 특정 API 요청-응답 트랜잭션의 모든 활동을 총칭하여 참조할 수 있습니다. 예를 들어, 요청 ID를 기반으로 특정 트랜잭션에 대한 모든 이벤트 메시지를 검색할 수 있습니다.
동기식 호출과 비동기식 호출
서버가 클라이언트로부터 받은 HTTP 요청을 수행하는 주요 방법은 두 가지입니다.
-
동기식 서버가 요청을 즉시 수행하고 상태 코드 200, 201 또는 204로 응답합니다.
-
비동기 방식입니다. 서버는 요청을 수락하고 상태 코드 202로 응답합니다. 이는 서버가 클라이언트의 요청을 수락하고 요청 처리를 위한 백그라운드 작업을 시작했음을 나타냅니다. 최종 성공 또는 실패 여부는 즉시 확인할 수 없으며, 추가 API 호출을 통해 확인해야 합니다.
장기 실행 작업의 완료를 확인합니다
일반적으로 완료하는 데 시간이 오래 걸릴 수 있는 모든 작업은 서버에서 백그라운드 작업을 사용하여 비동기적으로 처리됩니다. Deploy REST API에서는 모든 백그라운드 작업에 Job 객체가 연결되어 있으며, 이 객체는 작업을 추적하고 현재 상태와 같은 정보를 제공합니다. 백그라운드 작업이 생성되면 고유 식별자를 포함한 Job 객체가 HTTP 응답으로 반환됩니다.
Job 객체를 직접 조회하여 관련 API 호출의 성공 또는 실패 여부를 확인할 수 있습니다. 자세한 내용은 _Job 객체를 사용한 비동기 처리_를 참조하십시오.
Job 객체를 사용하는 것 외에도 다음과 같은 방법으로 요청의 성공 또는 실패 여부를 판단할 수 있습니다.
-
이벤트 메시지 특정 API 호출과 관련된 모든 이벤트 메시지는 원래 응답에 포함된 요청 ID를 사용하여 검색할 수 있습니다. 이벤트 메시지에는 일반적으로 성공 또는 실패 여부가 표시되며 오류 상황을 디버깅할 때도 유용하게 사용할 수 있습니다.
-
리소스 상태 여러 리소스는 상태 값을 유지하며, 이 값을 조회하여 요청의 성공 또는 실패 여부를 간접적으로 확인할 수 있습니다.
보안
Deploy API는 다음과 같은 보안 기술을 사용합니다.
-
전송 계층 보안 Deploy 서버와 클라이언트 간에 네트워크를 통해 전송되는 모든 트래픽은 TLS를 통해 암호화됩니다. 암호화되지 않은 채널을 통한 HTTP 프로토콜 사용은 지원되지 않습니다. TLS 버전 1.2가 지원됩니다.
-
HTTP 인증 기본 인증은 모든 API 트랜잭션에 사용됩니다. base64 문자열로 사용자 이름과 암호를 포함하는 HTTP 헤더가 모든 요청에 추가됩니다.