Consulta de clústeres dedicados - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación DescribeDedicatedHostGroups para consultar la información de uno o varios clústeres dedicados.

Los clústeres dedicados permiten gestionar varias instancias simultáneamente. Puede crear varios clústeres dedicados en una sola región. Cada clúster dedicado se compone de varios hosts y permite crear varias instancias en cada uno. Para obtener más información, consulte ¿Qué es ApsaraDB MyBase?.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación desde OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	Query dedicated clusters	La operación que desea ejecutar. Establezca el valor en DescribeDedicatedHostGroups.
RegionId	String	Sí	cn-hangzhou	El ID de región de los clústeres dedicados. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
DedicatedHostGroupId	String	No	dhg-7a9xxxxxxxx	El ID del clúster dedicado.
ImageCategory	String	No	WindowsWithMssqlStdLicense	La imagen base con la que se crean los hosts en los clústeres dedicados. Valores válidos: WindowsWithMssqlStdLicense: imagen de Windows que incluye las licencias de SQL Server Standard Edition. WindowsWithMssqlEntLisence: imagen de Windows que incluye las licencias de SQL Server Enterprise Edition. WindowsWithMssqlWebLisence: imagen de Windows que incluye las licencias de SQL Server Web Edition. AliLinux: imagen de Linux.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
DedicatedHostGroups	Array of DedicatedHostGroups		Arreglo que contiene los clústeres dedicados devueltos.
DedicatedHostGroups
AllocationPolicy	String	Evenly	La directiva que utiliza el sistema para asignar recursos en el clúster dedicado. Valores válidos: Evenly: el sistema distribuye los recursos uniformemente entre todos los hosts del clúster dedicado. Intensively: el sistema asigna prioritariamente los recursos a los hosts con mayor carga dentro del clúster dedicado.
BastionInstanceId	String	bastionhost-cn-m7xxxxxxxx	El ID del bastion host.
CpuAllocateRation	Float	25	El porcentaje de núcleos asignados en el clúster dedicado. Unidad: %.
CpuAllocatedAmount	Float	8	La cantidad de núcleos asignados en el clúster dedicado.
CpuAllocationRatio	Integer	200	La relación de sobreasignación de núcleos del clúster dedicado. Unidad: %. Para obtener más información sobre esta relación, consulte Gestión de un clúster dedicado.
CreateTime	String	1571125370000	La marca de tiempo de creación del clúster dedicado.
DedicatedHostCountGroupByHostType	Map	dhg_cloud_ssd	El tipo de medio de almacenamiento que utilizan los hosts del clúster dedicado. Valores válidos: dhg_cloud_ssd: unidad de estado sólido (SSD) estándar o mejorada. dhg_local_ssd: SSD local.
DedicatedHostGroupDesc	String	testHostGroup	El nombre del clúster dedicado.
DedicatedHostGroupId	String	dhg-7a9xxxxxxxx	El ID del clúster dedicado.
DiskAllocateRation	Float	0.49	El porcentaje de espacio en disco asignado en el clúster dedicado. Unidad: %.
DiskAllocatedAmount	Float	200	La cantidad de espacio en disco asignado en el clúster dedicado. Unidad: GB.
DiskAllocationRatio	Integer	200	La relación de sobreasignación de disco del clúster dedicado. Unidad: %. Para obtener más información sobre esta relación, consulte Gestión de un clúster dedicado.
DiskUsedAmount	Float	20	La cantidad de espacio en disco utilizado en el clúster dedicado. Unidad: GB.
DiskUtility	Float	0	El uso de disco del clúster dedicado. Unidad: %.
Engine	String	MySQL	El motor de base de datos que ejecutan las instancias del clúster dedicado.
HostNumber	Integer	3	El número total de hosts en el clúster dedicado.
HostReplacePolicy	String	Auto	La directiva que utiliza el sistema para manejar fallos en los hosts. Valores válidos: Auto: el sistema reemplaza automáticamente los hosts defectuosos. Manual: debe reemplazar manualmente los hosts defectuosos.
InstanceNumber	Integer	4	El número total de instancias en el clúster dedicado.
MemAllocateRation	Float	33.7	El porcentaje de memoria asignada en el clúster dedicado. Unidad: %.
MemAllocatedAmount	Float	16384	La cantidad de memoria asignada en el clúster dedicado.
MemAllocationRatio	Integer	90	La relación de sobreasignación de memoria del clúster dedicado. Unidad: %. Para obtener más información sobre esta relación, consulte Gestión de un clúster dedicado.
MemUsedAmount	Float	0	La cantidad de memoria utilizada en el clúster dedicado. Unidad: MB.
MemUtility	Float	0	El uso de memoria del clúster dedicado. Unidad: %.
OpenPermission	String	3	Indica si es posible otorgar permisos del sistema operativo en los hosts del clúster dedicado. Valores válidos: 0 o null: no es posible otorgar los permisos. 1: es posible otorgar los permisos. 3: los permisos ya se han otorgado.
Text	String	testHostGroup/dhg-7a9xxxxxxxx	El nombre y el ID del clúster dedicado. El valor de este parámetro consta de dos partes: el valor del parámetro DedicatedHostGroupDesc y el valor del parámetro DedicatedHostGroupId. Formato: DedicatedHostGroupDesc/DedicatedHostGroupId.
VPCId	String	vpc-bp1oxxxxxx	El ID de la virtual private cloud (VPC) a la que pertenece el clúster dedicado.
ZoneIDList	List	cn-hangzhou	Lista de zonas a las que pertenecen los hosts del clúster dedicado.
RequestId	String	AB44DC0A-7E77-442A-97A9-C6418694CB22	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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

Respuestas de éxito de ejemplo

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 error

Para obtener una lista de códigos de error, visite el Centro de errores de API.