Price Sheet - Download By Billing Account

參考

服務:: Cost Management

API 版本:: 2024-08-01

根據註冊標識碼，以異步方式產生所提供計費周期的價格表。這是針對 Enterprise 合約客戶。

移轉至 2024-08-01 版

您可以使用 2024-08-01 API 版本搭配新的 URI：

'/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download'

有了下面詳述的新架構，新版本的價位表會提供其他資訊，並包含目前計費期間 Azure 保留實例（RI）的價格。如果您要維持過去 Azure 保留實例（RI）定價的持續記錄，建議您在進入新的計費期間時下載 Azure 價位表。

EA Azure 價位表適用於過去 13 個月的計費期間。若要要求超過 13 個月的計費週期價位表，請連絡支持人員。

Azure 價位錶下載體驗已從單一 .csv 檔案更新為包含多個 .csv 檔案的 zip 檔案，每個檔案大小上限為 75MB。 2023-11-01 版本已升級為使用 HTTP POST 方法;您可以在下方找到詳細數據。

Microsoft.Consumption Azure 價位表的所有版本 - 依計費帳戶下載（包括 2022-06-01， 2021-10-01、2020-01-01-preview、2019-10-01、2019-05-01）已排定於 2026 年 6 月 1 日淘汰，在此日期之後將不再支援。

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

URI 參數

名稱位於必要類型 Description

名稱	位於	必要	類型	Description
billingAccountId	path	True	string	BillingAccount 識別符
billingPeriodName	path	True	string	計費期間名稱。 Regex 模式: `^[0-9]*$`
api-version	query	True	string	要用於這項作業的 API 版本。

billingAccountId

path

True

string

BillingAccount 識別符

billingPeriodName

path

True

string

計費期間名稱。

Regex 模式: ^[0-9]*$

api-version

query

True

string

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

回應

名稱	類型	Description
200 OK	OperationStatus	還行。要求已成功。
202 Accepted		接受。標題 Location: string Retry-After: string
Other Status Codes	ErrorResponse	描述作業失敗原因的錯誤回應。

名稱

類型

Description

200 OK

OperationStatus

還行。要求已成功。

202 Accepted

接受。

標題

Location: string
Retry-After: string

Other Status Codes

ErrorResponse

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

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

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

範圍

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

範例

EAPriceSheetForBillingPeriod

範例要求

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/billingPeriods/202311/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2024-08-01

範例回覆

狀態碼:: 202

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

狀態碼:: 200

{
  "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
EAPriceSheetProperties	EA 價位表的屬性。 2024-08-01 版支援的屬性如下所示
ErrorDetails	錯誤的詳細數據。
ErrorResponse	錯誤回應表示服務無法處理傳入要求。錯誤訊息中會提供原因。某些錯誤回應： 429 TooManyRequests - 要求已節流。等候「x-ms-ratelimit-microsoft.consumption-retry-after」標頭中指定的時間後重試。 503 ServiceUnavailable - 服務暫時無法使用。等候「Retry-After」標頭中指定的時間後重試。
OperationStatus	長時間執行作業的狀態。
OperationStatusType	長時間執行作業的狀態。

EAPriceSheetProperties

EA 價位表的屬性。 2024-08-01 版支援的屬性如下所示

名稱	類型	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	計量類型的名稱
offerId	string	決定與此計量相關聯的 Azure 供應專案。 [深入瞭解 Azure 供應專案]（https://azure.microsoft.com/en-us/support/legal/offer-details/）
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	如何測量服務的使用量。注意：2023-11-01 版已移除欄位 “UnitofMeasure”，請使用字段 “UnitOfMeasure”。
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	ErrorDetails	錯誤的詳細數據。

OperationStatus

長時間執行作業的狀態。

名稱	類型	Description
properties.downloadFileProperties	EAPriceSheetProperties	已下載檔案中的屬性
properties.downloadUrl	string	要下載價位表的連結（url）。
properties.validTill	string	下載連結有效性。
status	OperationStatusType	長時間執行作業的狀態。

OperationStatusType

長時間執行作業的狀態。

名稱	類型	Description
Completed	string
Failed	string
Running	string

共用方式為

Price Sheet - Download By Billing Account

URI 參數

回應

安全性

azure_auth

範圍

範例

EAPriceSheetForBillingPeriod

範例要求

範例回覆

定義

EAPriceSheetProperties

ErrorDetails

ErrorResponse

OperationStatus

OperationStatusType

其他資源