Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Leia as propriedades e as relações de um objeto signInIdentifierBase .
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) |
SignInIdentifier.Read.All |
SignInIdentifier.ReadWrite.All |
| Delegado (conta pessoal da Microsoft) |
Sem suporte. |
Sem suporte. |
| Application |
SignInIdentifier.Read.All |
SignInIdentifier.ReadWrite.All |
Importante
Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado 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.
O Administrador de Política de Autenticação é a função com menos privilégios com suporte para essa operação.
Solicitação HTTP
GET /identity/signInIdentifiers/{signInIdentifier-name}
Parâmetros do caminho
| Parâmetro |
Tipo |
Descrição |
| nome do signInIdentifier |
Cadeia de caracteres |
O nome do identificador de entrada a ser recuperado. Valores suportados: Email, UPN, Username, CustomUsername1CustomUsername2, . |
Parâmetros de consulta opcionais
Esse método não dá suporte a parâmetros de consulta OData para ajudar a personalizar a resposta. O identificador de entrada é recuperado diretamente por meio do caminho da URL.
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 código de 200 OK resposta e um objeto signInIdentifierBase no corpo da resposta.
Exemplos
Exemplo 1: Obter identificador de entrada de Email
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/identity/signInIdentifiers/Email
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Identity.SignInIdentifiers["{signInIdentifierBase-name}"].GetAsync();
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
signInIdentifiers, err := graphClient.Identity().SignInIdentifiers().BySignInIdentifierBaseName("signInIdentifierBase-name").Get(context.Background(), nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
SignInIdentifierBase result = graphClient.identity().signInIdentifiers().bySignInIdentifierBaseName("{signInIdentifierBase-name}").get();
const options = {
authProvider,
};
const client = Client.init(options);
let signInIdentifierBase = await client.api('/identity/signInIdentifiers/Email')
.version('beta')
.get();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$result = $graphServiceClient->identity()->signInIdentifiers()->bySignInIdentifierBaseName('signInIdentifierBase-name')->get()->wait();
Import-Module Microsoft.Graph.Beta.Identity.SignIns
Get-MgBetaIdentitySignInIdentifier -SignInIdentifierBaseName $signInIdentifierBaseName
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.identity.sign_in_identifiers.by_sign_in_identifier_base_name('signInIdentifierBase-name').get()
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
{
"@odata.type": "#microsoft.graph.emailSignInIdentifier",
"name": "Email",
"isEnabled": true
}
Exemplo 2: obter identificador de login de nome de usuário personalizado
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/identity/signInIdentifiers/CustomUsername1
// Code snippets are only available for the latest version. Current version is 5.x
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Identity.SignInIdentifiers["{signInIdentifierBase-name}"].GetAsync();
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
//other-imports
)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
signInIdentifiers, err := graphClient.Identity().SignInIdentifiers().BySignInIdentifierBaseName("signInIdentifierBase-name").Get(context.Background(), nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
SignInIdentifierBase result = graphClient.identity().signInIdentifiers().bySignInIdentifierBaseName("{signInIdentifierBase-name}").get();
const options = {
authProvider,
};
const client = Client.init(options);
let signInIdentifierBase = await client.api('/identity/signInIdentifiers/CustomUsername1')
.version('beta')
.get();
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$result = $graphServiceClient->identity()->signInIdentifiers()->bySignInIdentifierBaseName('signInIdentifierBase-name')->get()->wait();
Import-Module Microsoft.Graph.Beta.Identity.SignIns
Get-MgBetaIdentitySignInIdentifier -SignInIdentifierBaseName $signInIdentifierBaseName
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
result = await graph_client.identity.sign_in_identifiers.by_sign_in_identifier_base_name('signInIdentifierBase-name').get()
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
{
"@odata.type": "#microsoft.graph.customUsernameSignInIdentifier",
"name": "CustomUsername1",
"isEnabled": true,
"validationRegex": "^[a-zA-Z]{4}\\d{5}$"
}