Price Sheet - Get
サブスクリプションの価格シートを取得します。 価格シートは、2014 年 5 月 1 日以降にのみ、この API を介して利用できます。
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?$expand={$expand}&$skiptoken={$skiptoken}&$top={$top}&api-version=2024-08-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
subscription
|
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: 1maximum: 1000 |
結果の数を上位 N 個の結果に制限するために使用できます。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
わかりました。 要求は成功しました。 |
|
Other Status Codes |
操作が失敗した理由を説明するエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー。
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
名前 | 説明 |
---|---|
user_impersonation | ユーザー アカウントを偽装する |
例
PriceSheet
要求のサンプル
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01
応答のサンプル
{
"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",
"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",
"savingsPlan": {
"term": "P3Y",
"effectivePrice": 0.002,
"marketPrice": 0.00328
}
}
]
}
}
定義
名前 | 説明 |
---|---|
Error |
リソース管理エラーの追加情報。 |
Error |
エラーの詳細。 |
Error |
エラー応答 |
Meter |
メーターに関する詳細。 既定では、$expandで指定されていない限り、これは設定されません。 |
Price |
Price Sheet |
Price |
pricesheet リソース。 |
Savings |
SavingsPlan の詳細 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
エラー オブジェクト。 |
MeterDetails
メーターに関する詳細。 既定では、$expandで指定されていない限り、これは設定されません。
名前 | 型 | 説明 |
---|---|---|
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
Price Sheet
名前 | 型 | 説明 |
---|---|---|
billingPeriodId |
string |
使用量が属する請求期間リソースの ID。 |
currencyCode |
string |
通貨コード |
includedQuantity |
number (decimal) |
オファーに含まれる品質 |
meterDetails |
メーターに関する詳細。 既定では、$expandで指定されていない限り、これは設定されません。 |
|
meterId |
string (uuid) |
メーター ID (GUID) |
offerId |
string |
オファー ID |
partNumber |
string |
部品番号 |
savingsPlan |
SavingsPlan の詳細 |
|
unitOfMeasure |
string |
出荷単位 |
unitPrice |
number (decimal) |
単価 |
PriceSheetResult
pricesheet リソース。
名前 | 型 | 説明 |
---|---|---|
etag |
string |
リソースの etag。 |
id |
string |
イベントの完全修飾 ARM ID。 |
name |
string |
イベントを一意に識別する ID。 |
properties.download |
Pricesheet のダウンロードの詳細。 |
|
properties.nextLink |
string |
結果の次のページへのリンク (URL)。 |
properties.pricesheets |
Price Sheet |
|
tags |
object |
リソース タグ。 |
type |
string |
リソースの種類。 |
SavingsPlan
SavingsPlan の詳細
名前 | 型 | 説明 |
---|---|---|
effectivePrice |
number (decimal) |
SavingsPlan Effective Price |
marketPrice |
number (decimal) |
SavingsPlan の市場価格 |
term |
string |
SavingsPlan の用語 |