Поделиться через


Role Definitions - List

Получите все определения ролей, применимые в области и выше.

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

Параметры URI

Имя В Обязательно Тип Описание
scope
path True

string

Область определения роли.

api-version
query True

string

minLength: 1

Версия API, используемая для этой операции.

$filter
query

string

Фильтр, применяемый к операции. Используйте фильтр atScopeAndBelow для поиска ниже заданной области.

Ответы

Имя Тип Описание
200 OK

RoleDefinitionListResult

ОК. Возвращает массив определений ролей.

Other Status Codes

ErrorResponse

Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

List role definitions for scope

Образец запроса

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

Пример ответа

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

Определения

Имя Описание
ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Ответ на ошибку

Permission

Разрешения определения роли.

RoleDefinition

Определение роли.

RoleDefinitionListResult

Результат операции списка определений ролей.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

Permission

Разрешения определения роли.

Имя Тип Описание
actions

string[]

Разрешенные действия.

dataActions

string[]

Разрешенные действия с данными.

notActions

string[]

Отказано в действиях.

notDataActions

string[]

Действия с запрещенными данными.

RoleDefinition

Определение роли.

Имя Тип Описание
id

string

Идентификатор определения роли.

name

string

Имя определения роли.

properties.assignableScopes

string[]

Области определения роли, назначаемые.

properties.createdBy

string

Идентификатор пользователя, создавшего назначение

properties.createdOn

string (date-time)

Время его создания

properties.description

string

Описание определения роли.

properties.permissions

Permission[]

Разрешения определения роли.

properties.roleName

string

Имя роли.

properties.type

string

Тип роли.

properties.updatedBy

string

Идентификатор пользователя, который обновил назначение

properties.updatedOn

string (date-time)

Время обновления

type

string

Тип определения роли.

RoleDefinitionListResult

Результат операции списка определений ролей.

Имя Тип Описание
nextLink

string

URL-адрес, используемый для получения следующего набора результатов.

value

RoleDefinition[]

Список определений ролей.