Price Sheet - Get
取得訂閱的價格表。 價位表僅適用於 2014 年 5 月 1 日或更新版本。
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?api-version=2024-08-01&$expand={$expand}&$skiptoken={$skiptoken}&$top={$top}
URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
subscription
|
path | True |
string minLength: 1 |
目標訂用帳戶的標識碼。 |
|
api-version
|
query | True |
string minLength: 1 |
用於此作業的 API 版本。 |
|
$expand
|
query |
string |
可用來展開價位表內的屬性/meterDetails。 根據預設,傳回價位表時不會包含這些欄位。 |
|
|
$skiptoken
|
query |
string |
只有在先前的作業傳回部分結果時,才會使用Skiptoken。 如果先前的回應包含 nextLink 元素,則 nextLink 元素的值會包含 skiptoken 參數,指定要用於後續呼叫的起點。 |
|
|
$top
|
query |
integer (int32) minimum: 1maximum: 1000 |
可用來將結果數目限制為前 N 個結果。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
Azure 作業已順利完成。 |
|
| Other Status Codes |
未預期的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
| 名稱 | Description |
|---|---|
| user_impersonation | 模擬您的用戶帳戶 |
範例
PriceSheet
範例要求
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Consumption/pricesheets/default?api-version=2024-08-01
範例回覆
{
"name": "default",
"type": "Microsoft.Consumption/pricesheets",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.Billing/billingPeriods/201702/providers/Microsoft.Consumption/pricesheets/default",
"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",
"currencyCode": "EUR",
"includedQuantity": 100,
"meterId": "00000000-0000-0000-0000-000000000000",
"offerId": "OfferId 1",
"partNumber": "XX-11110",
"savingsPlan": {
"effectivePrice": 0.002,
"marketPrice": 0.00328,
"term": "P3Y"
},
"unitOfMeasure": "100 Hours",
"unitPrice": 0.00328
}
]
}
}
定義
| 名稱 | Description |
|---|---|
|
created |
建立資源的身分識別類型。 |
|
Error |
資源管理錯誤其他資訊。 |
|
Error |
錯誤詳細數據。 |
|
Error |
錯誤回應 |
|
Meter |
計量詳細數據的屬性。 |
|
Price |
價位表的屬性。 |
|
Price |
價位表資源。 |
|
Savings |
SavingsPlan 的屬性。 |
|
system |
與建立和上次修改資源相關的元數據。 |
createdByType
建立資源的身分識別類型。
| 值 | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
| 名稱 | 類型 | Description |
|---|---|---|
| info |
object |
其他資訊。 |
| type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細數據。
| 名稱 | 類型 | Description |
|---|---|---|
| additionalInfo |
錯誤其他資訊。 |
|
| code |
string |
錯誤碼。 |
| details |
錯誤詳細數據。 |
|
| message |
string |
錯誤訊息。 |
| target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
| 名稱 | 類型 | Description |
|---|---|---|
| error |
error 物件。 |
MeterDetails
計量詳細數據的屬性。
| 名稱 | 類型 | Description |
|---|---|---|
| meterCategory |
string |
計量的類別,例如「雲端服務」、「網路」等。 |
| meterLocation |
string |
Azure 服務可供使用的位置。 |
| meterName |
string |
指定計量類別內計量的名稱 |
| meterSubCategory |
string |
計量的子類別,例如 『A6 雲端服務』、『ExpressRoute (IXP)』等等。 |
| pretaxStandardRate |
number (decimal) |
售前清單價格。 |
| serviceName |
string |
服務的名稱。 |
| serviceTier |
string |
服務層級。 |
| totalIncludedQuantity |
number (decimal) |
與供應專案相關聯的包含數量總計。 |
| unit |
string |
計量耗用量計費單位,例如『Hours』、『GB』等。 |
PriceSheetProperties
價位表的屬性。
| 名稱 | 類型 | Description |
|---|---|---|
| billingPeriodId |
string |
使用量所屬計費週期資源的標識碼。 |
| currencyCode |
string |
貨幣代碼 |
| includedQuantity |
number (decimal) |
供應專案包含的品質 |
| meterDetails |
計量的詳細數據。 根據預設,除非在 $expand 中指定,否則不會填入此專案。 |
|
| meterId |
string (uuid) |
計量識別碼 (GUID) |
| offerId |
string |
供應項目標識碼 |
| partNumber |
string |
元件編號 |
| savingsPlan |
SavingsPlan 詳細數據 |
|
| unitOfMeasure |
string |
衡量單位 |
| unitPrice |
number (decimal) |
單價 |
PriceSheetResult
價位表資源。
| 名稱 | 類型 | Description |
|---|---|---|
| etag |
string |
資源的 eTag。 若要處理並行更新案例,此字段將用來判斷使用者是否要更新最新版本。 |
| id |
string |
資源的完整資源標識碼。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| name |
string |
資源的名稱 |
| properties.download |
價位錶下載詳細數據。 |
|
| properties.nextLink |
string |
結果下一頁的連結(url)。 |
| properties.pricesheets |
價位表 |
|
| systemData |
包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。 |
|
| tags |
object |
資源標籤。 |
| type |
string |
資源的類型。 例如「Microsoft.Compute/virtualMachines」或「Microsoft.Storage/storageAccounts」 |
SavingsPlan
SavingsPlan 的屬性。
| 名稱 | 類型 | Description |
|---|---|---|
| effectivePrice |
number (decimal) |
SavingsPlan 有效價格 |
| marketPrice |
number (decimal) |
SavingsPlan 市場價格 |
| term |
string |
SavingsPlan 字詞 |
systemData
與建立和上次修改資源相關的元數據。
| 名稱 | 類型 | Description |
|---|---|---|
| createdAt |
string (date-time) |
資源建立的時間戳(UTC)。 |
| createdBy |
string |
建立資源的身分識別。 |
| createdByType |
建立資源的身分識別類型。 |
|
| lastModifiedAt |
string (date-time) |
上次修改的資源時間戳 (UTC) |
| lastModifiedBy |
string |
上次修改資源的身分識別。 |
| lastModifiedByType |
上次修改資源的身分識別類型。 |