Eliminar phoneAuthenticationMethod
Namespace: microsoft.graph
Elimine o método de autenticação do telemóvel de um utilizador. Esta ação remove o número de telefone do utilizador e deixará de poder utilizar o número para autenticação, seja através de SMS ou chamadas de voz.
Um utilizador não pode ter um alternateMobile
número sem um mobile
número. Se quiser remover um mobile
número de um utilizador que também tenha um alternateMobile
número, primeiro atualize o mobile
número para o novo número e, em seguida, elimine o alternateMobile
número.
Se o número de telefone for o método de autenticação multifator (MFA) predefinido do utilizador, não poderá ser eliminado. Peça ao utilizador para alterar o método de autenticação predefinido e, em seguida, elimine o número.
Esta API está disponível nas seguintes implementações de cloud nacionais.
Serviço global | US Government 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 que atuam de forma autónoma
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 que atuam noutros utilizadores
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 |
Em cenários delegados com contas escolares ou profissionais em que o utilizador com sessão iniciada está a agir sobre outro utilizador, tem de lhes ser atribuída uma função suportada do Microsoft Entra ou uma função personalizada com uma permissão de função suportada. As seguintes funções com menos privilégios são suportadas para esta operação.
- Administrador de Autenticação
- Administrador de Autenticação Privilegiada
Solicitação HTTP
Elimine o seu próprio método de autenticação de telemóvel.
DELETE /me/authentication/phoneMethods/{phoneMethodId}
Elimine o método de autenticação do telemóvel do seu ou de outro utilizador.
DELETE /users/{id | userPrincipalName}/authentication/phoneMethods/{phoneMethodId}
O valor correspondente phoneMethodId
ao phoneType a eliminar é um dos seguintes:
-
b6332ec1-7057-4abe-9331-3d72feddfe41
para eliminar oalternateMobile
phoneType. -
e37fc753-ff3b-4958-9484-eaa9425c82bc
para eliminar ooffice
phoneType. -
3179e48a-750b-4051-897c-87b9720928f7
para eliminar 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
. Não devolve nada no corpo da resposta.
Exemplos
Solicitação
Eis um exemplo do pedido.
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