// roles/azure · containers

Azure Arc Kubernetes ViewerAzure built-in role

Lets you view all resources in cluster/namespace, except secrets.

Role ID	`63f0a09d-1495-4db4-a681-037d84835eb4`
Category	Containers
Actions	7
Data actions	28

Before you assign it

It reaches the data, not just the resource. It has 28 data actions, such as reading blobs, secrets or messages.

What it can do

Permission	What it allows
`Microsoft.Authorization/*/read`	Any read operation on anything under Microsoft.Authorization
`Microsoft.Insights/alertRules/*`	Every operation under Microsoft.Insights/alertRules
`Microsoft.Resources/deployments/write`	Creates or updates an deployment.
`Microsoft.Resources/subscriptions/operationresults/read`	Get the subscription operation results.
`Microsoft.Resources/subscriptions/read`	Gets the list of subscriptions.
`Microsoft.Resources/subscriptions/resourceGroups/read`	Gets or lists resource groups.
`Microsoft.Support/*`	Every operation under Microsoft.Support

Data actions

Permission	What it allows
`Microsoft.Kubernetes/connectedClusters/apps/controllerrevisions/read`	Reads controllerrevisions
`Microsoft.Kubernetes/connectedClusters/apps/daemonsets/read`	Reads daemonsets
`Microsoft.Kubernetes/connectedClusters/apps/deployments/read`	Reads deployments
`Microsoft.Kubernetes/connectedClusters/apps/replicasets/read`	Reads replicasets
`Microsoft.Kubernetes/connectedClusters/apps/statefulsets/read`	Reads statefulsets
`Microsoft.Kubernetes/connectedClusters/autoscaling/horizontalpodautoscalers/read`	Reads horizontalpodautoscalers
`Microsoft.Kubernetes/connectedClusters/batch/cronjobs/read`	Reads cronjobs
`Microsoft.Kubernetes/connectedClusters/batch/jobs/read`	Reads jobs
`Microsoft.Kubernetes/connectedClusters/configmaps/read`	Reads configmaps
`Microsoft.Kubernetes/connectedClusters/endpoints/read`	Reads endpoints
`Microsoft.Kubernetes/connectedClusters/events.k8s.io/events/read`	Reads events
`Microsoft.Kubernetes/connectedClusters/events/read`	Reads events
`Microsoft.Kubernetes/connectedClusters/extensions/daemonsets/read`	Reads daemonsets
`Microsoft.Kubernetes/connectedClusters/extensions/deployments/read`	Reads deployments
`Microsoft.Kubernetes/connectedClusters/extensions/ingresses/read`	Reads ingresses
`Microsoft.Kubernetes/connectedClusters/extensions/networkpolicies/read`	Reads networkpolicies
`Microsoft.Kubernetes/connectedClusters/extensions/replicasets/read`	Reads replicasets
`Microsoft.Kubernetes/connectedClusters/limitranges/read`	Reads limitranges
`Microsoft.Kubernetes/connectedClusters/namespaces/read`	Reads namespaces
`Microsoft.Kubernetes/connectedClusters/networking.k8s.io/ingresses/read`	Reads ingresses
`Microsoft.Kubernetes/connectedClusters/networking.k8s.io/networkpolicies/read`	Reads networkpolicies
`Microsoft.Kubernetes/connectedClusters/persistentvolumeclaims/read`	Reads persistentvolumeclaims
`Microsoft.Kubernetes/connectedClusters/pods/read`	Reads pods
`Microsoft.Kubernetes/connectedClusters/policy/poddisruptionbudgets/read`	Reads poddisruptionbudgets
`Microsoft.Kubernetes/connectedClusters/replicationcontrollers/read`	Reads replicationcontrollers
`Microsoft.Kubernetes/connectedClusters/resourcequotas/read`	Reads resourcequotas
`Microsoft.Kubernetes/connectedClusters/serviceaccounts/read`	Reads serviceaccounts
`Microsoft.Kubernetes/connectedClusters/services/read`	Reads services

Assign it

Scope it as tightly as you can: a resource or resource group rather than the whole subscription.

azure cli

az role assignment create \
  --assignee "jane.doe@contoso.com" \
  --role "Azure Arc Kubernetes Viewer" \
  --scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"

powershell3 lines

1
2
3New-AzRoleAssignment -SignInName "jane.doe@contoso.com" `
  -RoleDefinitionName "Azure Arc Kubernetes Viewer" `
  -Scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"

bicep7 lines

1
2
3
4
5
6
7resource assignment 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
  name: guid(resourceGroup().id, principalId, '63f0a09d-1495-4db4-a681-037d84835eb4')
  properties: {
    roleDefinitionId: subscriptionResourceId('Microsoft.Authorization/roleDefinitions', '63f0a09d-1495-4db4-a681-037d84835eb4')
    principalId: principalId
  }
}

Who already has it?

kql · azure resource graph

authorizationresources
| where type == "microsoft.authorization/roleassignments"
| where tostring(properties.roleDefinitionId) endswith "63f0a09d-1495-4db4-a681-037d84835eb4"
| project principalId = tostring(properties.principalId), principalType = tostring(properties.principalType), scope = tostring(properties.scope)

Other containers roles

AcrDelete · 1 permission
AcrPull · 1 permission
Connected Cluster Managed Identity CheckAccess Reader · 1 permission
Container Registry Cache Rule Reader · 1 permission
Container Registry Credential Set Reader · 1 permission
Container Registry Repository Catalog Lister · 1 permission
AcrImageSigner · 2 permissions
AcrPush · 2 permissions

Find the smallest role for a task →

Sources

Microsoft Learn: Azure built-in roles