Todos os produtos
Search

Este produto

    Bastionhost:GetHost

    Central de documentação

    Bastionhost:GetHost

    Última atualização: Jun 28, 2026

    Obtém os detalhes de um host, como nome, origem, endereço, protocolo e porta de serviç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 no qual você deseja consultar o 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 no qual você deseja consultar o host.

    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
    HostId

    string

    Sim

    O ID do host que você deseja consultar. Você pode especificar apenas um ID de host.

    Nota

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

    1

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    RequestId

    string

    O ID da solicitação.

    EC9BF0F4-8983-491A-BC8C-1B4DD94976DE
    Host

    object

    As informações retornadas sobre o host.

    Comment

    string

    A descrição do host.

    host
    ActiveAddressType

    string

    O tipo de endereço do host. Valores válidos:

    • Public: endereço público

    • Private: endereço privado

    Public
    HostPublicAddress

    string

    O endereço público do host. O valor é um nome de domínio ou um endereço IP.

    1.1.XX.XX
    HostName

    string

    O nome do host.

    host
    Source

    string

    A origem do host. Valores válidos:

    • Local: um host em um data center

    • Ecs: uma instância Elastic Compute Service (ECS)

    • Rds: um host em um cluster dedicado ApsaraDB MyBase

    Local
    HostPrivateAddress

    string

    O endpoint interno do host. O valor é um nome de domínio ou um endereço IP.

    192.168.XX.XX
    OSType

    string

    O sistema operacional do host. Valores válidos:

    • Linux

    • Windows

    Linux
    HostId

    string

    O ID do host.

    1
    SourceInstanceState

    string

    O status do host. Valores válidos:

    • Normal: normal

    • Release: liberado

    Normal
    SourceInstanceId

    string

    O ID da instância ECS ou do host em um cluster dedicado ApsaraDB MyBase.

    Nota

    Se Local for retornado para o parâmetro Source, nenhum valor será retornado para este parâmetro.

    i-bp19ienyt0yax748****
    Protocols

    array<object>

    As informações de protocolo sobre o host.

    object

    HostFingerPrint

    string

    The fingerprint of the host. This parameter uniquely identifies a host. A value is returned for this parameter only if you have performed O&M operations on the host by using the bastion host. Otherwise, no value is returned.

    ssh-ed25519|3e:46:5a:e1:1f:0d:39:7e:61:35:d5:fa:7b:2b:**:**
    Port

    integer

    The service port of the host.

    22
    ProtocolName

    string

    The protocol that is used to connect to the host. Valid values:

    • SSH

    • RDP

    SSH
    NetworkDomainId

    string

    O ID do domínio de rede ao qual o host pertence.

    1
    PrefKex

    string

    O algoritmo de troca de chaves preferido do host. O valor deste parâmetro é retornado se OSType estiver definido como Linux. Valores válidos:

    • default

    • diffie-hellman-group1-sha1

    • diffie-hellman-group14-sha1

    • diffie-hellman-group-exchange-sha1

    default

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "RequestId": "EC9BF0F4-8983-491A-BC8C-1B4DD94976DE",
  "Host": {
    "Comment": "host",
    "ActiveAddressType": "Public",
    "HostPublicAddress": "1.1.XX.XX",
    "HostName": "host",
    "Source": "Local",
    "HostPrivateAddress": "192.168.XX.XX",
    "OSType": "Linux",
    "HostId": "1",
    "SourceInstanceState": "Normal",
    "SourceInstanceId": "i-bp19ienyt0yax748****",
    "Protocols": [
      {
        "HostFingerPrint": "ssh-ed25519|3e:46:5a:e1:1f:0d:39:7e:61:35:d5:fa:7b:2b:**:**",
        "Port": 22,
        "ProtocolName": "SSH"
      }
    ],
    "NetworkDomainId": "1",
    "PrefKex": "default"
  }
}

    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.
    400 HostNotFound The host is not found.
    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.