Role Assignments - Delete

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

DELETE https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}?api-version=2022-04-01
DELETE https://management.azure.com/{scope}/providers/Microsoft.Authorization/roleAssignments/{roleAssignmentName}?api-version=2022-04-01&tenantId={tenantId}

Параметры URI

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

string

Имя назначения роли. Это может быть любой допустимый GUID.

scope
path True

string

Полностью квалифицированный идентификатор менеджера ресурсов Azure для ресурса.

api-version
query True

string

minLength: 1

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

tenantId
query

string

Идентификатор клиента для запроса между клиентами

Ответы

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

RoleAssignment

Операция Azure успешно завершена.

204 No Content

Ресурс не существует.

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Разрешения

Для вызова этого API вам должна быть назначена роль со следующими разрешениями. Дополнительные сведения см. в статье Встроенные роли Azure.

Microsoft.Authorization/roleAssignments/delete

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

azure_auth

Azure Active Directory OAuth2 Flow.

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

Области

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

Примеры

Delete role assignment

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

DELETE https://management.azure.com/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments/b0f43c54-e787-4862-89b1-a653fa9cf747?api-version=2022-04-01

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

{
  "name": "b0f43c54-e787-4862-89b1-a653fa9cf747",
  "type": "Microsoft.Authorization/roleAssignments",
  "id": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2/providers/Microsoft.Authorization/roleAssignments/b0f43c54-e787-4862-89b1-a653fa9cf747",
  "properties": {
    "principalId": "ce2ce14e-85d7-4629-bdbc-454d0519d987",
    "principalType": "User",
    "roleDefinitionId": "/providers/Microsoft.Authorization/roleDefinitions/0b5fe924-9a61-425c-96af-cfe6e287ca2d",
    "scope": "/subscriptions/a925f2f7-5c63-4b7b-8799-25a5f97bc3b2"
  }
}

Определения

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

Тип удостоверения, создавшего ресурс.

ErrorAdditionalInfo

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

ErrorDetail

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

ErrorResponse

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

PrincipalType

Основной тип назначенного идентификатора субъекта.

RoleAssignment

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

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

createdByType

Тип удостоверения, создавшего ресурс.

Значение Описание
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

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

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

object

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

type

string

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

ErrorDetail

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

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

ErrorAdditionalInfo[]

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

code

string

Код ошибки.

details

ErrorDetail[]

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

message

string

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

target

string

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

ErrorResponse

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

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

ErrorDetail

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

PrincipalType

Основной тип назначенного идентификатора субъекта.

Значение Описание
User

User

Group

Группа

ServicePrincipal

Сервисный принципал (ServicePrincipal)

ForeignGroup

Иностранная группа

Device

Device

RoleAssignment

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

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

string

Полный идентификатор ресурса для ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name

string

Имя ресурса

properties.condition

string

Условия назначения роли. Это ограничивает ресурсы, которым он может быть назначен. например: @Resource[Майкрософт. Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

Версия условия. В настоящее время единственным допустимым значением является "2.0"

properties.createdBy

string

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

properties.createdOn

string (date-time)

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

properties.delegatedManagedIdentityResourceId

string

Идентификатор делегированного ресурса управляемого удостоверения

properties.description

string

Описание назначения ролей

properties.principalId

string

Идентификатор субъекта.

properties.principalType

PrincipalType

User

Основной тип назначенного идентификатора субъекта.

properties.roleDefinitionId

string

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

properties.scope

string

Область назначения ролей.

properties.updatedBy

string

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

properties.updatedOn

string (date-time)

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

systemData

systemData

Azure Resource Manager метаданные, содержащие информацию createdBy и modifiedBy.

type

string

Тип ресурса. Например, «Майкрософт. Compute/virtualMachines» или «Майкрософт. Аккаунты хранения/хранения»

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

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

string (date-time)

Метка времени создания ресурса (UTC).

createdBy

string

Удостоверение, создающее ресурс.

createdByType

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string (date-time)

Временная метка последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.