Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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-3d72feddfe41para atualizar oalternateMobilephoneType. -
e37fc753-ff3b-4958-9484-eaa9425c82bcpara atualizar oofficephoneType. -
3179e48a-750b-4051-897c-87b9720928f7para atualizar omobilephoneType.
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