Price Sheet - Download By Billing Profile

參考

服務:: Cost Management

API 版本:: 2024-08-01

取得 URL，以下載帳單配置檔的當月價位表。合約類型Microsoft合作夥伴合約或Microsoft客戶合約的計費帳戶支援此作業。

您可以在 2023 年 1 月以後的計費期間使用新的 2023-09-01 API 版本。 Azure 保留實例（RI）定價僅適用於新版本的 API。

由於 Azure 產品成長，此預覽版本中的 Azure 價位錶下載體驗將從單一 csv/json 檔案更新為包含多個 csv/json 檔案的 Zip 檔案，每個檔案的大小上限為 75MB。

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

URI 參數

名稱位於必要類型 Description

billingAccountName

path

True

string

可唯一識別計費帳戶的標識碼。

Regex 模式: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+):([A-Za-z0-9]+(-[A-Za-z0-9]+)+)_[0-9]{4}-[0-9]{2}-[0-9]{2}

billingProfileName

path

True

string

可唯一識別帳單配置檔的標識碼。

Regex 模式: ([A-Za-z0-9]+(-[A-Za-z0-9]+)+)

api-version

query

True

string

要用於這項作業的 API 版本。

回應

名稱

類型

Description

200 OK

PricesheetDownloadProperties

還行。要求已成功。

202 Accepted

接受。

標題

Location: string
Retry-After: string
OData-EntityId: string

Other Status Codes

描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

PricesheetDownloadByBillingProfile

範例要求

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

範例回覆

狀態碼:: 202

Location: https://management.azure.com:443/providers/Microsoft.Billing/billingAccounts/7c05a543-80ff-571e-9f98-1063b3b53cf2:99ad03ad-2d1b-4889-a452-090ad407d25f_2019-05-31/billingProfiles/2USN-TPCD-BG7-TGB/providers/Microsoft.CostManagement/operationResults/45000000-0000-0000-0000-000000000000?sessiontoken=0:000000&api-version=2024-08-01&OperationType=PriceSheet
Retry-After: 60
OData-EntityId: 45000000-0000-0000-0000-000000000000

狀態碼:: 200

{
  "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",
  "expiryTime": "2018-07-21T17:32:28Z"
}

定義

名稱	Description
ErrorDetails	錯誤的詳細數據。
ErrorResponse	錯誤回應表示服務無法處理傳入要求。錯誤訊息中會提供原因。某些錯誤回應： 429 TooManyRequests - 要求已節流。等候「x-ms-ratelimit-microsoft.consumption-retry-after」標頭中指定的時間後重試。 503 ServiceUnavailable - 服務暫時無法使用。等候「Retry-After」標頭中指定的時間後重試。
MCAPriceSheetProperties	價位表的屬性。
PricesheetDownloadProperties	要下載所產生報表的 URL。

ErrorDetails

錯誤的詳細數據。

名稱	類型	Description
code	string	錯誤碼。
message	string	錯誤訊息，指出作業失敗的原因。

ErrorResponse

錯誤回應表示服務無法處理傳入要求。錯誤訊息中會提供原因。

某些錯誤回應：

429 TooManyRequests - 要求已節流。等候「x-ms-ratelimit-microsoft.consumption-retry-after」標頭中指定的時間後重試。
503 ServiceUnavailable - 服務暫時無法使用。等候「Retry-After」標頭中指定的時間後重試。

名稱	類型	Description
error	ErrorDetails	錯誤的詳細數據。

MCAPriceSheetProperties

價位表的屬性。

名稱	類型	Description
basePrice	string	客戶登入時或服務計量 GA 啟動時的單價，如果是登入之後，則為單價。這適用於 Enterprise 合約使用者
billingAccountID	string	計費帳戶的唯一標識碼。
billingAccountName	string	設定為接收發票的帳單配置檔名稱。價位表中的價格會與此賬單配置文件相關聯。
billingCurrency	string	張貼費用的貨幣。
billingProfileId	string	帳單配置檔的唯一標識符。
billingProfileName	string	設定為接收發票的帳單配置檔名稱。價位表中的價格會與此賬單配置文件相關聯。
currency	string	反映所有價格的貨幣。
effectiveEndDate	string	價位表計費週期的有效結束日期
effectiveStartDate	string	價位表計費週期的有效開始日期
marketPrice	string	指定產品或服務的目前清單價格。此價格沒有任何談判，且以您的Microsoft合約類型為基礎。針對 PriceType 使用量，市場價格會反映為隨用隨付價格。對於 PriceType 儲蓄方案，市場價格會反映相應承諾期限的隨用隨付價格之上的儲蓄方案權益。對於 PriceType ReservedInstance，市場價格會反映 1 或 3 年承諾用量的總價格。
meterCategory	string	計量分類類別的名稱。例如，雲端服務、網路等。
meterName	string	計量的名稱。計量代表 Azure 服務的可部署資源。
meterRegion	string	服務計量可供使用之 Azure 區域的名稱。
meterSubCategory	string	計量子分類類別目錄的名稱。
meterType	string	計量類型的名稱
priceType	string	產品的價格類型。例如，具有隨用隨付率的 Azure 資源，其 priceType 為使用量。其他價格類型包括 ReservedInstance 和 Savings 方案。
product	string	產生費用的產品名稱。
productId	string	取用計量之產品的唯一標識符。
productOrderName	string	已購買產品方案的名稱。指出此定價是否為標準 Azure 方案定價、開發/測試定價等。 Azure 第三方和 ReservedInstance 計量目前無法使用。
serviceFamily	number	Azure 服務的類型。例如，計算、分析和安全性。
skuId	string	SKU 的唯一標識碼
term	string	Azure 儲蓄方案或保留期限的期限長度 – 一年或三年（P1Y 或 P3Y）
tierMinimumUnits	string	定義定義價格的階層範圍的下限。例如，如果範圍是 0 到 100，tierMinimumUnits 會是 0。
unitOfMeasure	string	如何測量服務的使用量
unitPrice	string	指定產品或服務計費時的每一單價，包括以市場價格為基礎的任何談判折扣。對於 PriceType ReservedInstance，單價會反映 1 或 3 年承諾用量的總成本，包括折扣。注意：當服務在各層都有差異價格時，使用量詳細數據下載的有效價格與單價不同。如果服務具有多層式定價，則有效價格是各層的混合費率，而且不會顯示階層特定的單價。混合價格或有效價格是跨越多層的已取用數量的凈價格（其中每一層都有特定的單價）。

PricesheetDownloadProperties

要下載所產生報表的 URL。

名稱	類型	Description
downloadFileProperties	MCAPriceSheetProperties	已下載檔案中的屬性
downloadUrl	string	要下載所產生報表的 URL。
expiryTime	string	報表 URL 在 UTC 中變成無效/到期的時間，例如 2020-12-08T05：55：59.4394737Z。