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

API Management Developer Portal Content EditorAzure built-in role

Can customize the developer portal, edit its content, and publish it.

Role IDc031e6a8-4391-4de0-8d69-4706a7ed3729
CategoryIntegration
Actions8
Data actions0

What it can do

PermissionWhat it allows
Microsoft.ApiManagement/service/portalRevisions/readLists a collection of developer portal revision entities. or Gets developer portal revision specified by its identifier.
Microsoft.ApiManagement/service/portalRevisions/writeCreates a new developer portal revision. or Updates the description of specified portal revision or makes it current.
Microsoft.ApiManagement/service/contentTypes/readReturns list of content types or Returns content type
Microsoft.ApiManagement/service/contentTypes/deleteRemoves content type.
Microsoft.ApiManagement/service/contentTypes/writeCreates new content type
Microsoft.ApiManagement/service/contentTypes/contentItems/readReturns list of content items or Returns content item details
Microsoft.ApiManagement/service/contentTypes/contentItems/writeCreates new content item or Updates specified content item
Microsoft.ApiManagement/service/contentTypes/contentItems/deleteRemoves specified content item.

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 Developer Portal Content Editor" \
  --scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
powershell3 lines
New-AzRoleAssignment -SignInName "jane.doe@contoso.com" `
  -RoleDefinitionName "API Management Developer Portal Content Editor" `
  -Scope "/subscriptions/<subscription id>/resourceGroups/<resource group>"
bicep7 lines
resource assignment 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
  name: guid(resourceGroup().id, principalId, 'c031e6a8-4391-4de0-8d69-4706a7ed3729')
  properties: {
    roleDefinitionId: subscriptionResourceId('Microsoft.Authorization/roleDefinitions', 'c031e6a8-4391-4de0-8d69-4706a7ed3729')
    principalId: principalId
  }
}

Who already has it?

kql · azure resource graph
authorizationresources
| where type == "microsoft.authorization/roleassignments"
| where tostring(properties.roleDefinitionId) endswith "c031e6a8-4391-4de0-8d69-4706a7ed3729"
| project principalId = tostring(properties.principalId), principalType = tostring(properties.principalType), scope = tostring(properties.scope)

Other integration roles

Find the smallest role for a task →

Sources