Price Sheet - Download By Billing Account

參考

服務:: Cost Management

API 版本:: 2023-11-01

根據註冊標識碼，以異步方式產生所提供計費周期的價位表。這適用於 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

名稱	位於	必要	類型	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=2023-11-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 價位表的屬性。
ErrorDetails	錯誤的詳細數據。
ErrorResponse	錯誤回應表示服務無法處理傳入要求。錯誤訊息中會提供原因。某些錯誤回應： 429 TooManyRequests - 要求已節流。等候「x-ms-ratelimit-microsoft.consumption-retry-after」標頭中指定的時間後重試。 503 ServiceUnavailable - 服務暫時無法使用。請在等候「Retry-After」標頭中指定的時間之後重試。
OperationStatus	長時間執行作業的狀態。
OperationStatusType	長時間執行作業的狀態。

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	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

其他資源