Price Sheet - Download By Billing Account

サービス:

Cost Management

API バージョン:

2024-08-01

登録 ID に基づいて、指定された請求期間の価格シートを非同期的に生成します。 これは Enterprise Agreement のお客様向けです。

バージョン 2024-08-01 への移行

新しい URI で 2024-08-01 API バージョンを使用できます。

'/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download'

以下に詳しく説明する新しいスキーマでは、価格シートの新しいバージョンで追加情報が提供され、現在の請求期間の Azure 予約インスタンス (RI) の価格が含まれます。 過去の Azure 予約インスタンス (RI) 価格の継続的な記録を維持する場合は、新しい請求期間を入力するときに Azure Price Sheet をダウンロードすることをお勧めします。

EA Azure の価格シートは、過去 13 か月間の請求期間で使用できます。 13 か月を超える請求期間の価格シートを要求するには、サポートにお問い合わせください。

Azure 価格シートのダウンロード エクスペリエンスは、1 つの .csv ファイルから、最大サイズが 75 MB の複数の .csv ファイルを含む zip ファイルに更新されました。 2023-11-01 バージョンは、http POST メソッドを使用するようにアップグレードされました。詳細については、以下を参照してください。

すべてのバージョンの Microsoft.Consumption Azure Price Sheet - 課金アカウントによるダウンロード (2022-06-01 を含む) 2021-10-01、2020-01-01-preview、2019-10-01、2019-05-01) は 2026 年 6 月 1 日に廃止される予定であり、この日以降はサポートされなくなります。

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

URI パラメーター

名前	/	必須	型	説明
billingAccountId	path	True	string	BillingAccount ID
billingPeriodName	path	True	string	請求期間名。 正規表現パターン: ^[0-9]*$
api-version	query	True	string	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	OperationStatus	わかりました。 要求は成功しました。
202 Accepted		受け入れ られる。 ヘッダー Location: string Retry-After: string
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザー アカウントを偽装する

例

EAPriceSheetForBillingPeriod

要求のサンプル

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202311/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

応答のサンプル

状態コード:

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"
  }
}

定義

名前	説明
EAPriceSheetProperties	EA 価格シートのプロパティ。 バージョン 2024-08-01 でサポートされるプロパティは次のとおりです。
ErrorDetails	エラーの詳細。
ErrorResponse	エラー応答は、サービスが受信要求を処理できないことを示します。 エラー メッセージに理由が示されます。 いくつかのエラー応答: 429 TooManyRequests - 要求が調整されました。 "x-ms-ratelimit-microsoft.consumption-retry-after" ヘッダーで指定された時刻を待機した後に再試行します。 503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻を待機した後に再試行します。
OperationStatus	実行時間の長い操作の状態。
OperationStatusType	実行時間の長い操作の状態。

EAPriceSheetProperties

EA 価格シートのプロパティ。 バージョン 2024-08-01 でサポートされるプロパティは次のとおりです。

名前	型	説明
basePrice	string	顧客がサインオンした時点の単価、またはサインオン後の場合はサービス メーター GA 起動時の単価。 これは、Enterprise Agreement ユーザーに適用されます
currencyCode	string	エンタープライズ契約が署名された通貨
effectiveEndDate	string	価格シート請求期間の終了日
effectiveStartDate	string	価格シート請求期間の有効開始日
enrollmentNumber	string	EA 課金アカウントの一意識別子。
includedQuantity	string	EA のお客様が増分料金なしで使用できる特定のサービスの数量。
marketPrice	string	特定の製品またはサービスの現在の定価。 この価格は交渉を伴わず、Microsoft 契約の種類に基づいています。 PriceType Consumption の場合、市場価格は従量課金制の価格として反映されます。 PriceType Savings プランの場合、市場価格には、対応するコミットメント期間の従量課金制価格の上に Savings プラン特典が反映されます。 PriceType ReservedInstance の場合、市場価格は 1 年または 3 年間のコミットメントの合計価格を反映します。 注: 交渉がない EA のお客様の場合、市場価格は単価とは異なる小数点精度に丸められたように見える場合があります。
meterCategory	string	メーターの分類カテゴリの名前。 たとえば、クラウド サービス、ネットワークなどです。
meterId	string	メーターの一意識別子
meterName	string	メーターの名前。 メーターは、Azure サービスのデプロイ可能なリソースを表します。
meterRegion	string	サービスのメーターが使用可能な Azure リージョンの名前。
meterSubCategory	string	メーターサブクラス化カテゴリの名前。
meterType	string	メーターの種類の名前
offerId	string	このメーターに関連付けられている Azure オファーを決定します。 [Azure オファーの詳細を確認する](https://azure.microsoft.com/en-us/support/legal/offer-details/)
partNumber	string	メーターに関連付けられている部品番号
priceType	string	製品の価格の種類。 たとえば、従量課金制の料金で priceType を従量課金制として使用する Azure リソースなどです。 その他の価格の種類には、ReservedInstance と Savings プランがあります。
product	string	料金が発生する製品の名前。
productId	string	メーターが消費される製品の一意識別子。
serviceFamily	number	Azure サービスの種類。 たとえば、コンピューティング、分析、セキュリティなどです。
skuId	string	SKU の一意識別子
term	string	Azure Savings プランまたは予約期間の期間 - 1 年または 3 年 (P1Y または P3Y)
unitOfMeasure	string	サービスの使用状況の測定方法。 注: "Unit" フィールドは、バージョン 2023-11-01 で "UnitofMeasure" の複製として削除されました。フィールド "UnitOfMeasure" を使用してください。
unitPrice	string	特定の製品またはサービスに対する請求時の単価(市場価格に基づく交渉済みの割引を含む)。 PriceType ReservedInstance の場合、単価には、割引を含む 1 年または 3 年間のコミットメントの合計コストが反映されます。 注: サービスが階層間で差分価格を持っている場合、単価は使用状況の詳細ダウンロードの有効価格と同じではありません。 サービスに多層価格がある場合、有効な価格は階層全体のブレンドレートであり、階層固有の単価は表示されません。 ブレンド価格または有効価格は、複数のレベルにまたがる消費数量の純価格です (各レベルには特定の単価があります)。

ErrorDetails

エラーの詳細。

名前	型	説明
code	string	エラー コード。
message	string	操作が失敗した理由を示すエラー メッセージ。

ErrorResponse

エラー応答は、サービスが受信要求を処理できないことを示します。 エラー メッセージに理由が示されます。

いくつかのエラー応答:

• 429 TooManyRequests - 要求が調整されました。 "x-ms-ratelimit-microsoft.consumption-retry-after" ヘッダーで指定された時刻を待機した後に再試行します。

• 503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻を待機した後に再試行します。

名前	型	説明
error	ErrorDetails	エラーの詳細。

OperationStatus

実行時間の長い操作の状態。

名前	型	説明
properties.downloadFileProperties	EAPriceSheetProperties	ダウンロードしたファイルのプロパティ
properties.downloadUrl	string	価格シートをダウンロードするためのリンク (URL)。
properties.validTill	string	リンクの有効性をダウンロードします。
status	OperationStatusType	実行時間の長い操作の状態。

OperationStatusType

実行時間の長い操作の状態。

名前	型	説明
Completed	string
Failed	string
Running	string