Role Definitions - List

Get all role definitions that are applicable at scope and above.

GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions?api-version=2015-07-01
GET https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleDefinitions?$filter={$filter}&api-version=2015-07-01

URI Parameters

Name In Required Type Description
scope
path True
  • string

The scope of the role definition.

$filter
query
  • string

The filter to apply on the operation. Use atScopeAndBelow filter to search below the given scope as well.

api-version
query True
  • string

The API version to use for this operation.

Responses

Name Type Description
200 OK

OK - Returns an array of role definitions.

Media Types: "application/json", "text/json"

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

GetConfigurations

Sample Request

GET https://management.azure.com/scope/providers/Microsoft.Authorization/roleDefinitions?api-version=2015-07-01

Sample Response

{
  "value": [
    {
      "properties": {
        "roleName": "Role name",
        "type": "roletype",
        "description": "Role description",
        "assignableScopes": [
          "/subscriptions/subId"
        ],
        "permissions": [
          {
            "actions": [
              "action"
            ],
            "notActions": []
          }
        ]
      },
      "id": "/subscriptions/subID/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
      "type": "Microsoft.Authorization/roleDefinitions",
      "name": "roleDefinitionId"
    }
  ]
}

Definitions

Permission

Role definition permissions.

RoleDefinition

Role definition.

RoleDefinitionListResult

Role definition list operation result.

RoleDefinitionProperties

Role definition properties.

Permission

Role definition permissions.

Name Type Description
actions
  • string[]

Allowed actions.

notActions
  • string[]

Denied actions.

RoleDefinition

Role definition.

Name Type Description
id
  • string

The role definition ID.

name
  • string

The role definition name.

properties

Role definition properties.

type
  • string

The role definition type.

RoleDefinitionListResult

Role definition list operation result.

Name Type Description
nextLink
  • string

The URL to use for getting the next set of results.

value

Role definition list.

RoleDefinitionProperties

Role definition properties.

Name Type Description
assignableScopes
  • string[]

Role definition assignable scopes.

description
  • string

The role definition description.

permissions

Role definition permissions.

roleName
  • string

The role name.

type
  • string

The role type.