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

Cognitive Services Language ReaderAzure built-in role

Has access to Read and Test functions under Language portal

Role ID7628b7b8-a8b2-4cdc-b46f-e9b35248918e
CategoryAi-machine-learning
Actions3
Data actions16

Before you assign it

  • It reaches the data, not just the resource. It has 16 data actions, 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.Authorization/roleAssignments/readGet information about a role assignment.
Microsoft.Authorization/roleDefinitions/readGet information about a role definition.

Data actions

PermissionWhat it allows
Microsoft.CognitiveServices/accounts/LanguageAuthoring/*/readAny read operation on anything under Microsoft.CognitiveServices/accounts/LanguageAuthoring
Microsoft.CognitiveServices/accounts/ConversationalLanguageUnderstanding/*/readAny read operation on anything under Microsoft.CognitiveServices/accounts/ConversationalLanguageUnderstanding
Microsoft.CognitiveServices/accounts/ConversationalLanguageUnderstanding/projects/export/actionTriggers a job to export project data in JSON format.
Microsoft.CognitiveServices/accounts/Language/*/readAny read operation on anything under Microsoft.CognitiveServices/accounts/Language
Microsoft.CognitiveServices/accounts/Language/*/projects/export/actionEvery operation matching Microsoft.CognitiveServices/accounts/Language/*/projects/export/action
Microsoft.CognitiveServices/accounts/Language/query-text/actionAnswer Text.
Microsoft.CognitiveServices/accounts/Language/query-dataverse/actionQuery Dataverse.
Microsoft.CognitiveServices/accounts/Language/analyze-text/jobs/actionSubmit a collection of text documents for analysis. Specify one or more unique tasks to be executed.
Microsoft.CognitiveServices/accounts/Language/analyze-text/actionSubmit a collection of text documents for analysis. Specify a single unique task to be executed immediately.
Microsoft.CognitiveServices/accounts/Language/analyze-text/jobscancel/actionCancel a long-running Text Analysis job.
Microsoft.CognitiveServices/accounts/Language/analyze-conversations/actionAnalyzes the input conversation.
Microsoft.CognitiveServices/accounts/Language/analyze-conversations/jobscancel/actionCancel a long-running analysis job on conversation.
Microsoft.CognitiveServices/accounts/Language/analyze-conversations/jobs/actionSubmit a long conversation for analysis. Specify one or more unique tasks to be executed as a long-running operation.
Microsoft.CognitiveServices/accounts/Language/query-knowledgebases/actionAnswer Knowledgebase.
Microsoft.CognitiveServices/accounts/Language/generate/actionLanguage generation.
Microsoft.CognitiveServices/accounts/TextAnalytics/*Every operation under Microsoft.CognitiveServices/accounts/TextAnalytics

Data actions it can't do

PermissionWhat it allows
Microsoft.CognitiveServices/accounts/TextAnalytics/QnaMaker/*Every operation under Microsoft.CognitiveServices/accounts/TextAnalytics/QnaMaker

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 Language Reader" \
  --scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
powershell3 lines
New-AzRoleAssignment -SignInName "jane.doe@contoso.com" `
  -RoleDefinitionName "Cognitive Services Language Reader" `
  -Scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
bicep7 lines
resource assignment 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
  name: guid(resourceGroup().id, principalId, '7628b7b8-a8b2-4cdc-b46f-e9b35248918e')
  properties: {
    roleDefinitionId: subscriptionResourceId('Microsoft.Authorization/roleDefinitions', '7628b7b8-a8b2-4cdc-b46f-e9b35248918e')
    principalId: principalId
  }
}

Who already has it?

kql · azure resource graph
authorizationresources
| where type == "microsoft.authorization/roleassignments"
| where tostring(properties.roleDefinitionId) endswith "7628b7b8-a8b2-4cdc-b46f-e9b35248918e"
| 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