Price Sheet - Download By Billing Account

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

登録 ID に基づいて、指定された請求期間の価格シートを非同期的に生成します。 これは、Enterprise Agreementのお客様向けです。 新しい 2023-09-01 API バージョンは、2023 年 1 月以降の請求期間の '/providers/Microsoft.Billing/billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download' で使用できます。 以下で詳しく説明する新しいスキーマでは、新しい価格シートに詳細が表示され、現在の請求期間の Azure 予約インスタンス (RI) の価格が含まれています。

過去の Azure 予約インスタンス (RI) 価格の記録を保持する場合は、新しい請求期間を入力するときに、Azure Price Sheet をダウンロードすることをお勧めします。 Azure 製品の成長により、このプレビュー バージョンの Azure 価格シートのダウンロード エクスペリエンスは、1 つの .csv ファイルから、それぞれ最大サイズが 75 MB の複数の csv ファイルを含む zip ファイルに更新されます。

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

URI パラメーター

名前 / 必須 型 説明
billingAccountId
 path True

string

BillingAccount ID
billingPeriodName
 path True

string

請求期間名。

正規表現パターン: ^[0-9]*$
api-version
 query True

string

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

応答

名前 型 説明
200 OK

OperationStatus

OK です。 要求は成功しました。
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

要求のサンプル

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202311/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-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 価格シートのプロパティ。
ErrorDetails

エラーの詳細。
ErrorResponse

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

いくつかのエラー応答:

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

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

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

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

EAPriceSheetProperties

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

名前 型 説明
basePrice

string

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

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

string

Enterprise Agreementが署名された通貨
effectiveEndDate

string

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

string

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

string

EA 課金アカウントの一意識別子。
includedQuantity

string

EA のお客様が増分料金なしで消費する権利がある特定のサービスの数量。
marketPrice

string

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

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

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

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

注: 交渉を行っていない EA のお客様の場合、市場価格は単価とは異なる 10 進精度に丸められる場合があります。
meterCategory

string

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

string

メーターの一意識別子
meterName

string

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

string

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

string

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

string

メーターの種類の名前
partNumber

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)
unitOfMeasure

string

サービスの使用状況の測定方法
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