Atualizar phoneAuthenticationMethod

Namespace: microsoft.graph

Atualizar o número de telefone de um usuário associado a um objeto de método de autenticação por telefone .

Você não pode alterar o tipo de um telefone. Para alterar o tipo de um telefone, adicione um novo número do tipo desejado e exclua o objeto com o tipo original.

Se um usuário estiver habilitado pela política para usar o SMS para entrar e o mobile número for alterado, o sistema tentará registrar o número para uso nesse sistema.

Não há suporte para operações de autoatendimento.

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

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) UserAuthMethod-Phone.ReadWrite UserAuthenticationMethod.ReadWrite.All, UserAuthMethod-Phone.ReadWrite.All, UserAuthenticationMethod.ReadWrite
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application UserAuthenticationMethod.ReadWrite.All UserAuthMethod-Phone.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:

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

Quando os usuários gerenciam seus próprios métodos de autenticação, o sistema solicita que eles concluam a autenticação multifator (MFA) se eles foram autenticados pela última vez há mais de 10 minutos na sessão atual.

Solicitação HTTP

Atualize o método de autenticação por telefone de outro usuário. Os usuários não podem atualizar seu próprio método de autenticação por telefone.

PATCH /users/{id | userPrincipalName}/authentication/phoneMethods/{phoneMethodId}

O valor correspondente phoneMethodId ao phoneType a ser atualizado é um dos seguintes:

  • b6332ec1-7057-4abe-9331-3d72feddfe41 para atualizar o alternateMobilephoneType.
  • e37fc753-ff3b-4958-9484-eaa9425c82bc para atualizar o officephoneType.
  • 3179e48a-750b-4051-897c-87b9720928f7 para atualizar o mobilephoneType.

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-type application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados. As propriedades existentes que não estiverem incluídas no corpo da solicitação serão recalculadas com base nas alterações de outros valores de propriedade.

Propriedade Tipo Descrição
phoneNumber Cadeia de caracteres O número de telefone para enviar uma mensagem de texto ou ligar para autenticação. Os números de telefone usam o formato +{country code} {number}x{extension}, com extensão opcional. Por exemplo, +1 5555551234 ou +1 5555551234x123 são válidos. Os números serão rejeitados na criação ou atualização se não corresponderem ao formato necessário.
phoneType string Os valores possíveis são: mobile, alternateMobile, ou office.

Resposta

Se for bem-sucedido, esse método retornará um código de 204 No Content resposta e um objeto phoneAuthenticationMethod atualizado no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

PATCH https://graph.microsoft.com/v1.0/users/kim@contoso.com/authentication/phoneMethods/3179e48a-750b-4051-897c-87b9720928f7
Content-type: application/json

{
  "phoneNumber": "+1 2065555554",
  "phoneType": "mobile",
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 204 No Content