Migrate from Azure Enterprise Reporting to Microsoft Cost Management APIs overview
This article informs developers that have built custom solutions using the Azure Enterprise Reporting APIs about important changes. The newer Microsoft Cost Management APIs now offer enhanced capabilities and support for service principals, making them a more robust choice for your projects.
Key points:
- Migration recommended - We strongly recommend that you consider migrating your custom solutions to the Microsoft Cost Management APIs. They're actively being developed and offer improved functionality.
- Retirement date - All Azure Enterprise Reporting APIs are retired.
This article provides:
- An overview of the differences between Azure Enterprise Reporting APIs and Cost Management APIs.
- Guidance about what to expect when migrating to the Cost Management APIs.
- Insight into the new capabilities available with the Cost Management APIs.
Call to action:
- To ensure a smooth transition, we encourage you to begin planning your migration to the Cost Management APIs well in advance of the retirement date.
API differences
The following information describes the differences between the older Azure Enterprise Reporting APIs and the newer Cost Management APIs.
Use | Azure Enterprise Reporting APIs | Microsoft Cost Management APIs |
---|---|---|
Authentication | API key provisioned in the Azure portal | Microsoft Entra authentication using user tokens or service principals. Service principals take the place of API keys. |
Scopes and permissions | All requests are at the enrollment scope. API Key permission assignments will determine whether data for the entire enrollment, a department, or a specific account is returned. No user authentication. | Users or service principals are assigned access to the enrollment, department, or account scope. |
URI Endpoint | https://consumption.azure.com |
https://management.chinacloudapi.cn |
Development status | None, the APIs are retired. | In active development |
Available APIs | Limited to what's currently available | Equivalent APIs are available to replace each EA API. Additional Cost Management APIs are also available, including: - Budgets - Alerts - Exports |
Migration checklist
- Familiarize yourself with the Azure Resource Manager REST APIs.
- Determine which Enterprise Reporting APIs you use and see which Cost Management APIs to move to at Migrate from Azure Enterprise Reporting to Microsoft Cost Management APIs.
- Configure service authorization and authentication for the Cost Management APIs. For more information, see Assign permission to ACM APIs.
- Test the APIs and then update any programming code to replace Enterprise Reporting API calls with Cost Management API calls.
- Update error handling to use new error codes. Some considerations include:
- Cost Management APIs have a timeout period of 60 seconds.
- Cost Management APIs have rate limiting in place. This results in a
429 throttling error
if rates are exceeded. Build your solutions so that you don't make too many API calls in a short time period.
- Review the other Cost Management APIs available through Azure Resource Manager and assess for use later. For more information, see Migrate from Azure Enterprise Reporting to Microsoft Cost Management APIs.
Enterprise Reporting API mapping to new Cost Management APIs
Use the following information to identify the Enterprise Reporting APIs that you currently use and the replacement Cost Management API to use instead.
Use additional Cost Management APIs
After you've migrated to the Cost Management APIs for your existing reporting scenarios, you can use many other APIs, too. The APIs are also available through Azure Resource Manager and can be automated using service principal-based authentication. Here's a quick summary of the new capabilities that you can use.
- Budgets - Use to set thresholds to proactively monitor your costs, alert relevant stakeholders, and automate actions in response to threshold breaches.
- Alerts - Use to view alert information including, but not limited to, budget alerts, invoice alerts, credit alerts, and quota alerts.
- Exports - Use to schedule recurring data export of your charges to an Azure Storage account of your choice. It's the recommended solution for customers with a large Azure presence who want to analyze their data and use it in their own internal systems.
Related content
- Familiarize yourself with the Azure Resource Manager REST APIs.
- If needed, determine which Enterprise Reporting APIs you use and see which Cost Management APIs to move to at Migrate from Azure Enterprise Reporting to Microsoft Cost Management APIs.
- If you're not already using Azure Resource Manager APIs, register your client app with Microsoft Entra ID.
- If needed, update any of your programming code to use Microsoft Entra authentication with your service principal.