你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
适用于中国的 Azure 零售价格 API
此 API 提供未经身份验证的体验，可获取中国所有 Azure 服务的零售费率。 使用 API 了解不同区域和不同 SKU 中的 Azure 服务的价格。 该 API 还可以帮助你创建自己的工具，以便跨 SKU 和区域进行内部分析和价格比较。 本文中的信息涵盖仅适用于在中国使用的 Azure 零售价格 API 的信息。
通过 API 响应，你将获得一个 URL，用于下载 CSV 文件，其中包含中国所有 Azure 服务的零售费率。
本文档中显示的零售价格是示例。
API 终结点
https://prices.azure.cn/api/retail/pricesheet/download?api-version=2023-06-01-preview
URI 参数
| 名称 | 在 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
| api-version | query | True | 字符串 | 用于此操作的 API 版本 |
响应
| 名称 | 类型 | 说明 |
|---|---|---|
| 200 正常 | DownloadURL | 没问题。 请求已成功 |
| 其他状态代码 | ErrorResponse | 描述操作失败原因的错误响应 |
示例请求
https://prices.azure.cn/api/retail/pricesheet/download?api-version=2023-06-01-preview
示例响应
Status code: 200
{
"DownloadUrl": "https://upapisachinanorth3.blob.core.chinacloudapi.cn/retailpricesasync/2023060101/AzureRetailPrices.csv?<token>",
"LastRefreshedAt": "2023-06-02T04:19:45Z",
"ExpiryTime": ""2023-06-02T06:54:57.1059946Z"}"
}
定义
| 名称 | 说明 |
|---|---|
| DownloadURL | 用于下载生成的报表的 URL |
| ErrorDetails | 错误的详细信息 |
| ErrorResponse | 错误响应指示服务无法处理传入请求。 错误消息中提供了原因 |
DownloadURL
用于下载生成的报表的 URL。
| 名称 | 类型 | 说明 |
|---|---|---|
| DownloadUrl | 字符串 | 用于下载生成的报表的 URL |
| LastRefreshedAt | 字符串 | 以 UTC 格式刷新数据的时间。 例如，2023-06-02T04：19：45Z |
| expiryTime | 字符串 | 报表 URL 变为无效/过期的时间（UTC）。 例如，2023-06-02T06：54：57.1059946Z |
DownloadURL 用法
以下信息是来自 API 的示例响应。
{"DownloadUrl":"https://upapisachinanorth3.blob.core.chinacloudapi.cn/retailpricesasync/2023060101/AzureRetailPrices.csv?<token>","LastRefreshedAt":"2023-06-02T04:19:45Z","ExpiryTime":"2023-06-02T06:54:57.1059946Z"}
复制 URL 的引号内的内容，然后粘贴到浏览器地址中。 然后转到地址以开始 CSV 文件下载。 不要包含 LastRefreshedAt 或 ExpiryTime 字符串。 下面是一个示例。
https://upapisachinanorth3.blob.core.chinacloudapi.cn/retailpricesasync/2023060101/AzureRetailPrices.csv?<token>
AzureRetailPrices.csv开始下载文件。
ErrorDetails
错误的详细信息。
| 名称 | 类型 | 说明 |
|---|---|---|
| code | string | 错误代码 |
| message | string | 指示操作失败原因的错误消息 |
ErrorResponse
错误响应指示服务无法处理传入请求。 错误消息中提供了原因。
下面是一些错误响应：
-
429 TooManyRequests- 请求受到限制。 等待x-ms-ratelimit-microsoft.consumption-retry-after标头中指定的时间后重试。 -
503 ServiceUnavailable- 服务暂时不可用。 等待Retry-After标头中指定的时间后重试。
| 名称 | 类型 | 说明 |
|---|---|---|
| error | ErrorDetails | 错误的详细信息 |
下载的 CSV 文件中的属性详细信息
下面是下载的 CSV 文件中包含的所有属性详细信息。
显示的价格是示例。
| 字段 | 示例值 | 定义 |
|---|---|---|
| currencyCode | CNY | 定义费率并返回价格的货币。 在中国的服务始终是人民币 |
| tierMinimumUnits | 0 | 每个层的最小单位。 对于所有单位的统一定价的服务，该值始终为 0。 对于采用分层定价的服务，该值指示每个层的最小单位 |
| retailPrice | 0.869038 | Microsoft 服务的零售价格 |
| unitPrice | 0.869038 | Microsoft 服务的零售价格 |
| armRegionName | chinaeast2 | 服务可用的 Azure 资源管理器区域 |
| 位置 | CN 东部 2 | 部署资源的 Azure 数据中心 |
| effectiveStartDate | 2020-08-01T00：00：00Z | 显示零售价格生效的日期。 |
| meterId | f25b95bd-f9fa-5e85-a3e8-379259ae8dce | 资源的唯一标识符 |
| meterName | D2/DS2 | 计量的名称 |
| productid | DZH318Z0BPVW | 产品的 UniqueID |
| skuId | DZH318Z0BPVW/00F9 | SKU 的 UniqueID |
| productName | 虚拟机 D 系列 Windows | 产品名称 |
| skuName | D2 | SKU 名称 |
| serviceName | 虚拟机 | 服务名称 |
| serviceFamily | 计算 | SKU 的服务系列 |
| unitOfMeasure | 1 小时 | 如何衡量服务的使用情况 |
| type | 消耗 | 定价费率的类型。 支持的类型为 Reservation、 ConsumptionSavingsPlanConsumption 和 DevTestConsumption。 |
| armSkuName | Standard_F16s | 在 Azure 中注册的 SKU 名称 |
| 关键词 | 3 年 | 术语长度。 它适用于预留期限或承诺期限，以获取 SavingsPlan 费率 |
| isPrimaryMeterRegion | True | 指示是否将计量区域设置为主要计量。 主要计量用于费用和计费。 |
下载的 CSV 文件示例
下面是 CSV 文件中格式化为表后的数据的示例。
显示的价格是示例。
