Consulta de hosts en un clúster dedicado - - Centro de documentación de Alibaba Cloud

Puede llamar a la operación DescribeDedicatedHosts para consultar la información de uno o varios hosts en un clúster dedicado.

Los clústeres dedicados permiten gestionar varias instancias simultáneamente. Es posible crear varios clústeres dedicados en una sola región. Cada clúster dedicado consta de varios hosts y, en cada host, se pueden crear varias instancias. 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 en 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 hosts in dedicated cluster	La operación que desea ejecutar. Establezca el valor en DescribeDedicatedHosts.
DedicatedHostGroupId	String	Sí	dhg-7a9xxxxxxxx	El ID del clúster dedicado. Puede llamar a la operación DescribeDedicatedHostGroups para consultar los ID de los clústeres dedicados.
RegionId	String	No	cn-hangzhou	El ID de región de los hosts. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
OrderId	Long	No	102565235	El ID del pedido.
HostType	String	No	dhg_cloud_ssd	El tipo de medio de almacenamiento utilizado en los hosts. Valores válidos: dhg_cloud_ssd: unidad de estado sólido (SSD) mejorada dhg_local_ssd: SSD local
HostStatus	String	No	1	El estado de los hosts. Valores válidos: 0: consulta los hosts que se están creando 1: consulta los hosts en ejecución 2: consulta los hosts con fallas 3: consulta los hosts que se están reemplazando 4: consulta los hosts obsoletos 5: consulta los hosts que se están eliminando 6: consulta los hosts que se están reiniciando
AllocationStatus	String	No	1	Especifica si se deben consultar los hosts donde puede crear instancias o aquellos donde no es posible hacerlo. Valores válidos: 0: consulta los hosts donde no puede crear instancias 1: consulta los hosts donde puede crear instancias
ZoneId	String	No	cn-hangzhou-i	El ID de zona de los hosts.
DedicatedHostId	String	No	ch-t4nn100ddxxxxxxxx	El ID del host.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
DedicatedHostGroupId	String	dhg-7a9xxxxxxxx	El ID del clúster dedicado.
DedicatedHosts	Array of DedicatedHosts		Una matriz compuesta por los hosts devueltos.
DedicatedHosts
AccountName	String	test123	La cuenta del host. Puede llamar a la operación CreateDedicatedHostAccount para crear una cuenta de host.
AllocationStatus	String	1	Indica si el sistema permite crear instancias en el host. Valores válidos: 0: El sistema no permite crear instancias en el host. 1: El sistema permite crear instancias en el host.
BastionInstanceId	String	bastionhost-cn-m7xxxxxxxx	El ID del bastion host.
CPUAllocationRatio	String	200	La relación de sobreasignación de núcleos del clúster dedicado. Unidad: %. Para obtener más información sobre la relación de sobreasignación de núcleos, consulte Gestión de un clúster dedicado.
CpuUsed	String	4	El número de núcleos utilizados en el host.
CreatedTime	String	2021-03-25 17:29:06.0	La hora en que se creó el host.
DedicatedHostGroupId	String	dhg-7a9xxxxxxxx	El ID del clúster dedicado.
DedicatedHostId	String	i-bpxxxxxxx	El ID del host.
DiskAllocationRatio	String	200	La relación de sobreasignación de disco del clúster dedicado. Unidad: %. Para obtener más información sobre la relación de sobreasignación de disco, consulte Gestión de un clúster dedicado.
EndTime	String	2021-04-25T16:00:00Z	La hora en que caduca el host.
Engine	String	mysql	El motor de base de datos de las instancias creadas en el host.
HostCPU	String	8	El número total de núcleos configurados para el host.
HostClass	String	ecs.i2.16xlarge	Las especificaciones del host.
HostMem	String	32238	El espacio total de memoria del host. Unidad: MB.
HostName	String	testHost1	El nombre del host.
HostStatus	String	1	El estado del host. Valores válidos: 0: El host se está creando. 1: El host está en ejecución. 2: El host tiene fallas. 3: El host se está reemplazando. 4: El host es obsoleto. 5: El host se está eliminando. 6: El host se está reiniciando.
HostStorage	String	2097152	La capacidad de almacenamiento del host. Unidad: MB.
HostType	String	dhg_cloud_ssd	El tipo de medio de almacenamiento utilizado en el host. Valores válidos: dhg_cloud_ssd: SSD mejorada dhg_local_ssd: SSD local
IPAddress	String	192.xx.xx.xx	La dirección IP interna del host.
ImageCategory	String	WindowsWithMssqlStdLicense	La imagen del host. Este parámetro solo se devuelve cuando el parámetro Engine está establecido en mssql. Valores válidos: WindowsWithMssqlStdLicense: una imagen de Windows que contiene las licencias de SQL Server Standard Edition WindowsWithMssqlEntLisence: una imagen de Windows que contiene las licencias de SQL Server Enterprise Edition WindowsWithMssqlWebLisence: una imagen de Windows que contiene las licencias de SQL Server Web Edition
InstanceNumber	String	4	El número total de instancias creadas en el host.
MemAllocationRatio	String	90	El uso máximo de memoria por host en el clúster dedicado.
MemoryUsed	String	16384	La cantidad de espacio de memoria utilizado en el host. Unidad: MB.
OpenPermission	String	3	Indica si se pueden otorgar permisos del sistema operativo del host. Valores válidos: 0 o null: No se pueden otorgar los permisos. 1: Se pueden otorgar los permisos. 3: Los permisos ya se han otorgado.
StorageUsed	String	0	La cantidad de espacio de almacenamiento utilizado en el host.
VPCId	String	vpc-bpxxxxxxx	El ID de la virtual private cloud (VPC) a la que pertenece el host.
VSwitchId	String	vsw-bpxxxxxxx	El ID del vSwitch asociado con la VPC especificada.
ZoneId	String	cn-hangzhou-i	El ID de zona del host.
RequestId	String	C860658E-68A6-46C1-AF6E-3AE7C4D3CACF	El ID de la solicitud.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato XML

<DescribeDedicatedHostsResponse>
      <DedicatedHosts>
            <DedicatedHosts>
                  <CPUAllocationRatio>200</CPUAllocationRatio>
                  <DiskAllocationRatio>200</DiskAllocationRatio>
                  <DedicatedHostId>i-bpxxxxxxx</DedicatedHostId>
                  <InstanceNumber>4</InstanceNumber>
                  <CreatedTime>2021-03-25 17:29:06.0</CreatedTime>
                  <EndTime>2021-04-25T16:00:00Z</EndTime>
                  <DedicatedHostGroupId>dhg-7a9xxxxxxxx</DedicatedHostGroupId>
                  <BastionInstanceId>bastionhost-cn-m7xxxxxxxx</BastionInstanceId>
                  <ImageCategory>WindowsWithMssqlStdLicense</ImageCategory>
                  <HostStorage>2097152</HostStorage>
                  <OpenPermission>3</OpenPermission>
                  <HostType>dhg_cloud_ssd</HostType>
                  <HostMem>32238</HostMem>
                  <MemoryUsed>16384</MemoryUsed>
                  <HostStatus>1</HostStatus>
                  <CpuUsed>4</CpuUsed>
                  <Engine>mysql</Engine>
                  <HostName>testHost1</HostName>
                  <AllocationStatus>1</AllocationStatus>
                  <ZoneId>cn-hangzhou-i</ZoneId>
                  <MemAllocationRatio>90</MemAllocationRatio>
                  <VPCId>vpc-bpxxxxxxx</VPCId>
                  <VSwitchId>vsw-bpxxxxxxx</VSwitchId>
                  <StorageUsed>0</StorageUsed>
                  <HostClass>ecs.i2.16xlarge</HostClass>
                  <HostCPU>8</HostCPU>
                  <IPAddress>192.xx.xx.xx</IPAddress>
                  <AccountName>test123</AccountName>
            </DedicatedHosts>
      </DedicatedHosts>
      <RequestId>C860658E-68A6-46C1-AF6E-3AE7C4D3CACF</RequestId>
      <DedicatedHostGroupId>dhg-7a9xxxxxxxx</DedicatedHostGroupId>
</DescribeDedicatedHostsResponse>
            <DedicatedHosts>
                  <CPUAllocationRatio>200</CPUAllocationRatio>
                  <DiskAllocationRatio>200</DiskAllocationRatio>
                  <DedicatedHostId>i-bpxxxxxxx</DedicatedHostId>
                  <InstanceNumber>4</InstanceNumber>
                  <CreatedTime>2021-03-25 17:29:06.0</CreatedTime>
                  <EndTime>2021-04-25T16:00:00Z</EndTime>
                  <DedicatedHostGroupId>dhg-7a9xxxxxxxx</DedicatedHostGroupId>
                  <BastionInstanceId>bastionhost-cn-m7xxxxxxxx</BastionInstanceId>
                  <ImageCategory>WindowsWithMssqlStdLicense</ImageCategory>
                  <HostStorage>2097152</HostStorage>
                  <OpenPermission>3</OpenPermission>
                  <HostType>dhg_cloud_ssd</HostType>
                  <HostMem>32238</HostMem>
                  <MemoryUsed>16384</MemoryUsed>
                  <HostStatus>1</HostStatus>
                  <CpuUsed>4</CpuUsed>
                  <Engine>mysql</Engine>
                  <HostName>testHost1</HostName>
                  <AllocationStatus>1</AllocationStatus>
                  <ZoneId>cn-hangzhou-i</ZoneId>
                  <MemAllocationRatio>90</MemAllocationRatio>
                  <VPCId>vpc-bpxxxxxxx</VPCId>
                  <VSwitchId>vsw-bpxxxxxxx</VSwitchId>
                  <StorageUsed>0</StorageUsed>
                  <HostClass>ecs.i2.16xlarge</HostClass>
                  <HostCPU>8</HostCPU>
                  <IPAddress>192.xx.xx.xx</IPAddress>
                  <AccountName>test123</AccountName>
            </DedicatedHosts>
      </DedicatedHosts>
      <RequestId>C860658E-68A6-46C1-AF6E-3AE7C4D3CACF</RequestId>
      <DedicatedHostGroupId>dhg-7a9xxxxxxxx</DedicatedHostGroupId>
</DescribeDedicatedHostsResponse>

Formato JSON

{
    "DedicatedHosts": {
        "DedicatedHosts": [{
            "CPUAllocationRatio": "200",
            "DiskAllocationRatio": "200",
            "DedicatedHostId": "i-bpxxxxxxx",
            "InstanceNumber": "4",
            "CreatedTime": "2021-03-25 17:29:06.0",
            "EndTime": "2021-04-25T16:00:00Z",
            "DedicatedHostGroupId": "dhg-7a9xxxxxxxx",
            "BastionInstanceId": "bastionhost-cn-m7xxxxxxxx",
            "ImageCategory": "WindowsWithMssqlStdLicense",
            "HostStorage": "2097152",
            "OpenPermission": "3",
            "HostType": "dhg_cloud_ssd",
            "HostMem": "32238",
            "MemoryUsed": "16384",
            "HostStatus": "1",
            "CpuUsed": "4",
            "Engine": "mysql",
            "HostName": "testHost1",
            "AllocationStatus": "1",
            "ZoneId": "cn-hangzhou-i",
            "MemAllocationRatio": "90",
            "VPCId": "vpc-bpxxxxxxx",
            "VSwitchId": "vsw-bpxxxxxxx",
            "StorageUsed": "0",
            "HostClass": "ecs.i2.16xlarge",
            "HostCPU": "8",
            "IPAddress": "192.xx.xx.xx",
            "AccountName": "test123"
        }]
    },
    "RequestId": "C860658E-68A6-46C1-AF6E-3AE7C4D3CACF",
    "DedicatedHostGroupId": "dhg-7a9xxxxxxxx"
}

Códigos de error

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