Price Sheet - Download By Billing Profile

  • リファレンス
サービス:
Cost Management
API バージョン:
2023-11-01

課金プロファイルの現在の月の価格シートをダウンロードする URL を取得します。 この操作は、契約の種類がMicrosoft Partner AgreementまたはMicrosoft 顧客契約の課金アカウントでサポートされています。

2023 年 1 月以降の請求期間には、新しい 2023-09-01 API バージョンを使用できます。 Azure Reserved Instance (RI) の価格は、新しいバージョンの API でのみ使用できます。

Azure 製品の増加により、このプレビュー バージョンの Azure 価格シートのダウンロード エクスペリエンスは、1 つの csv/json ファイルから、それぞれ最大サイズが 75 MB の複数の csv/json ファイルを含む Zip ファイルに更新されます。

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

URI パラメーター

名前 / 必須 型 説明
billingAccountName
 path True

string

課金アカウントを一意に識別する ID。

正規表現パターン: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+):([A-Za-z0-9]+(-[A-Za-z0-9]+)+)_[0-9]{4}-[0-9]{2}-[0-9]{2}
billingProfileName
 path True

string

課金プロファイルを一意に識別する ID。

正規表現パターン: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+)
api-version
 query True

string

この操作に使用する API バージョン。

応答

名前 型 説明
200 OK

PricesheetDownloadProperties

OK です。 要求は成功しました。
202 Accepted

受理されました。

ヘッダー

  • Location: string
  • Retry-After: string
  • OData-EntityId: 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 ユーザー アカウントの借用

例

PricesheetDownloadByBillingProfile

要求のサンプル

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

応答のサンプル

状態コード:
202 
Location: https://management.azure.com:443/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/operationResults/45000000-0000-0000-0000-000000000000?sessiontoken=0:000000&api-version=2023-11-01&OperationType=PriceSheet
Retry-After: 60
OData-EntityId: 45000000-0000-0000-0000-000000000000
状態コード:
200 
{
  "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",
  "expiryTime": "2018-07-21T17:32:28Z"
}

定義

名前 説明
ErrorDetails

エラーの詳細。
ErrorResponse

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

いくつかのエラー応答:

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

  • 503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻まで待ってから、再試行してください。
MCAPriceSheetProperties

価格シートのプロパティ。
PricesheetDownloadProperties

生成されたレポートをダウンロードする URL。

ErrorDetails

エラーの詳細。

名前 型 説明
code

string

エラー コード。
message

string

操作が失敗した理由を示すエラー メッセージ。

ErrorResponse

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

いくつかのエラー応答:

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

  • 503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻まで待ってから、再試行してください。

名前 型 説明
error

ErrorDetails

エラーの詳細。

MCAPriceSheetProperties

価格シートのプロパティ。

名前 型 説明
basePrice

string

顧客がサインオンした時点の単価、またはサインオン後の場合はサービスメーター GA 起動時の単価。

これは、Enterprise Agreement ユーザーに適用されます
billingAccountID

string

請求先アカウントの一意の識別子。
billingAccountName

string

請求書を受け取るよう設定されている課金プロファイルの名前。 価格シート内の価格は、この課金プロファイルに関連付けられています。
billingCurrency

string

料金が転記される通貨。
billingProfileId

string

課金プロファイルの一意の識別子。
billingProfileName

string

請求書を受け取るよう設定されている課金プロファイルの名前。 価格シート内の価格は、この課金プロファイルに関連付けられています。
currency

string

すべての価格が反映される通貨。
effectiveEndDate

string

価格シート請求期間の有効終了日
effectiveStartDate

string

価格シート請求期間の有効開始日
marketPrice

string

特定の製品またはサービスの現在の定価。 この価格は交渉を行わず、お客様の Microsoft 契約の種類に基づいています。

PriceType Consumption の場合、市場価格は従量課金制の価格として反映されます。

PriceType 節約プランの場合、市場価格には、対応するコミットメント期間の従量課金制価格の上に節約プランの特典が反映されます。

PriceType ReservedInstance の場合、市場価格には 1 年または 3 年間のコミットメントの合計価格が反映されます。
meterCategory

string

メーターの分類カテゴリの名前。 たとえば、Cloud services、Networking などです。
meterName

string

メーターの名前。 メーターは、Azure サービスのデプロイ可能なリソースを表します。
meterRegion

string

サービスのメーターが使用可能な Azure リージョンの名前。
meterSubCategory

string

メーターのサブ分類カテゴリの名前。
meterType

string

メーターの種類の名前
priceType

string

製品の価格の種類。 たとえば、従量課金制の料金で priceType を従量課金制として使用する Azure リソースです。 その他の価格の種類には、ReservedInstance と Savings プランが含まれます。
product

string

料金が発生する製品の名前。
productId

string

メーターが消費される製品の一意の識別子。
serviceFamily

number

Azure サービスの種類。 たとえば、Compute、Analytics、Security などです。
skuId

string

SKU の一意識別子
term

string

Azure 節約プランまたは予約期間の期間 - 1 年または 3 年 (P1Y または P3Y)
tierMinimumUnits

string

価格が定義されているレベル範囲の下限を定義します。 たとえば、範囲が 0 から 100 の場合、tierMinimumUnits は 0 になります。
unitOfMeasure

string

サービスの使用状況の測定方法
unitPrice

string

特定の製品またはサービスの請求時の単価(市場価格に基づく交渉済みの割引を含む)。

PriceType ReservedInstance の場合、単価には、割引を含む 1 年または 3 年間のコミットメントの合計コストが反映されます。

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

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

PricesheetDownloadProperties

生成されたレポートをダウンロードする URL。

名前 型 説明
downloadFileProperties

MCAPriceSheetProperties

ダウンロードしたファイルのプロパティ
downloadUrl

string

生成されたレポートをダウンロードする URL。
expiryTime

string

レポート URL が無効になるか、UTC で期限切れになる時刻 (例: 2020-12-08T05:55:59.4394737Z)。