ListHostAccounts - : 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, que gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	ListHostAccounts	Operação a ser executada. Defina o valor como ListHostAccounts.
InstanceId	String	Sim	bastionhost-cn-st220aw****	ID do bastion host onde consultar as contas do host especificado. 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 onde consultar as contas do host especificado. Nota Para mais informações sobre o mapeamento entre IDs e nomes de regiões, consulte Regiões e zonas.
HostId	String	Sim	1	ID do host cujas contas serão consultadas. Nota Chame a operação ListHosts para obter o ID do host.
PageNumber	String	Não	1	Número da página a retornar. Valor padrão: 1.
PageSize	String	Não	20	Número de entradas a retornar por página. Valor máximo: 100. Valor padrão: 20. Se este parâmetro ficar vazio, o sistema retorna 20 entradas por página. Nota Recomendamos não deixar este parâmetro vazio.
HostAccountName	String	Não	abc	Nome da conta do host a consultar. O nome pode ter até 128 caracteres. Somente correspondência exata é suportada.
ProtocolName	String	Não	SSH	Protocolo usado pelo host cujas contas serão consultadas. Valores válidos: SSH RDP

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
TotalCount	Integer	1	Número total de contas de host consultadas.
RequestId	String	EC9BF0F4-8983-491A-BC8C-1B4DD94976DE	ID da solicitação.
HostAccounts	Array of Item		Array composto pelas contas de host consultadas.
HasPassword	Boolean	true	Indica se há uma senha configurada para a conta do host. Valores válidos: true: Há uma senha configurada para a conta do host. false: Não há senha configurada para a conta do host.
PrivateKeyFingerprint	String	fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a::	Impressão digital da chave privada da conta do host.
ProtocolName	String	SSH	Protocolo usado pelo host. Valores válidos: SSH RDP
HostAccountName	String	abc	Nome da conta do host.
HostAccountId	String	1	ID da conta do host.
HostId	String	1	ID do host.
HostShareKeyId	String	1	ID da chave compartilhada.
HostShareKeyName	String	name	Nome da chave compartilhada.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=ListHostAccounts
&InstanceId=bastionhost-cn-st220aw****
&RegionId=cn-hangzhou
&HostId=1
&PageNumber=1
&PageSize=20
&HostAccountName=abc
&ProtocolName=SSH
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

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

Formato JSON

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

{
  "TotalCount" : 1,
  "RequestId" : "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
  "HostAccounts" : [ {
    "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",
    "HostShareKeyName" : "name"
  } ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidParameter	The argument is invalid.	Um ou mais parâmetros são inválidos.
500	InternalError	An unknown error occurred.	Ocorreu um erro desconhecido.

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