分享方式：

從 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 取代每個 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，且想要分析其資料並在自己的內部系統中使用的客戶。

相關內容