Obter phoneAuthenticationMethod
Namespace: microsoft.graph
Recupere um único objeto phoneAuthenticationMethod para um usuário. Esse método está disponível apenas para usuários padrão Microsoft Entra ID e B2B, mas não para usuários B2C.
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.Read, 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.Read.All, UserAuthenticationMethod.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. |
Application | UserAuthenticationMethod.Read.All, UserAuthenticationMethod.ReadWrite.All |
Para cenários delegados em que um administrador está agindo em outro usuário, o administrador precisa de pelo menos uma das seguintes funções Microsoft Entra.
- Leitor Global
- Administrador de Autenticação
- Administrador de Autenticação Privilegiada
Observação
O administrador de autenticação só vê números de telefone mascarados.
Solicitação HTTP
Recupere detalhes do seu próprio método de autenticação telefônica.
GET /me/authentication/phoneMethods/{phoneMethodId}
Recupere detalhes do seu próprio método de autenticação telefônica ou de outro usuário.
GET /users/{userId | userPrincipalName}/authentication/phoneMethods/{phoneMethodId}
O valor de phoneMethodId
correspondente ao phoneType é um dos seguintes:
b6332ec1-7057-4abe-9331-3d72feddfe41
para recuperar oalternateMobile
phoneType.e37fc753-ff3b-4958-9484-eaa9425c82bc
para recuperar ooffice
phoneType.3179e48a-750b-4051-897c-87b9720928f7
para recuperar omobile
phoneType.
Parâmetros de consulta opcionais
Esse método não dá suporte a parâmetros de consulta opcionais para personalizar a resposta.
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 for bem-sucedido, esse método retornará um 200 OK
código de resposta e o objeto phoneAuthenticationMethod solicitado no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/v1.0/me/authentication/phoneMethods/3179e48a-750b-4051-897c-87b9720928f7
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"phoneNumber": "+1 2065555555",
"phoneType": "mobile",
"smsSignInState": "ready",
"id": "3179e48a-750b-4051-897c-87b9720928f7"
}
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