パートナー向けのオートメーション

Microsoft Cost Management は、顧客を Microsoft 顧客契約にオンボードし、Azure プランを購入した直接パートナーがネイティブに利用できます。 パートナーとそのお客様は、Cost Management API の一般的なタスクを使用できます。 オートメーション以外のシナリオについては、「パートナー向け Cost Management」を参照してください。

Note

この記事の例では特定の API バージョンを示していますが、使用可能な最新の API バージョンを使用することをお勧めします。 新しい API バージョンでは、機能が強化されている可能性があります。 新しい API バージョンでは、以前のバージョンがサポートされています。

Microsoft Cost Management API - 直接および間接プロバイダー

パートナー テナントの課金スコープにアクセスできるパートナーは、次の API を使用して請求されたコストを表示できます。

パートナーは、サブスクリプションに対してアクセス権を持っている間、コスト ポリシーに関係なく、サブスクリプション スコープの API を呼び出すことができます。 サブスクリプションにアクセスできる他のユーザー (顧客やリセラーなど) は、パートナーが顧客テナントのコスト ポリシーを有効にした後でのみ、API を呼び出すことができます。

課金アカウントの一覧を取得するには

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview 

顧客の一覧を取得するには

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers?api-version=2019-10-01-preview 

サブスクリプションの一覧を取得するには

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions?api-version=2019-10-01-preview 

特定期間の請求書の一覧を取得するには

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices?api-version=2019-10-01-preview&periodStartDate={periodStartDate}&periodEndDate={periodEndDate} 

この API 呼び出しは、次の JSON コードのような要素を持つ一連の請求書を返します。

   {      "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountID}/billingProfiles/{BillingProfileID}/invoices/{InvoiceID}",      "name": "{InvoiceID}",      "properties": {        "amountDue": {          "currency": "USD",          "value": x.xx        },        ...    } 

使用状況の詳細のクエリを実行するには、返された前の ID フィールドの値を使用し、次の例でスコープとして置き換えます。

GET https://management.azure.com/{id}/providers/Microsoft.Consumption/UsageDetails?api-version=2019-10-01 

この例は、特定の請求書に関連付けられた使用状況レコードを返します。

顧客がコストを表示するためのポリシーを取得するには

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview 

顧客がコストを表示するためのポリシーを設定するには

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview 

課金アカウントの Azure サービスの使用状況を取得するには

このようなシナリオのために、エクスポートを構成することをお勧めします。 詳細については、エクスポートを使用した大規模な使用状況データセットの取得に関する記事を参照してください。

顧客の Azure サービスの使用状況をダウンロードするには

このようなシナリオのためにも、エクスポートを構成することをお勧めします。 ただし、オンデマンドでデータをダウンロードする必要がある場合は、Cost Details API を使用できます。 詳細については、「オンデマンドで小規模なコスト データセットを取得する」を参照してください。

使用された Azure サービスの価格シートを取得またはダウンロードするには

まず、次の POST を使用します。

POST https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheet/default/download?api-version=2019-10-01-preview&format=csv" -verbose 

次に、非同期操作プロパティの値を呼び出します。 次に例を示します。

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheetDownloadOperations/{operation}?sessiontoken=0:11186&api-version=2019-10-01-preview 

前の GET 呼び出しでは、価格シートを含むダウンロード リンクが返されます。

集計コストを取得するには

POST https://management.azure.com/providers/microsoft.billing/billingAccounts/{billingAccountName}/providers/microsoft.costmanagement/query?api-version=2019-10-01 

パートナーの予算を作成する

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/providers/Microsoft.CostManagement/budgets/partnerworkshopbudget?api-version=2019-10-01 

顧客の予算を作成する

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/providers/Microsoft.Consumption/budgets/{budgetName}?api-version=2019-10-01 

予算を削除する

DELETE https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/budgets/{budgetName}?api-version=2019-10-01