Azure Management and governance built-in role

Blueprint Operator

Assigns existing published Azure Blueprint versions and manages blueprint assignments without creating blueprint definitions. Microsoft states that this built-in role works only when the blueprint assignment uses a user-assigned managed identity.

Role-definition permissions are imported from Microsoft Learn. Practical scope, use cases, prerequisites, best practices, security considerations, assignment guidance, and relationships have been reviewed against the official sources below.

Role definition ID: 437d2ced-4a38-4302-8479-ed2bcb43d090

Control-plane actions (5)

Data-plane actions (0)

None — this role grants no data-plane (data access) actions.

Excluded actions (0)

None

Assignable scopes (1)

Practical scope

Assign at the target management group or subscription where published blueprints may be assigned. Assignment effects flow to resources within that target hierarchy, while the user-assigned managed identity receives the permissions needed to deploy assignment artifacts.

Common use cases (2)

Prerequisites (2)

Best practices (2)

Security considerations (2)

Assignment guidance

Assign to the deployment-governance operator at the exact management group or subscription receiving existing published blueprints. Require a user-assigned managed identity, review its permissions separately, and keep authoring on Blueprint Contributor.

Related roles (2)

Common questions

When should I assign the Blueprint Operator Azure role?

Assign Blueprint Operator when you need to: Create or update assignments of an approved published blueprint version to a management group or subscription.; and Operate existing blueprint assignment lifecycle while definition authoring remains with a separate governance team.. Practical scope: Assign at the target management group or subscription where published blueprints may be assigned. Assignment effects flow to resources within that target hierarchy, while the user-assigned managed identity receives the permissions needed to deploy assignment artifacts.

What permissions does the Blueprint Operator Azure role grant?

The role definition grants 5 combined control-plane and data-plane actions. Representative operations include: Microsoft.Authorization/*/read; Microsoft.Blueprint/blueprintAssignments/*; Microsoft.Resources/subscriptions/resourceGroups/read; Microsoft.Resources/deployments/*; and Microsoft.Support/*. Review the permission sections above for the complete definition and exclusions.

What are the security risks of the Blueprint Operator Azure role?

Key considerations when assigning Blueprint Operator: A blueprint assignment can deploy resources, policies, role assignments, and locks through its managed identity across the target scope.; and The operator cannot author definitions, but choosing a version, parameters, target scope, and identity can materially change the environment.. Follow the assignment guidance above and use the narrowest practical scope.

Editorial sources (6)

Official Microsoft Learn documentation →