Interroger les clusters dédiés - - Centre de documentation Alibaba Cloud

Appelez l'opération DescribeDedicatedHostGroups pour interroger les informations relatives à un ou plusieurs clusters dédiés.

Les clusters dédiés vous permettent de gérer plusieurs instances simultanément. Vous pouvez créer plusieurs clusters dédiés au sein d'une même région. Chaque cluster dédié est constitué de plusieurs hôtes, sur lesquels vous pouvez déployer plusieurs instances. Pour plus d'informations, consultez la rubrique Présentation d'ApsaraDB MyBase

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération via OpenAPI Explorer, qui génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	Interroger les clusters dédiés	Opération à exécuter. Définissez la valeur sur DescribeDedicatedHostGroups.
RegionId	String	Oui	cn-hangzhou	ID de région des clusters dédiés. Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes.
DedicatedHostGroupId	String	Non	dhg-7a9xxxxxxxx	ID du cluster dédié.
ImageCategory	String	Non	WindowsWithMssqlStdLicense	Image sur laquelle les hôtes des clusters dédiés sont créés. Valeurs possibles : WindowsWithMssqlStdLicense : image Windows incluant les licences SQL Server Standard Edition WindowsWithMssqlEntLisence : image Windows incluant les licences SQL Server Enterprise Edition WindowsWithMssqlWebLisence : image Windows incluant les licences SQL Server Web Edition AliLinux : image Linux

Paramètres de réponse

Paramètre	Type	Exemple	Description
DedicatedHostGroups	Array of DedicatedHostGroups		Tableau contenant les clusters dédiés renvoyés.
DedicatedHostGroups
AllocationPolicy	String	Evenly	Politique d'allocation des ressources dans le cluster dédié. Valeurs possibles : Evenly : le système répartit uniformément les ressources sur tous les hôtes du cluster dédié. Intensively : le système attribue les ressources en priorité aux hôtes les plus chargés du cluster dédié.
BastionInstanceId	String	bastionhost-cn-m7xxxxxxxx	ID de l'hôte bastion.
CpuAllocateRation	Float	25	Pourcentage de cœurs alloués dans le cluster dédié. Unité : %.
CpuAllocatedAmount	Float	8	Nombre de cœurs alloués dans le cluster dédié.
CpuAllocationRatio	Integer	200	Taux de surallocation des cœurs du cluster dédié. Unité : %. Pour plus d'informations sur ce taux, consultez la rubrique Gérer un cluster dédié.
CreateTime	String	1571125370000	Horodatage de création du cluster dédié.
DedicatedHostCountGroupByHostType	Map	dhg_cloud_ssd	Type de support de stockage utilisé par les hôtes du cluster dédié. Valeurs possibles : dhg_cloud_ssd : SSD standard ou amélioré dhg_local_ssd : SSD local
DedicatedHostGroupDesc	String	testHostGroup	Nom du cluster dédié.
DedicatedHostGroupId	String	dhg-7a9xxxxxxxx	ID du cluster dédié.
DiskAllocateRation	Float	0.49	Pourcentage d'espace disque alloué dans le cluster dédié. Unité : %.
DiskAllocatedAmount	Float	200	Espace disque alloué dans le cluster dédié. Unité : Go.
DiskAllocationRatio	Integer	200	Taux de surallocation du disque du cluster dédié. Unité : %. Pour plus d'informations sur ce taux, consultez la rubrique Gérer un cluster dédié.
DiskUsedAmount	Float	20	Espace disque utilisé dans le cluster dédié. Unité : Go.
DiskUtility	Float	0	Utilisation du disque du cluster dédié. Unité : %.
Engine	String	MySQL	Moteur de base de données exécuté sur les instances du cluster dédié.
HostNumber	Integer	3	Nombre total d'hôtes dans le cluster dédié.
HostReplacePolicy	String	Auto	Politique de gestion des pannes d'hôtes. Valeurs possibles : Auto : le système remplace automatiquement les hôtes défaillants. Manual : vous devez remplacer manuellement les hôtes défaillants.
InstanceNumber	Integer	4	Nombre total d'instances dans le cluster dédié.
MemAllocateRation	Float	33.7	Pourcentage de mémoire allouée dans le cluster dédié. Unité : %.
MemAllocatedAmount	Float	16384	Quantité de mémoire allouée dans le cluster dédié.
MemAllocationRatio	Integer	90	Taux de surallocation de la mémoire du cluster dédié. Unité : %. Pour plus d'informations sur ce taux, consultez la rubrique Gérer un cluster dédié.
MemUsedAmount	Float	0	Quantité de mémoire utilisée dans le cluster dédié. Unité : Mo.
MemUtility	Float	0	Utilisation de la mémoire du cluster dédié. Unité : %.
OpenPermission	String	3	Indique si les autorisations du système d'exploitation des hôtes du cluster dédié peuvent être accordées. Valeurs possibles : 0 ou null : les autorisations ne peuvent pas être accordées. 1 : les autorisations peuvent être accordées. 3 : les autorisations ont été accordées.
Text	String	testHostGroup/dhg-7a9xxxxxxxx	Nom et ID du cluster dédié. La valeur de ce paramètre se compose de deux parties : la valeur du paramètre DedicatedHostGroupDesc et celle du paramètre DedicatedHostGroupId. Format : DedicatedHostGroupDesc/DedicatedHostGroupId.
VPCId	String	vpc-bp1oxxxxxx	ID du VPC (Virtual Private Cloud) auquel appartient le cluster dédié.
ZoneIDList	List	cn-hangzhou	Liste des zones auxquelles appartiennent les hôtes du cluster dédié.
RequestId	String	AB44DC0A-7E77-442A-97A9-C6418694CB22	ID de la requête.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format 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>

Format 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"
            }
        }]
    }
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.