Excluir emailAuthenticationMethod

Namespace: microsoft.graph

Exclui o objeto emailAuthenticationMethod de um usuário.

Essa API está disponível nas seguintes implantações de nuvem nacional.

Serviço global Governo dos EUA L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

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

Permissões agindo em si

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões com privilégios mais elevados
Delegado (conta corporativa ou de estudante) UserAuthenticationMethod.ReadWrite.All UserAuthMethod-Email. ReadWrite, UserAuthMethod-Email. ReadWrite.All, UserAuthenticationMethod.ReadWrite
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application UserAuthenticationMethod.ReadWrite.All UserAuthMethod-Email. ReadWrite.All

Importante

Para acesso delegado usando contas corporativas ou de estudante em que o usuário conectado está agindo sobre outro usuário, ele deve receber uma função do Microsoft Entra com suporte ou uma função personalizada que conceda as permissões necessárias para esta operação. Esta operação dá suporte às seguintes funções internas, que fornecem apenas o menor privilégio necessário:

  • Leitor Global
  • Administrador de Autenticação
  • Administrador de Autenticação Privilegiada

Solicitação HTTP

A ID do método de autenticação de email, referenciada por {emailMethods-id}, é sempre 3ddfcfc8-9383-446f-83cc-3ab9be4be18f.

Exclua o método de email de sua própria conta. Para um usuário conectado atualizar seu próprio método de autenticação, ele deve ter atendido a um requisito de autenticação multifator durante a entrada.

Observação

Chamar o ponto de extremidade /me exige um usuário conectado e, portanto, uma permissão delegada. Não há suporte para permissões de aplicativo ao usar o /me ponto de extremidade.

DELETE /me/authentication/emailMethods/{emailMethods-id}

Exclua o método de autenticação de email da conta de outro usuário.

Observação

Ao chamar o /users/{id} ponto de extremidade representando {id} o usuário conectado, as permissões delegadas com privilégios mínimos são UserAuthenticationMethod.Read para operações de leitura e UserAuthenticationMethod.ReadWrite para operações de gravação.

DELETE /users/{id | userPrincipalName}/authentication/emailMethods/{emailMethods-id}

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Corpo da solicitação

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

Resposta

Se tiver êxito, este método retornará um código de resposta 204 No Content. Ele não retorna nada no corpo da resposta.

Exemplos

Solicitação

DELETE https://graph.microsoft.com/v1.0/users/kim@contoso.com/authentication/emailMethods/3ddfcfc8-9383-446f-83cc-3ab9be4be18f

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content