Price Sheet - Get By Billing Period

リファレンス

サービス:: Consumption

API バージョン:: 2024-08-01

subscriptionId と請求期間ごとにスコープの価格シートを取得します。価格シートは、2014 年 5 月 1 日以降にのみ、この API を介して利用できます。

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01

省略可能なパラメーターを含む:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?$expand={$expand}&$skiptoken={$skiptoken}&$top={$top}&api-version=2024-08-01

URI パラメーター

名前	/	必須	型	説明
billingPeriodName	path	True	string	請求期間名。
subscriptionId	path	True	string	Azure サブスクリプション ID。
api-version	query	True	string	クライアント要求で使用する API のバージョン。現在のバージョンは 2023-03-01 です。
$expand	query		string	価格シート内のプロパティ/meterDetails を展開するために使用できます。既定では、これらのフィールドは価格シートを返すときに含まれません。
$skiptoken	query		string	Skiptoken は、前の操作で部分的な結果が返された場合にのみ使用されます。前の応答に nextLink 要素が含まれている場合、nextLink 要素の値には、後続の呼び出しに使用する開始点を指定する skiptoken パラメーターが含まれます。
$top	query		integer (int32) minimum: 1 maximum: 1000	結果の数を上位 N 個の結果に制限するために使用できます。

応答

名前	型	説明
200 OK	PriceSheetResult	わかりました。要求は成功しました。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

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

スコープ

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

例

PriceSheetExpand

PriceSheetForBillingPeriod

PriceSheetExpand

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201801/providers/Microsoft.Consumption/pricesheets/default?$expand=meterDetails&api-version=2024-08-01

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/pricesheets/default",
  "name": "default",
  "type": "Microsoft.Consumption/pricesheets",
  "properties": {
    "nextLink": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/microsoft.consumption/pricesheets/default?api-version=2018-01-31&$skiptoken=AQAAAA%3D%3D&$expand=properties/pricesheets/meterDetails",
    "pricesheets": [
      {
        "billingPeriodId": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "unitOfMeasure": "100 Hours",
        "includedQuantity": 100,
        "partNumber": "XX-11110",
        "unitPrice": 0.00328,
        "currencyCode": "EUR",
        "offerId": "OfferId 1",
        "meterDetails": {
          "meterName": "Data Transfer Out (GB)",
          "meterCategory": "Networking",
          "unit": "GB",
          "meterLocation": "Zone 2",
          "totalIncludedQuantity": 0,
          "pretaxStandardRate": 0.138
        }
      }
    ]
  }
}

PriceSheetForBillingPeriod

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201801/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01

応答のサンプル

状態コード:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/pricesheets/default",
  "name": "default",
  "type": "Microsoft.Consumption/pricesheets",
  "properties": {
    "nextLink": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/microsoft.consumption/pricesheets/default?api-version=2018-01-31",
    "pricesheets": [
      {
        "billingPeriodId": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702",
        "meterId": "00000000-0000-0000-0000-000000000000",
        "unitOfMeasure": "100 Hours",
        "includedQuantity": 100,
        "partNumber": "XX-11110",
        "unitPrice": 0.00328,
        "currencyCode": "EUR",
        "offerId": "OfferId 1"
      }
    ]
  }
}

定義

名前	説明
ErrorDetails	エラーの詳細。
ErrorResponse	エラー応答は、サービスが受信要求を処理できないことを示します。エラーメッセージに理由が示されます。いくつかのエラー応答: 429 TooManyRequests - 要求が調整されました。 "x-ms-ratelimit-microsoft.consumption-retry-after" ヘッダーで指定された時刻を待機した後に再試行します。 503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻を待機した後に再試行します。 504 ゲートウェイタイムアウト - 要求の処理中にサービスがタイムアウトしました。可能であれば、要求の日付範囲を減らします。
MeterDetails	メーターの詳細のプロパティ。
PriceSheetProperties	価格シートのプロパティ。
PriceSheetResult	pricesheet リソース。
SavingsPlan	SavingsPlan のプロパティ。

ErrorDetails

Object

エラーの詳細。

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

ErrorResponse

Object

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

いくつかのエラー応答:

429 TooManyRequests - 要求が調整されました。 "x-ms-ratelimit-microsoft.consumption-retry-after" ヘッダーで指定された時刻を待機した後に再試行します。
503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻を待機した後に再試行します。
504 ゲートウェイタイムアウト - 要求の処理中にサービスがタイムアウトしました。可能であれば、要求の日付範囲を減らします。

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

MeterDetails

Object

メーターの詳細のプロパティ。

名前	型	説明
meterCategory	string	メーターのカテゴリ ("クラウドサービス"、"ネットワーク" など)。
meterLocation	string	Azure サービスが使用可能な場所。
meterName	string	指定されたメーターカテゴリ内のメーターの名前
meterSubCategory	string	メーターのサブカテゴリ (例: "A6 クラウドサービス"、"ExpressRoute (IXP)")。
pretaxStandardRate	number (decimal)	pretax の掲載価格。
serviceName	string	サービスの名前。
serviceTier	string	サービスレベル。
totalIncludedQuantity	number (decimal)	オファーに関連付けられている合計含まれる数量。
unit	string	メーター使用量が課金される単位 (たとえば、"Hours"、"GB")。

PriceSheetProperties

Object

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

名前	型	説明
billingPeriodId	string	使用量が属する請求期間リソースの ID。
currencyCode	string	通貨コード
includedQuantity	number (decimal)	オファーに含まれる品質
meterDetails	MeterDetails	メーターに関する詳細。既定では、$expandで指定されていない限り、これは設定されません。
meterId	string (uuid)	メーター ID (GUID)
offerId	string	オファー ID
partNumber	string	部品番号
savingsPlan	SavingsPlan	SavingsPlan の詳細
unitOfMeasure	string	出荷単位
unitPrice	number (decimal)	単価

PriceSheetResult

Object

pricesheet リソース。

名前	型	説明
etag	string	リソースの etag。
id	string	イベントの完全修飾 ARM ID。
name	string	イベントを一意に識別する ID。
properties.download	MeterDetails	Pricesheet のダウンロードの詳細。
properties.nextLink	string	結果の次のページへのリンク (URL)。
properties.pricesheets	PriceSheetProperties[]	Price Sheet
tags	object	リソースタグ。
type	string	リソースの種類。

SavingsPlan

Object

SavingsPlan のプロパティ。

名前	型	説明
effectivePrice	number (decimal)	SavingsPlan Effective Price
marketPrice	number (decimal)	SavingsPlan の市場価格
term	string	SavingsPlan の用語

次の方法で共有

Price Sheet - Get By Billing Period

URI パラメーター

応答

セキュリティ

azure_auth

スコープ

例

PriceSheetExpand

要求のサンプル

応答のサンプル

PriceSheetForBillingPeriod

要求のサンプル

応答のサンプル

定義

ErrorDetails

ErrorResponse

MeterDetails

PriceSheetProperties

PriceSheetResult

SavingsPlan

その他のリソース