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/00000000-0000-0000-0000-000000000000?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/00000000-0000-0000-0000-000000000000?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 年のコミットメントの合計コストが反映されます。

注: サービスの価格がレベルごとに異なる場合、単価は使用量の詳細のダウンロード内の有効価格と同じではありません。

サービスに複数のレベルの価格がある場合、有効価格はレベル全体のブレンド価格であり、レベル別の単価は示されません。 ブレンド価格または有効価格は、複数のレベル (各レベルには固有の単価が存在) にまたがって消費された数量に対する正味価格です。

次のステップ