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 パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
customer_id
|
path | True |
string |
サブスクリプションを所有している顧客の ID。 |
|
subscription_id
|
path | True |
string |
使用率を取得する Azure サブスクリプションの ID。 |
|
end_time
|
query |
string date-time |
課金システムで使用状況が測定された終了時刻。 |
|
|
granularity
|
query |
string |
リソースの使用時間の細分性。 1 日 1 回または 1 時間単位で指定できます。 遅延は毎日行われます。 |
|
|
seek_operation
|
query |
string |
実行するシーク操作。 Next のみがサポートされています。 |
|
|
show_details
|
query |
boolean |
true に設定すると、使用率レコードはリソース インスタンス レベルによって分割されます。 false に設定すると、使用率レコードはリソース レベルで集計されます。 既定値は true です。 |
|
|
size
|
query |
integer int32 |
返されるレコードの最大数 (省略可能)。 既定値は 1000 です。 返されるリソース コレクションでは、使用可能な使用率レコードが増えた場合に備えて、次のリンクが指定されます。 |
|
|
start_time
|
query |
string date-time |
課金システムで使用状況が測定された開始時刻。 |
要求ヘッダー
| 名前 | 必須 | 型 | 説明 |
|---|---|---|---|
| Authorization | True |
string |
承認ベアラー トークン |
| ms-correlationid |
string |
要求を内部的に追跡するために使用されます。 ms-correlationid が指定されていない場合、サーバーは要求ごとに新しいものを生成します |
|
| ms-cv |
string |
要求を内部的に追跡するために使用されます。 ms-cv が指定されていない場合、サーバーは要求ごとに新しい ms-cv を生成します |
|
| ms-requestid |
string |
要求のべき等性に使用されます。 ms-requestid が指定されていない場合、サーバーは要求ごとに新しいものを生成します |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 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 サービスまたはその依存関係の 1 つが要求を満たできませんでした。 呼び出し元はこれを再試行できます。 Media Types: "application/json", "text/json", "application/xml", "text/xml" |
定義
Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]
| 名前 | 型 | 説明 |
|---|---|---|
| attributes | ||
| items | ||
| links | ||
| totalCount |
integer |
Link
| 名前 | 型 | 説明 |
|---|---|---|
| headers |
System. |
|
| method |
string |
|
| uri |
string |
ResourceAttributes
| 名前 | 型 | 説明 |
|---|---|---|
| etag |
string |
|
| objectType |
string |
ResourceLinks
| 名前 | 型 | 説明 |
|---|---|---|
| next | ||
| previous | ||
| self |
System.Collections.Generic.KeyValuePair[System.String,System.String]
| 名前 | 型 | 説明 |
|---|---|---|
| key |
string |
|
| value |
string |
Utilizations.AzureInstanceData
| 名前 | 型 | 説明 |
|---|---|---|
| additionalInfo |
object |
|
| location |
string |
|
| orderNumber |
string |
|
| partNumber |
string |
|
| resourceUri |
string |
|
| tags |
object |
Utilizations.AzureResource
| 名前 | 型 | 説明 |
|---|---|---|
| category |
string |
|
| id |
string |
|
| name |
string |
|
| region |
string |
|
| subcategory |
string |
Utilizations.AzureUtilizationRecord
| 名前 | 型 | 説明 |
|---|---|---|
| attributes | ||
| infoFields |
object |
|
| instanceData | ||
| quantity |
number |
|
| resource | ||
| unit |
string |
|
| usageEndTime |
string |
|
| usageStartTime |
string |