azureblog.co.uk
← cd ~/roles
// roles/azure · integration

API Management Service Operator RoleAzure built-in role

Can manage service but not the APIs

Role IDe022efe7-f5ba-4159-bbe4-b44f577e9b61
CategoryIntegration
Actions15 (minus 1 NotActions)
Data actions0

What it can do

PermissionWhat it allows
Microsoft.ApiManagement/service/*/readAny read operation on anything under Microsoft.ApiManagement/service
Microsoft.ApiManagement/service/backup/actionBackup API Management Service to the specified container in a user provided storage account
Microsoft.ApiManagement/service/deleteDelete API Management Service instance
Microsoft.ApiManagement/service/managedeployments/actionChange SKU/units, add/remove regional deployments of API Management Service
Microsoft.ApiManagement/service/readRead metadata for an API Management Service instance
Microsoft.ApiManagement/service/restore/actionRestore API Management Service from the specified container in a user provided storage account
Microsoft.ApiManagement/service/updatecertificate/actionUpload TLS/SSL certificate for an API Management Service
Microsoft.ApiManagement/service/updatehostname/actionSetup, update or remove custom domain names for an API Management Service
Microsoft.ApiManagement/service/writeCreate or Update API Management Service instance
Microsoft.Authorization/*/readAny read operation on anything under Microsoft.Authorization
Microsoft.Insights/alertRules/*Every operation under Microsoft.Insights/alertRules
Microsoft.ResourceHealth/availabilityStatuses/readGets the availability statuses for all resources in the specified scope
Microsoft.Resources/deployments/*Every operation under Microsoft.Resources/deployments
Microsoft.Resources/subscriptions/resourceGroups/readGets or lists resource groups.
Microsoft.Support/*Every operation under Microsoft.Support

Can't do

These are taken away from the actions above.

PermissionWhat it allows
Microsoft.ApiManagement/service/users/keys/readGet keys associated with user

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 "API Management Service Operator Role" \
  --scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
powershell3 lines
New-AzRoleAssignment -SignInName "jane.doe@contoso.com" `
  -RoleDefinitionName "API Management Service Operator Role" `
  -Scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
bicep7 lines
resource assignment 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
  name: guid(resourceGroup().id, principalId, 'e022efe7-f5ba-4159-bbe4-b44f577e9b61')
  properties: {
    roleDefinitionId: subscriptionResourceId('Microsoft.Authorization/roleDefinitions', 'e022efe7-f5ba-4159-bbe4-b44f577e9b61')
    principalId: principalId
  }
}

Who already has it?

kql · azure resource graph
authorizationresources
| where type == "microsoft.authorization/roleassignments"
| where tostring(properties.roleDefinitionId) endswith "e022efe7-f5ba-4159-bbe4-b44f577e9b61"
| project principalId = tostring(properties.principalId), principalType = tostring(properties.principalType), scope = tostring(properties.scope)

Other integration roles

Find the smallest role for a task →

Sources