適用於企業客戶的報告 API - 餘額與摘要
注意
在 2024 年 5 月 1 日，Azure 企業報告 API 將會淘汰。 任何剩餘的企業報告 API 都會停止回應要求。 客戶需要先轉換至使用 Microsoft 成本管理 API。 若要深入了解，請參閱從 Azure 企業版報告移轉至 Microsoft 成本管理 API 概觀。
餘額與摘要 API 可提供餘額、新購買、Azure Marketplace 服務費用、調整及超額部分費用的每月摘要資訊。
要求
需要新增的一般標頭屬性，指定於適用於企業客戶的報告 API 概觀中。 如果未指定計費週期，則會傳回目前計費周期的數據。
| 方法 | 要求 URI |
|---|---|
| GET | https://consumption.azure.com/v3/enrollments/{enrollmentNumber}/balancesummary |
| GET | https://consumption.azure.com/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/balancesummary |
注意
若要使用舊版的 API，請將 v3 取代為上述 URL 中的 v2。 如果您使用 v2，則無法使用某些欄位。
回應
{
"id": "enrollments/100/billingperiods/201507/balancesummaries",
"billingPeriodId": 201507,
"currencyCode": "USD",
"beginningBalance": 0,
"endingBalance": 1.1,
"newPurchases": 1,
"adjustments": 1.1,
"utilized": 1.1,
"serviceOverage": 1,
"chargesBilledSeparately": 1,
"totalOverage": 1,
"totalUsage": 1.1,
"azureMarketplaceServiceCharges": 1,
"newPurchasesDetails": [
{
"name": "",
"value": 1
}
],
"adjustmentDetails": [
{
"name": "Promo Credit",
"value": 1.1
},
{
"name": "SIE Credit",
"value": 1.0
}
]
}
回應屬性定義
| 屬性名稱 | 類型 | Description |
|---|---|---|
| id | 字串 | 特定計費週期和註冊的唯一識別碼 |
| billingPeriodId | 字串 | 計費週期識別碼 |
| currencyCode | 字串 | 貨幣代碼 |
| beginningBalance | decimal | 計費週期的開始餘額 |
| endingBalance | decimal | 計費週期的結算餘額 (此值在開放期間內會每天更新) |
| newPurchases | decimal | 新購買總數 |
| adjustments | decimal | 總調整量 |
| utilized | decimal | 總承諾用量 |
| serviceOverage | decimal | Azure 服務的超額部分 |
| chargesBilledSeparately | decimal | 另外計費的費用 |
| totalOverage | decimal | serviceOverage + chargesBilledSeparately |
| totalUsage | decimal | Azure 服務承諾用量 + 總超額部分 |
| azureMarketplaceServiceCharges | decimal | Azure Marketplace 的總費用 |
| newPurchasesDetails | 名稱值組的 JSON 字串陣列 | 新購買的清單 |
| adjustmentDetails | 名稱值組的 JSON 字串陣列 | 調整的清單 (促銷信用額度、SIE 信用額度等) |