Consulta as configurações de parâmetros de um host especificado em um cluster dedicado.
Depuração
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 |
|
|
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âmetro | Tipo | Exemplo | Descrição |
| HostType | String | dhg_cloud_ssd | Tipo de armazenamento do host. Valores válidos:
|
| HostStorage | Integer | 100 | Capacidade total de armazenamento do host. Unidade: GB. |
| InstanceNumberROSlave | Integer | 1 | Número de instâncias secundárias na instância somente leitura implantada no host. |
| AccountType | String | Admin | Tipo da conta do host. Valores válidos:
|
| MemoryUsed | String | 24576 | Quantidade de memória utilizada pelo host. Unidade: GB. |
| DedicatedHostGroupId | String | dhg-34639v1jt4y4**** | ID do cluster dedicado onde o host está implantado. |
| RequestId | String | 00A001D6-2630-5CBD-A23C-80BC1BAFDC31 | ID da solicitação. |
| InstanceNumberROMaster | Integer | 1 | Número de instâncias primárias na instância somente leitura implantada no host. |
| AllocationStatus | String | Suspended | Indica se é possível criar instâncias no host. Valores válidos:
|
| StorageUsed | String | 588800 | Uso de armazenamento do host. Unidade: GB. |
| EcsClassCode | String | ecs.r5.16xlarge | Tipo da instância Elastic Compute Service (ECS). |
| DedicatedHostId | String | ch-bp10a5id3boqi**** | ID do host. |
| MemAllocationRatio | String | 90 | Uso de memória do host. Unidade: %. |
| CreatedTime | String | 2021-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. |
| IPAddress | String | 192.168.XX.XX | Endereço IP do host. |
| AutoRenew | String | false | Indica se a renovação automática está ativada no host. Valor padrão: false. Valores válidos:
|
| HostStatus | String | 1 | Estado do host. Valores válidos:
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. |
| HostName | String | ch-8vbj9x74z874o**** | Nome do host. |
| HostCPU | Integer | 16 | Número de núcleos de CPU do host. |
| OpenPermission | String | 1 | Indica se o recurso que concede permissões de SO nos hosts do cluster dedicado está ativado.
|
| InstanceNumber | Integer | 3 | Número de instâncias criadas no host. |
| CpuUsed | String | 36 | Número de núcleos de CPU utilizados pelo host. |
| VPCId | String | vpc-wz9vu1jb32wn3sdd6**** | ID da Virtual Private Cloud (VPC) onde o host foi criado. |
| HostClass | String | mssql.host.c2xlarge | Tipo de instância do host. |
| RegionId | String | cn-hangzhou | |
| InstanceNumberMaster | Integer | 4 | Número de instâncias primárias criadas no host. |
| VSwitchId | String | vsw-bp1kaugqyrzb58oc1**** | ID do vSwitch. |
| InstanceNumberSlave | Integer | 1 | Número de instâncias secundárias criadas no host. |
| ExpiredTime | String | 2022-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. |
| ZoneId | String | cn-hangzhou-h | ID da zona. |
| CPUAllocationRatio | String | 200 | Taxa de overcommit de CPU do cluster dedicado. Unidade: %. Precisão até a casa das dezenas. |
| ImageCategory | String | WindowsWithMssqlStdLicense | Imagem do host. Retornado apenas se o mecanismo de banco de dados for SQL Server. Valores válidos:
|
| DiskAllocationRatio | String | 200 | Taxa de overcommit de armazenamento do cluster dedicado. |
| HostMem | Integer | 2048 | Quantidade de memória do host. Unidade: MB. |
| AccountName | String | cdp_system | Nome da conta do host.
|
| DistributionTag | String | tag | 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.