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

Obtém os detalhes de uma conta de host em um host gerenciado por uma instância Bastionhost, como o tipo de protocolo e o nome da conta.

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 da instância Bastionhost onde reside a conta de host que você deseja consultar. Nota Você pode chamar a operação DescribeInstances para obter este parâmetro.	bastionhost-cn-st220aw****
RegionId	string	Não	O ID da região da instância Bastionhost onde reside a conta de host que você deseja consultar. Nota Para mais informações sobre o mapeamento entre IDs de região e nomes de região, consulte Regiões e zonas.	cn-hangzhou
HostAccountId	string	Sim	O ID da conta de host que você deseja consultar. Nota Você pode chamar a operação ListHostAccounts para obter este parâmetro.	1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os dados de resposta.
RequestId	string	O identificador único gerado pelo Alibaba Cloud para a solicitação.	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE
HostAccount	object	As informações detalhadas sobre a conta de host consultada.
HasPassword	boolean	Indica se uma senha está definida para a conta de host. Valores válidos: true: Uma senha está definida. false: Nenhuma senha está definida.	true
PrivateKeyFingerprint	string	As informações de fingerprint da chave privada.	fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a::
ProtocolName	string	O nome do protocolo da conta de host. Valores válidos: SSH RDP	SSH
HostAccountName	string	O nome da conta de host.	abc
HostAccountId	string	O ID da conta de host.	1
HostId	string	O ID do host ao qual a conta de host pertence.	1
HostShareKeyId	string	O ID da chave compartilhada para o host.	1
RotationMode	string	O modo de rotação de senha da conta. Privileged: Usar uma conta privilegiada para rotacionar senhas Self: Não usar uma conta privilegiada para rotacionar senhas Nota Este parâmetro é suportado apenas na versão V3.2.47 e posteriores.	Privileged
HostShareKeyName	string	O nome da chave compartilhada para o host.	name
PrivilegeType	string	O tipo de permissão da conta. Privileged: Conta privilegiada Normal: Conta regular Nota Este parâmetro é suportado apenas na versão V3.2.47 e posteriores.	Normal

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
  "HostAccount": {
    "HasPassword": true,
    "PrivateKeyFingerprint": "fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**",
    "ProtocolName": "SSH",
    "HostAccountName": "abc",
    "HostAccountId": "1",
    "HostId": "1",
    "HostShareKeyId": "1",
    "RotationMode": "Privileged",
    "HostShareKeyName": "name",
    "PrivilegeType": "Normal"
  }
}

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.
404	HostAccountNotFound	The host account is not found.	The host account is not found.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.