Todos os produtos
Search
Central de documentação

Bastionhost:ListOperationHostAccounts

Última atualização: Jun 28, 2026

Consulta uma lista de contas de host que o usuário atual do Resource Access Management (RAM) está autorizado a gerenciar.

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

HostId

string

Sim

O ID do host cujas contas você deseja consultar.

Nota

Você pode chamar a operação ListOperationHosts para consultar o ID do host.

1

PageNumber

string

Não

O número da página. Valor padrão: 1.

1

PageSize

string

Não

O número de entradas por página.
Valores válidos: 1 a 100. Valor padrão: 20. Se você deixar este parâmetro vazio, 20 entradas serão retornadas em cada página.

Nota

Recomendamos que você não deixe este parâmetro vazio.

20

HostAccountName

string

Não

O nome da conta do host a ser consultada. Há suporte apenas para correspondência exata.

root

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

HostAccounts

array<object>

As contas de host retornadas.

array<object>

HasPassword

boolean

Indica se uma senha está configurada para a conta do host.

  • true

  • false

true

HostAccountId

string

O ID da conta do host.

1

HostAccountName

string

O nome da conta do host.

root

HostId

string

O ID do host.

HostShareKeyId

string

O ID da chave compartilhada associada ao host.

3

PrivateKeyFingerprint

string

A impressão digital da chave privada da conta do host.

fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**

ProtocolName

string

O protocolo usado pela conta do host.

  • SSH

  • RDP

SSH

SSHConfig

object

Indica se os canais do Secure File Transfer Protocol (SFTP) ou os canais SSH estão ativados para a conta do host que usa o protocolo SSH.

EnableSFTPChannel

boolean

Indicates whether SFTP channels are enabled for the account.

EnableSSHChannel

boolean

Indicates whether SSH channels are enabled for the account.

RequestId

string

O ID da solicitação.

EC9BF0F4-8983-491A-BC8C-1B4DD94976DE

TotalCount

integer

O número total de contas de host retornadas.

1

Exemplos

Resposta de sucesso

JSON formato

{
  "HostAccounts": [
    {
      "HasPassword": true,
      "HostAccountId": "1",
      "HostAccountName": "root",
      "HostId": "1",
      "HostShareKeyId": "3",
      "PrivateKeyFingerprint": "fe:ca:37:42:30:00:9d:95:e6:73:e5:b0:32:0a:**:**",
      "ProtocolName": "SSH",
      "SSHConfig": {
        "EnableSFTPChannel": false,
        "EnableSSHChannel": false
      }
    }
  ],
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
  "TotalCount": 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.