개체 표현을 검색하려면 클라이언트는 개체 참조에 대해 HTTP 요청을 수행합니다.

보안

API 클라이언트와 서버 간의 HTTP 링크는 SSL을 사용하여 구축됩니다. API 클라이언트는 서버와 통신하도록 토큰 기반 인증을 구성합니다.

그림 1. 시나리오: ID 123의 경고에 대한 세부 정보를 가져오기 위해 사용자 자격 증명 제공
유효한 자격 증명으로 보호된 끝점에 액세스됨
Cloud Services 인증 토큰을 생성한 후 vRealize Operations Cloud API를 호출할 수 있습니다. 다음 엔드포인트를 사용합니다.
https://www.mgmt.cloud.vmware.com/vrops-cloud/suite-api
참고: 조직이 미국 외부에 있는 경우 API 엔드포인트의 해당 국가 약어를 사용합니다. 잘못된 엔드포인트를 사용하면 404 오류가 발생합니다. 예를 들어 조직이 오스트레일리아에 있는 경우 국가 약자는 AU이며 API 엔드포인트는 다음과 같습니다.
https://au.www.mgmt.cloud.vmware.com/vrops-cloud/suite-api 
Cloud Services 인증 토큰을 모든 요청과 함께 다음 형식의 HTTP 헤더로 전달해야 합니다.
Authorization: CSPToken {CSP Auth Token}
예:
curl -k https://www.mgmt.cloud.vmware.com/vrops-cloud/suite-api/api/resources -H "Content-Type: application/json" -H "Accept: application/json" -H "Authorization: CSPToken abc12345...

요청 헤더

다음 HTTP 헤더는 일반적으로 API 요청에 포함되어 있습니다.
수락-언어 응답에 원하는 언어를 지정하려면 Accept-Language 요청 헤더를 사용합니다. ErrorType 응답의 메시지 문자열은 현지화됩니다. 프랑스어로 현지화된 메시지 문자열로 응답을 요청하려면 다음 헤더를 사용합니다.
Accept-Language: fr-FR
권한 부여 API 세션을 생성하기 위한 모든 요청에는 조직에서 사용하는 ID 제공자에 의해 규정된 양식의 Authorization 헤더가 포함되어야 합니다.
컨텐츠-유형 본문을 포함하는 요청에는 적절한 HTTP Content-Type 헤더가 포함되어야 합니다.
  • XML의 요청 본문의 경우 헤더에 컨텐츠 유형: 애플리케이션/XML이 포함되어야 합니다.
  • JSON의 요청 본문의 경우 헤더에 컨텐츠 유형: 애플리케이션/JSON이 포함되어야 합니다.
허용 원하는 응답 형식을 지정하려면 Accept 요청 헤더를 포함합니다.
  • XML의 응답의 경우 헤더에 허용: 애플리케이션/XML이 포함되어야 합니다.
  • JSON의 응답의 경우 헤더에 허용: 애플리케이션/JSON이 포함되어야 합니다.

XML 형식의 본문 요청

XML로 작성된 요청 본문의 경우, vRealize Operations Cloud는 요청 본문의 요소가 순서와 숫자에서 스키마와 호응하도록 요구하는 유효성 검사 XML 구문 분석을 사용합니다. 요청 본문은 다음 조건을 충족하지 않는 한 잘못된 것으로 거부됩니다.

  • 요청에서 요소로 표시되는 모든 네임스페이스에 대해 XML 네임스페이스 특성을 제공해야 합니다.
  • 요청에 네임스페이스가 여러 개 표시되는 경우, XML 네임스페이스 특성에 식별 접두사를 포함해야 하고 해당 접두사를 해당 네임스페이스의 모든 요소와 함께 사용해야 합니다.
  • 모든 필수 요소가 요청 본문에 나타나야 합니다. 요청 본문에 표시되는 모든 요소는 스키마가 구축하는 순서와 스키마가 지정하는 유형 제약 조건을 준수하는 컨텐츠로 나타나야 합니다.