Todos os produtos
Search
Central de documentação

:DescribeDedicatedHostAttribute

Última atualização: Jun 28, 2026

Consulta as configurações de parâmetros de um host especificado em um cluster dedicado.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DescribeDedicatedHostAttribute

Operação a ser executada. Defina o valor como DescribeDedicatedHostAttribute.

RegionId

String

Não

cn-hangzhou

ID da região.

DedicatedHostId

String

Sim

ch-bp10a5id3boqi****

ID do host. Faça login no console do ApsaraDB MyBase e acesse a página Hosts para visualizar o ID do host.

DedicatedHostGroupId

String

Sim

dhg-34639v1jt4y4****

ID do cluster dedicado onde o host está implantado. Faça login no console do ApsaraDB MyBase e acesse a página Dedicated Clusters para visualizar o ID do cluster dedicado.

Parâmetros de resposta

ParâmetroTipoExemploDescrição
HostTypeStringdhg_cloud_ssd

Tipo de armazenamento do host. Valores válidos:

  • dhg_cloud_ssd ou dhg_cloud_essd: SSD aprimorado (ESSD)
  • dhg_local_ssd: SSD local
HostStorageInteger100

Capacidade total de armazenamento do host. Unidade: GB.

InstanceNumberROSlaveInteger1

Número de instâncias secundárias na instância somente leitura implantada no host.

AccountTypeStringAdmin

Tipo da conta do host. Valores válidos:

  • Normal: conta padrão
  • Admin: conta de administrador
MemoryUsedString24576

Quantidade de memória utilizada pelo host. Unidade: GB.

DedicatedHostGroupIdStringdhg-34639v1jt4y4****

ID do cluster dedicado onde o host está implantado.

RequestIdString00A001D6-2630-5CBD-A23C-80BC1BAFDC31

ID da solicitação.

InstanceNumberROMasterInteger1

Número de instâncias primárias na instância somente leitura implantada no host.

AllocationStatusStringSuspended

Indica se é possível criar instâncias no host. Valores válidos:

  • Allocatable: É possível criar instâncias no host.
  • Suspended: Não é possível criar instâncias no host.
StorageUsedString588800

Uso de armazenamento do host. Unidade: GB.

EcsClassCodeStringecs.r5.16xlarge

Tipo da instância Elastic Compute Service (ECS).

DedicatedHostIdStringch-bp10a5id3boqi****

ID do host.

MemAllocationRatioString90

Uso de memória do host. Unidade: %.

CreatedTimeString2021-11-13T07:14:22Z

Horário de criação do host. Segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. Exibido em UTC.

IPAddressString192.168.XX.XX

Endereço IP do host.

AutoRenewStringfalse

Indica se a renovação automática está ativada no host. Valor padrão: false. Valores válidos:

  • true: Renovação automática ativada.
  • false: Renovação automática desativada.
HostStatusString1

Estado do host. Valores válidos:

  • 0: Host em criação.
  • 1: Host em execução.
  • 2: Host com falha.
  • 3: Host pronto para desativação.
  • 4: Host em manutenção.
  • 5: Host desativado.
  • 6: Host reiniciando.
  • 7: Host bloqueado.
Nota Quando um host falha, ele é desativado. Antes da desativação, os dados das instâncias criadas nesse host são migrados para outro host no mesmo cluster dedicado. Isso garante a integridade dos dados.
HostNameStringch-8vbj9x74z874o****

Nome do host.

HostCPUInteger16

Número de núcleos de CPU do host.

OpenPermissionString1

Indica se o recurso que concede permissões de SO nos hosts do cluster dedicado está ativado.

  • 0: Recurso desativado.
  • 1: Recurso ativado.
InstanceNumberInteger3

Número de instâncias criadas no host.

CpuUsedString36

Número de núcleos de CPU utilizados pelo host.

VPCIdStringvpc-wz9vu1jb32wn3sdd6****

ID da Virtual Private Cloud (VPC) onde o host foi criado.

HostClassStringmssql.host.c2xlarge

Tipo de instância do host.

RegionIdStringcn-hangzhou

ID da região.

InstanceNumberMasterInteger4

Número de instâncias primárias criadas no host.

VSwitchIdStringvsw-bp1kaugqyrzb58oc1****

ID do vSwitch.

InstanceNumberSlaveInteger1

Número de instâncias secundárias criadas no host.

ExpiredTimeString2022-03-16T16:00:00Z

Horário de expiração do host. Segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. Exibido em UTC.

ZoneIdStringcn-hangzhou-h

ID da zona.

CPUAllocationRatioString200

Taxa de overcommit de CPU do cluster dedicado. Unidade: %. Precisão até a casa das dezenas.

ImageCategoryStringWindowsWithMssqlStdLicense

Imagem do host. Retornado apenas se o mecanismo de banco de dados for SQL Server. Valores válidos:

  • WindowsWithMssqlEntAlwaysonLicense: SQL Server Enterprise Edition AlwaysOn
  • WindowsWithMssqlStdLicense: SQL Server Standard Edition
  • WindowsWithMssqlEntLicense: SQL Server Enterprise Edition
  • WindowsWithMssqlWebLicense: SQL Server Web Edition
DiskAllocationRatioString200

Taxa de overcommit de armazenamento do cluster dedicado.

HostMemInteger2048

Quantidade de memória do host. Unidade: MB.

AccountNameStringcdp_system

Nome da conta do host.

  • Pode conter letras minúsculas, dígitos e sublinhados (_).
  • Deve começar com letra minúscula e terminar com letra minúscula ou dígito.
  • Deve ter entre 2 e 16 caracteres.
DistributionTagStringtag

Tag de distribuição do host.

Exemplos

Exemplos de solicitações

http(s)://cddc.aliyuncs.com/?Action=DescribeDedicatedHostAttribute
&RegionId=cn-hangzhou
&DedicatedHostId=ch-bp10a5id3boqi****
&DedicatedHostGroupId=dhg-34639v1jt4y4****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DescribeDedicatedHostAttributeResponse>
    <HostType>dhg_cloud_ssd</HostType>
    <HostStorage>100</HostStorage>
    <InstanceNumberROSlave>1</InstanceNumberROSlave>
    <AccountType>Admin</AccountType>
    <MemoryUsed>24576</MemoryUsed>
    <DedicatedHostGroupId>dhg-34639v1jt4y4****</DedicatedHostGroupId>
    <RequestId>00A001D6-2630-5CBD-A23C-80BC1BAFDC31</RequestId>
    <InstanceNumberROMaster>1</InstanceNumberROMaster>
    <AllocationStatus>Suspended</AllocationStatus>
    <StorageUsed>588800</StorageUsed>
    <EcsClassCode>ecs.r5.16xlarge</EcsClassCode>
    <DedicatedHostId>ch-bp10a5id3boqi****</DedicatedHostId>
    <MemAllocationRatio>90</MemAllocationRatio>
    <CreatedTime>2021-11-13T07:14:22Z</CreatedTime>
    <IPAddress>192.168.XX.XX</IPAddress>
    <AutoRenew>false</AutoRenew>
    <HostStatus>1</HostStatus>
    <HostName>ch-8vbj9x74z874o****</HostName>
    <HostCPU>16</HostCPU>
    <OpenPermission>1</OpenPermission>
    <InstanceNumber>3</InstanceNumber>
    <CpuUsed>36</CpuUsed>
    <VPCId>vpc-wz9vu1jb32wn3sdd6****</VPCId>
    <HostClass>mssql.host.c2xlarge</HostClass>
    <RegionId>cn-hangzhou</RegionId>
    <InstanceNumberMaster>4</InstanceNumberMaster>
    <VSwitchId>vsw-bp1kaugqyrzb58oc1****</VSwitchId>
    <InstanceNumberSlave>1</InstanceNumberSlave>
    <ExpiredTime>2022-03-16T16:00:00Z</ExpiredTime>
    <ZoneId>cn-hangzhou-h</ZoneId>
    <CPUAllocationRatio>200</CPUAllocationRatio>
    <ImageCategory>WindowsWithMssqlStdLicense</ImageCategory>
    <DiskAllocationRatio>200</DiskAllocationRatio>
    <HostMem>2048</HostMem>
    <AccountName>cdp_system</AccountName>
    <DistributionTag>tag</DistributionTag>
</DescribeDedicatedHostAttributeResponse>

Formato JSON

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

{
  "HostType" : "dhg_cloud_ssd",
  "HostStorage" : 100,
  "InstanceNumberROSlave" : 1,
  "AccountType" : "Admin",
  "MemoryUsed" : "24576",
  "DedicatedHostGroupId" : "dhg-34639v1jt4y4****",
  "RequestId" : "00A001D6-2630-5CBD-A23C-80BC1BAFDC31",
  "InstanceNumberROMaster" : 1,
  "AllocationStatus" : "Suspended",
  "StorageUsed" : "588800",
  "EcsClassCode" : "ecs.r5.16xlarge",
  "DedicatedHostId" : "ch-bp10a5id3boqi****",
  "MemAllocationRatio" : "90",
  "CreatedTime" : "2021-11-13T07:14:22Z",
  "IPAddress" : "192.168.XX.XX",
  "AutoRenew" : "false",
  "HostStatus" : "1",
  "HostName" : "ch-8vbj9x74z874o****",
  "HostCPU" : 16,
  "OpenPermission" : "1",
  "InstanceNumber" : 3,
  "CpuUsed" : "36",
  "VPCId" : "vpc-wz9vu1jb32wn3sdd6****",
  "HostClass" : "mssql.host.c2xlarge",
  "RegionId" : "cn-hangzhou",
  "InstanceNumberMaster" : 4,
  "VSwitchId" : "vsw-bp1kaugqyrzb58oc1****",
  "InstanceNumberSlave" : 1,
  "ExpiredTime" : "2022-03-16T16:00:00Z",
  "ZoneId" : "cn-hangzhou-h",
  "CPUAllocationRatio" : "200",
  "ImageCategory" : "WindowsWithMssqlStdLicense",
  "DiskAllocationRatio" : "200",
  "HostMem" : 2048,
  "AccountName" : "cdp_system",
  "DistributionTag" : "tag"
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

403

Forbidden.RAM

User not authorized to operate on the specified resource, or this API does not support RAM.

Erro retornado quando a operação especificada é proibida.

403

Permission.NotSupport

The user permission does not support the operation.

Erro retornado quando você não tem autorização para executar esta operação.

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.