Migrate to Azure Cost Management APIs
PreviousAssign Reader and Tag Contributor Roles (multiple subscriptions)NextAssign Azure Subscription Owner Rights
Last updated
Was this helpful?
Last updated
Was this helpful?
Microsoft will retire the legacy Azure Enterprise Reporting APIs on 1 May 2024. Currently, the Client Portal uses these APIs to get your Azure EA consumption data.
If you have an Azure Enterprise Agreement (EA), you must migrate to the new Azure Cost Management APIs to maintain your cost and usage data in the Client Portal.
Before migrating to the new Cost Management APIs, note the following points:
The new APIs don't require access tokens because the authorization is done through Microsoft Entra ID (also known as Azure Active Directory) using service principals.
Only individuals with the Azure EA Enterprise Administrator role permission can carry out the migration steps. If you have trouble finding out who is your EA admin in Azure, see Microsoft's documentation on .
During the consent flow, the SoftwareOne Cloud Consumption app is added to the organization tenant. This enterprise application is granted the EA Reader permission, which allows us to read the consumption data. To add the application to the tenant, you'll need permission to approve an Enterprise Application.
If your EA admin doesn't have access to the Client Portal, you can collaborate with them by sharing your screen, so your EA admin can sign in and complete the authorization required for migration.
During migration, our system automatically assigns the to the service principal.
If you've already onboarded your EA cloud account to the Client Portal and have appropriate permissions to approve Enterprise Applications, follow these steps to transition to the new API:
Open the page. EA cloud accounts that haven't been migrated will display EA API migration required in the Status column.
Select Migrate EA API.
In the Migrate to EA API window, enter the enrollment number and select Migrate.
Sign in to the Microsoft portal using the credentials of a user with Enterprise administrator permission.
On the consent page, review the permissions required by the Client Portal and select Accept to grant consent.
You'll be redirected to the Cloud Tenant Setup details page.
The system will mark the enrollment number you provided as migrated, and automatically assign the Enrollment reader permission to the SoftwareOne Cloud Consumption (formerly PyraCloud Azure) application. When the migration has been completed, the consumption data is fetched from Microsoft.
If you can't provide consent to approve enterprise applications or have environment restrictions, you can follow these steps to migrate and assign permissions manually:
In the Actions column, select Migrate EA API.
In the Migrate to EA API window, enter the enrollment number, then select Migrate without consent.
On the details page of the tenant, select the Enrollment Numbers tab and select Show manual steps.
In Manual steps, assign permissions using Cloud Shell or REST API and select Close. Note that you must have the Azure EA Enterprise Administrator role to assign permissions.
The Enrollment Numbers tab on the details page of the cloud tenant displays the enrollment numbers that are migrated to the new API, along with the respective enrollment status:
Connected - Indicates that the system is connected and working as expected.
Cannot connect - Indicates that the Client Portal doesn't have access to the new Azure Cost Management API and the EnrollmentReader permission is missing. You can assign permissions using the Azure Cost Management API or Azure Cloud Shell.
Activation required - Indicates that the Client Portal can access the enrollment data, but the cloud account has not been set up as an EA account type.
On the page, locate the required EA cloud account with the status EA API Migration required.
If you're adding a new EA cloud account to the Client Portal, you'll need to provide the enrollment number while adding the account. For information on how to add a new EA account, see .
