EA Price Sheet API から移行
以前に Enterprise Reporting consumption.azure.com API を使用して価格シートを取得していた EA のお客様は、代わりの Azure Resource Manager API に移行する必要があります。 次の手順は移行に役立ち、古い API と新しい API のコントラクトの違いについても説明しています。
Note
すべての Azure Enterprise Reporting API は廃止されます。 できるだけ早く Microsoft Cost Management API に移行する必要があります。
API を呼び出すアクセス許可をサービス プリンシパルに割り当てる
API を呼び出す前に、適切なアクセス許可を持つサービス プリンシパル (SPN) を構成する必要があります。 サービス プリンシパルを使用して API を呼び出します。 詳細については、「Cost Management API へのアクセス許可の割り当て」を参照してください。
Price Sheet API を呼び出す
Price Sheet API は、価格シートを非同期的に生成し、ダウンロードしたファイルを生成します。
新しい Price Sheet API を呼び出す際は、以下の要求 URI を使用します。
サポートされている要求
この API は、次のスコープを使用して呼び出すことができます。
加入契約: providers/Microsoft.Billing/billingAccounts/{billingAccountId}
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01
POST 要求は、次の応答で説明されているように、レポート生成状態をポーリングする場所を返します。
サンプル応答
状態コード: 202
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01
Retry-After: 60
状態コード:200
{
"status": "Completed",
"properties": {
"downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
"validTill": "2023-09-30T17:32:28Z"
}
}
レポートの生成状態をポーリングする要求のサンプル
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e?api-version=2023-09-01
応答本文の変更
[
{
"id": "enrollments/57354989/billingperiods/201601/products/343/pricesheets",
"billingPeriodId": "201704",
"meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
"meterName": "A1 VM",
"unitOfMeasure": "100 Hours",
"includedQuantity": 0,
"partNumber": "N7H-00015",
"unitPrice": 0.00,
"currencyCode": "USD"
},
{
"id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
"billingPeriodId": "201404",
"meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
"meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
"unitOfMeasure": "100 GB",
"includedQuantity": 0,
"partNumber": "N9H-00402",
"unitPrice": 0.00,
"currencyCode": "USD"
},
...
]
応答の新しい変更点
価格シートのプロパティは次のとおりです。
名前 | タイプ | 説明 |
---|---|---|
basePrice | string | 顧客がサインオンした時点の単価、またはサインオン後の場合はサービス メーター GA 起動時の単価。 この単価は Enterprise Agreement ユーザーに適用されます |
currencyCode | string | Enterprise Agreement が締結された通貨 |
effectiveEndDate | string | Price Sheet 請求期間の終了日 |
effectiveStartDate | string | Price Sheet 請求期間の開始日 |
enrollmentNumber | string | EA 請求先アカウントの一意の識別子。 |
includedQuantity | string | 増分料金なしで EA 顧客に利用資格がある特定のサービスの数量。 |
marketPrice | string | 特定の製品またはサービスの現在の定価。 この価格は交渉を伴わず、Microsoft 契約の種類に基づいています。 PriceType が Consumption の場合、市場価格は、従量課金制の価格として反映されます。 PriceType が Savings Planの場合、市場価格には、対応するコミットメント期間の従量課金制価格に節約プラン特典が反映されます。 PriceType が ReservedInstance の場合、市場価格は 1 年または 3 年間のコミットメントの合計価格が反映されます。 注: 交渉を伴わない EA 顧客の場合、市場価格は単価とは異なる小数点以下の精度で四捨五入されて表示される場合があります。 |
meterCategory | string | メーターの分類カテゴリの名前。 たとえば、Cloud services、Networking などです。 |
meterId | string | メーターの一意識別子 |
meterName | string | メーターの名前。 メーターは、Azure サービスのデプロイ可能なリソースを表します。 |
meterRegion | string | サービスのメーターが使用可能な Azure リージョンの名前。 |
meterSubCategory | string | メーターのサブ分類カテゴリの名前。 |
meterType | string | メーターの種類の名前 |
partNumber | string | メーターに関連付けられた部品番号 |
priceType | string | 製品の価格の種類。 たとえば、従量課金制レートの Azure リソースで、priceType が Consumption の場合。 その他の価格の種類には、ReservedInstance と Savings プランがあります。 |
product | string | 料金が発生する製品の名前。 |
productId | string | メーターが消費される製品の一意の識別子。 |
serviceFamily | 数値 | Azure サービスの種類。 たとえば、Compute、Analytics、Security などです。 |
skuId | string | SKU の一意識別子 |
の用語 | string | Azure Savings プランまたは予約期間の期間 - 1 年または 3 年 (P1Y または P3Y) |
unitOfMeasure | string | サービスの使用状況の測定方法 |
unitPrice | string | 特定の製品またはサービスに対する請求時の単価 (市場価格に交渉済み割引を含む)。 PriceType が ReservedInstance の場合、単価には、割引を含む 1 年または 3 年のコミットメントの合計コストが反映されます。 注: サービスの価格がレベルごとに異なる場合、単価は使用量の詳細のダウンロード内の有効価格と同じではありません。 サービスに複数のレベルの価格がある場合、有効価格はレベル全体のブレンド価格であり、レベル別の単価は示されません。 ブレンド価格または有効価格は、複数のレベル (各レベルには固有の単価が存在) にまたがって消費された数量に対する正味価格です。 |
関連するコンテンツ
- 「EA レポートから ARM API への移行の概要」の記事を参照してください。