Todos os produtos
Search

Este produto

    Elastic Compute Service:DescribeDedicatedHosts

    Central de documentação

    Elastic Compute Service:DescribeDedicatedHosts

    Última atualização: Oct 09, 2026

    Consulta os detalhes de um ou mais hosts dedicados. Esta operação permite obter informações como métricas de desempenho físico, código da máquina, status de uso e a lista de instâncias ECS criadas dos hosts dedicados. Você pode especificar parâmetros como os IDs dos hosts dedicados, ID do cluster de hosts dedicados, nome do host e status para consultar com precisão os detalhes necessários do host dedicado, o que fornece um forte suporte para o gerenciamento e a otimização eficientes dos recursos de computação em nuvem.

    Descrição da operação

    Descrição da operação

    Você pode consultar os detalhes de um ou mais hosts dedicados usando um dos seguintes métodos:

    • Especifique DedicatedHostIds para consultar os detalhes dos hosts dedicados.

    • Especifique DedicatedHostClusterId para consultar os detalhes dos hosts dedicados em um cluster de hosts dedicados.

    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

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    ecs:DescribeDedicatedHosts

    get

    Host dedicado.

    acs:ecs:{#regionId}:{#accountId}:ddh/*

    Host dedicado.

    acs:ecs:{#regionId}:{#accountId}:ddh/{#ddhId}

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    RegionId

    string

    Sim

    O ID da região do host dedicado. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.

    cn-hangzhou
    ZoneId

    string

    Não

    O ID da zona. Você pode chamar a operação DescribeZones para consultar a lista de zonas mais recente.

    cn-hangzhou-g
    DedicatedHostIds

    string

    Não

    Os IDs dos hosts dedicados. Você pode especificar até 100 IDs. Separe vários IDs com vírgulas (,).

    ["dh-bp165p6xk2tlw61e****", "dh-bp1f9vxmno7emy96****"]
    DedicatedHostName

    string

    Não

    O nome do host dedicado.

    MyDDHTestName
    Status

    string

    Não

    O status de uso do host dedicado. Valores válidos:

    • Available: O host dedicado está em execução. Este é o status de execução normal do host dedicado.

    • UnderAssessment: A máquina física apresenta riscos e está no período de incubação de uma falha. A máquina física está disponível, mas pode causar problemas para as instâncias ECS no host dedicado.

    • PermanentFailure: Ocorreu uma falha permanente e o host dedicado está indisponível.

    • TempUnavailable: O host dedicado está temporariamente indisponível.

    • Redeploying: O host dedicado está sendo recuperado.

    Valor padrão: Available.

    Available
    DedicatedHostType

    string

    Não

    O tipo de host dedicado. Você pode chamar a operação DescribeDedicatedHostTypes para consultar a lista de tipos de hosts dedicados mais recente.

    ddh.g5
    LockReason

    string

    Não

    O motivo pelo qual o host dedicado está bloqueado. Valores válidos:

    • financial: O host dedicado está bloqueado devido a pagamentos em atraso.

    • security: O host dedicado está bloqueado por motivos de segurança.

    financial
    PageNumber

    integer

    Não

    Nota

    Este parâmetro será descontinuado em breve. Recomendamos que você use NextToken e MaxResults para paginação.

    1
    PageSize

    integer

    Não

    Nota

    Este parâmetro será descontinuado em breve. Recomendamos que você use NextToken e MaxResults para paginação.

    10
    ResourceGroupId

    string

    Não

    O ID do grupo de recursos ao qual o host dedicado pertence. Ao usar este parâmetro para filtrar recursos, a contagem de recursos não pode exceder 1.000.

    Nota

    A filtragem pelo grupo de recursos padrão não é suportada.

    rg-aek3b6jzp66****
    NeedHostDetail

    string

    Não

    Especifica se os detalhes do host dedicado devem ser retornados.

    false
    Tag

    array<object>

    Não

    A lista de tags. A lista pode conter de 0 a 20 tags.

    object

    Não

    Key

    string

    Não

    A chave da tag do host dedicado. Se você especificar este parâmetro, ele não poderá ser uma string vazia. A chave da tag pode ter até 128 caracteres e não pode começar com aliyun ou acs:. Não pode conter http:// ou https://.

    TestKey
    Value

    string

    Não

    O valor da tag do host dedicado. Se você especificar este parâmetro, ele poderá ser uma string vazia. O valor da tag pode ter até 128 caracteres e não pode conter http:// ou https://.

    TestValue
    DedicatedHostClusterId

    string

    Não

    O ID do cluster de hosts dedicados.

    dc-bp12wlf6am0vz9v2****
    SocketDetails

    string

    Não

    Especifica se as informações de capacidade no nível do soquete devem ser exibidas. Você pode visualizar as informações de recursos restantes (uso de vCPU e memória, quantidade restante e quantidade total) no nível do soquete para determinar se instâncias ECS dos tipos correspondentes podem ser criadas. Valores válidos:

    • true: Exibe as informações. Apenas hosts dedicados de tipos específicos suportam a exibição de informações de recursos no nível do soquete. Para mais informações, consulte Visualizar e exportar informações de hosts dedicados.

    • false: Não exibe as informações.

    Importante

    Geralmente, cada host dedicado possui duas CPUs, e o ID de cada CPU é Socket 0 ou Socket 1. Em um host dedicado exclusivo, para garantir que as instâncias ECS no host dedicado ofereçam o máximo desempenho, as instâncias ECS não são criadas entre soquetes. Isso significa que uma instância ECS é criada com base em apenas um soquete.

    • Se os recursos de computação restantes de um soquete forem maiores ou iguais aos requisitos do tipo de instância ECS a ser criada, a instância ECS será criada.

    • Se os recursos de computação restantes de cada soquete forem menores que os requisitos do tipo de instância ECS a ser criada, a criação da instância ECS falhará. Mesmo que o total de recursos restantes dos dois soquetes no host dedicado atenda aos requisitos do tipo de instância ECS, a instância ECS ainda não poderá ser criada.

    true
    NextToken

    string

    Não

    O token de consulta. Defina o valor como o valor de NextToken retornado da chamada anterior a esta operação. Você não precisa especificar este parâmetro ao chamar esta operação pela primeira vez.

    e71d8a535bd9cc11
    MaxResults

    integer

    Não

    O número máximo de entradas por página para uma consulta paginada. Se você especificar este parâmetro, a consulta será realizada usando a combinação de MaxResults e NextToken.

    Valor máximo: 100.

    Valor padrão: 10.

    10
    QueryInventory

    boolean

    Não

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    DedicatedHosts

    object

    DedicatedHost

    array<object>

    Os detalhes dos hosts dedicados.

    array<object>

    O ID do espaço privado gerenciado ao qual o host dedicado pertence.

    ActionOnMaintenance

    string

    A política de migração para instâncias hospedadas no host dedicado quando ocorre uma falha. Valores válidos:

    • Migrate: O host dedicado é migrado para outro servidor físico, e as instâncias que não foram desligadas antes da falha são iniciadas.

    • Stop: As instâncias são interrompidas no host dedicado atual. Após a confirmação de que o host dedicado não pode ser reparado, as instâncias são migradas para outro servidor físico e reiniciadas. Se o host dedicado estiver conectado a discos em nuvem, o valor padrão é Migrate. Se o host dedicado estiver conectado a discos locais, o valor padrão é Stop.

    Migrate
    AutoPlacement

    string

    Especifica se o host dedicado é adicionado ao pool de recursos de implantação automática. Valores válidos:

    • on: O host dedicado é adicionado ao pool de recursos de implantação automática.

    • off: O host dedicado não é adicionado ao pool de recursos de implantação automática. Para mais informações sobre a implantação automática, consulte Implantação automática.

    on
    AutoReleaseTime

    string

    A hora de liberação automática. A hora é exibida no formato yyyy-MM-ddTHH:mmZ em UTC, de acordo com o padrão ISO 8601.

    2017-01-01T12:00Z
    Capacity

    object

    As métricas de desempenho do host dedicado.

    AvailableInstanceTypes

    object

    AvailableInstanceType

    array<object>

    A lista de tipos de instância disponíveis.

    object

    As informações do tipo de instância disponível.

    AvailableInstanceCapacity

    integer

    A capacidade disponível para o tipo de instância.

    0
    InstanceType

    string

    O tipo de instância. Para valores válidos, consulte família de instâncias.

    Nota

    Este parâmetro é obrigatório.

    AvailableLocalStorage

    integer

    A capacidade disponível de disco local. Unidade: GiB.

    65
    AvailableMemory

    number

    A capacidade de memória disponível. Unidade: GiB.

    25
    AvailableVcpus

    integer

    O número de vCPUs disponíveis.

    5
    AvailableVgpus

    integer

    O número de vGPUs disponíveis.

    2
    LocalStorageCategory

    string

    A categoria do disco local.

    i2
    SocketCapacities

    object

    SocketCapacity

    array<object>

    A lista de informações de capacidade por soquete.

    object

    AvailableMemory

    number

    A capacidade de memória disponível. Unidade: GiB.

    65
    AvailableVcpu

    integer

    O número de vCPUs disponíveis.

    64
    SocketId

    integer

    O ID do soquete.

    1
    TotalMemory

    number

    A capacidade total de memória. Unidade: GiB.

    128
    TotalVcpu

    integer

    O número total de vCPUs.

    128
    TotalLocalStorage

    integer

    A capacidade total de disco local. Unidade: GiB.

    512
    TotalMemory

    number

    A capacidade total de memória. Unidade: GiB.

    1024
    TotalVcpus

    integer

    O número total de vCPUs.

    56
    TotalVgpus

    integer

    O número total de vGPUs.

    10
    ChargeType

    string

    O método de cobrança do host dedicado.

    Prepaid
    Cores

    integer

    O número de núcleos por CPU.

    3
    CpuOverCommitRatio

    number

    A taxa de overcommit de CPU. Valores válidos: 1 a 5.

    1
    CreationTime

    string

    A hora em que o host dedicado foi criado. A hora é exibida no formato yyyy-MM-ddTHH:mmZ em UTC, de acordo com o padrão ISO 8601.

    2018-01-01T12:00Z
    DedicatedHostClusterId

    string

    O ID do cluster de hosts dedicados ao qual o host dedicado pertence.

    dc-bp12wlf6am0vz9v2****
    DedicatedHostId

    string

    O ID do host dedicado.

    dh-bp165p6xk2tlw61e****
    DedicatedHostName

    string

    O nome do host dedicado.

    MyDDHTestName
    DedicatedHostOwnerId

    integer

    O ID de usuário do proprietário do host dedicado.

    100************7
    DedicatedHostType

    string

    O tipo do host dedicado.

    ddh.g5
    Description

    string

    A descrição do host dedicado.

    this-is-my-DDH
    ExpiredTime

    string

    A hora de expiração do host dedicado por assinatura. A hora é exibida no formato yyyy-MM-ddTHH:mmZ em UTC, de acordo com o padrão ISO 8601.

    2019-01-01T12:00Z
    GPUSpec

    string

    O modelo da GPU.

    gpu
    HostDetailInfo

    object

    Este parâmetro será descontinuado. Para garantir a compatibilidade, use outros parâmetros em seu lugar.

    SerialNumber

    string

    Este parâmetro será descontinuado. Para garantir a compatibilidade, use outros parâmetros em seu lugar.

    null
    VgpuVersion

    string

    Este parâmetro será descontinuado. Para garantir a compatibilidade, use outros parâmetros em seu lugar.

    null
    Instances

    object

    Instance

    array<object>

    A lista de instâncias ECS criadas no host dedicado.

    object

    A instância ECS criada no host dedicado.

    InstanceId

    string

    O ID da instância ECS criada no host dedicado.

    i-bp14ot0ykf8w13a1****
    InstanceOwnerId

    integer

    O ID de usuário do proprietário da instância ECS.

    128************0
    InstanceType

    string

    As informações do tipo de instância ECS da instância criada no host dedicado.

    ecs.g5.large
    SocketId

    string

    O ID do soquete onde a instância está localizada.

    0,1
    MachineId

    string

    O ID da máquina do host dedicado.

    12aaa123456ff19dec12345d3026e****
    NetworkAttributes

    object

    Os atributos de rede do host dedicado.

    SlbUdpTimeout

    integer

    O período de tempo limite de UDP do Server Load Balancer (SLB). Unidade: segundos. Somente 60 segundos são suportados.

    60
    UdpTimeout

    integer

    O período de tempo limite de UDP. Unidade: segundos. Somente 60 segundos são suportados.

    60
    OperationLocks

    object

    OperationLock

    array<object>

    A lista de motivos pelos quais o host dedicado está bloqueado.

    object

    LockReason

    string

    O motivo pelo qual o host dedicado está bloqueado. Valores válidos:

    • financial: O host dedicado está bloqueado devido a pagamentos em atraso.

    • security: O host dedicado está bloqueado por motivos de segurança.

    financial
    PhysicalGpus

    integer

    O número de GPUs físicas.

    10
    RegionId

    string

    O ID da região do host dedicado.

    cn-hangzhou
    ResourceGroupId

    string

    O ID do grupo de recursos ao qual o host dedicado pertence.

    rg-aek3b6jzp66****
    SaleCycle

    string

    O ciclo de cobrança do host dedicado por assinatura. Valores válidos:

    • Month

    • Year

    Month
    SchedulerOptions.ManagedPrivateSpaceId

    string

    O ID do espaço privado gerenciado ao qual o host dedicado pertence.

    mps-iq81z6pkbqjx61php46e
    Sockets

    integer

    O número de CPUs físicas.

    5
    Status

    string

    O status do host dedicado. Valores válidos:

    • Available: Em execução. O host dedicado está em execução normalmente.

    • UnderAssessment: Risco de servidor físico. O servidor físico está em um período de falha latente e permanece disponível, mas isso pode causar problemas para as instâncias ECS no host dedicado.

    • PermanentFailure: Falhou. Ocorreu uma falha permanente e o host dedicado está indisponível.

    Available
    SupportedCustomInstanceTypeFamilies

    object

    SupportedCustomInstanceTypeFamily

    array

    A família de tipos de instância personalizada suportada pelo host dedicado.

    string

    A família de tipos de instância personalizada suportada pelo host dedicado.

    ecs.ddh6s.custom
    SupportedInstanceTypeFamilies

    object

    SupportedInstanceTypeFamily

    array

    A lista de famílias de tipos de instância ECS suportadas pelo host dedicado.

    string

    A família de instâncias ECS suportada pelo host dedicado.

    ecs.g5
    SupportedInstanceTypesList

    object

    SupportedInstanceTypesList

    array

    A lista de tipos de instância ECS suportados pelo host dedicado.

    string

    O tipo de instância ECS suportado pelo host dedicado.

    ecs.g5.large
    Tags

    object

    Tag

    array<object>

    A lista de tags do host dedicado.

    object

    O par chave-valor da tag.

    TagKey

    string

    A chave da tag do host dedicado.

    TestKey
    TagValue

    string

    O valor da tag do host dedicado.

    TestValue
    ZoneId

    string

    O ID da zona.

    cn-hangzhou-g
    NextToken

    string

    O token de consulta retornado pela invocação atual. Se você usar MaxResults e NextToken para consulta paginada e este token de paginação estiver vazio, nenhum outro dado será retornado.

    e71d8a535bd9cc11
    PageNumber

    integer

    O número da página da lista de hosts dedicados.

    5
    PageSize

    integer

    O número de entradas por página.

    1
    RequestId

    string

    O ID da solicitação.

    7654525A-9964-4ABB-8BCD-98F8835E809A
    TotalCount

    integer

    O número total de hosts dedicados.

    3

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "DedicatedHosts": {
    "DedicatedHost": [
      {
        "ActionOnMaintenance": "Migrate",
        "AutoPlacement": "on",
        "AutoReleaseTime": "2017-01-01T12:00Z",
        "Capacity": {
          "AvailableInstanceTypes": {
            "AvailableInstanceType": [
              {
                "AvailableInstanceCapacity": 0,
                "InstanceType": ""
              }
            ]
          },
          "AvailableLocalStorage": 65,
          "AvailableMemory": 25,
          "AvailableVcpus": 5,
          "AvailableVgpus": 2,
          "LocalStorageCategory": "i2",
          "SocketCapacities": {
            "SocketCapacity": [
              {
                "AvailableMemory": 65,
                "AvailableVcpu": 64,
                "SocketId": 1,
                "TotalMemory": 128,
                "TotalVcpu": 128
              }
            ]
          },
          "TotalLocalStorage": 512,
          "TotalMemory": 1024,
          "TotalVcpus": 56,
          "TotalVgpus": 10
        },
        "ChargeType": "Prepaid",
        "Cores": 3,
        "CpuOverCommitRatio": 1,
        "CreationTime": "2018-01-01T12:00Z",
        "DedicatedHostClusterId": "dc-bp12wlf6am0vz9v2****",
        "DedicatedHostId": "dh-bp165p6xk2tlw61e****",
        "DedicatedHostName": "MyDDHTestName",
        "DedicatedHostOwnerId": 0,
        "DedicatedHostType": "ddh.g5",
        "Description": "this-is-my-DDH",
        "ExpiredTime": "2019-01-01T12:00Z",
        "GPUSpec": "gpu",
        "HostDetailInfo": {
          "SerialNumber": "null",
          "VgpuVersion": "null"
        },
        "Instances": {
          "Instance": [
            {
              "InstanceId": "i-bp14ot0ykf8w13a1****",
              "InstanceOwnerId": 0,
              "InstanceType": "ecs.g5.large",
              "SocketId": "0,1"
            }
          ]
        },
        "MachineId": "12aaa123456ff19dec12345d3026e****",
        "NetworkAttributes": {
          "SlbUdpTimeout": 60,
          "UdpTimeout": 60
        },
        "OperationLocks": {
          "OperationLock": [
            {
              "LockReason": "financial"
            }
          ]
        },
        "PhysicalGpus": 10,
        "RegionId": "cn-hangzhou",
        "ResourceGroupId": "rg-aek3b6jzp66****",
        "SaleCycle": "Month",
        "SchedulerOptions.ManagedPrivateSpaceId": "mps-iq81z6pkbqjx61php46e",
        "Sockets": 5,
        "Status": "Available",
        "SupportedCustomInstanceTypeFamilies": {
          "SupportedCustomInstanceTypeFamily": [
            "ecs.ddh6s.custom"
          ]
        },
        "SupportedInstanceTypeFamilies": {
          "SupportedInstanceTypeFamily": [
            "ecs.g5"
          ]
        },
        "SupportedInstanceTypesList": {
          "SupportedInstanceTypesList": [
            "ecs.g5.large"
          ]
        },
        "Tags": {
          "Tag": [
            {
              "TagKey": "TestKey",
              "TagValue": "TestValue"
            }
          ]
        },
        "ZoneId": "cn-hangzhou-g"
      }
    ]
  },
  "NextToken": "e71d8a535bd9cc11",
  "PageNumber": 5,
  "PageSize": 1,
  "RequestId": "7654525A-9964-4ABB-8BCD-98F8835E809A",
  "TotalCount": 3
}

    Códigos de erro

    Código de status HTTP

    Código de erro

    Mensagem de erro

    Descrição
    400 InvalidStatus.ValueNotSupported The pecified dedicated host status is not supported. O status do disco especificado não suporta esta operação.
    400 MissingParamter.RegionId The regionId should not be null. O parâmetro RegionId não pode estar vazio.
    400 InvalidParameter.DedicatedHostIds The specified parameter dedicatedHostIds is not valid. O parâmetro DedicatedHostIds especificado é inválido.
    400 InvalidRegion.NotFound The specified parameter RegionId is not valid. O parâmetro RegionId é inválido.
    400 InvalidZone.NotFound The specified parameter ZoneId is not valid. O ZoneId especificado é inválido.
    403 InvalidDedicatedHostIds.Malformed The amount of specified dedicatedHostIds exceeds the limit. O parâmetro DedicatedHostIds pode conter no máximo 100 entradas.
    404 InvalidLockReason.NotFound The specified LockReason is not found. O tipo de bloqueio especificado não existe.

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.