你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Price Sheet - Download By Billing Account

参考

服务:: Cost Management

API 版本:: 2024-08-01

根据注册 ID 异步生成提供的计费周期的价目表。这适用于企业协议客户。

迁移到版本 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-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 参数

名称在必需类型说明

名称	在	必需	类型	说明
billingAccountId	path	True	string	BillingAccount ID
billingPeriodName	path	True	string	计费周期名称。正则表达式模式: `^[0-9]*$`
api-version	query	True	string	用于此操作的 API 版本。

billingAccountId

path

True

string

BillingAccount ID

billingPeriodName

path

True

string

计费周期名称。

正则表达式模式: ^[0-9]*$

api-version

query

True

string

用于此操作的 API 版本。

响应

名称	类型	说明
200 OK	OperationStatus	还行。请求已成功。
202 Accepted		接受。标头 Location: string Retry-After: string
Other Status Codes	ErrorResponse	描述操作失败的原因的错误响应。

名称

类型

说明

200 OK

OperationStatus

还行。请求已成功。

202 Accepted

接受。

标头

Location: string
Retry-After: string

Other Status Codes

ErrorResponse

描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
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"
  }
}

定义

名称	说明
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 支持的属性如下所示

名称	类型	说明
basePrice	string	客户登录时的单价或服务计量 GA 启动时的单价（如果登录后）。这适用于企业协议用户
currencyCode	string	签署企业协议的货币
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 Plan。
product	string	产生费用的产品的名称。
productId	string	使用计量的产品的唯一标识符。
serviceFamily	number	Azure 服务的类型。例如，计算、分析和安全性。
skuId	string	SKU 的唯一标识符
term	string	Azure 储蓄计划或预留期限的期限 - 一年或三年（P1Y 或 P3Y）
unitOfMeasure	string	如何测量服务的使用情况。注意：字段“Unit”已删除版本 2023-11-01 作为“UnitofMeasure”的副本，请使用字段“UnitOfMeasure”。
unitPrice	string	给定产品或服务计费时的按单价，包括基于市场价格的任何协商折扣。对于 PriceType ReservedInstance，单价反映包括折扣在内的 1 年或 3 年承诺的总成本。注意：当服务跨层具有差异价格时，使用详细信息下载的有效价格与单价不同。如果服务具有多层定价，则有效价格是各层之间的混合费率，并且不显示特定于层的单价。混合价格或有效价格是跨多个层（其中每个层具有特定单价）的消耗量的净价格。

ErrorDetails

错误的详细信息。

名称	类型	说明
code	string	错误代码。
message	string	指示操作失败的原因的错误消息。

ErrorResponse

错误响应指示服务无法处理传入请求。错误消息中提供了原因。

一些错误响应：

429 TooManyRequests - 请求受到限制。等待“x-ms-ratelimit-microsoft.consumption-retry-after”标头中指定的时间后重试。
503 ServiceUnavailable - 服务暂时不可用。在等待“Retry-After”标头中指定的时间后重试。

名称	类型	说明
error	ErrorDetails	错误的详细信息。

OperationStatus

长时间运行的操作的状态。

名称	类型	说明
properties.downloadFileProperties	EAPriceSheetProperties	下载文件中的属性
properties.downloadUrl	string	用于下载价目表的链接（url）。
properties.validTill	string	下载链接有效性。
status	OperationStatusType	长时间运行的操作的状态。

OperationStatusType

长时间运行的操作的状态。

名称	类型	说明
Completed	string
Failed	string
Running	string

通过

Price Sheet - Download By Billing Account

URI 参数

响应

安全性

azure_auth

作用域

示例

EAPriceSheetForBillingPeriod

示例请求

示例响应

定义

EAPriceSheetProperties

ErrorDetails

ErrorResponse

OperationStatus

OperationStatusType

其他资源