你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
适用于企业客户的报告 API - 计费周期
注意
2024 年 5 月 1 日，Azure 企业报告 API 将停用。 任何剩余的企业报告 API 都将停止响应请求。 在此之前，客户需要过渡到使用 Microsoft 成本管理 API。 要了解详细信息，请参阅从 Azure 企业报告迁移到 Microsoft 成本管理 API 概述。
计费周期 API 会以倒序顺序为指定的注册返回具有消耗数据的计费周期列表。 每个周期都有一个属性指向以下四个数据集的 API 路由：BalanceSummary、UsageDetails、Marketplace Charge 和 PriceSheet。 如果周期没有数据，则对应的属性为 null。
请求
需要添加的常见标头属性在企业客户的报告 API 概述一文中指定。
| 方法 | 请求 URI |
|---|---|
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingperiods |
注意
若要使用以前版本的 API，请将 v2 替换为上述 URL 中的 v1。 如果使用 v2，则某些字段不可用。
响应
[
{
"billingPeriodId": "201704",
"billingStart": "2017-04-01T00:00:00Z",
"billingEnd": "2017-04-30T11:59:59Z",
"balanceSummary": "/v1/enrollments/100/billingperiods/201704/balancesummary",
"usageDetails": "/v1/enrollments/100/billingperiods/201704/usagedetails",
"marketplaceCharges": "/v1/enrollments/100/billingperiods/201704/marketplacecharges",
"priceSheet": "/v1/enrollments/100/billingperiods/201704/pricesheet"
},
....
]
响应属性定义
| 属性名称 | 类型 | 说明 |
|---|---|---|
| billingPeriodId | 字符串 | 表示特定计费周期的唯一 ID |
| billingStart | datetime | 表示周期开始日期的 ISO 8601 字符串 |
| billingEnd | datetime | 表示周期结束日期的 ISO 8601 字符串 |
| balanceSummary | 字符串 | 路由到此周期的“余额摘要”数据的 URL 路径 |
| usageDetails | 字符串 | 路由到此周期的“使用情况详细信息”数据的 URL 路径 |
| marketplaceCharges | 字符串 | 路由到此周期的“市场费用”数据的 URL 路径 |
| priceSheet | 字符串 | 路由到此周期的“价目表”数据的 URL 路径 |