phoneAuthenticationMethod tipo de recurso
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.
Uma representação de um telefone registado para um utilizador. Este recurso inclui o número de telefone, o tipo de telefone e se o telefone está configurado para o utilizador iniciar sessão através de SMS.
Um telemóvel tem um de três tipos: telemóvel, telemóvel alternativo ou escritório. Um utilizador pode ter um número registado para cada tipo e tem de ter um telemóvel antes de ser adicionado um telemóvel alternativo. Ao utilizar um telemóvel para autenticação multifator (MFA) ou reposição personalizada de palavra-passe (SSPR), o telemóvel é a predefinição e o telemóvel alternativo é a cópia de segurança.
Os telemóveis principais podem ser utilizados para chamadas DE SMS e de voz, consoante as definições do inquilino.
Um telefone de escritório só pode receber chamadas de voz e não mensagens SMS.
Este é um tipo derivado que herda do tipo de recurso authenticationMethod .
Métodos
| Método | Tipo de retorno | Descrição |
|---|---|---|
| List | phoneAuthenticationMethod | Leia as propriedades e relações de todos os objetos phoneAuthenticationMethod deste utilizador. |
| Get | phoneAuthenticationMethod | Ler propriedades e relações do objeto phoneAuthenticationMethod. |
| Add | phoneAuthenticationMethod | Create o objeto phoneAuthenticationMethod de um utilizador. |
| Atualizar | phoneAuthenticationMethod | Atualize o objeto phoneAuthenticationMethod. |
| Delete | Nenhum | Elimine o objeto phoneAuthenticationMethod. |
| Desativar o início de sessão por SMS | Nenhum | Desative o início de sessão por SMS para um utilizador. |
| Ativar o início de sessão por SMS | Nenhum | Ative o início de sessão por SMS para um utilizador. |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| id | Cadeia de caracteres | O identificador deste telemóvel registado para este utilizador. Somente leitura. O valor do ID é um dos seguintes:
|
| phoneNumber | Cadeia de caracteres | O número de telefone para enviar sms ou ligar para autenticação. Os números de telefone utilizam o formato "+<country code><number>x<extension>", com a extensão opcional. Por exemplo, +1 5555551234 ou +1 5555551234x123 são válidos. Os números são rejeitados ao criar/atualizar se não corresponderem ao formato necessário. |
| phoneType | authenticationPhoneType | O tipo deste telefone. Os valores possíveis são: mobile, alternateMobile ou office. |
| smsSignInState | authenticationMethodSignInState | Se um telemóvel está ou não pronto para ser utilizado para o início de sessão por SMS. Os valores possíveis são: , , , , , readyou notConfigured. unknownFutureValuephoneNumberNotUniquenotEnablednotAllowedByPolicynotSupported |
authenticationPhoneType values (valores authenticationPhoneType)
Os telefones podem ser de três tipos. Seguem-se os valores possíveis.
| Valor | Descrição |
|---|---|
| móvel | Um telemóvel principal, utilizável para SMS e chamadas de voz. |
| alternateMobile | Um telemóvel alternativo ou de cópia de segurança, utilizável apenas para chamadas de voz. |
| office | Um telefone de escritório ou telefone fixo, utilizável apenas para chamadas de voz. |
authenticationMethodSignInState values (valores authenticationMethodSignInState)
A propriedade estado de início de sessão por SMS fornece informações sobre se um número de telefone está ou não pronto para iniciar sessão por SMS. Seguem-se os valores possíveis.
| Valor | Descrição |
|---|---|
| não Suportado | O início de sessão principal não é suportado neste método de autenticação. Por exemplo, o início de sessão só pode ser ativado no número de telemóvel principal de um utilizador e não no número alternativo. |
| notAllowedByPolicy | Este utilizador não está ativado pela política para utilizar este método como início de sessão principal. |
| não Configurado | Este utilizador está ativado pela política para utilizar este método como início de sessão principal, mas tem de tomar medidas adicionais para o configurar. |
| phoneNumberNotUnique | Este utilizador tentou configurar um número de telefone como início de sessão principal, mas o número não era exclusivo e não pode ser utilizado como um nome de início de sessão. |
| pronto | Este método de autenticação está pronto para ser utilizado no início de sessão primário. |
| notEnabled | Este método de início de sessão não está ativado |
Relações
Nenhum
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.phoneAuthenticationMethod",
"id": "String (identifier)",
"phoneNumber": "String",
"phoneType": "string",
"smsSignInState": "string"
}