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 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
customer_id
|
path | True |
string |
擁有訂用帳戶的客戶標識碼。 |
|
subscription_id
|
path | True |
string |
要擷取使用率的 Azure 訂用帳戶標識碼。 |
|
end_time
|
query |
string date-time |
計費系統中使用量計量的結束時間。 |
|
|
granularity
|
query |
string |
資源使用量時間粒度。 可以是每日或每小時。 誹謗是每天的。 |
|
|
seek_operation
|
query |
string |
要執行的搜尋作業。 僅支援 Next。 |
|
|
show_details
|
query |
boolean |
如果設定為 true，則會依資源實例層級分割使用率記錄。 如果設定為 false，則會在資源層級匯總使用率記錄。 默認值為 true。 |
|
|
size
|
query |
integer int32 |
要傳回的選擇性記錄數目上限。 預設值為 1000。 傳回的資源集合將會指定下一個連結，以防有更多可用的使用率記錄。 |
|
|
start_time
|
query |
string date-time |
計費系統中使用量計量的開始時間。 |
要求標頭
| 名稱 | 必要 | 類型 | Description |
|---|---|---|---|
| Authorization | True |
string |
授權持有人令牌 |
| ms-correlationid |
string |
用於在內部追蹤要求。 如果未提供 ms-correlationid，伺服器會為每個要求產生新的要求 |
|
| ms-cv |
string |
用於在內部追蹤要求。 如果未提供 ms-cv，伺服器將會為每個要求產生新的要求 |
|
| ms-requestid |
string |
用於要求等冪性。 如果未提供 ms-requestid，伺服器將會為每個要求產生新的要求 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
Collections. |
要求成功。 回應本文包含 Azure 使用率記錄資源集合。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
| 204 No Content |
Collections. |
數據不適用於指定的開始和結束時間。 未傳回任何內容，且標頭為 retry-after 標頭。 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]
| 名稱 | 類型 | Description |
|---|---|---|
| attributes | ||
| items | ||
| links | ||
| totalCount |
integer |
Link
| 名稱 | 類型 | Description |
|---|---|---|
| headers |
System. |
|
| method |
string |
|
| uri |
string |
ResourceAttributes
| 名稱 | 類型 | Description |
|---|---|---|
| etag |
string |
|
| objectType |
string |
ResourceLinks
| 名稱 | 類型 | Description |
|---|---|---|
| next | ||
| previous | ||
| self |
System.Collections.Generic.KeyValuePair[System.String,System.String]
| 名稱 | 類型 | Description |
|---|---|---|
| key |
string |
|
| value |
string |
Utilizations.AzureInstanceData
| 名稱 | 類型 | Description |
|---|---|---|
| additionalInfo |
object |
|
| location |
string |
|
| orderNumber |
string |
|
| partNumber |
string |
|
| resourceUri |
string |
|
| tags |
object |
Utilizations.AzureResource
| 名稱 | 類型 | Description |
|---|---|---|
| category |
string |
|
| id |
string |
|
| name |
string |
|
| region |
string |
|
| subcategory |
string |
Utilizations.AzureUtilizationRecord
| 名稱 | 類型 | Description |
|---|---|---|
| attributes | ||
| infoFields |
object |
|
| instanceData | ||
| quantity |
number |
|
| resource | ||
| unit |
string |
|
| usageEndTime |
string |
|
| usageStartTime |
string |