Role Definitions - Delete

Ссылка

Service:: Key Vault

API Version:: 7.3

Удаляет определение настраиваемой роли.

DELETE {vaultBaseUrl}/{scope}/providers/Microsoft.Authorization/roleDefinitions/{roleDefinitionName}?api-version=7.3

Параметры URI

Name	In	Required	Type	Description
roleDefinitionName	path	True	string	Имя (GUID) удаляемого определения роли.
scope	path	True	string	Область удаляемого определения роли. Управляемый модуль HSM поддерживает только "/".
vaultBaseUrl	path	True	string	Имя хранилища, например https://myvault.vault.azure.net.
api-version	query	True	string	Версия API клиента.

Ответы

Name	Type	Description
200 OK	RoleDefinition	ОК. Возвращает сведения об удаленном определении роли.
Other Status Codes	KeyVaultError	Key Vault ответ об ошибке, описывающий причину сбоя операции.

Примеры

DeleteRoleDefinition

Sample Request

HTTP

DELETE https://myvault.vault.azure.net////providers/Microsoft.Authorization/roleDefinitions/00000000-0000-0000-0000-000000000000?api-version=7.3

Sample Response

Status code:: 200

{
  "properties": {
    "roleName": "My custom role",
    "type": "CustomRole",
    "description": "Role description",
    "assignableScopes": [
      "/"
    ],
    "permissions": [
      {
        "dataActions": [
          "Microsoft.KeyVault/managedHsm/keys/sign/action"
        ]
      }
    ]
  },
  "id": "Microsoft.KeyVault/providers/Microsoft.Authorization/roleDefinitions/00000000-0000-0000-0000-000000000000",
  "type": "Microsoft.Authorization/roleDefinitions",
  "name": "00000000-0000-0000-0000-000000000000"
}

Определения

Error	Ошибка сервера хранилища ключей.
KeyVaultError	Исключение ошибки хранилища ключей.
Permission	Разрешения определения роли.
RoleDefinition	Определение роли.
RoleDefinitionType	Тип определения роли.
RoleType	Тип роли.

Error

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

Name	Type	Description
code	string	Код ошибки.
innererror	Error	Ошибка сервера хранилища ключей.
message	string	Сообщение об ошибке.

KeyVaultError

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

Name	Type	Description
error	Error	Ошибка сервера хранилища ключей.

Permission

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

Name	Type	Description
actions	string[]	Предоставленные разрешения на действия.
dataActions	string[]	Предоставленные разрешения на действия данных.
notActions	string[]	Разрешения на действия, исключенные, но не запрещенные. Они могут быть предоставлены другими определениями ролей, назначенными субъекту.
notDataActions	string[]	Разрешения на действие данных, исключенные, но не запрещенные. Они могут быть предоставлены другими определениями ролей, назначенными субъекту.

RoleDefinition

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

Name	Type	Description
id	string	Идентификатор определения роли.
name	string	Имя определения роли.
properties.assignableScopes	string[]	Области, назначаемые определением роли.
properties.description	string	Описание определения роли.
properties.permissions	Permission[]	Разрешения определения роли.
properties.roleName	string	Имя роли.
properties.type	RoleType	Тип роли.
type	RoleDefinitionType	Тип определения роли.

RoleDefinitionType

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

Name	Type	Description
Microsoft.Authorization/roleDefinitions	string

RoleType

Тип роли.

Name	Type	Description
AKVBuiltInRole	string	Встроенная роль.
CustomRole	string	Пользовательская роль.