Role Assignments - Delete

Exclua uma atribuição de função por escopo e nome.

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}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
roleAssignmentName
path True

string

O nome da atribuição de função. Pode ser qualquer GUID válido.

scope
path True

string

O escopo da operação ou do recurso. Os escopos válidos são: assinatura (formato: '/subscriptions/{subscriptionId}'), grupo de recursos (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}', ou recurso (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/[{parentResourcePath}/]{resourceType}/{resourceName}'

api-version
query True

string

A versão da API a ser usada para esta operação.

tenantId
query

string

ID do locatário para solicitação entre locatários

Respostas

Nome Tipo Description
200 OK

RoleAssignment

Retorna a atribuição de função excluída.

204 No Content

A atribuição de função já foi excluída ou não existe.

Other Status Codes

ErrorResponse

Resposta de erro que descreve por que a operação falhou.

Permissões

Para chamar essa API, você precisa de uma função atribuída que tenha as permissões a seguir. Para obter mais informações, veja Funções internas do Azure.

Microsoft.Authorization/roleAssignments/delete

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Delete role assignment

Solicitação de exemplo

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

Resposta de exemplo

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

Definições

Nome Description
ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

PrincipalType

O tipo principal da ID da entidade de segurança atribuída.

RoleAssignment

Atribuições de Funções

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

PrincipalType

O tipo principal da ID da entidade de segurança atribuída.

Nome Tipo Description
Device

string

ForeignGroup

string

Group

string

ServicePrincipal

string

User

string

RoleAssignment

Atribuições de Funções

Nome Tipo Valor padrão Description
id

string

ID de atribuição de função.

name

string

O nome da atribuição de função.

properties.condition

string

As condições na atribuição de função. Isso limita os recursos aos quais ele pode ser atribuído. por exemplo: @Resource[Microsoft.Storage/storageAccounts/blobServices/containers:ContainerName] StringEqualsIgnoreCase 'foo_storage_container'

properties.conditionVersion

string

Versão da condição. Atualmente, o único valor aceito é '2.0'

properties.createdBy

string

Id do usuário que criou a atribuição

properties.createdOn

string

Hora em que foi criado

properties.delegatedManagedIdentityResourceId

string

ID do recurso de identidade gerenciada delegado

properties.description

string

Descrição da atribuição de função

properties.principalId

string

A ID da entidade de segurança.

properties.principalType

PrincipalType

User

O tipo principal da ID da entidade de segurança atribuída.

properties.roleDefinitionId

string

A ID de definição de função.

properties.scope

string

O escopo da atribuição de função.

properties.updatedBy

string

Id do usuário que atualizou a atribuição

properties.updatedOn

string

Hora em que ele foi atualizado

type

string

O tipo de atribuição de função.