DescribeDedicatedHosts - - Centro de documentación de Alibaba Cloud

Consulta los detalles de los hosts dedicados, incluidas las especificaciones de rendimiento físico, los códigos de máquina y los estados de servicio de los hosts dedicados, así como las instancias de Elastic Compute Service (ECS) creadas en dichos hosts.

Notas de uso

Utilice uno de los siguientes métodos para consultar los detalles de los hosts dedicados:

Especifique DedicatedHostIds para consultar los detalles de los hosts dedicados.
Especifique DedicatedHostClusterId para consultar los detalles de los hosts dedicados en un clúster de hosts dedicados.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	DescribeDedicatedHosts	La operación que desea ejecutar. Establezca el valor en DescribeDedicatedHosts.
RegionId	String	Sí	cn-hangzhou	El ID de región del host dedicado. Puede invocar la operación DescribeRegions para consultar la lista de regiones más reciente.
ZoneId	String	No	cn-hangzhou-g	El ID de zona del host dedicado. Puede invocar la operación DescribeZones para consultar la lista de zonas más reciente.
DedicatedHostIds	String	No	["dh-bp165p6xk2tlw61e**", "dh-bp1f9vxmno7emy96**"]	Los ID de los hosts dedicados. Puede especificar hasta 100 ID de hosts dedicados en una sola solicitud. Separe los ID con comas (,).
DedicatedHostName	String	No	MyDDHTestName	El nombre del host dedicado.
Status	String	No	Available	El estado de servicio del host dedicado. Valores válidos: Available: El host dedicado funciona con normalidad. UnderAssessment: El host dedicado está disponible, pero presenta riesgos potenciales que podrían provocar fallos en las instancias de ECS alojadas en él. PermanentFailure: El host dedicado ha sufrido fallos permanentes y no está disponible. TempUnavailable: El host dedicado no está disponible temporalmente. Redeploying: El host dedicado se encuentra en proceso de restauración. Valor predeterminado: Available.
DedicatedHostType	String	No	ddh.g5	El tipo de host dedicado. Puede invocar la operación DescribeDedicatedHostTypes para obtener la lista más reciente de tipos de hosts dedicados.
LockReason	String	No	financial	El motivo por el cual se bloqueó el host dedicado. Valores válidos: financial security
PageNumber	Integer	No	1	El número de entradas por página. Valor predeterminado: 1.
PageSize	Integer	No	10	El número de página. Valores válidos: de 1 a 100. Valor predeterminado: 10.
ResourceGroupId	String	No	rg-aek3b6jzp66****	El ID del resource group al que pertenece el host dedicado. Si se especifica este parámetro para consultar recursos, la respuesta puede mostrar hasta 1,000 recursos pertenecientes al resource group indicado. Nota Los recursos del resource group predeterminado se muestran en la respuesta independientemente de cómo se configure este parámetro.
Tag.N.Key	String	No	TestKey	La clave de la etiqueta N del host dedicado. Valores válidos de N: de 1 a 20. La clave de la etiqueta no puede ser una cadena vacía. Puede tener una longitud máxima de 128 caracteres y no puede comenzar con `acs:` ni con `aliyun`. Tampoco puede contener `http://` o `https://`.
Tag.N.Value	String	No	TestValue	El valor de la etiqueta N del host dedicado. Valores válidos de N: de 1 a 20. El valor de la etiqueta puede ser una cadena vacía. Puede tener una longitud máxima de 128 caracteres y no puede comenzar con `acs:` ni con `aliyun`. Tampoco puede contener `http://` o `https://`.
DedicatedHostClusterId	String	No	dc-bp12wlf6am0vz9v2****	El ID del clúster de hosts dedicados al que pertenece el host dedicado.
SocketDetails	String	No	true	Indica si se debe mostrar la información del socket. Valores válidos: true false

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
PageSize	Integer	1	El número de entradas por página.
RequestId	String	7654525A-9964-4ABB-8BCD-98F8835E809A	El ID de la solicitud.
PageNumber	Integer	5	El número de página.
TotalCount	Integer	3	El número total de hosts dedicados.
DedicatedHosts	Array of DedicatedHost		Los hosts dedicados consultados.
DedicatedHost
CreationTime	String	2018-01-01T12:00Z	La hora de creación del host dedicado. La hora sigue el estándar ISO 8601 en formato `yyyy-MM-ddTHH:mmZ`. La hora se muestra en UTC.
SchedulerOptions.ManagedPrivateSpaceId	String	mps-iq81z6pkbqjx61php46e	El ID del espacio privado administrado al que pertenece el host dedicado.
Status	String	Available	El estado de servicio del host dedicado. Valores válidos: Available: El host dedicado funciona con normalidad. UnderAssessment: El host dedicado está disponible, pero presenta riesgos potenciales que podrían provocar fallos en las instancias de ECS alojadas en él. PermanentFailure: El host dedicado ha sufrido fallos permanentes y no está disponible.
Cores	Integer	3	El número de núcleos físicos por CPU.
AutoPlacement	String	on	Indica si el host dedicado se agregó al pool de recursos para el despliegue automático. Valores válidos: on: El host dedicado se agregó al pool de recursos para el despliegue automático. off: El host dedicado no se agregó al pool de recursos para el despliegue automático. Para obtener más información sobre el despliegue automático, consulte la sección "Despliegue automático" en el tema Funciones y características.
GPUSpec	String	gpu	El modelo de GPU.
AutoReleaseTime	String	2017-01-01T12:00Z	La hora de liberación automática del host dedicado. La hora sigue el estándar ISO 8601 en formato `yyyy-MM-ddTHH:mmZ`. La hora se muestra en UTC.
ChargeType	String	Prepaid	El método de facturación del host dedicado.
CpuOverCommitRatio	Float	1	La relación de sobreasignación de CPU.
ActionOnMaintenance	String	Migrate	La directiva utilizada para migrar las instancias desplegadas en el host dedicado cuando este falla. Valores válidos: Migrate: Las instancias se migran a otro servidor físico. Las instancias que no se encuentran en estado Stopped al momento del fallo del host dedicado se reinician. Stop: Las instancias se detienen. Si el host dedicado no se puede restaurar, las instancias se migran a otro servidor físico y se reinician. Si el host dedicado tiene discos en la nube conectados, el valor predeterminado es Migrate. Si el host dedicado tiene discos locales conectados, el valor predeterminado es Stop.
SaleCycle	String	Month	La unidad del periodo de suscripción. Valores válidos: Month Year
PhysicalGpus	Integer	10	El número de GPU físicas.
RegionId	String	cn-hangzhou	El ID de región del host dedicado.
DedicatedHostName	String	MyDDHTestName	El nombre del host dedicado.
Description	String	this-is-my-DDH	La descripción del host dedicado.
DedicatedHostClusterId	String	dc-bp12wlf6am0vz9v2****	El ID del clúster de hosts dedicados al que pertenece el host dedicado.
ExpiredTime	String	2019-01-01T12:00Z	La fecha de vencimiento del host dedicado de suscripción. La hora sigue el estándar ISO 8601 en formato `yyyy-MM-ddTHH:mmZ`. La hora se muestra en UTC.
DedicatedHostType	String	ddh.g5	El tipo del host dedicado.
ResourceGroupId	String	rg-aek3b6jzp66****	El ID del resource group al que pertenece el host dedicado.
ZoneId	String	cn-hangzhou-g	El ID de zona del host dedicado.
DedicatedHostId	String	dh-bp165p6xk2tlw61e****	El ID del host dedicado.
Sockets	Integer	5	El número de CPU físicas.
MachineId	String	12aaa123456ff19dec12345d3026e****	El código de máquina del host dedicado.
Instances	Array of Instance		Las instancias de ECS creadas en el host dedicado.
Instance
InstanceType	String	ecs.g5.large	El tipo de la instancia de ECS.
InstanceId	String	i-bp14ot0ykf8w13a1****	El ID de la instancia de ECS.
SocketId	String	0,1	El ID del socket al que pertenece la instancia de ECS.
InstanceOwnerId	Long	128************0	El ID del propietario de la instancia de ECS.
OperationLocks	Array of OperationLock		Los motivos por los cuales se bloquearon los recursos del host dedicado.
OperationLock
LockReason	String	financial	El motivo por el cual se bloqueó el host dedicado. Valores válidos: financial security
Tags	Array of Tag		Las etiquetas del host dedicado.
Tag
TagValue	String	TestValue	El valor de la etiqueta del host dedicado.
TagKey	String	TestKey	La clave de la etiqueta del host dedicado.
SupportedInstanceTypeFamilies	Array of String	ecs.g5	Las familias de instancias de ECS compatibles con el host dedicado.
SupportedCustomInstanceTypeFamilies	Array of String	ecs.ddh6s.custom	Las familias de instancias de ECS personalizadas compatibles con el host dedicado.
SupportedInstanceTypesList	Array of String	ecs.g5.large	Los tipos de instancias de ECS compatibles con el host dedicado.
Capacity	Object		Las especificaciones de rendimiento del host dedicado.
AvailableMemory	Float	25	La cantidad de memoria disponible. Unidad: GiB.
LocalStorageCategory	String	i2	La familia de instancias que utiliza discos locales.
TotalMemory	Float	1024	La capacidad total de la memoria. Unidad: GiB.
TotalLocalStorage	Integer	512	La capacidad total de los discos locales. Unidad: GiB.
TotalVcpus	Integer	56	El número total de vCPU.
TotalVgpus	Integer	10	El número total de vGPU.
AvailableLocalStorage	Integer	65	La cantidad de capacidad disponible en los discos locales. Unidad: GiB.
AvailableVcpus	Integer	5	El número de vCPU disponibles.
AvailableVgpus	Integer	2	El número de vGPU disponibles.
SocketCapacities	Array of SocketCapacity		Las capacidades de los sockets.
SocketCapacity
SocketId	Integer	1	El ID del socket.
AvailableMemory	Float	65	La capacidad restante de la memoria. Unidad: GiB.
TotalMemory	Float	128	La capacidad total de la memoria. Unidad: GiB.
AvailableVcpu	Integer	64	El número total de vCPU.
TotalVcpu	Integer	128	El número de vCPU disponibles.
NetworkAttributes	Object		Los atributos de red del host dedicado.
UdpTimeout	Integer	60	El tiempo de espera de la sesión UDP establecida entre un usuario y un servicio de Alibaba Cloud en el host dedicado. Unidad: segundos. Valor válido: 60.
SlbUdpTimeout	Integer	60	El tiempo de espera de la sesión UDP establecida entre Server Load Balancer (SLB) y el host dedicado. Unidad: segundos. Valor válido: 60.
HostDetailInfo	Object		Este parámetro se eliminará en el futuro. Le recomendamos utilizar otros parámetros para garantizar la compatibilidad futura.
SerialNumber	String	null	Este parámetro se eliminará en el futuro. Le recomendamos utilizar otros parámetros para garantizar la compatibilidad futura.
DedicatedHostOwnerId	Long	100************7	El ID del propietario del host dedicado.

Ejemplos

Solicitudes de ejemplo

http(s)://ecs.aliyuncs.com/?Action=DescribeDedicatedHosts
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-g
&DedicatedHostIds=["dh-bp165p6xk2tlw61e****", "dh-bp1f9vxmno7emy96****"]
&DedicatedHostName=MyDDHTestName
&Status=Available
&DedicatedHostType=ddh.g5
&LockReason=financial
&PageNumber=1
&PageSize=10
&ResourceGroupId=rg-aek3b6jzp66****
&Tag=[{"Key":"TestKey","Value":"TestValue"}]
&DedicatedHostClusterId=dc-bp12wlf6am0vz9v2****
&SocketDetails=true
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDedicatedHostsResponse>
    <PageSize>1</PageSize>
    <RequestId>7654525A-9964-4ABB-8BCD-98F8835E809A</RequestId>
    <PageNumber>5</PageNumber>
    <TotalCount>3</TotalCount>
    <DedicatedHosts>
        <CreationTime>2018-01-01T12:00Z</CreationTime>
        <SchedulerOptions.ManagedPrivateSpaceId>mps-iq81z6pkbqjx61php46e</SchedulerOptions.ManagedPrivateSpaceId>
        <Status>Available</Status>
        <Cores>3</Cores>
        <AutoPlacement>on</AutoPlacement>
        <GPUSpec>gpu</GPUSpec>
        <AutoReleaseTime>2017-01-01T12:00Z</AutoReleaseTime>
        <ChargeType>Prepaid</ChargeType>
        <CpuOverCommitRatio>1</CpuOverCommitRatio>
        <ActionOnMaintenance>Migrate</ActionOnMaintenance>
        <SaleCycle>Month</SaleCycle>
        <PhysicalGpus>10</PhysicalGpus>
        <RegionId>cn-hangzhou</RegionId>
        <DedicatedHostName>MyDDHTestName</DedicatedHostName>
        <Description>this-is-my-DDH</Description>
        <DedicatedHostClusterId>dc-bp12wlf6am0vz9v2****</DedicatedHostClusterId>
        <ExpiredTime>2019-01-01T12:00Z</ExpiredTime>
        <DedicatedHostType>ddh.g5</DedicatedHostType>
        <ResourceGroupId>rg-aek3b6jzp66****</ResourceGroupId>
        <ZoneId>cn-hangzhou-g</ZoneId>
        <DedicatedHostId>dh-bp165p6xk2tlw61e****</DedicatedHostId>
        <Sockets>5</Sockets>
        <MachineId>12aaa123456ff19dec12345d3026e****</MachineId>
        <Instances>
            <InstanceType>ecs.g5.large</InstanceType>
            <InstanceId>i-bp14ot0ykf8w13a1****</InstanceId>
            <SocketId>0,1</SocketId>
        </Instances>
        <OperationLocks>
            <LockReason>financial</LockReason>
        </OperationLocks>
        <Tags>
            <TagValue>TestValue</TagValue>
            <TagKey>TestKey</TagKey>
        </Tags>
        <SupportedInstanceTypeFamilies>ecs.g5</SupportedInstanceTypeFamilies>
        <SupportedCustomInstanceTypeFamilies>ecs.ddh6s.custom</SupportedCustomInstanceTypeFamilies>
        <SupportedInstanceTypesList>ecs.g5.large</SupportedInstanceTypesList>
        <Capacity>
            <AvailableMemory>25</AvailableMemory>
            <LocalStorageCategory>i2</LocalStorageCategory>
            <TotalMemory>1024</TotalMemory>
            <TotalLocalStorage>512</TotalLocalStorage>
            <TotalVcpus>56</TotalVcpus>
            <TotalVgpus>10</TotalVgpus>
            <AvailableLocalStorage>65</AvailableLocalStorage>
            <AvailableVcpus>5</AvailableVcpus>
            <AvailableVgpus>2</AvailableVgpus>
            <SocketCapacities>
                <SocketId>1</SocketId>
                <AvailableMemory>65</AvailableMemory>
                <TotalMemory>128</TotalMemory>
                <AvailableVcpu>64</AvailableVcpu>
                <TotalVcpu>128</TotalVcpu>
            </SocketCapacities>
        </Capacity>
        <NetworkAttributes>
            <UdpTimeout>60</UdpTimeout>
            <SlbUdpTimeout>60</SlbUdpTimeout>
        </NetworkAttributes>
        <HostDetailInfo>
            <SerialNumber>null</SerialNumber>
        </HostDetailInfo>
    </DedicatedHosts>
</DescribeDedicatedHostsResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageSize" : 1,
  "RequestId" : "7654525A-9964-4ABB-8BCD-98F8835E809A",
  "PageNumber" : 5,
  "TotalCount" : 3,
  "DedicatedHosts" : [ {
    "CreationTime" : "2018-01-01T12:00Z",
    "SchedulerOptions.ManagedPrivateSpaceId" : "mps-iq81z6pkbqjx61php46e",
    "Status" : "Available",
    "Cores" : 3,
    "AutoPlacement" : "on",
    "GPUSpec" : "gpu",
    "AutoReleaseTime" : "2017-01-01T12:00Z",
    "ChargeType" : "Prepaid",
    "CpuOverCommitRatio" : 1,
    "ActionOnMaintenance" : "Migrate",
    "SaleCycle" : "Month",
    "PhysicalGpus" : 10,
    "RegionId" : "cn-hangzhou",
    "DedicatedHostName" : "MyDDHTestName",
    "Description" : "this-is-my-DDH",
    "DedicatedHostClusterId" : "dc-bp12wlf6am0vz9v2****",
    "ExpiredTime" : "2019-01-01T12:00Z",
    "DedicatedHostType" : "ddh.g5",
    "ResourceGroupId" : "rg-aek3b6jzp66****",
    "ZoneId" : "cn-hangzhou-g",
    "DedicatedHostId" : "dh-bp165p6xk2tlw61e****",
    "Sockets" : 5,
    "MachineId" : "12aaa123456ff19dec12345d3026e****",
    "Instances" : [ {
      "InstanceType" : "ecs.g5.large",
      "InstanceId" : "i-bp14ot0ykf8w13a1****",
      "SocketId" : "0,1"
    } ],
    "OperationLocks" : [ {
      "LockReason" : "financial"
    } ],
    "Tags" : [ {
      "TagValue" : "TestValue",
      "TagKey" : "TestKey"
    } ],
    "SupportedInstanceTypeFamilies" : [ "ecs.g5" ],
    "SupportedCustomInstanceTypeFamilies" : [ "ecs.ddh6s.custom" ],
    "SupportedInstanceTypesList" : [ "ecs.g5.large" ],
    "Capacity" : {
      "AvailableMemory" : 25,
      "LocalStorageCategory" : "i2",
      "TotalMemory" : 1024,
      "TotalLocalStorage" : 512,
      "TotalVcpus" : 56,
      "TotalVgpus" : 10,
      "AvailableLocalStorage" : 65,
      "AvailableVcpus" : 5,
      "AvailableVgpus" : 2,
      "SocketCapacities" : [ {
        "SocketId" : 1,
        "AvailableMemory" : 65,
        "TotalMemory" : 128,
        "AvailableVcpu" : 64,
        "TotalVcpu" : 128
      } ]
    },
    "NetworkAttributes" : {
      "UdpTimeout" : 60,
      "SlbUdpTimeout" : 60
    },
    "HostDetailInfo" : {
      "SerialNumber" : "null"
    }
  } ]
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidStatus.ValueNotSupported	The pecified dedicated host status is not supported.	Esta operación no se puede realizar en el host dedicado en su estado actual.
400	MissingParamter.RegionId	The regionId should not be null.	RegionId es obligatorio.
400	InvalidParameter.DedicatedHostIds	The specified parameter dedicatedHostIds is not valid.	El valor de DedicatedHostIds no es válido.
400	InvalidRegion.NotFound	The specified parameter RegionId is not valid.	El valor de RegionId no es válido.
400	InvalidZone.NotFound	The specified parameter ZoneId is not valid.	El valor de ZoneId no es válido.
403	InvalidDedicatedHostIds.Malformed	The amount of specified dedicatedHostIds exceeds the limit.	Se especificaron más de 100 ID de hosts dedicados en el valor de DedicatedHostIds.
404	InvalidLockReason.NotFound	The specified LockReason is not found.	No se encontró el valor especificado de LockReason.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.