從 Azure 企業版報告移轉至 Microsoft 成本管理 API 概觀
本文旨在向使用 Azure 企業版報告 API 建置自訂解決方案的開發人員通報重大變更。 較新的 Microsoft 成本管理 API 現在提供增強的功能以及對服務主體支援，因此對您的專案而言將是更可靠的選擇。
重點︰
- 建議移轉 - 強烈建議您考慮將自訂解決方案移轉至 Microsoft 成本管理 API。 此 API 正積極開發中，並提供改良的功能。
- 停用日期 - 所有 Azure 企業版報告 API 都已淘汰。
本文提供：
- 概述 Azure 企業版報告 API 與成本管理 API 之間的差異。
- 指引在移轉至成本管理 API 時應有的預期。
- 深入了解成本管理 API 所提供的新功能。
行動呼籲：
- 為確保能順利轉換，建議您在淘汰日期之前及早規劃移轉至成本管理 API 的工作。
API 差異
下列資訊說明舊版 Azure 企業版報告 API 與較新的成本管理 API 之間的差異。
| 使用 | Azure 企業版報告 API | Microsoft 成本管理 API |
|---|---|---|
| 驗證 | 在 Azure 入口網站中佈建的 API 金鑰 | 使用使用者權杖或服務主體的 Microsoft Entra 驗證。 服務主體會取代 API 金鑰。 |
| 範圍和權限 | 所有要求都在註冊範圍。 API 金鑰權限指派會決定是否傳回整個註冊、部門或特定帳戶的資料。 無需使用者驗證。 | 系統會將註冊、部門或帳戶範圍的存取權指派給使用者或服務主體。 |
| URI 端點 | https://consumption.azure.com |
https://management.azure.com |
| 開發狀態 | 無，API 已淘汰。 | 在開發期間 |
| 可用的 API | 限制為目前可用的項目 | 可以使用對等 API 取代每個 EA API。 也可以使用其他成本管理 API，包括： - 預算 - 警示 - 匯出 |
移轉檢查清單
- 熟悉 Azure Resource Manager REST API。
- 判斷您使用的是哪一個企業報告 API，並在從 Azure 企業報告移轉至 Microsoft 成本管理 API 中查看要移動哪一個成本管理 API。
- 設定成本管理 API 的服務授權和驗證。 如需詳細資訊，請參閱將權限指派給 ACM API。
- 測試 API，然後更新所有程式設計程式碼，以成本管理 API 呼叫來取代企業版報告 API 呼叫。
- 將錯誤處理機制更新為使用新的錯誤碼。 考量項目包括：
- 成本管理 API 的逾時時間為 60 秒。
- 成本管理 API 已有速率限制。 如果超出速率，這會導致
429 throttling error。 建置解決方案，讓您在短時間內不會進行過多的 API 呼叫。
- 檢閱其他透過 Azure Resource Manager 提供的成本管理 API，並評估稍後使用。 如需詳細資訊，請參閱從 Azure 企業報告移轉至 Microsoft 成本管理 API。
企業版報告 API 對應至新的成本管理 API
請使用下列資訊來識別您目前使用的企業版報告 API，以及要改用的成本管理 API。
| 案例 | 企業版報告 API | 成本管理 API |
|---|---|---|
| 從 EA 使用量詳細資料 API 移轉 | /usagedetails/download /usagedetails/submit /usagedetails /usagedetailsbycustomdate |
針對所有週期性資料擷取工作負載使用 Microsoft.CostManagement/Exports。 針對小型隨選資料集使用成本詳細資料報告。 |
| 從 EA 餘額摘要 API 移轉 | /balancesummary | Microsoft.Consumption/balances |
| 從 EA 價位表 API 移轉 | /pricesheet | 如需談判價格，請使用 Microsoft.Consumption/pricesheets/default 如需零售價格，請使用零售價格 API |
| 從 EA 保留執行個體使用量詳細資料 API 移轉 | /reservationdetails | Microsoft.CostManagement/generateReservationDetailsReport |
| 從 EA 保留執行個體使用量摘要 API 移轉 | /reservationsummaries | Microsoft.Consumption/reservationSummaries |
| 從 EA 保留的執行個體建議 API 移轉 | /SharedReservationRecommendations /SingleReservationRecommendations |
Microsoft.Consumption/reservationRecommendations |
| 從 EA 保留執行個體費用 API 移轉 | /reservationcharges | Microsoft.Consumption/reservationTransactions |
使用額外的成本管理 API
遷移至現有報告案例的成本管理 API 後，您也可以使用許多其他 API。 您也可透過 Azure Resource Manager 取得 API，而且可以使用服務主體型驗證來自動化。 以下是您可以使用的新功能快速摘要。
- 預算 - 用來設定閾值，以主動監視您的成本、警示相關的利害關係人，以及將動作自動化以回應閾值違規。
- 警示 - 用來檢視警示資訊，包括 (但不限於) 預算警示、發票警示、信用額度警示和配額警示。
- 匯出 - 用來排程費用的週期資料並匯出至您選擇的 Azure 儲存體帳戶。 這是建議的解決方案，適用於大量使用 Azure，且想要分析其資料並在自己的內部系統中使用的客戶。
相關內容
- 熟悉 Azure Resource Manager REST API。
- 若有需要，請判斷您使用的是哪一個企業報告 API，並在從 Azure 企業報告移轉至 Microsoft 成本管理 API 中查看要移動哪一個成本管理 API。
- 如果您尚未使用 Azure Resource Manager API，請使用 Microsoft Entra ID 註冊您的用戶端應用程式。
- 如有需要，請更新所有程式設計程式碼，以對服務主體使用 Microsoft Entra 驗證。