Consultar clusters dedicados - : Central de Documentação do Alibaba Cloud

Chame a operação DescribeDedicatedHostGroups para consultar informações sobre um ou mais clusters dedicados.

Os clusters dedicados permitem gerenciar várias instâncias simultaneamente. É possível criar múltiplos clusters dedicados em uma única região. Cada cluster dedicado consiste em vários hosts, nos quais você pode criar diversas instâncias. Para mais informações, consulte O que é o ApsaraDB MyBase?.

Depuração

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

Parâmetros de solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	Consultar clusters dedicados	A operação a ser executada. Defina o valor como DescribeDedicatedHostGroups.
RegionId	String	Sim	cn-hangzhou	O ID da região dos clusters dedicados. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
DedicatedHostGroupId	String	Não	dhg-7a9xxxxxxxx	O ID do cluster dedicado.
ImageCategory	String	Não	WindowsWithMssqlStdLicense	A imagem base para criação dos hosts nos clusters dedicados. Valores válidos: WindowsWithMssqlStdLicense: imagem Windows com licenças do SQL Server Standard Edition WindowsWithMssqlEntLisence: imagem Windows com licenças do SQL Server Enterprise Edition WindowsWithMssqlWebLisence: imagem Windows com licenças do SQL Server Web Edition AliLinux: imagem Linux

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
DedicatedHostGroups	Array of DedicatedHostGroups		Um array composto pelos clusters dedicados retornados.
DedicatedHostGroups
AllocationPolicy	String	Evenly	A política de alocação de recursos no cluster dedicado. Valores válidos: Evenly: o sistema aloca os recursos uniformemente entre todos os hosts do cluster dedicado. Intensively: o sistema prioriza a alocação de recursos nos hosts com maior carga do cluster dedicado.
BastionInstanceId	String	bastionhost-cn-m7xxxxxxxx	O ID do bastion host.
CpuAllocateRation	Float	25	A porcentagem de núcleos alocados no cluster dedicado. Unidade: %.
CpuAllocatedAmount	Float	8	A quantidade de núcleos alocados no cluster dedicado.
CpuAllocationRatio	Integer	200	A taxa de overcommitment de núcleos do cluster dedicado. Unidade: %. Para mais informações sobre essa taxa, consulte Gerencie um cluster dedicado.
CreateTime	String	1571125370000	O timestamp de criação do cluster dedicado.
DedicatedHostCountGroupByHostType	Map	dhg_cloud_ssd	O tipo de mídia de armazenamento dos hosts no cluster dedicado. Valores válidos: dhg_cloud_ssd: unidade de estado sólido (SSD) padrão ou aprimorada dhg_local_ssd: SSD local
DedicatedHostGroupDesc	String	testHostGroup	O nome do cluster dedicado.
DedicatedHostGroupId	String	dhg-7a9xxxxxxxx	O ID do cluster dedicado.
DiskAllocateRation	Float	0.49	A porcentagem de espaço em disco alocado no cluster dedicado. Unidade: %.
DiskAllocatedAmount	Float	200	A quantidade de espaço em disco alocado no cluster dedicado. Unidade: GB.
DiskAllocationRatio	Integer	200	A taxa de overcommitment de disco do cluster dedicado. Unidade: %. Para mais informações sobre essa taxa, consulte Gerencie um cluster dedicado.
DiskUsedAmount	Float	20	A quantidade de espaço em disco utilizado no cluster dedicado. Unidade: GB.
DiskUtility	Float	0	A utilização de disco do cluster dedicado. Unidade: %.
Engine	String	MySQL	O mecanismo de banco de dados das instâncias no cluster dedicado.
HostNumber	Integer	3	O número total de hosts no cluster dedicado.
HostReplacePolicy	String	Auto	A política de tratamento de falhas de host. Valores válidos: Auto: o sistema substitui automaticamente os hosts com falha. Manual: substitua manualmente os hosts com falha.
InstanceNumber	Integer	4	O número total de instâncias no cluster dedicado.
MemAllocateRation	Float	33.7	A porcentagem de memória alocada no cluster dedicado. Unidade: %.
MemAllocatedAmount	Float	16384	A quantidade de memória alocada no cluster dedicado.
MemAllocationRatio	Integer	90	A taxa de overcommitment de memória do cluster dedicado. Unidade: %. Para mais informações sobre essa taxa, consulte Gerencie um cluster dedicado.
MemUsedAmount	Float	0	A quantidade de memória utilizada no cluster dedicado. Unidade: MB.
MemUtility	Float	0	A utilização de memória do cluster dedicado. Unidade: %.
OpenPermission	String	3	Indica se as permissões do sistema operacional dos hosts no cluster dedicado podem ser concedidas. Valores válidos: 0 ou null: as permissões não podem ser concedidas. 1: as permissões podem ser concedidas. 3: as permissões já foram concedidas.
Text	String	testHostGroup/dhg-7a9xxxxxxxx	O nome e o ID do cluster dedicado. Este parâmetro combina os valores de DedicatedHostGroupDesc e DedicatedHostGroupId. Formato: DedicatedHostGroupDesc/DedicatedHostGroupId.
VPCId	String	vpc-bp1oxxxxxx	O ID da Virtual Private Cloud (VPC) à qual o cluster dedicado pertence.
ZoneIDList	List	cn-hangzhou	Uma lista das zonas às quais os hosts do cluster dedicado pertencem.
RequestId	String	AB44DC0A-7E77-442A-97A9-C6418694CB22	O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=DescribeDedicatedHostGroups
&RegionId=cn-hangzhou
&DedicatedHostGroupId=dhg-7a9xxxxxxxx
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<DescribeDedicatedHostGroups>
  <RequestId>AB44DC0A-7E77-442A-97A9-C6418694CB22</RequestId>
  <DedicatedHostGroups>
        <DedicatedHostGroups>
              <DiskAllocationRatio>200</DiskAllocationRatio>
              <DiskUsedAmount>20</DiskUsedAmount>
              <InstanceNumber>4</InstanceNumber>
              <AllocationPolicy>Evenly</AllocationPolicy>
              <HostReplacePolicy>Auto</HostReplacePolicy>
              <DedicatedHostGroupId>dhg-7a9xxxxxxxx</DedicatedHostGroupId>
              <BastionInstanceId>bastionhost-cn-m7xxxxxxxx</BastionInstanceId>
              <MemAllocatedAmount>16384</MemAllocatedAmount>
              <OpenPermission>3</OpenPermission>
              <MemAllocateRation>33.7</MemAllocateRation>
              <DiskAllocatedAmount>200</DiskAllocatedAmount>
              <Engine>MySQL</Engine>
              <MemUtility>0</MemUtility>
              <MemAllocationRatio>90</MemAllocationRatio>
              <CpuAllocateRation>25</CpuAllocateRation>
              <VPCId>vpc-bp1oxxxxxx</VPCId>
              <CreateTime>1571125370000</CreateTime>
              <Text>testHostGroup/dhg-7a9xxxxxxxx</Text>
              <MemUsedAmount>0</MemUsedAmount>
              <DedicatedHostGroupDesc>testHostGroup</DedicatedHostGroupDesc>
              <DiskUtility>0</DiskUtility>
              <CpuAllocationRatio>200</CpuAllocationRatio>
              <DiskAllocateRation>0.49</DiskAllocateRation>
              <HostNumber>3</HostNumber>
              <CpuAllocatedAmount>8</CpuAllocatedAmount>
              <DedicatedHostCountGroupByHostType>dhg_cloud_ssd</DedicatedHostCountGroupByHostType>
              <ZoneIDList>
                    <ZoneIDList>cn-hangzhou</ZoneIDList>
              </ZoneIDList>
        </DedicatedHostGroups>
  </DedicatedHostGroups>
</DescribeDedicatedHostGroups>
  <DedicatedHostGroups>
        <DedicatedHostGroups>
              <DiskAllocationRatio>200</DiskAllocationRatio>
              <DiskUsedAmount>20</DiskUsedAmount>
              <InstanceNumber>4</InstanceNumber>
              <AllocationPolicy>Evenly</AllocationPolicy>
              <HostReplacePolicy>Auto</HostReplacePolicy>
              <DedicatedHostGroupId>dhg-7a9xxxxxxxx</DedicatedHostGroupId>
              <BastionInstanceId>bastionhost-cn-m7xxxxxxxx</BastionInstanceId>
              <MemAllocatedAmount>16384</MemAllocatedAmount>
              <OpenPermission>3</OpenPermission>
              <MemAllocateRation>33.7</MemAllocateRation>
              <DiskAllocatedAmount>200</DiskAllocatedAmount>
              <Engine>MySQL</Engine>
              <MemUtility>0</MemUtility>
              <MemAllocationRatio>90</MemAllocationRatio>
              <CpuAllocateRation>25</CpuAllocateRation>
              <VPCId>vpc-bp1oxxxxxx</VPCId>
              <CreateTime>1571125370000</CreateTime>
              <Text>testHostGroup/dhg-7a9xxxxxxxx</Text>
              <MemUsedAmount>0</MemUsedAmount>
              <DedicatedHostGroupDesc>testHostGroup</DedicatedHostGroupDesc>
              <DiskUtility>0</DiskUtility>
              <CpuAllocationRatio>200</CpuAllocationRatio>
              <DiskAllocateRation>0.49</DiskAllocateRation>
              <HostNumber>3</HostNumber>
              <CpuAllocatedAmount>8</CpuAllocatedAmount>
              <DedicatedHostCountGroupByHostType>dhg_cloud_ssd</DedicatedHostCountGroupByHostType>
              <ZoneIDList>
                    <ZoneIDList>cn-hangzhou</ZoneIDList>
              </ZoneIDList>
        </DedicatedHostGroups>
  </DedicatedHostGroups>
</DescribeDedicatedHostGroups>

Formato JSON

{
    "RequestId": "AB44DC0A-7E77-442A-97A9-C6418694CB22",
    "DedicatedHostGroups": {
        "DedicatedHostGroups": [{
            "DiskAllocationRatio": "200",
            "DiskUsedAmount": "20",
            "InstanceNumber": "4",
            "AllocationPolicy": "Evenly",
            "HostReplacePolicy": "Auto",
            "DedicatedHostGroupId": "dhg-7a9xxxxxxxx",
            "BastionInstanceId": "bastionhost-cn-m7xxxxxxxx",
            "MemAllocatedAmount": "16384",
            "OpenPermission": "3",
            "MemAllocateRation": "33.7",
            "DiskAllocatedAmount": "200",
            "Engine": "MySQL",
            "MemUtility": "0",
            "MemAllocationRatio": "90",
            "CpuAllocateRation": "25",
            "VPCId": "vpc-bp1oxxxxxx",
            "CreateTime": "1571125370000",
            "Text": "testHostGroup/dhg-7a9xxxxxxxx",
            "MemUsedAmount": "0",
            "DedicatedHostGroupDesc": "testHostGroup",
            "DiskUtility": "0",
            "CpuAllocationRatio": "200",
            "DiskAllocateRation": "0.49",
            "HostNumber": "3",
            "CpuAllocatedAmount": "8",
            "DedicatedHostCountGroupByHostType": "dhg_cloud_ssd",
            "ZoneIDList": {
                "ZoneIDList": "cn-hangzhou"
            }
        }]
    }
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.