Role Assignments - Get

Служба:

Key Vault

Версия API:

2025-07-01

Получите указанное назначение ролей.

GET {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}?api-version=2025-07-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
roleAssignmentName	path	True	string	Имя назначения роли, которое необходимо получить.
scope	path	True	string	Область назначения роли.
vaultBaseUrl	path	True	string (uri)
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Ответы

Имя	Тип	Описание
200 OK	RoleAssignment	Запрос выполнен успешно.
Other Status Codes	KeyVaultError	Непредвиденное сообщение об ошибке.

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

OAuth2Auth

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

Области

Имя	Описание
https://vault.azure.net/.default

Примеры

Get the specified role assignment

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

HTTP

GET https://myvault.vault.azure.net//keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentName?api-version=2025-07-01

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

Код состояния:

200

{
  "properties": {
    "roleDefinitionId": "/keys/providers/Microsoft.Authorization/roleDefinitions/roleDefinitionId",
    "principalId": "principalId",
    "scope": "/keys"
  },
  "id": "/keys/providers/Microsoft.Authorization/roleAssignments/roleAssignmentId",
  "type": "Microsoft.Authorization/roleAssignments",
  "name": "roleAssignmentId"
}

Определения

Имя	Описание
Error
KeyVaultError	Исключение ошибки хранилища ключей.
RoleAssignment	Назначения ролей
RoleAssignmentPropertiesWithScope	Свойства назначения ролей с областью действия.
RoleScope	Область действия роли.

Error

Object

Имя	Тип	Описание
code	string	Код ошибки.
innererror	Error	Ошибка сервера хранилища ключей.
message	string	Сообщение об ошибке.

KeyVaultError

Object

Исключение ошибки хранилища ключей.

Имя	Тип	Описание
error	Error	Ошибка сервера хранилища ключей.

RoleAssignment

Object

Назначения ролей

Имя	Тип	Описание
id	string	Идентификатор назначения роли.
name	string	Имя назначения роли.
properties	RoleAssignmentPropertiesWithScope	Свойства назначения ролей.
type	string	Тип назначения роли.

RoleAssignmentPropertiesWithScope

Object

Свойства назначения ролей с областью действия.

Имя	Тип	Описание
principalId	string	Идентификатор субъекта.
roleDefinitionId	string	Идентификатор определения роли.
scope	RoleScope	Область действия роли.

RoleScope

Перечисление

Область действия роли.

Значение	Описание
/	Глобальный охват
/keys	Область применения ключей