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

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	GetHostAccount	A operação a ser executada. Defina o valor como GetHostAccount.
InstanceId	String	Sim	bastionhost-cn-st220aw****	ID do bastion host no qual você deseja consultar os detalhes da conta de host. Nota Chame a operação DescribeInstances para obter o ID do bastion host.
RegionId	String	Não	cn-hangzhou	ID da região do bastion host no qual você deseja modifique as informações da conta de host. Nota Para mais informações sobre o mapeamento entre IDs e nomes de regiões, consulte Regiões e zonas.
HostAccountId	String	Sim	1	ID da conta de host a ser consultada. Nota Chame a operação ListHostAccounts para obter o ID da conta de host.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE	ID da solicitação. Trata-se de um identificador exclusivo da requisição.
HostAccount	Object		Detalhes da conta de host consultada.
HasPassword	Boolean	true	Indica se há uma senha defina para a conta de host. Valores válidos: true: sim false: não
PrivateKeyFingerprint	String	fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a::	Impressão digital da chave privada.
ProtocolName	String	SSH	Protocolo usado pelo host. Valores válidos: SSH RDP
HostAccountName	String	abc	Nome da conta de host.
HostAccountId	String	1	ID da conta de host.
HostId	String	1	ID do host ao qual a conta de host pertence.
HostShareKeyId	String	1	ID da chave compartilhada.
HostShareKeyName	String	name	Nome da chave compartilhada.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=GetHostAccount
&HostAccountId=1
&InstanceId=bastionhost-cn-st220aw****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<GetHostAccountResponse>
    <RequestId>EC9BF0F4-8983-491A-BC8C-1B4DD94976DE</RequestId>
    <HostAccount>
        <HostAccountName>abc</HostAccountName>
        <ProtocolName>SSH</ProtocolName>
        <PrivateKeyFingerprint>fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**</PrivateKeyFingerprint>
        <HostId>1</HostId>
        <HasPassword>true</HasPassword>
        <HostAccountId>1</HostAccountId>
    </HostAccount>
</GetHostAccountResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
  "HostAccount" : {
    "HostAccountName" : "abc",
    "ProtocolName" : "SSH",
    "PrivateKeyFingerprint" : "fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**",
    "HostId" : "1",
    "HasPassword" : "true",
    "HostAccountId" : "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.	Mensagem de erro retornada quando um ou mais parâmetros são inválidos.
404	HostAccountNotFound	The host account is not found.	Mensagem de erro retornada quando a conta de host não existe.
500	InternalError	An unknown error occurred.	Mensagem de erro retornada quando ocorre um erro desconhecido.

Para obter uma lista de códigos de erro, visite o API Error Center.