Manage billing - Get a customer's utilization records for Azure
파트너의 고객이 소유한 Azure 구독에 속하는 리소스의 사용률을 가져옵니다.
GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azureGET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure?start_time={start_time}&end_time={end_time}&size={size}&granularity={granularity}&show_details={show_details}&seek_operation={seek_operation}URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
customer_id
|
path | True |
string |
구독을 소유한 고객의 ID입니다. |
|
subscription_id
|
path | True |
string |
사용률을 검색할 Azure 구독의 ID입니다. |
|
end_time
|
query |
string date-time |
청구 시스템에서 사용률이 측정된 종료 시간입니다. |
|
|
granularity
|
query |
string |
리소스 사용 시간 세분성입니다. 매일 또는 매시간 사용할 수 있습니다. Defalt는 매일입니다. |
|
|
seek_operation
|
query |
string |
수행할 검색 작업입니다. 다음만 지원됩니다. |
|
|
show_details
|
query |
boolean |
true로 설정하면 사용률 레코드가 리소스 인스턴스 수준으로 분할됩니다. false로 설정하면 사용률 레코드가 리소스 수준에서 집계됩니다. 기본값은 true입니다. |
|
|
size
|
query |
integer int32 |
반환할 선택적 최대 레코드 수입니다. 기본값은 1000입니다. 반환된 리소스 컬렉션은 사용 가능한 사용률 레코드가 더 많은 경우 다음 링크를 지정합니다. |
|
|
start_time
|
query |
string date-time |
청구 시스템에서 사용률이 측정된 시작 시간입니다. |
요청 헤더
| Name | 필수 | 형식 | Description |
|---|---|---|---|
| Authorization | True |
string |
권한 부여 전달자 토큰 |
| ms-correlationid |
string |
내부적으로 요청을 추적하는 데 사용됩니다. ms-correlationid가 제공되지 않으면 서버는 각 요청에 대해 새 상관 관계를 생성합니다. |
|
| ms-cv |
string |
내부적으로 요청을 추적하는 데 사용됩니다. ms-cv 제공되지 않으면 서버는 각 요청에 대해 새 ms-cv 생성합니다. |
|
| ms-requestid |
string |
요청의 idempotency에 사용됩니다. ms-requestid가 제공되지 않으면 서버는 각 요청에 대해 새 요청을 생성합니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
Collections. |
요청이 성공했습니다. 응답 본문에는 Azure 사용률 레코드 리소스 컬렉션이 포함됩니다. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
| 204 No Content |
Collections. |
지정된 시작 및 종료 시간에는 데이터를 사용할 수 없습니다. 재시도 후 헤더와 함께 콘텐츠가 반환되지 않습니다. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
| 400 Bad Request |
누락되었거나 잘못된 입력이 있었습니다. 응답 본문은 오류 세부 정보를 제공합니다. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 401 Unauthorized |
요청이 인증되지 않았습니다. 클라이언트는 먼저 파트너 API 서비스를 사용하여 인증해야 합니다. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 403 Forbidden |
요청이 인증되었지만 호출자가 호출할 권한이 없으므로 거부되었습니다. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 404 Not Found |
리소스를 찾을 수 없거나 지정된 입력 매개 변수와 함께 사용할 수 없습니다. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
|
| 500 Internal Server Error |
파트너 API 서비스 또는 해당 종속성 중 하나가 요청을 충족하지 못했습니다. 호출자는 이를 다시 시도할 수 있습니다. Media Types: "application/json", "text/json", "application/xml", "text/xml" |
정의
Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]
| Name | 형식 | Description |
|---|---|---|
| attributes | ||
| items | ||
| links | ||
| totalCount |
integer |
Link
| Name | 형식 | Description |
|---|---|---|
| headers |
System. |
|
| method |
string |
|
| uri |
string |
ResourceAttributes
| Name | 형식 | Description |
|---|---|---|
| etag |
string |
|
| objectType |
string |
ResourceLinks
| Name | 형식 | Description |
|---|---|---|
| next | ||
| previous | ||
| self |
System.Collections.Generic.KeyValuePair[System.String,System.String]
| Name | 형식 | Description |
|---|---|---|
| key |
string |
|
| value |
string |
Utilizations.AzureInstanceData
| Name | 형식 | Description |
|---|---|---|
| additionalInfo |
object |
|
| location |
string |
|
| orderNumber |
string |
|
| partNumber |
string |
|
| resourceUri |
string |
|
| tags |
object |
Utilizations.AzureResource
| Name | 형식 | Description |
|---|---|---|
| category |
string |
|
| id |
string |
|
| name |
string |
|
| region |
string |
|
| subcategory |
string |
Utilizations.AzureUtilizationRecord
| Name | 형식 | Description |
|---|---|---|
| attributes | ||
| infoFields |
object |
|
| instanceData | ||
| quantity |
number |
|
| resource | ||
| unit |
string |
|
| usageEndTime |
string |
|
| usageStartTime |
string |