Add the Billing Profile Reader role to the Microsoft Azure service principal

  • Release version: Yokohama
  • Updated June 2, 2025
  • 1 minute to read

    • Assign the Billing Profile Reader role to the Azure service principal for your Microsoft Customer Agreement (MCA) account to download Azure price sheet data.

    Before you begin

    Role required: Azure Cloud admin

    About this task

    The Billing Profile Reader role provides the required permissions to download price sheet data at the profile scope only for MCA accounts. For more information on Azure roles, see Microsoft documentation.

    Important:
    The support for MCA accounts is available from Cloud Cost Management version 9.0 and later.

    Procedure

    1. Log in to the Azure portal and search for Cost Management + Billing.
    2. Select Billing scopes.
    3. Select Access Control (IAM) at the billing profile scope to which you’re assigning the billing profile reader role.
    4. Select +Add.
    5. In the Add role assignment window, select Billing profile reader in the Role field.
    6. In the Users, groups, or apps field, select the service principal to which you’re assigning the role.
    7. Complete the role assignment for the Azure MCA account by selecting Add.

    What to do next

    Schedule and manage the jobs that download Azure billing data