Price Sheet - Download By Billing Account
根據註冊標識碼,以異步方式產生所提供計費周期的價位表。 這適用於 Enterprise 合約 客戶。 您可以在 '/providers/Microsoft.Billing/billingAccounts/{billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download' 上使用新的 2023-09-01 API 版本。2023 年 1 月之後的計費期間。 有了下面詳述的新架構,新的價位表會提供詳細資訊,並包含 Azure 保留實例的價格, (RI) 目前計費週期。
如果您要維護過去 Azure 保留實例的記錄, (RI) 定價,建議您在輸入新的計費期間時下載 Azure 價位表。 由於 Azure 產品成長,此預覽版本中的 Azure 價位錶下載體驗將從單一 .csv 檔案更新為包含多個 csv 檔案的 zip 檔案,每個檔案大小上限為 75MB。
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
billing
|
path | True |
string |
BillingAccount 識別符 |
billing
|
path | True |
string |
計費期間名稱。 Regex 模式: |
api-version
|
query | True |
string |
用於此作業的 API 版本。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
正常。 要求已成功。 |
|
202 Accepted |
已接受。 標題
|
|
Other Status Codes |
描述作業失敗原因的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
名稱 | Description |
---|---|
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
範例回覆
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
{
"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"
}
}
定義
名稱 | Description |
---|---|
EAPrice |
EA 價位表的屬性。 |
Error |
錯誤的詳細數據。 |
Error |
錯誤回應表示服務無法處理傳入要求。 錯誤訊息中會提供原因。 某些錯誤回應:
|
Operation |
長時間執行作業的狀態。 |
Operation |
長時間執行作業的狀態。 |
EAPriceSheetProperties
EA 價位表的屬性。
名稱 | 類型 | Description |
---|---|---|
basePrice |
string |
當客戶登入時或服務計量 GA 啟動時的單價,如果登入之後,則為單價。 這適用於 Enterprise 合約使用者 |
currencyCode |
string |
簽署 Enterprise 合約的貨幣 |
effectiveEndDate |
string |
價位表計費期間的有效結束日期 |
effectiveStartDate |
string |
價位表計費週期的有效開始日期 |
enrollmentNumber |
string |
EA 計費帳戶的唯一標識符。 |
includedQuantity |
string |
EA 客戶有權取用的特定服務數量,不需累加費用。 |
marketPrice |
string |
指定產品或服務的目前清單價格。 此價格不含任何交涉,且以您的 Microsoft 合約類型為基礎。 針對 PriceType 使用量,市場價格會反映為隨用隨付價格。 針對 PriceType 節省方案,市場價格會反映相對應承諾用量期間隨用隨付價格的節省方案權益。 針對 PriceType ReservedInstance,市場價格會反映 1 或 3 年承諾用量的總價格。 注意:對於沒有交涉的EA客戶,市場價格可能會四捨五入為與單價不同的十進位有效位數。 |
meterCategory |
string |
計量的分類類別名稱。 例如,雲端服務、網路等等。 |
meterId |
string |
計量的唯一標識碼 |
meterName |
string |
計量的名稱。 計量代表 Azure 服務的可部署資源。 |
meterRegion |
string |
服務計量可供使用之 Azure 區域的名稱。 |
meterSubCategory |
string |
計量的子分類類別名稱。 |
meterType |
string |
計量類型的名稱 |
partNumber |
string |
與計量相關聯的元件編號 |
priceType |
string |
產品的價格類型。 例如,具有隨用隨付率的 Azure 資源,其 priceType 為耗用量。 其他價格類型包括 ReservedInstance 和 Savings 方案。 |
product |
string |
產生費用的產品名稱。 |
productId |
string |
已耗用計量之產品的唯一識別碼。 |
serviceFamily |
number |
Azure 服務的類型。 例如,計算、分析和安全性。 |
skuId |
string |
SKU 的唯一標識碼 |
term |
string |
Azure 節省方案或保留期限的期限 - P1Y 或 P3Y (一年或三年) |
unitOfMeasure |
string |
如何測量服務的使用量 |
unitPrice |
string |
指定產品或服務的計費時,包含任何交涉折扣,以市場價格為依據的每個單價。 針對 PriceType ReservedInstance,單價會反映 1 或 3 年承諾用量的總成本,包括折扣。 注意:當服務在各層之間具有差異價格時,使用量詳細數據下載的有效價格與單價不同。 如果服務具有多層式定價,則有效價格是各層的混合費率,而且不會顯示階層特定的單價。 混合價格或有效價格是跨多層之取用數量的淨價格 (每一層都有特定的單位價格)。 |
ErrorDetails
錯誤的詳細數據。
名稱 | 類型 | Description |
---|---|---|
code |
string |
錯誤碼。 |
message |
string |
錯誤訊息,指出作業失敗的原因。 |
ErrorResponse
錯誤回應表示服務無法處理傳入要求。 錯誤訊息中會提供原因。
某些錯誤回應:
429 TooManyRequests - 要求已節流。 等候 「x-ms-ratelimit-microsoft.consumption-retry-after」 標頭中指定的時間後重試。
503 ServiceUnavailable - 服務暫時無法使用。 請在等候「Retry-After」標頭中指定的時間之後重試。
名稱 | 類型 | Description |
---|---|---|
error |
錯誤的詳細數據。 |
OperationStatus
長時間執行作業的狀態。
名稱 | 類型 | Description |
---|---|---|
properties.downloadFileProperties |
已下載檔案中的屬性 |
|
properties.downloadUrl |
string |
要下載價位表的連結 (url) 。 |
properties.validTill |
string |
下載連結有效性。 |
status |
長時間執行作業的狀態。 |
OperationStatusType
長時間執行作業的狀態。
名稱 | 類型 | Description |
---|---|---|
Completed |
string |
|
Failed |
string |
|
Running |
string |