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

API Management Workspace API DeveloperAzure built-in role

Has read access to entities in the workspace and read and write access to entities for editing APIs. This role should be assigned on the workspace scope.

Role ID56328988-075d-4c6a-8766-d93edd6725b6
CategoryIntegration
Actions17
Data actions0

What it can do

PermissionWhat it allows
Microsoft.ApiManagement/service/workspaces/*/readAny read operation on anything under Microsoft.ApiManagement/service/workspaces
Microsoft.ApiManagement/service/workspaces/apis/*Every operation under Microsoft.ApiManagement/service/workspaces/apis
Microsoft.ApiManagement/service/workspaces/apiVersionSets/*Every operation under Microsoft.ApiManagement/service/workspaces/apiVersionSets
Microsoft.ApiManagement/service/workspaces/policies/*Every operation under Microsoft.ApiManagement/service/workspaces/policies
Microsoft.ApiManagement/service/workspaces/schemas/*Every operation under Microsoft.ApiManagement/service/workspaces/schemas
Microsoft.ApiManagement/service/workspaces/products/*Every operation under Microsoft.ApiManagement/service/workspaces/products
Microsoft.ApiManagement/service/workspaces/policyFragments/*Every operation under Microsoft.ApiManagement/service/workspaces/policyFragments
Microsoft.ApiManagement/service/workspaces/namedValues/*Every operation under Microsoft.ApiManagement/service/workspaces/namedValues
Microsoft.ApiManagement/service/workspaces/tags/*Every operation under Microsoft.ApiManagement/service/workspaces/tags
Microsoft.ApiManagement/service/workspaces/backends/*Every operation under Microsoft.ApiManagement/service/workspaces/backends
Microsoft.ApiManagement/service/workspaces/certificates/*Every operation under Microsoft.ApiManagement/service/workspaces/certificates
Microsoft.ApiManagement/service/workspaces/diagnostics/*Every operation under Microsoft.ApiManagement/service/workspaces/diagnostics
Microsoft.ApiManagement/service/workspaces/loggers/*Every operation under Microsoft.ApiManagement/service/workspaces/loggers
Microsoft.Authorization/*/readAny read operation on anything under Microsoft.Authorization
Microsoft.Insights/diagnosticSettings/*/readAny read operation on anything under Microsoft.Insights/diagnosticSettings
Microsoft.insights/logs/readReading data from all your logs
Microsoft.insights/logs/ApiManagementGatewayLogs/readRead data from the ApiManagementGatewayLogs table

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 Workspace API Developer" \
  --scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
powershell3 lines
New-AzRoleAssignment -SignInName "jane.doe@contoso.com" `
  -RoleDefinitionName "API Management Workspace API Developer" `
  -Scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
bicep7 lines
resource assignment 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
  name: guid(resourceGroup().id, principalId, '56328988-075d-4c6a-8766-d93edd6725b6')
  properties: {
    roleDefinitionId: subscriptionResourceId('Microsoft.Authorization/roleDefinitions', '56328988-075d-4c6a-8766-d93edd6725b6')
    principalId: principalId
  }
}

Who already has it?

kql · azure resource graph
authorizationresources
| where type == "microsoft.authorization/roleassignments"
| where tostring(properties.roleDefinitionId) endswith "56328988-075d-4c6a-8766-d93edd6725b6"
| project principalId = tostring(properties.principalId), principalType = tostring(properties.principalType), scope = tostring(properties.scope)

Other integration roles

Find the smallest role for a task →

Sources