리소스 공급자에서 사용량 현황 데이터 검색
적용 대상: Windows Azure Pack
리소스 공급자에서 사용량 현황 데이터를 검색합니다.
요청
UsageEndpoint>를 Windows Azure Pack 사용자 지정 리소스 공급자 사용 REST API의 엔드포인트 주소로 바꿉<니다.
메서드 |
요청 URI |
HTTP 버전 |
|---|---|---|
GET |
<https:// UsageEndpoint>/usage |
HTTP/1.1 |
URI 매개 변수
다음 표에서는 URI 매개 변수에 대해 설명합니다.
URI 매개 변수 |
설명 |
|---|---|
lastID |
사용 수집기에서 받은 마지막 레코드의 ID입니다. lastID 매개 변수는 첫 번째 요청에 대해 비어 있습니다. 이는 사용 수집기가 이전 레코드를 인식하므로 삭제할 수 있음을 인정하는 것입니다. |
BatchSize |
사용 수집기로 보낼 새 레코드의 수입니다. 새 레코드는 lastID 매개 변수로 식별된 레코드를 따르는 레코드입니다. 리소스 공급자는 요청된 것보다 작은 일괄 처리를 보낼 수 있지만 더 큰 일괄 처리는 보낼 수 없습니다. |
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.
요청 헤더 |
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 |
|---|---|
EventId |
필수 요소. 각 사용 레코드를 나타내는 고유 식별자입니다. 이 값은 lastID URI 매개 변수의 값과 일치합니다. |
ResourceId |
(선택 사항) 리소스 공급자에 단일 구독에 대한 여러 리소스가 있고 사용량이 리소스를 집계하는 경우 이 필드를 사용하여 리소스 이름을 지정할 수 있습니다. 사용량이 구독 ID별로 집계되는 경우 이 요소는 사용되지 않습니다. |
StartTime |
필수 요소. 사용량 현황 데이터 수집이 시작된 시기를 나타냅니다. |
EndTime |
필수 요소. 사용량 현황 데이터 수집이 종료된 시기를 나타냅니다. |
ServiceType |
필수 요소. 사용된 서비스의 계층입니다. |
SubscriptionId |
필수 요소. 사용량 현황 데이터가 수집된 구독 식별자입니다. (GUID). |
속성 |
(선택 사항) 사용량에 대한 추가 정보를 전달하는 데 사용되는 이름-값 쌍의 사전입니다. |
리소스 |
필수 요소. 할당되거나 사용된 리소스를 나타내는 이름-값 쌍의 사전입니다. 예를 들어 SQL 리소스 공급자는 총 공간 및 데이터베이스 수를 메트릭으로 사용할 수 있습니다. |
설명
리소스 공급자에서 사용량 현황 데이터 검색 은 사용 수집기에서 주기적으로 호출되어 리소스 공급자의 사용량 정보를 수집합니다. 이 정보는 리소스 공급자 사용에 대한 청구 비용을 생성하는 데 사용할 수 있습니다. 자세한 내용은 사용자 지정 리소스 공급자 엔드포인트를 참조하세요. Windows Azure Pack 사용량 서비스에 대한 자세한 내용은 Windows Azure Pack 사용 현황 서비스를 참조하세요.