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

Cognitive Services Speech UserAzure built-in role

Access to the real-time speech recognition and batch transcription APIs, real-time speech synthesis and long audio APIs, as well as to read the data/test/model/endpoint for custom models, but can't create, delete or modify the data/test/model/endpoint for custom models.

Role IDf2dc8367-1007-4938-bd23-fe263f013447
CategoryAi-machine-learning
Actions3
Data actions19

Before you assign it

  • It reaches the data, not just the resource. It has 19 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/SpeechServices/*/readAny read operation on anything under Microsoft.CognitiveServices/accounts/SpeechServices
Microsoft.CognitiveServices/accounts/SpeechServices/*/transcriptions/readEvery operation matching Microsoft.CognitiveServices/accounts/SpeechServices/*/transcriptions/read
Microsoft.CognitiveServices/accounts/SpeechServices/*/transcriptions/writeEvery operation matching Microsoft.CognitiveServices/accounts/SpeechServices/*/transcriptions/write
Microsoft.CognitiveServices/accounts/SpeechServices/*/transcriptions/deleteEvery operation matching Microsoft.CognitiveServices/accounts/SpeechServices/*/transcriptions/delete
Microsoft.CognitiveServices/accounts/SpeechServices/*/transcriptions/actionEvery operation matching Microsoft.CognitiveServices/accounts/SpeechServices/*/transcriptions/action
Microsoft.CognitiveServices/accounts/SpeechServices/*/frontend/actionEvery operation matching Microsoft.CognitiveServices/accounts/SpeechServices/*/frontend/action
Microsoft.CognitiveServices/accounts/SpeechServices/text-dependent/*/actionAny action on anything under Microsoft.CognitiveServices/accounts/SpeechServices/text-dependent
Microsoft.CognitiveServices/accounts/SpeechServices/text-independent/*/actionAny action on anything under Microsoft.CognitiveServices/accounts/SpeechServices/text-independent
Microsoft.CognitiveServices/accounts/SpeechServices/voiceagent/realtime/*Every operation under Microsoft.CognitiveServices/accounts/SpeechServices/voiceagent/realtime
Microsoft.CognitiveServices/accounts/SpeechServices/voicelive/realtime/*Every operation under Microsoft.CognitiveServices/accounts/SpeechServices/voicelive/realtime
Microsoft.CognitiveServices/accounts/CustomVoice/*/readAny read operation on anything under Microsoft.CognitiveServices/accounts/CustomVoice
Microsoft.CognitiveServices/accounts/CustomVoice/evaluations/*Every operation under Microsoft.CognitiveServices/accounts/CustomVoice/evaluations
Microsoft.CognitiveServices/accounts/CustomVoice/longaudiosynthesis/*Every operation under Microsoft.CognitiveServices/accounts/CustomVoice/longaudiosynthesis
Microsoft.CognitiveServices/accounts/AudioContentCreation/*Every operation under Microsoft.CognitiveServices/accounts/AudioContentCreation
Microsoft.CognitiveServices/accounts/TTSPlayer/*Every operation under Microsoft.CognitiveServices/accounts/TTSPlayer
Microsoft.CognitiveServices/accounts/VideoTranslation/*Every operation under Microsoft.CognitiveServices/accounts/VideoTranslation
Microsoft.CognitiveServices/accounts/CustomAvatar/*/readAny read operation on anything under Microsoft.CognitiveServices/accounts/CustomAvatar
Microsoft.CognitiveServices/accounts/BatchAvatar/*Every operation under Microsoft.CognitiveServices/accounts/BatchAvatar
Microsoft.CognitiveServices/accounts/BatchTextToSpeech/*Every operation under Microsoft.CognitiveServices/accounts/BatchTextToSpeech

Data actions it can't do

PermissionWhat it allows
Microsoft.CognitiveServices/accounts/CustomVoice/datasets/files/readGets the files of the dataset identified by the given ID.
Microsoft.CognitiveServices/accounts/CustomVoice/datasets/utterances/readGets utterances of the specified training set.

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

Who already has it?

kql · azure resource graph
authorizationresources
| where type == "microsoft.authorization/roleassignments"
| where tostring(properties.roleDefinitionId) endswith "f2dc8367-1007-4938-bd23-fe263f013447"
| 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