구독에 대한 사용 요약 검색
적용 대상: Windows Azure Pack
리소스 공급자가 생성한 구독 사용량 데이터의 요약을 검색하기 위해 서비스 관리 API에서 호출됩니다. 이 정보는 청구 어댑터에서 청구 비용을 계산하는 데 사용할 수 있습니다. 자세한 내용은 Windows Azure Pack 사용 현황 서비스를 참조하세요.
요청
NotificationEndpoint>를 Windows Azure Pack 사용자 지정 리소스 공급자 알림 REST API의 엔드포인트 주소로 바꿉<니다. ID>를 검색할 사용 요약의 식별자로 바꿉<니다.
메서드 |
요청 URI |
HTTP 버전 |
|---|---|---|
GET |
<http:// NotificationEndpoint>/subscriptions/<Id>/usagesummary |
HTTP/1.1 |
URI 매개 변수
없음.
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.
요청 헤더 |
Description |
|---|---|
권한 부여: 기본 |
필수 요소. 기본 권한 부여 토큰입니다. |
x-ms-principal-id |
필수 요소. 보안 주체 식별자입니다. |
x-ms-client-request-id |
(선택 사항) 클라이언트 요청 식별자입니다. |
x-ms-client-session-id |
(선택 사항) 클라이언트 세션 식별자입니다. |
x-ms-principal-liveid |
(선택 사항) 보안 주체 라이브 식별자입니다. |
요청 본문
없음.
응답
응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.
상태 코드
작업에 성공하면 상태 코드 200(정상)이 반환됩니다.
상태 코드에 대한 자세한 내용은 상태 및 오류 코드(Windows Azure Pack Service Management)를 참조하세요.
응답 헤더
이 작업에 대한 응답에는 표준 HTTP 헤더가 포함됩니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 준수합니다.
응답 본문
다음 표에서는 응답 본문의 주요 요소에 대해 설명합니다.
요소 이름 |
Description |
|---|---|
ServiceUsageSummary |
검색된 사용 요약입니다. 자세한 내용은 ServiceUsageSummary(알림 엔드포인트 개체)를 참조하세요. |
예제
다음 코드 예제에서는 구독 사용 요약 가져오기 요청을 보여 줍니다.
GET https://<NotificationEndpoint>/subscriptions/685a05ed-3a6f-4c3a-b70c-924a1307834f/usagesummary HTTP/1.1
Referer: https://<Computer>:30004/subscriptions/685a05ed-3a6f-4c3a-b70c-924a1307834f/usagesummaries
Accept: application/json
Accept-Language: en-US
x-ms-client-request-id: 82610bdb-14d6-4e2a-99a0-9930d879b300-2013-07-25 06:14:56Z
x-ms-client-session-id: be02e255-38de-4e86-9690-b3a3e3037e4c
x-ms-principal-id: <COMPUTER>\Administrator
x-ms-principal-liveid: <COMPUTER>\Administrator
x-ms-request-id: 37739ad5c7ab4654b6bb5d5e211f974e.2013-07-25T06:14:57.7649169Z
Authorization: Basic <encoded username and password>
Host: <Computer>:30010
다음 코드 예제에서는 구독 사용 요약 JSON 가져오기 응답을 보여 줍니다.
{
"ServiceName": "SqlServer",
"ServiceDisplayName": "Sql Server",
"RetrievedSuccessfully": false,
"ErrorMessage": null,
"Usages": [
]
}
설명
TBD를 호출할 때 서비스 관리 API는 응답을 위해 1분 동안 대기합니다. 응답을 받지 못하면 구독이 동기화되지 않은 것으로 표시됩니다.