適用対象: パートナー センター | Microsoft Cloud for US Government のパートナー センター
Azure 使用率レコードには、Azure サブスクリプション リソースの使用率に関する詳細が含まれています。 顧客の Azure サブスクリプションの課金関係を所有しているクラウド サービス プロバイダー パートナーの場合は、この REST API を使用して、サブスクリプションで発生した使用状況を追跡するスケーラブルな方法を提供して、すべての請求サイクルの最後に顧客に請求書を送信できます。
使用量を追跡し、毎月の請求書と個々の顧客の請求書を予測するために、レート カード クエリを組み合わせて Microsoft Azure の価格を取得 し、Azure の顧客の使用率レコードを取得する要求を組み合わせることができます。
価格は市場と通貨によって異なり、この API では場所が考慮されます。 既定では、API はパートナー センターのパートナー プロファイル設定とブラウザー言語を使用します。これらの設定はカスタマイズ可能です。 場所の認識は、1 つの一元化されたオフィスから複数の市場での売上を管理する場合に特に関連します。
AzureUtilizationRecord
Azure 使用率レコード リソースのプロパティについて説明します。
| プロパティ | タイプ | 必須 | Description |
|---|---|---|---|
| usageStartTime | 文字列 | イエス | 使用状況集計時間範囲の開始。 応答は、消費時間 (リソースが使用されたときと、課金システムに報告された日時) でグループ化されます。 |
| usageEndTime | 文字列 | イエス | 使用状況集計時間範囲の末尾。 応答は、使用時間ごとにグループ化されます。 つまり、リソースが使用されたときと、いつ課金システムに報告されたかです。 |
| リソース | オブジェクト | イエス | AzureResource オブジェクトが含まれています。 |
| 量 | 数値 | イエス | AzureResource の消費量。 |
| ユニット | 文字列 | いいえ | 数量の種類 (時間、バイトなど)このプロパティは省略可能です |
| infoFields | オブジェクト | イエス | インスタンス レベルの詳細のキーと値のペア。 このオブジェクトは空にすることができます。 |
| instanceData | オブジェクト | いいえ | インスタンス レベルの詳細のキーと値のペアを含む AzureInstanceData オブジェクトを格納します。 このプロパティは省略可能であり、含まれない場合があります。 |
| attributes | ResourceAttributes | イエス | メタデータ属性。 "objectType": "AzureUtilizationRecord" が含まれています |
AzureUtilizationRecord リソースに対する操作
AzureResource
Azure リソースのプロパティについて説明します。
| プロパティ | タイプ | 必須 | Description |
|---|---|---|---|
| id | 文字列 | イエス | Azure リソースの一意識別子。 resourceID またはリソース GUID とも呼ばれます。 |
| 名前 | 文字列 | いいえ | 使用されているリソースのフレンドリ名。 このプロパティは省略可能です。 |
| カテゴリ | 文字列 | いいえ | 消費されたリソースのカテゴリ。 このプロパティは省略可能です。 |
| サブカテゴリ | 文字列 | いいえ | 消費されたリソースのサブカテゴリ。 このプロパティは省略可能です。 |
| リージョン | 文字列 | いいえ | 消費されたリソースのリージョン。 このプロパティは省略可能です。 |
AzureInstanceData
Azure インスタンス データ リソースのプロパティについて説明します。
| プロパティ | タイプ | 必須 | Description |
|---|---|---|---|
| resourceUri | 文字列 | イエス | リソース グループとインスタンス名を含む完全修飾 Azure リソース ID。 |
| 位置 | 文字列 | イエス | サービスが実行されたリージョン。 |
| 部品番号 | オブジェクト | イエス | Microsoft Marketplace のサード パーティの使用状況のリソースを識別するために使用される一意の名前空間。 このプロパティには空の文字列を指定できます。 |
| orderNumber | 数値 | イエス | Microsoft Marketplace のサード パーティの注文を識別するために使用される一意の名前空間。 このプロパティには空の文字列を指定できます。 |
| tags | 文字列の配列 | いいえ | ユーザーによって指定されたリソース タグ。 このプロパティは省略可能であり、含まれない場合があります。 |
| 追加情報 | 文字列の配列 | いいえ | Azure リソースの追加データ。 このプロパティは省略可能であり、含まれない場合があります。 |