Excluir phoneAuthenticationMethod
Namespace: microsoft.graph
Exclua o método de autenticação telefônica de um usuário. Isso remove o número de telefone do usuário e ele não poderá mais usar o número para autenticação, seja por SMS ou chamadas de voz.
Um usuário não pode ter um alternateMobile
número sem um mobile
número. Se você quiser remover um mobile
número de um usuário que também tem um alternateMobile
número, primeiro atualize o mobile
número para o novo número e exclua o alternateMobile
número.
Se o número de telefone for o método de autenticação MFA (autenticação multifator) padrão do usuário, ele não poderá ser excluído. Faça com que o usuário altere o método de autenticação padrão e exclua o número.
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA 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 mesmo
Tipo de permissão | Permissões (da com menos para a com mais privilégios) |
---|---|
Delegado (conta corporativa ou de estudante) | UserAuthenticationMethod.ReadWrite |
Delegado (conta pessoal da Microsoft) | Sem suporte. |
Aplicativo | Sem suporte. |
Permissões agindo em outros usuários
Tipo de permissão | Permissões (da com menos para a com mais privilégios) |
---|---|
Delegado (conta corporativa ou de estudante) | UserAuthenticationMethod.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. |
Application | UserAuthenticationMethod.ReadWrite.All |
Para cenários delegados em que um administrador está agindo em outro usuário, o administrador precisa, pelo menos, da função Administrador de Autenticação ou Administrador de Autenticação PrivilegiadaMicrosoft Entra função.
Solicitação HTTP
Exclua seu próprio método de autenticação telefônica.
DELETE /me/authentication/phoneMethods/{phoneMethodId}
Exclua seu próprio método de autenticação telefônica ou de outro usuário.
DELETE /users/{id | userPrincipalName}/authentication/phoneMethods/{phoneMethodId}
O valor de phoneMethodId
correspondente ao phoneType a ser excluído é um dos seguintes:
b6332ec1-7057-4abe-9331-3d72feddfe41
para excluir oalternateMobile
phoneType.e37fc753-ff3b-4958-9484-eaa9425c82bc
para excluir ooffice
phoneType.3179e48a-750b-4051-897c-87b9720928f7
para excluir omobile
phoneType.
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
Aqui está um exemplo da solicitação.
DELETE https://graph.microsoft.com/v1.0/me/authentication/phoneMethods/3179e48a-750b-4051-897c-87b9720928f7
Resposta
Veja um exemplo de resposta.
HTTP/1.1 204 No Content
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de