GetInstanceTwoFactor - Bastionhost: Central de Documentação do Alibaba Cloud

Descrição da operação

Consulta as configurações de autenticação de dois fatores de um bastion host. Quando a autenticação de dois fatores está ativada, o Bastionhost envia um código de verificação para um usuário local que faz logon no bastion host. O usuário local deve inserir um nome de usuário, uma senha e um código de verificação válidos para fazer logon, o que reduz os riscos de segurança de vazamento de informações da conta.

Limite

Esta operação pode ser chamada até 10 vezes por segundo por conta. Se o número de chamadas por segundo exceder o limite, a limitação de taxa será acionada e seus negócios poderão ser afetados. Leve em consideração esse limite ao chamar esta operação.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID do bastion host. Nota Você pode chamar a operação DescribeInstances para consultar o ID do bastion host.	bastionhost-cn-st220aw****
RegionId	string	Não	O ID da região do bastion host. Nota Para obter mais informações sobre o mapeamento entre IDs de região e nomes de região, consulte Regiões e zonas.	cn-hangzhou

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta.
RequestId	string	O ID da solicitação, que é usado para localizar e solucionar problemas.	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE
Config	object	As configurações de autenticação de dois fatores.
EnableTwoFactor	boolean	Indica se a autenticação de dois fatores está ativada. Valores válidos: true false	true
TwoFactorMethods	array	Os métodos de autenticação de dois fatores.
	string	Indica um ou mais métodos usados para enviar códigos de verificação se a autenticação de dois fatores estiver ativada. Valores válidos: sms: autenticação de dois fatores baseada em mensagem de texto. email: autenticação de dois fatores baseada em e-mail. dingtalk: autenticação de dois fatores baseada no DingTalk. totp: autenticação de dois fatores baseada em token de senha de uso único (OTP). gmusbkey: autenticação de dois fatores usando chaves USB baseadas em SM.	sms
SkipTwoFactorTime	integer	A duração durante a qual a autenticação de dois fatores não é necessária após um usuário local passar pela autenticação de dois fatores. Valores válidos: `0 a 168`. Unidade: horas. Nota Se 0 for retornado, um usuário local deverá passar pela autenticação de dois fatores sempre que fizer logon no bastion host.	1

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
  "Config": {
    "EnableTwoFactor": true,
    "TwoFactorMethods": [
      "sms"
    ],
    "SkipTwoFactorTime": 1
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	The argument is invalid.	The argument is invalid.
500	InternalError	An unknown error occurred.	An unknown error occurred.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.