Azure Containers built-in role
Azure Kubernetes Service RBAC Writer
Azure Kubernetes Service RBAC Writer grants read and write access to most Kubernetes objects, excluding role and role-binding management on the AKS cluster. The effective workload authority is expressed as Kubernetes API DataActions under the Microsoft.ContainerService managed-cluster resource provider.
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: a7ffa36f-339b-4b5c-8bdf-e2c188b2c0eb
Control-plane actions (4)
Microsoft.Authorization/*/readMicrosoft.Resources/subscriptions/operationresults/readMicrosoft.Resources/subscriptions/readMicrosoft.Resources/subscriptions/resourceGroups/read
Data-plane actions (35)
Microsoft.ContainerService/managedClusters/apps/controllerrevisions/readMicrosoft.ContainerService/managedClusters/apps/daemonsets/*Microsoft.ContainerService/managedClusters/apps/deployments/*Microsoft.ContainerService/managedClusters/apps/replicasets/*Microsoft.ContainerService/managedClusters/apps/statefulsets/*Microsoft.ContainerService/managedClusters/autoscaling/horizontalpodautoscalers/*Microsoft.ContainerService/managedClusters/batch/cronjobs/*Microsoft.ContainerService/managedClusters/coordination.k8s.io/leases/readMicrosoft.ContainerService/managedClusters/coordination.k8s.io/leases/writeMicrosoft.ContainerService/managedClusters/coordination.k8s.io/leases/deleteMicrosoft.ContainerService/managedClusters/discovery.k8s.io/endpointslices/readMicrosoft.ContainerService/managedClusters/batch/jobs/*Microsoft.ContainerService/managedClusters/configmaps/*Microsoft.ContainerService/managedClusters/endpoints/*Microsoft.ContainerService/managedClusters/events.k8s.io/events/readMicrosoft.ContainerService/managedClusters/events/*Microsoft.ContainerService/managedClusters/extensions/daemonsets/*Microsoft.ContainerService/managedClusters/extensions/deployments/*Microsoft.ContainerService/managedClusters/extensions/ingresses/*Microsoft.ContainerService/managedClusters/extensions/networkpolicies/*Microsoft.ContainerService/managedClusters/extensions/replicasets/*Microsoft.ContainerService/managedClusters/limitranges/readMicrosoft.ContainerService/managedClusters/metrics.k8s.io/pods/readMicrosoft.ContainerService/managedClusters/metrics.k8s.io/nodes/readMicrosoft.ContainerService/managedClusters/namespaces/readMicrosoft.ContainerService/managedClusters/networking.k8s.io/ingresses/*Microsoft.ContainerService/managedClusters/networking.k8s.io/networkpolicies/*Microsoft.ContainerService/managedClusters/persistentvolumeclaims/*Microsoft.ContainerService/managedClusters/pods/*Microsoft.ContainerService/managedClusters/policy/poddisruptionbudgets/*Microsoft.ContainerService/managedClusters/replicationcontrollers/*Microsoft.ContainerService/managedClusters/resourcequotas/readMicrosoft.ContainerService/managedClusters/secrets/*Microsoft.ContainerService/managedClusters/serviceaccounts/*Microsoft.ContainerService/managedClusters/services/*
Excluded actions (0)
None
Assignable scopes (1)
/
Practical scope
Assign at the Kubernetes namespace sub-scope whenever the workflow is namespace-bound. Assigning at the the AKS cluster resource or an inherited parent Azure scope applies the Kubernetes API DataActions across all namespaces available through each inherited cluster.
Common use cases (1)
- Let an application team deploy and operate workloads in an AKS namespace without directly managing Kubernetes roles or role bindings.
Prerequisites (1)
- The the AKS cluster must use the documented Microsoft Entra and Azure RBAC integration for Kubernetes authorization.
Best practices (2)
- Create namespace-scoped assignments for application teams and reserve cluster-scope assignments for documented cross-namespace responsibilities.
- Audit Kubernetes API activity and review the ServiceAccounts, Secrets, and authorization objects reachable within the assigned scope.
Security considerations (2)
- The role can read Secrets and run pods as any ServiceAccount in scope, so it can inherit the Kubernetes API permissions of those ServiceAccounts even though it cannot edit role bindings directly.
- An Azure role assignment at a parent scope is inherited by child cluster resources; Kubernetes namespace semantics do not prevent a broad Azure assignment from reaching multiple clusters.
Assignment guidance
Assign Azure Kubernetes Service RBAC Writer at the narrowest documented namespace scope to the principal that needs read and write access to most Kubernetes objects, excluding role and role-binding management. Test access with the intended identity and avoid using this role as a substitute for Azure control-plane cluster administration.
Editorial sources (6)
- Azure built-in roles for Containers - Azure RBAC | Microsoft Learn →
Supports: Description, Practical scope, Security considerations. Retrieved 2026-07-17.
- Understand Azure role definitions →
Supports: Description, Security considerations. Retrieved 2026-07-17.
- Steps to assign an Azure role →
Supports: Assignment guidance. Retrieved 2026-07-17.
- Understand scope for Azure RBAC →
Supports: Practical scope, Assignment guidance. Retrieved 2026-07-17.
- Best practices for Azure RBAC →
Supports: Best practices, Assignment guidance. Retrieved 2026-07-17.
- Use Azure RBAC for Kubernetes authorization →
Supports: Description, Practical scope, Common use cases, Prerequisites, Best practices, Security considerations, Assignment guidance. Retrieved 2026-07-17.