Azure enterprise customers today manage their subscriptions on the EA portal and use the EA hierarchy to group and report on usage and costs by subscription. Until today, the only APIs available for the enterprise hierarchy was the key based APIs, this month we are releasing ARM supported APIs for the enrollment hierarchy. This will enable users with the required privileges to make API calls to the individual nodes in the management hierarchy and get the most current cost and usage information.
The benefits of this API is an improved security posture, seamless onboarding to the cost APIs and benefiting from the continued investment in planned work on the APM APIs, like budgets. Departments today support rudimentary spending limits, but in the coming weeks we will be supporting budgets, that were recently announced for subscriptions and resource groups on EA hierarchy nodes as well. The ARM APIs also standardize the pattern and enable AD based authentication.
Hierarchy Updates
As part of this release the ARM API introduces a few new terms:
- Enrollments in the ARM APIs are Billing Accounts
- Departments continue on as Departments
- Accounts in the ARM APIs are referred to as Enrollment Accounts
This release of ARM APIs above the subscription scope supports all currently supported functions of usage details, monetary balances, marketplace charges and price sheet. The price sheet API also supports calls at a subscription grain to get the specific prices for that subscription based on the offer type. Each of these calls by default apply to the current (open period), with the option to call the API for specific billing period in the past. Here’s the detailed list of operations and scopes with links to the documentation:
|
Billing Account (Enrollment) |
Department |
Enrollment Account (Account) |
|
|
Usage Details |
|||
|
Monetary Balance |
N/A |
N/A |
|
|
Market place Charges |
|||
|
Price sheets |
|
|
|
|
Budgets |
Planned |
Planned |
Planned |