Azure DevOps built-in role

Chaos Studio Operator

Reads Chaos Studio resources and starts, cancels, and retrieves execution details for existing experiments. The role uses control-plane Actions and has no DataActions; it cannot create experiments or manage targets and capabilities.

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: 1a40e87e-6645-48e0-b27a-0b115d849a20

Control-plane actions (10)

Data-plane actions (0)

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

Excluded actions (0)

None

Assignable scopes (1)

Practical scope

Assign on the individual experiment or the resource group containing the approved experiments. A broader assignment is inherited by every Chaos Studio experiment below it, but does not replace the separate target-resource permissions required by each experiment managed identity.

Common use cases (2)

Prerequisites (2)

Best practices (3)

Security considerations (3)

Assignment guidance

Assign Chaos Studio Operator directly on an approved experiment or its dedicated resource group to the team that executes resilience tests. Keep experiment creation and target onboarding with separate principals, and grant target permissions only to the experiment managed identity.

Related roles (2)

Common questions

When should I assign the Chaos Studio Operator Azure role?

Assign Chaos Studio Operator when you need to: Run and stop preapproved chaos experiments during a controlled resilience exercise.; and Inspect execution status and per-action errors without changing experiment definitions or target onboarding.. Practical scope: Assign on the individual experiment or the resource group containing the approved experiments. A broader assignment is inherited by every Chaos Studio experiment below it, but does not replace the separate target-resource permissions required by each experiment managed identity.

What permissions does the Chaos Studio Operator Azure role grant?

The role definition grants 10 combined control-plane and data-plane actions. Representative operations include: Microsoft.Chaos/*/read; Microsoft.Chaos/experiments/start/action; Microsoft.Chaos/experiments/cancel/action; Microsoft.Chaos/experiments/executions/getExecutionDetails/action; Microsoft.Chaos/locations/operationResults/read; and Microsoft.Chaos/locations/operationStatuses/read. Review the permission sections above for the complete definition and exclusions.

What are the security risks of the Chaos Studio Operator Azure role?

Key considerations when assigning Chaos Studio Operator: The experiment start Action triggers fault injection and can disrupt services even though the role cannot edit the experiment.; Cancel authority can stop an active exercise, while execution details can expose operational status and fault errors.; and An assignment at resource-group or subscription scope permits the principal to start every inherited Chaos Studio experiment.. Follow the assignment guidance above and use the narrowest practical scope.

Editorial sources (6)

Official Microsoft Learn documentation →