Remover membro da função de diretório

Namespace: microsoft.graph

Remover um membro de um directoryRole.

Você pode usar a ID do objeto e a ID do modelo do directoryRole com essa API. A ID do modelo de uma função embutida é imutável e pode ser vista na descrição da função no portal do Azure. Para obter detalhes, consulte Role template IDs.

Permissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegada (conta corporativa ou de estudante) RoleManagement.ReadWrite.Directory, Directory.AccessAsUser.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo RoleManagement.ReadWrite.Directory

Solicitação HTTP

DELETE /directoryRoles/{role-objectId}/members/{id}/$ref
DELETE /directoryRoles/roleTemplateId={role-templateId}/members/{id}/$ref

Cabeçalhos de solicitação

Nome Tipo Descrição
Autorização string {token} de portador. Obrigatório.

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Resposta

Se bem-sucedido, este método retorna um código de resposta 204 No Content. Não retorna nada no corpo da resposta.

Exemplos

Exemplo 1: Remover membro da função de diretório usando objectId de função

Solicitação

Neste exemplo, substitua pelo valor de id da função de diretório e pelo valor de id do usuário ou objeto de diretório que você deseja f8e85ed8-f66f-4058-b170-3efae8b9c6e5 desasinalhar da função de bb165b45-151c-4cf6-9911-cd7188912848 diretório.

DELETE https://graph.microsoft.com/v1.0/directoryRoles/f8e85ed8-f66f-4058-b170-3efae8b9c6e5/members/bb165b45-151c-4cf6-9911-cd7188912848/$ref

Resposta

Veja a seguir um exemplo da resposta.

HTTP/1.1 204 No Content

Exemplo 2: Remover membro da função de diretório usando modelo de funçãoId

Solicitação

Este é um exemplo da solicitação. Substitua pelo valor de sua roleTemplateId e pelo valor 9f06204d-73c1-4d4c-880a-6edb90606fd8 de bb165b45-151c-4cf6-9911-cd7188912848 id do usuário do objeto directory.

DELETE https://graph.microsoft.com/v1.0/directoryRoles/roleTemplateId=9f06204d-73c1-4d4c-880a-6edb90606fd8/members/bb165b45-151c-4cf6-9911-cd7188912848/$ref

Resposta

Veja a seguir um exemplo da resposta.

HTTP/1.1 204 No Content