Azure Internet of Things built-in role

Azure IoT Operations Administrator

Creates, changes, and deletes Azure IoT Operations instances and downstream Azure IoT Operations and Azure Device Registry assets. The role uses Azure control-plane Actions and has no DataActions; dependency services such as Key Vault, Storage, and Arc have separate authorization.

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: 5bc02df6-6cd5-43fe-ad3d-4c93cf56cc16

Control-plane actions (13)

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 resource group containing the Azure IoT Operations instance and its downstream resources. A subscription assignment extends administration to every inherited instance and is broader than the documented deployment boundary.

Common use cases (2)

Prerequisites (2)

Best practices (2)

Security considerations (2)

Assignment guidance

Assign Azure IoT Operations Administrator on the deployment resource group to the operations team that must manage the instance and downstream assets. Grant dependency roles only for verified tasks and use Onboarding only for the initial Arc and deployment workflow.

Related roles (1)

Common questions

When should I assign the Azure IoT Operations Administrator Azure role?

Assign Azure IoT Operations Administrator when you need to: Administer an existing Azure IoT Operations instance, assets, asset endpoint profiles, discovered assets and devices, schemas, and downstream resources.; and Give an operations team broad Azure-side management after onboarding is complete, without granting the onboarding role assignment capability.. Practical scope: Assign on the resource group containing the Azure IoT Operations instance and its downstream resources. A subscription assignment extends administration to every inherited instance and is broader than the documented deployment boundary.

What permissions does the Azure IoT Operations Administrator Azure role grant?

The role definition grants 13 combined control-plane and data-plane actions. Representative operations include: Microsoft.IoTOperations/*; Microsoft.Authorization/*/read; Microsoft.DeviceRegistry/Assets/*; Microsoft.DeviceRegistry/AssetEndpointProfiles/*; Microsoft.DeviceRegistry/Namespaces/Assets/*; and Microsoft.DeviceRegistry/Namespaces/Devices/*. Review the permission sections above for the complete definition and exclusions.

What are the security risks of the Azure IoT Operations Administrator Azure role?

Key considerations when assigning Azure IoT Operations Administrator: The role can create, edit, and delete the IoT Operations instance and downstream Device Registry assets but does not include roleAssignments/write.; and Adding broad dependency roles can expand access to secrets, storage, Kubernetes extensions, and managed identities beyond this role definition.. Follow the assignment guidance above and use the narrowest practical scope.

Editorial sources (7)

Official Microsoft Learn documentation →