DescribeInstances - - Centro de documentación de Alibaba Cloud

Consulta los detalles de las instancias de Elastic Compute Service (ECS).

Notas de uso

Puede especificar varios parámetros de solicitud para filtrar los resultados de la consulta. Los parámetros especificados tienen una relación lógica AND. Solo los parámetros indicados se incluyen en las condiciones de filtro. Sin embargo, si InstanceIds se establece como un arreglo JSON vacío, se considera una condición de filtro válida y se devuelve un resultado vacío.
Si utiliza un usuario de Resource Access Management (RAM) o un rol de RAM que no tiene permisos para llamar a esta operación, se devuelve una lista vacía. Puede incluir el parámetro DryRun en su solicitud para comprobar si la lista vacía se debe a la falta de permisos.
Cuando llama a una operación de API mediante Alibaba Cloud CLI, debe especificar los valores de los parámetros de solicitud de distintos tipos de datos en los formatos requeridos. Para obtener más información, consulte Parameter format overview.
Utilice uno de los siguientes métodos para revisar las respuestas:
- Método 1: Durante una consulta paginada, al llamar a la operación DescribeInstances para recuperar la primera página de resultados, establezca MaxResults para especificar el número máximo de entradas que se devolverán en la llamada. El valor devuelto de NextToken es un token de paginación, el cual puede usarse en la siguiente solicitud para recuperar una nueva página de resultados. Cuando llame a la operación DescribeInstances para obtener una nueva página, establezca NextToken con el valor de NextToken devuelto en la llamada anterior y configure MaxResults para indicar el número máximo de entradas a devolver en dicha llamada.
- Método 2: Utilice PageSize para especificar el número de entradas por página y luego use PageNumber para indicar el número de página a devolver.
  
  Solo puede utilizar uno de los métodos anteriores. Si se van a devolver muchas entradas, se recomienda usar el método 1. Cuando se especifica MaxResults o NextToken, los parámetros de solicitud PageSize y PageNumber no surten efecto y el parámetro de respuesta TotalCount no es válido.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor 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í	DescribeInstances	La operación que desea ejecutar. Establezca el valor en DescribeInstances.
RegionId	String	Sí	cn-hangzhou	El ID de región de la instancia. Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.
VpcId	String	No	v-bp67acfmxazb4p****	El ID de la virtual private cloud (VPC) a la que pertenece la instancia.
VSwitchId	String	No	vsw-bp67acfmxazb4p****	El ID del vSwitch al que está conectada la instancia.
ZoneId	String	No	cn-hangzhou-g	El ID de zona de la instancia.
InstanceNetworkType	String	No	vpc	El tipo de red de la instancia. Valores válidos: classic vpc
SecurityGroupId	String	No	sg-bp67acfmxazb4p****	El ID del security group al que pertenece la instancia.
InstanceIds	String	No	["i-bp67acfmxazb4p**", "i-bp67acfmxazb4p", ... "i-bp67acfmxazb4p**"]	Los ID de las instancias. El valor puede ser un arreglo JSON que contenga hasta 100 ID de instancia. Separe los ID con comas (,).
PageNumber	Integer	No	1	El número de página. Las páginas comienzan desde la página 1. Valor predeterminado: 1.
PageSize	Integer	No	10	El número de entradas por página. Valores válidos: 1 a 100. Valor predeterminado: 10.
NextToken	String	No	caeba0bbb2be03f84eb48b699f0a4883	El token de paginación que se usa en la siguiente solicitud para recuperar una nueva página de resultados. Debe especificar el token obtenido en la consulta anterior como valor de `NextToken`.
MaxResults	Integer	No	10	El número máximo de entradas por página. Valores válidos: 1 a 100. Valores predeterminados: Si este parámetro no se especifica o se establece en un valor menor a 10, el valor predeterminado es 10. Si este parámetro se establece en un valor mayor a 100, el valor predeterminado es 100.
InnerIpAddresses	String	No	["10.1.1.1", "10.1.2.1", ... "10.1.10.1"]	Las direcciones IP internas de las instancias ubicadas en la red clásica. Este parámetro es válido cuando InstanceNetworkType se establece en classic. El valor puede ser un arreglo JSON compuesto por hasta 100 direcciones IP. Separe las direcciones IP con comas (,).
PrivateIpAddresses	String	No	["172.16.1.1", "172.16.2.1", ... "172.16.10.1"]	Las direcciones IP privadas de las instancias ubicadas en VPC. Este parámetro es válido cuando InstanceNetworkType se establece en vpc. El valor puede ser un arreglo JSON compuesto por hasta 100 direcciones IP. Separe las direcciones IP con comas (,).
PublicIpAddresses	String	No	["42.1.1.", "42.1.2.", ... "42.1.10.**"]	Las direcciones IP públicas de las instancias. El valor puede ser un arreglo JSON compuesto por hasta 100 direcciones IP. Separe las direcciones IP con comas (,).
EipAddresses	String	No	["42.1.1.", "42.1.2.", ... "42.1.10.**"]	Las elastic IP addresses (EIP) de las instancias. Este parámetro es válido cuando InstanceNetworkType se establece en vpc. El valor puede ser un arreglo JSON compuesto por hasta 100 direcciones IP. Separe las direcciones IP con comas (,).
InstanceChargeType	String	No	PostPaid	El método de facturación de la instancia. Valores válidos: PostPaid: pay-as-you-go PrePaid: suscripción
InternetChargeType	String	No	PayByTraffic	El método de facturación para el uso de la red. Valores válidos: PayByBandwidth PayByTraffic Nota Cuando se utiliza el método de facturación pay-by-traffic para el uso de la red, los anchos de banda máximos de entrada y salida funcionan como límites superiores en lugar de rendimiento garantizado. En escenarios donde la demanda supera la oferta de recursos, los valores de ancho de banda máximo podrían verse limitados. Si requiere ancho de banda garantizado para sus instancias, utilice el método de facturación pay-by-bandwidth para el uso de la red.
InstanceName	String	No	Test	El nombre de la instancia. Se admite la búsqueda aproximada con caracteres comodín de asterisco (*).
ImageId	String	No	m-bp67acfmxazb4p****	El ID de la imagen.
Status	String	No	Running	El estado de la instancia. Valores válidos: Pending: La instancia se está creando. Running: La instancia se está ejecutando. Starting: La instancia se está iniciando. Stopping: La instancia se está deteniendo. Stopped: La instancia está detenida.
LockReason	String	No	security	El motivo por el cual la instancia está bloqueada. Valores válidos: financial: La instancia está bloqueada debido a pagos vencidos. security: La instancia está bloqueada por motivos de seguridad. recycling: La preemptible instance está bloqueada y pendiente de liberación. dedicatedhostfinancial: La instancia está bloqueada debido a pagos vencidos del host dedicado. refunded: La instancia está bloqueada porque se realizó un reembolso para ella.
Filter.1.Key	String	No	CreationStartTime	La clave del filtro 1 utilizada para consultar recursos. Establezca el valor en `CreationStartTime`. Puede definir una hora especificando tanto `Filter.1.Key` como `Filter.1.Value` para consultar los recursos creados después de dicha hora.
Filter.2.Key	String	No	CreationEndTime	La clave del filtro 2 utilizada para consultar recursos. Establezca el valor en `CreationEndTime`. Puede definir una hora especificando tanto `Filter.2.Key` como `Filter.2.Value` para consultar los recursos creados antes de dicha hora.
Filter.3.Key	String	No	ExpiredStartTime	La clave del filtro 3 utilizada para consultar recursos. Establezca el valor en `ExpiredStartTime`. Puede definir una hora especificando tanto `Filter.3.Key` como `Filter.3.Value` para consultar los recursos que caducan después de dicha hora.
Filter.4.Key	String	No	ExpiredEndTime	La clave del filtro 4 utilizada para consultar recursos. Establezca el valor en `ExpiredEndTime`. Puede definir una hora especificando tanto `Filter.4.Key` como `Filter.4.Value` para consultar los recursos que caducan antes de dicha hora.
Filter.1.Value	String	No	2017-12-05T22:40Z	El valor del filtro 1 utilizado para consultar recursos. Establezca el valor en una fecha y hora. Si especifica este parámetro, también debe especificar `Filter.1.Key`. Indique la hora en formato `yyyy-MM-ddTHH:mmZ`. La hora debe estar en UTC.
Filter.2.Value	String	No	2017-12-06T22:40Z	El valor del filtro 2 utilizado para consultar recursos. Establezca el valor en una fecha y hora. Si especifica este parámetro, también debe especificar `Filter.2.Key`. Indique la hora en formato `yyyy-MM-ddTHH:mmZ`. La hora debe estar en UTC.
Filter.3.Value	String	No	2017-12-07T22:40Z	El valor del filtro 3 utilizado para consultar recursos. Establezca el valor en una fecha y hora. Si especifica este parámetro, también debe especificar `Filter.3.Key`. Indique la hora en formato `yyyy-MM-ddTHH:mmZ`. La hora debe estar en UTC.
Filter.4.Value	String	No	2017-12-08T22:40Z	El valor del filtro 4 utilizado para consultar recursos. Establezca el valor en una fecha y hora. Si especifica este parámetro, también debe especificar `Filter.4.Key`. Indique la hora en formato `yyyy-MM-ddTHH:mmZ`. La hora debe estar en UTC.
DeviceAvailable	Boolean	No	false	Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
IoOptimized	Boolean	No	true	Indica si la instancia está optimizada para E/S. Valores válidos: true false
NeedSaleCycle	Boolean	No	false	Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
InstanceType	String	No	ecs.g5.large	El tipo de la instancia.
InstanceTypeFamily	String	No	ecs.g5	La familia de la instancia.
KeyPairName	String	No	KeyPairNameTest	El nombre del key pair SSH vinculado a la instancia.
ResourceGroupId	String	No	rg-bp67acfmxazb4p****	El ID del resource group al que se asignará la instancia. Si se especifica este parámetro para consultar recursos, se devuelven hasta 1,000 recursos pertenecientes al resource group indicado. Nota Las interfaces de red elásticas (ENI) del resource group predeterminado se muestran en la respuesta independientemente de cómo se configure este parámetro.
HpcClusterId	String	No	hpc-bp67acfmxazb4p****	El ID del clúster de computación de alto rendimiento (HPC) al que pertenece la instancia.
RdmaIpAddresses	String	No	10.10.10.102	Las direcciones IP de acceso remoto directo a memoria (RDMA) de la instancia que pertenece a un clúster HPC.
DryRun	Boolean	No	false	Indica si solo se realizará una prueba en seco, sin ejecutar la solicitud real. Valores válidos: true: realiza solo una prueba en seco. El sistema comprueba la solicitud en busca de posibles problemas, incluidos pares de accesskey no válidos, usuarios de RAM no autorizados y valores de parámetros faltantes. Si la solicitud no pasa la prueba, se devuelve un mensaje de error. De lo contrario, se devuelve el código de error DryRunOperation. false: realiza una prueba en seco y ejecuta la solicitud real. Si la solicitud pasa la prueba, se devuelve un código de estado HTTP 2xx y se lleva a cabo la operación. Valor predeterminado: false.
HttpEndpoint	String	No	enabled	Indica si el canal de acceso está habilitado para los metadatos de la instancia. Valores válidos: enabled disabled Valor predeterminado: enabled. Nota Para obtener más información sobre los metadatos de la instancia, consulte Overview of ECS instance metadata.
HttpTokens	String	No	optional	Indica si se fuerza el uso del modo de refuerzo de seguridad (IMDSv2) para acceder a los metadatos de la instancia. Valores válidos: optional: No se fuerza el uso del modo de refuerzo de seguridad (IMDSv2). required: Se fuerza el uso del modo de refuerzo de seguridad (IMDSv2). Después de establecer este parámetro en required, no podrá acceder a los metadatos de la instancia en modo normal. Valor predeterminado: optional. Nota Para obtener más información sobre los modos de acceso a los metadatos de la instancia, consulte Access mode of instance metadata.
HttpPutResponseHopLimit	Integer	No	0	Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
Ipv6Address.N	String	No	2408:4321:180:1701:94c7:bc38:3bfa:****	La dirección IPv6 N de la ENI. Puede especificar varias direcciones IPv6. Valores válidos de N: 1 a 100.
Tag.N.key	String	No	keyTest	La clave de la etiqueta N de la instancia. Nota Este parámetro se eliminará en el futuro. Le recomendamos utilizar el parámetro `Tag.N.Key` para garantizar la compatibilidad futura.
Tag.N.Key	String	No	TestKey	La clave de la etiqueta N de la instancia. Valores válidos de N: 1 a 20. Si se especifica una sola etiqueta para consultar recursos, se devuelven hasta 1,000 recursos que tienen agregada dicha etiqueta. Si se especifican varias etiquetas, se devuelven hasta 1,000 recursos que contienen todas esas etiquetas. Para consultar más de 1,000 recursos con las etiquetas especificadas, llame a la operación ListTagResources.
Tag.N.Value	String	No	TestValue	El valor de la etiqueta N de la instancia. Valores válidos de N: 1 a 20.
Tag.N.value	String	No	valueTest	El valor de la etiqueta N de la instancia. Nota Este parámetro se eliminará en el futuro. Le recomendamos utilizar el parámetro `Tag.N.Value` para garantizar la compatibilidad futura.
AdditionalAttributes.N	String	No	META_OPTIONS	El valor del atributo N. Valores válidos de N: 1 a 20. Valores válidos: META_OPTIONS: metadatos de la instancia DDH_CLUSTER: clúster de hosts dedicados NETWORK_PRIMARY_ENI_IP: dirección IP secundaria asociada con la ENI principal CPU_OPTIONS_TOPOLOGY_TYPE: topología de CPU de la instancia

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
NextToken	String	caeba0bbb2be03f84eb48b699f0a4883	Un token de paginación. Puede usarse en la siguiente solicitud para recuperar una nueva página de resultados.
PageSize	Integer	10	El número de entradas por página.
PageNumber	Integer	1	El número de página.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	El ID de la solicitud.
TotalCount	Integer	1	El número total de instancias consultadas. Nota Si especifica los parámetros `MaxResults` y `NextToken` para realizar una consulta paginada, el valor de `TotalCount` no es válido.
Instances	Array of Instance		Las instancias consultadas.
Instance
CreationTime	String	2017-12-10T04:04Z	La hora en que se creó la instancia. La hora sigue el estándar ISO 8601 en formato yyyy-MM-ddTHH:mm:ssZ. Se muestra en UTC. Para obtener más información, consulte ISO 8601.
SerialNumber	String	51d1353b-22bf-4567-a176-8b3e12e4****	El número de serie de la instancia.
Status	String	Running	El estado de la instancia.
DeploymentSetId	String	ds-bp67acfmxazb4p****	El ID del conjunto de despliegue donde se implementará la instancia.
KeyPairName	String	testKeyPairName	El nombre del key pair vinculado a la instancia.
SaleCycle	String	month	Nota Este parámetro ha sido eliminado.
SpotStrategy	String	NoSpot	La política de puja para la instancia pay-as-you-go. Valores válidos: NoSpot: La instancia es una instancia pay-as-you-go regular. SpotWithPriceLimit: La instancia es una preemptible instance con precios máximos por hora definidos por el usuario. SpotAsPriceGo: La instancia es una preemptible instance cuyo precio de mercado se usa automáticamente como precio de puja. El precio de mercado puede llegar hasta el precio pay-as-you-go.
DeviceAvailable	Boolean	true	Indica si se pueden adjuntar discos de datos a la instancia. true false
LocalStorageCapacity	Long	1000	La capacidad de los discos locales conectados a la instancia. Unidad: GiB.
Description	String	testDescription	La descripción de la instancia.
SpotDuration	Integer	1	El período de protección de la preemptible instance. Unidad: horas. Valores válidos: 1: Tras crear una preemptible instance, Alibaba Cloud garantiza que la instancia no se liberará automáticamente durante 1 hora. Una vez finalizado este período de protección de 1 hora, el sistema compara el precio de puja con el precio de mercado y verifica el inventario de recursos para determinar si conserva o libera la instancia. 0: Tras crear una preemptible instance, Alibaba Cloud no garantiza que la instancia se ejecute durante 1 hora. El sistema compara el precio de puja con el precio de mercado y verifica el inventario de recursos para determinar si conserva o libera la instancia. Alibaba Cloud envía un evento del sistema ECS para notificarle 5 minutos antes de que se libere la instancia. Las preemptible instances se facturan por segundo. Le recomendamos especificar un período de protección adecuado según sus necesidades comerciales. Nota Este parámetro se devuelve cuando el parámetro SpotStrategy se establece en SpotWithPriceLimit o SpotAsPriceGo.
InstanceNetworkType	String	vpc	El tipo de red de la instancia. Valores válidos: classic vpc
InstanceName	String	InstanceNameTest	El nombre de la instancia.
OSNameEn	String	CentOS 7.4 64 bit	El nombre en inglés del sistema operativo de la instancia.
HpcClusterId	String	hpc-bp67acfmxazb4p****	El ID del clúster HPC al que pertenece la instancia.
SpotPriceLimit	Float	0.98	El precio máximo por hora de la instancia. Puede tener hasta tres decimales. Este parámetro es válido cuando el parámetro SpotStrategy se establece en SpotWithPriceLimit.
Memory	Integer	16384	El tamaño de memoria de la instancia. Unidad: MiB.
OSName	String	CentOS 7.4 64-bit	El nombre del sistema operativo de la instancia.
DeploymentSetGroupNo	Integer	1	El número del grupo de conjunto de despliegue al que pertenece la instancia dentro de un conjunto de despliegue.
ImageId	String	m-bp67acfmxazb4p****	El ID de imagen de la instancia.
VlanId	String	10	El ID de la red de área local virtual (VLAN) de la instancia. Nota Este parámetro se eliminará en el futuro. Le recomendamos utilizar otros parámetros para garantizar la compatibilidad futura.
ClusterId	String	c-bp67acfmxazb4p****	El ID del clúster al que pertenece la instancia. Nota Este parámetro se eliminará en el futuro. Le recomendamos utilizar otros parámetros para garantizar la compatibilidad futura.
GPUSpec	String	NVIDIA V100	El modelo de GPU utilizado por el tipo de instancia.
AutoReleaseTime	String	2017-12-10T04:04Z	La hora en que se liberará automáticamente la instancia pay-as-you-go.
DeletionProtection	Boolean	false	El atributo de protección contra liberación de la instancia. Este parámetro indica si puede usar la consola de ECS o llamar a la operación DeleteInstance para liberar la instancia. true: La protección contra liberación estaba habilitada para la instancia. false: La protección contra liberación estaba deshabilitada para la instancia. Nota Este parámetro solo aplica a instancias pay-as-you-go. Protege las instancias contra liberaciones manuales, pero no contra liberaciones automáticas.
StoppedMode	String	KeepCharging	Indica si la instancia continúa facturándose después de detenerse. Valores válidos: KeepCharging: La instancia se detiene en modo estándar. La facturación continúa tras la detención y se conservan los recursos de la instancia. StopCharging: La instancia se detiene en modo económico. La facturación de algunos recursos se detiene tras apagar la instancia. Al detenerla, se liberan recursos como vCPU, memoria y dirección IP pública. Es posible que la instancia no pueda reiniciarse si algunos recursos necesarios están agotados en la región actual. Not-applicable: El modo económico no aplica a la instancia.
GPUAmount	Integer	4	El número de GPU utilizadas por el tipo de instancia.
HostName	String	testHostName	El nombre de host de la instancia.
InstanceId	String	i-bp67acfmxazb4p****	El ID de la instancia.
InternetMaxBandwidthOut	Integer	5	El ancho de banda público de salida máximo. Unidad: Mbit/s.
InternetMaxBandwidthIn	Integer	50	El ancho de banda público de entrada máximo. Unidad: Mbit/s.
InstanceType	String	ecs.g5.large	El tipo de instancia.
InstanceChargeType	String	PostPaid	El método de facturación de la instancia. Valores válidos: PrePaid: suscripción PostPaid: pay-as-you-go
RegionId	String	cn-hangzhou	El ID de región de la instancia.
IoOptimized	Boolean	true	Indica si la instancia está optimizada para E/S. true false
StartTime	String	2017-12-10T04:04Z	La hora en que se inició la instancia por última vez. La hora sigue el estándar ISO 8601 en formato yyyy-MM-ddTHH:mm:ssZ. Se muestra en UTC. Para obtener más información, consulte ISO 8601.
Cpu	Integer	8	El número de vCPU.
LocalStorageAmount	Integer	2	El número de discos locales conectados a la instancia.
ExpiredTime	String	2017-12-10T04:04Z	La hora en que caduca la instancia. La hora sigue el estándar ISO 8601 en formato yyyy-MM-ddTHH:mm:ssZ. Se muestra en UTC. Para obtener más información, consulte ISO 8601.
ResourceGroupId	String	rg-bp67acfmxazb4p****	El ID del resource group al que pertenece la instancia.
InternetChargeType	String	PayByTraffic	El método de facturación para el uso de la red. Valores válidos: PayByBandwidth PayByTraffic
ZoneId	String	cn-hangzhou-g	El ID de zona de la instancia.
Recyclable	Boolean	false	Indica si la instancia se puede reciclar.
ISP	String	null	Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
CreditSpecification	String	Standard	El modo de rendimiento de la instancia ampliable. Valores válidos: Standard: modo estándar. Para obtener más información, consulte la sección "Modo estándar" en Overview. Unlimited: modo ilimitado. Para obtener más información, consulte la sección "Modo ilimitado" en Overview.
InstanceTypeFamily	String	ecs.g5	La familia de la instancia.
OSType	String	linux	El tipo de sistema operativo de la instancia. Valores válidos: windows linux
NetworkInterfaces	Array of NetworkInterface		Las ENI vinculadas a la instancia.
NetworkInterface
Type	String	Primary	El tipo de ENI. Valores válidos: Primary Secondary
MacAddress	String	00:16:3e:32:b4:**	La dirección de control de acceso a medios (MAC) de la ENI.
PrimaryIpAddress	String	172.17..*	La dirección IP privada principal de la ENI.
NetworkInterfaceId	String	eni-2zeh9atclduxvf1z****	El ID de la ENI.
PrivateIpSets	Array of PrivateIpSet		Las direcciones IP privadas.
PrivateIpSet
PrivateIpAddress	String	172.17..	La dirección IP privada de la instancia.
Primary	Boolean	true	Indica si la dirección IP privada es la dirección IP privada principal. true false
Ipv6Sets	Array of Ipv6Set		Las direcciones IPv6 asignadas a la ENI. Este parámetro solo tiene valor cuando `AdditionalAttributes.N` se establece en `NETWORK_PRIMARY_ENI_IP`.
Ipv6Set
Ipv6Address	String	2408:4321:180:1701:94c7:bc38:3bfa:***	La dirección IPv6 asignada a la ENI.
Ipv4PrefixSets	Array of Ipv4PrefixSet		Los prefijos IPv4 asignados a la ENI. Este parámetro solo tiene valor cuando `AdditionalAttributes.N` se establece en `NETWORK_PRIMARY_ENI_IP`.
Ipv4PrefixSet
Ipv4Prefix	String	192.168../28	El prefijo IPv4 asignado a la ENI.
Ipv6PrefixSets	Array of Ipv6PrefixSet		Los prefijos IPv6 asignados a la ENI. Este parámetro solo tiene valor cuando `AdditionalAttributes.N` se establece en `NETWORK_PRIMARY_ENI_IP`.
Ipv6PrefixSet
Ipv6Prefix	String	2001:1111::::/80	El prefijo IPv6 asignado a la ENI.
OperationLocks	Array of LockReason		Los motivos por los cuales se bloqueó la instancia.
LockReason
LockMsg	String	The specified instance is locked due to financial reason.	El mensaje devuelto cuando se bloqueó la instancia.
LockReason	String	Recycling	El motivo por el cual se bloqueó la instancia. Valores válidos: financial: La instancia se bloqueó debido a pagos vencidos. security: La instancia se bloqueó por motivos de seguridad. recycling: La preemptible instance se bloqueó y está pendiente de liberación. dedicatedhostfinancial: La instancia se bloqueó debido a pagos vencidos del host dedicado. refunded: La instancia se bloqueó porque se realizó un reembolso para ella.
Tags	Array of Tag		Las etiquetas de la instancia.
Tag
TagValue	String	TestValue	El valor de la etiqueta de la instancia.
TagKey	String	TestKey	La clave de la etiqueta de la instancia.
RdmaIpAddress	Array of String	10.10.10.102	Las direcciones IP RDMA de la instancia que pertenece a un clúster HPC.
SecurityGroupIds	Array of String	sg-bp67acfmxazb4p****	Los ID de los security groups a los que pertenece la instancia.
PublicIpAddress	Array of String	121.40..	La dirección IP pública de la instancia.
InnerIpAddress	Array of String	10.170..	La dirección IP interna de la instancia ubicada en la red clásica.
VpcAttributes	Object		Los atributos de VPC de la instancia.
VpcId	String	vpc-2zeuphj08tt7q3brd****	El ID de la VPC.
NatIpAddress	String	172.17..	La dirección IP nat de la instancia. Se utiliza para la comunicación entre instancias de ECS en diferentes VPC.
VSwitchId	String	vsw-2zeh0r1pabwtg6wcs****	El ID del vSwitch.
PrivateIpAddress	Array of String	172.17..	La dirección IP privada de la instancia.
EipAddress	Object		La EIP asociada con la instancia.
IsSupportUnassociate	Boolean	true	Indica si la EIP se puede desasociar.
InternetChargeType	String	PayByTraffic	El método de facturación de la EIP. Valores válidos: PayByBandwidth PayByTraffic
IpAddress	String	42.112..	La EIP.
Bandwidth	Integer	5	El ancho de banda público máximo de la EIP. Unidad: Mbit/s.
AllocationId	String	eip-2ze88m67qx5z****	El ID de la EIP.
HibernationOptions	Object		Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
Configured	Boolean	false	Nota Este parámetro se encuentra en vista previa por invitación y no está disponible públicamente.
DedicatedHostAttribute	Object		La información sobre el host dedicado. Es un arreglo compuesto por los parámetros DedicatedHostClusterId, DedicatedHostId y DedicatedHostName.
DedicatedHostId	String	dh-bp67acfmxazb4p****	El ID del host dedicado.
DedicatedHostName	String	testDedicatedHostName	El nombre del host dedicado.
DedicatedHostClusterId	String	dc-bp67acfmxazb4h****	El ID del clúster de hosts dedicados al que pertenece el host dedicado.
EcsCapacityReservationAttr	Object		La reserva de capacidad asociada con la instancia.
CapacityReservationPreference	String	cr-bp67acfmxazb4p****	La preferencia de la reserva de capacidad.
CapacityReservationId	String	cr-bp67acfmxazb4p****	El ID de la reserva de capacidad.
DedicatedInstanceAttribute	Object		Los atributos de la instancia en el host dedicado.
Affinity	String	default	Indica si se debe asociar la instancia en un host dedicado con dicho host. Valores válidos: default: La instancia no está asociada con el host dedicado. Cuando la instancia se inicia desde el modo económico, podría desplegarse automáticamente en otro host dedicado dentro del pool de recursos de despliegue automático. host: La instancia está asociada con el host dedicado. Cuando la instancia se inicia desde el modo económico, permanece desplegada en el host dedicado original.
Tenancy	String	default	Indica si la instancia está alojada en un host dedicado. Valores válidos: default: La instancia no está alojada en un host dedicado. host: La instancia está alojada en un host dedicado.
CpuOptions	Object		Las opciones de CPU.
Numa	String	2	El número de subprocesos asignados. Valor válido: 2.
CoreCount	Integer	2	El número de núcleos físicos de CPU.
ThreadsPerCore	Integer	4	El número de subprocesos por núcleo de CPU.
TopologyType	String	DiscreteCoreToHTMapping	El tipo de topología de CPU de la instancia. Valores válidos: ContinuousCoreToHTMapping: Modo continuo de Hyper-Threading (HT) DiscreteCoreToHTMapping: Modo discreto de HT
MetadataOptions	Object		Las opciones de metadatos.
HttpEndpoint	String	enabled	Indica si el canal de acceso está habilitado para los metadatos de la instancia. Valores válidos: enabled disabled
HttpPutResponseHopLimit	Integer	0	Nota Este parámetro no está disponible públicamente.
HttpTokens	String	optional	Indica si se fuerza el uso del modo de refuerzo de seguridad (IMDSv2) para acceder a los metadatos de la instancia. Valores válidos: optional: No se fuerza el uso del modo de refuerzo de seguridad (IMDSv2). required: Se fuerza el uso del modo de refuerzo de seguridad (IMDSv2).
ImageOptions	Object		Las opciones de imagen.
LoginAsNonRoot	Boolean	false	Indica si la instancia que usa la imagen admite inicios de sesión del usuario ecs-user. Valores válidos: true false
SpotInterruptionBehavior	String	Terminate	El modo de interrupción de la preemptible instance cuando el sistema inicia una operación de interrupción. Valores válidos: terminate: libera la preemptible instance. Stop: detiene la instancia en modo económico.

Ejemplos

Solicitudes de ejemplo

https://ecs.aliyuncs.com/?Action=DescribeInstances
&RegionId=cn-hangzhou
&PageSize=1
&PageNumber=1
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<DescribeInstancesResponse>
    <NextToken>caeba0bbb2be03f84eb48b699f0a4883</NextToken>
    <PageSize>10</PageSize>
    <PageNumber>1</PageNumber>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <TotalCount>1</TotalCount>
    <Instances>
        <Instance>
            <CreationTime>2017-12-10T04:04Z</CreationTime>
            <SerialNumber>51d1353b-22bf-4567-a176-8b3e12e4****</SerialNumber>
            <Status>Running</Status>
            <DeploymentSetId>ds-bp67acfmxazb4p****</DeploymentSetId>
            <KeyPairName>testKeyPairName</KeyPairName>
            <SaleCycle>month</SaleCycle>
            <SpotStrategy>NoSpot</SpotStrategy>
            <DeviceAvailable>true</DeviceAvailable>
            <LocalStorageCapacity>1000</LocalStorageCapacity>
            <Description>testDescription</Description>
            <SpotDuration>1</SpotDuration>
            <InstanceNetworkType>vpc</InstanceNetworkType>
            <InstanceName>InstanceNameTest</InstanceName>
            <OSNameEn>CentOS  7.4 64 bit</OSNameEn>
            <HpcClusterId>hpc-bp67acfmxazb4p****</HpcClusterId>
            <SpotPriceLimit>0.98</SpotPriceLimit>
            <Memory>16384</Memory>
            <OSName>CentOS  7.4 64-bit</OSName>
            <DeploymentSetGroupNo>1</DeploymentSetGroupNo>
            <ImageId>m-bp67acfmxazb4p****</ImageId>
            <VlanId>10</VlanId>
            <ClusterId>c-bp67acfmxazb4p****</ClusterId>
            <GPUSpec>NVIDIA V100</GPUSpec>
            <AutoReleaseTime>2017-12-10T04:04Z</AutoReleaseTime>
            <DeletionProtection>false</DeletionProtection>
            <StoppedMode>KeepCharging</StoppedMode>
            <GPUAmount>4</GPUAmount>
            <HostName>testHostName</HostName>
            <InstanceId>i-bp67acfmxazb4p****</InstanceId>
            <InternetMaxBandwidthOut>5</InternetMaxBandwidthOut>
            <InternetMaxBandwidthIn>50</InternetMaxBandwidthIn>
            <InstanceType>ecs.g5.large</InstanceType>
            <InstanceChargeType>PostPaid</InstanceChargeType>
            <RegionId>cn-hangzhou</RegionId>
            <IoOptimized>true</IoOptimized>
            <StartTime>2017-12-10T04:04Z</StartTime>
            <Cpu>8</Cpu>
            <LocalStorageAmount>2</LocalStorageAmount>
            <ExpiredTime>2017-12-10T04:04Z</ExpiredTime>
            <ResourceGroupId>rg-bp67acfmxazb4p****</ResourceGroupId>
            <InternetChargeType>PayByTraffic</InternetChargeType>
            <ZoneId>cn-hangzhou-g</ZoneId>
            <Recyclable>false</Recyclable>
            <ISP>null</ISP>
            <CreditSpecification>Standard</CreditSpecification>
            <InstanceTypeFamily>ecs.g5</InstanceTypeFamily>
            <OSType>linux</OSType>
            <NetworkInterfaces>
                <NetworkInterface>
                    <Type>Primary</Type>
                    <MacAddress>00:16:3e:32:b4:**</MacAddress>
                    <PrimaryIpAddress>172.17.**.***</PrimaryIpAddress>
                    <NetworkInterfaceId>eni-2zeh9atclduxvf1z****</NetworkInterfaceId>
                    <PrivateIpSets>
                        <PrivateIpSet>
                            <PrivateIpAddress>172.17.**.**</PrivateIpAddress>
                            <Primary>true</Primary>
                        </PrivateIpSet>
                    </PrivateIpSets>
                    <Ipv6Sets>
                        <Ipv6Set>
                            <Ipv6Address>2408:4321:180:1701:94c7:bc38:3bfa:***</Ipv6Address>
                        </Ipv6Set>
                    </Ipv6Sets>
                    <Ipv4PrefixSets>
                        <Ipv4PrefixSet>
                            <Ipv4Prefix>192.168.*.*/28</Ipv4Prefix>
                        </Ipv4PrefixSet>
                    </Ipv4PrefixSets>
                    <Ipv6PrefixSets>
                        <Ipv6PrefixSet>
                            <Ipv6Prefix>2001:1111:*:*::/80</Ipv6Prefix>
                        </Ipv6PrefixSet>
                    </Ipv6PrefixSets>
                    <OperationLocks>
                        <OperationLock>
                            <LockMsg>The specified instance is locked due to financial reason.</LockMsg>
                            <LockReason>Recycling</LockReason>
                        </OperationLock>
                    </OperationLocks>
                    <Tags>
                        <Tag>
                            <TagValue>TestValue</TagValue>
                            <TagKey>TestKey</TagKey>
                        </Tag>
                    </Tags>
                    <RdmaIpAddresses>
                        <RdmaIpAddress>10.10.10.102</RdmaIpAddress>
                    </RdmaIpAddresses>
                    <SecurityGroupIds>
                        <SecurityGroupId>sg-bp67acfmxazb4p****</SecurityGroupId>
                    </SecurityGroupIds>
                    <PublicIpAddress>
                        <PublicIpAddres>121.40.**.**</PublicIpAddres>
                    </PublicIpAddress>
                    <InnerIpAddress>
                        <InnerIpAddres>10.170.**.**</InnerIpAddres>
                    </InnerIpAddress>
                    <VpcAttributes>
                        <VpcId>vpc-2zeuphj08tt7q3brd****</VpcId>
                        <NatIpAddress>172.17.**.**</NatIpAddress>
                        <VSwitchId>vsw-2zeh0r1pabwtg6wcs****</VSwitchId>
                        <PrivateIpAddress>
                            <PrivateIpAddres>172.17.**.**</PrivateIpAddres>
                        </PrivateIpAddress>
                    </VpcAttributes>
                    <EipAddress>
                        <IsSupportUnassociate>true</IsSupportUnassociate>
                        <InternetChargeType>PayByTraffic</InternetChargeType>
                        <IpAddress>42.112.**.**</IpAddress>
                        <Bandwidth>5</Bandwidth>
                        <AllocationId>eip-2ze88m67qx5z****</AllocationId>
                    </EipAddress>
                    <HibernationOptions>
                        <Configured>false</Configured>
                    </HibernationOptions>
                    <DedicatedHostAttribute>
                        <DedicatedHostId>dh-bp67acfmxazb4p****</DedicatedHostId>
                        <DedicatedHostName>testDedicatedHostName</DedicatedHostName>
                        <DedicatedHostClusterId>dc-bp67acfmxazb4h****</DedicatedHostClusterId>
                    </DedicatedHostAttribute>
                    <EcsCapacityReservationAttr>
                        <CapacityReservationPreference>cr-bp67acfmxazb4p****</CapacityReservationPreference>
                        <CapacityReservationId>cr-bp67acfmxazb4p****</CapacityReservationId>
                    </EcsCapacityReservationAttr>
                    <DedicatedInstanceAttribute>
                        <Affinity>default</Affinity>
                        <Tenancy>default</Tenancy>
                    </DedicatedInstanceAttribute>
                    <CpuOptions>
                        <Numa>2</Numa>
                        <CoreCount>2</CoreCount>
                        <ThreadsPerCore>4</ThreadsPerCore>
                    </CpuOptions>
                    <MetadataOptions>
                        <HttpEndpoint>enabled</HttpEndpoint>
                        <HttpPutResponseHopLimit>0</HttpPutResponseHopLimit>
                        <HttpTokens>optional</HttpTokens>
                    </MetadataOptions>
                    <ImageOptions>
                        <LoginAsNonRoot>false</LoginAsNonRoot>
                    </ImageOptions>
                </NetworkInterface>
            </NetworkInterfaces>
        </Instance>
    </Instances>
</DescribeInstancesResponse>

Formato JSON

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

{
  "NextToken" : "caeba0bbb2be03f84eb48b699f0a4883",
  "PageSize" : 10,
  "PageNumber" : 1,
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "TotalCount" : 1,
  "Instances" : {
    "Instance" : [ {
      "CreationTime" : "2017-12-10T04:04Z",
      "SerialNumber" : "51d1353b-22bf-4567-a176-8b3e12e4****",
      "Status" : "Running",
      "DeploymentSetId" : "ds-bp67acfmxazb4p****",
      "KeyPairName" : "testKeyPairName",
      "SaleCycle" : "month",
      "SpotStrategy" : "NoSpot",
      "DeviceAvailable" : true,
      "LocalStorageCapacity" : 1000,
      "Description" : "testDescription",
      "SpotDuration" : 1,
      "InstanceNetworkType" : "vpc",
      "InstanceName" : "InstanceNameTest",
      "OSNameEn" : "CentOS  7.4 64 bit",
      "HpcClusterId" : "hpc-bp67acfmxazb4p****",
      "SpotPriceLimit" : 0.98,
      "Memory" : 16384,
      "OSName" : "CentOS  7.4 64-bit",
      "DeploymentSetGroupNo" : 1,
      "ImageId" : "m-bp67acfmxazb4p****",
      "VlanId" : "10",
      "ClusterId" : "c-bp67acfmxazb4p****",
      "GPUSpec" : "NVIDIA V100",
      "AutoReleaseTime" : "2017-12-10T04:04Z",
      "DeletionProtection" : false,
      "StoppedMode" : "KeepCharging",
      "GPUAmount" : 4,
      "HostName" : "testHostName",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "InternetMaxBandwidthOut" : 5,
      "InternetMaxBandwidthIn" : 50,
      "InstanceType" : "ecs.g5.large",
      "InstanceChargeType" : "PostPaid",
      "RegionId" : "cn-hangzhou",
      "IoOptimized" : true,
      "StartTime" : "2017-12-10T04:04Z",
      "Cpu" : 8,
      "LocalStorageAmount" : 2,
      "ExpiredTime" : "2017-12-10T04:04Z",
      "ResourceGroupId" : "rg-bp67acfmxazb4p****",
      "InternetChargeType" : "PayByTraffic",
      "ZoneId" : "cn-hangzhou-g",
      "Recyclable" : false,
      "ISP" : "null",
      "CreditSpecification" : "Standard",
      "InstanceTypeFamily" : "ecs.g5",
      "OSType" : "linux",
      "NetworkInterfaces" : {
        "NetworkInterface" : [ {
          "Type" : "Primary",
          "MacAddress" : "00:16:3e:32:b4:**",
          "PrimaryIpAddress" : "172.17.**.***",
          "NetworkInterfaceId" : "eni-2zeh9atclduxvf1z****",
          "PrivateIpSets" : {
            "PrivateIpSet" : [ {
              "PrivateIpAddress" : "172.17.**.**",
              "Primary" : true
            } ]
          },
          "Ipv6Sets" : {
            "Ipv6Set" : [ {
              "Ipv6Address" : "2408:4321:180:1701:94c7:bc38:3bfa:***"
            } ]
          },
          "Ipv4PrefixSets" : {
            "Ipv4PrefixSet" : [ {
              "Ipv4Prefix" : "192.168.*.*/28"
            } ]
          },
          "Ipv6PrefixSets" : {
            "Ipv6PrefixSet" : [ {
              "Ipv6Prefix" : "2001:1111:*:*::/80"
            } ]
          },
          "OperationLocks" : {
            "OperationLock" : [ {
              "LockMsg" : "The specified instance is locked due to financial reason.",
              "LockReason" : "Recycling"
            } ]
          },
          "Tags" : {
            "Tag" : [ {
              "TagValue" : "TestValue",
              "TagKey" : "TestKey"
            } ]
          },
          "RdmaIpAddresses" : {
            "RdmaIpAddress" : [ "10.10.10.102" ]
          },
          "SecurityGroupIds" : {
            "SecurityGroupId" : [ "sg-bp67acfmxazb4p****" ]
          },
          "PublicIpAddress" : {
            "PublicIpAddres" : [ "121.40.**.**" ]
          },
          "InnerIpAddress" : {
            "InnerIpAddres" : [ "10.170.**.**" ]
          },
          "VpcAttributes" : {
            "VpcId" : "vpc-2zeuphj08tt7q3brd****",
            "NatIpAddress" : "172.17.**.**",
            "VSwitchId" : "vsw-2zeh0r1pabwtg6wcs****",
            "PrivateIpAddress" : {
              "PrivateIpAddres" : [ "172.17.**.**" ]
            }
          },
          "EipAddress" : {
            "IsSupportUnassociate" : true,
            "InternetChargeType" : "PayByTraffic",
            "IpAddress" : "42.112.**.**",
            "Bandwidth" : 5,
            "AllocationId" : "eip-2ze88m67qx5z****"
          },
          "HibernationOptions" : {
            "Configured" : false
          },
          "DedicatedHostAttribute" : {
            "DedicatedHostId" : "dh-bp67acfmxazb4p****",
            "DedicatedHostName" : "testDedicatedHostName",
            "DedicatedHostClusterId" : "dc-bp67acfmxazb4h****"
          },
          "EcsCapacityReservationAttr" : {
            "CapacityReservationPreference" : "cr-bp67acfmxazb4p****",
            "CapacityReservationId" : "cr-bp67acfmxazb4p****"
          },
          "DedicatedInstanceAttribute" : {
            "Affinity" : "default",
            "Tenancy" : "default"
          },
          "CpuOptions" : {
            "Numa" : "2",
            "CoreCount" : 2,
            "ThreadsPerCore" : 4
          },
          "MetadataOptions" : {
            "HttpEndpoint" : "enabled",
            "HttpPutResponseHopLimit" : 0,
            "HttpTokens" : "optional"
          },
          "ImageOptions" : {
            "LoginAsNonRoot" : false
          }
        } ]
      }
    } ]
  }
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidTag.Mismatch	The specified Tag.n.Key and Tag.n.Value are not match.	Los valores Tag.N.Key y Tag.N.Value no se corresponden entre sí.
400	InvalidTagCount	The specified tags are beyond the permitted range.	Se excedió el número máximo de etiquetas permitido.
400	InvalidHpcClusterId.NotFound	The specified HpcClusterId is not found.	No se encontró el valor de HpcClusterId especificado.
400	InvalidHpcClusterId.Creating	The specified HpcClusterId is creating.	El clúster HPC se está creando.
400	InternalError	The request processing has failed due to some unknown error, exception or failure.	Ocurrió un error interno. Inténtelo de nuevo más tarde.
404	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.	Valor de InstanceChargeType no válido.
404	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.	Valor de InternetChargeType no válido.
404	InvalidLockReason.NotFound	The specified LockReason is not found.	No se encontró el valor de LockReason especificado.
404	InvalidStatus.NotFound	The specified Status is not found.	No se encontró el valor de Status especificado.

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