azureblog.co.uk
← cd ~/roles
// roles/azure · ai-machine-learning

Cognitive Services UserAzure built-in role

Lets you read and list keys of Cognitive Services.

Role IDa97b65f3-24c7-4388-baec-2e87135dc908
CategoryAi-machine-learning
Actions13
Data actions1

Before you assign it

  • It reaches the data, not just the resource. It has 1 data action, such as reading blobs, secrets or messages.

What it can do

PermissionWhat it allows
Microsoft.CognitiveServices/*/readAny read operation on anything under Microsoft.CognitiveServices
Microsoft.CognitiveServices/accounts/listkeys/actionList keys
Microsoft.Insights/alertRules/readRead a classic metric alert
Microsoft.Insights/diagnosticSettings/readRead a resource diagnostic setting
Microsoft.Insights/logDefinitions/readRead log definitions
Microsoft.Insights/metricdefinitions/readRead metric definitions
Microsoft.Insights/metrics/readRead metrics
Microsoft.ResourceHealth/availabilityStatuses/readGets the availability statuses for all resources in the specified scope
Microsoft.Resources/deployments/operations/readGets or lists deployment operations.
Microsoft.Resources/subscriptions/operationresults/readGet the subscription operation results.
Microsoft.Resources/subscriptions/readGets the list of subscriptions.
Microsoft.Resources/subscriptions/resourceGroups/readGets or lists resource groups.
Microsoft.Support/*Every operation under Microsoft.Support

Data actions

PermissionWhat it allows
Microsoft.CognitiveServices/*Every operation under Microsoft.CognitiveServices

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 "Cognitive Services User" \
  --scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
powershell3 lines
New-AzRoleAssignment -SignInName "jane.doe@contoso.com" `
  -RoleDefinitionName "Cognitive Services User" `
  -Scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
bicep7 lines
resource assignment 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
  name: guid(resourceGroup().id, principalId, 'a97b65f3-24c7-4388-baec-2e87135dc908')
  properties: {
    roleDefinitionId: subscriptionResourceId('Microsoft.Authorization/roleDefinitions', 'a97b65f3-24c7-4388-baec-2e87135dc908')
    principalId: principalId
  }
}

Who already has it?

kql · azure resource graph
authorizationresources
| where type == "microsoft.authorization/roleassignments"
| where tostring(properties.roleDefinitionId) endswith "a97b65f3-24c7-4388-baec-2e87135dc908"
| project principalId = tostring(properties.principalId), principalType = tostring(properties.principalType), scope = tostring(properties.scope)

Other ai-machine-learning roles

Find the smallest role for a task →

Sources