Obter emailAuthenticationMethod
Namespace: microsoft.graph
Recupere o objeto de método de autenticação de email único de um usuário.
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
Solicitação HTTP
Obtenha detalhes do seu próprio método de autenticação por email.
GET /me/authentication/emailMethods/{id}
Obtenha detalhes do seu próprio método de autenticação por email ou de outro usuário.
GET /users/{id | userPrincipalName}/authentication/emailMethods/{id}
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 emailAuthenticationMethod solicitado no corpo da resposta.
Exemplos
Solicitação
GET https://graph.microsoft.com/v1.0/me/authentication/emailMethods/3ddfcfc8-9383-446f-83cc-3ab9be4be18f
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
{
"value": {
"id": "3ddfcfc8-9383-446f-83cc-3ab9be4be18f",
"emailAddress": "Kim@contoso.com"
}
}
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