Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Elastic Cloud Server/ Referencia de la API/ API (recomendado)/ Gestión del ciclo de vida/ Consulta de los detalles sobre un ECS

Actualización más reciente 2025-08-25 GMT+08:00

Ver PDF

Consulta de los detalles sobre un ECS

Función

Esta API se utiliza para consultar detalles sobre un ECS.

La información puede consultarse incluye el modo de facturación de ECS y el estado congelado de ECS.

URI

GET /v1/{project_id}/cloudservers/{server_id}

Tabla 1 describe los parámetros en el URI.

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Descripción
project_id	Sí	Especifica el ID del proyecto. Para obtener más información sobre cómo obtener el ID, consulte Obtención de un ID de proyecto.
server_id	Sí	Especifica el ID de ECS.

Solicitud

No hay

Respuesta

Tabla 2 describe los parámetros de respuesta.

**Tabla 2** Parámetros de respuesta
Parámetro	Tipo	Descripción
server	Object	Especifica la información de ECS. Para más detalles, consulte Tabla 3.

**Tabla 3** Descripción del campo **server**
Parámetro	Tipo	Descripción
status	String	Especifica el estado de ECS. Opciones: ACTIVE, BUILD, ERROR, HARD_REBOOT, MIGRATING, REBOOT, REBUILD, RESIZE, REVERT_RESIZE, SHUTOFF, VERIFY_RESIZE, y DELETED Para más detalles, consulte Estados de ECS.
updated	String	Especifica la hora a la que se actualizó el ECS la última vez. La hora está en el formato de "2019-05-22T03:30:52Z".
hostId	String	Especifica el ID del host donde se implementa el ECS.
OS-EXT-SRV-ATTR:host	String	Especifica el nombre del host en el que se implementa el ECS.
addresses	Object	Especifica el atributo de red del ECS. La estructura es Map<String, Object>. La clave indica el ID de subred de VPC. El valor indica los atributos de red especificados en Tabla 1.
key_name	String	Especifica el par de claves que se utiliza para autenticar un ECS.
image	Object	Especifica la imagen de ECS. Para más detalles, consulte Tabla 8.
OS-EXT-STS:task_state	String	Especifica el estado de la tarea ECS. Este es un atributo extendido. Para más detalles, consulte Estados de ECS.
OS-EXT-STS:vm_state	String	Especifica el estado de la tarea ECS. Este es un atributo extendido. Para más detalles, consulte Estados de ECS.
OS-EXT-SRV-ATTR:instance_name	String	Especifica el alias de ECS. Este es un atributo extendido.
OS-EXT-SRV-ATTR:hypervisor_hostname	String	Especifica el nombre del host en el que se implementa el ECS. Este es un atributo extendido.
flavor	Object	Especifica la variante de ECS. Para más detalles, consulte Tabla 2.
id	String	Especifica el ID de ECS en formato UUID.
security_groups	Array of objects	Especifica los grupos de seguridad del ECS. Para más detalles, consulte Tabla 3.
OS-EXT-AZ:availability_zone	String	Especifica la AZ de un ECS. Este es un atributo extendido.
user_id	String	Especifica el ID del usuario para crear el ECS. El valor está en formato UUID.
name	String	Especifica el nombre de ECS.
created	String	Especifica la hora a la que se creó el ECS. El tiempo está en el formato de "2019-05-22T03:19:19Z".
tenant_id	String	Especifica el ID del inquilino al que pertenece el ECS, que es el ID del proyecto en formato UUID.
OS-DCF:diskConfig	String	Especifica el tipo de configuración de disco. Este es un atributo extendido. Opciones: MANUAL: El espacio de la imagen no se expande. AUTO: El espacio de imagen del disco del sistema se ampliará para que sea el mismo que la variante.
accessIPv4	String	Reservada
accessIPv6	String	Reservada
fault	Object	Especifica la causa del error ECS. Para más detalles, consulte Tabla 4.
progress	Integer	Especifica el progreso de la creación de ECS. El valor varía de 0 a 100.
OS-EXT-STS:power_state	Integer	Especifica el estado de energía del ECS. Este es un atributo extendido. Opciones: 0: NOSTATE 1: RUNNING 4: SHUTDOWN
config_drive	String	Especifica el controlador de configuración.
metadata	Map<String,String>	Especifica los metadatos de ECS. Para más detalles, consulte Tabla 6. NOTA: Los metadatos incluyen los campos predeterminados del sistema y los campos establecidos por los usuarios.
OS-SRV-USG:launched_at	String	Especifica la hora a la que se inició el ECS. El tiempo está en el formato de "2019-05-22T03:23:59.000000".
OS-SRV-USG:terminated_at	String	Especifica la hora a la que se eliminó el ECS. El tiempo está en el formato de "2019-05-22T03:23:59.000000".
os-extended-volumes:volumes_attached	Array of objects	Especifica los discos conectados a un ECS. Para más detalles, consulte Tabla 5.
description	String	Describe el ECS.
host_status	String	Especifica el estado del host que aloja el ECS. UP: The nova-compute status is normal. UNKNOWN: El estado de nova-compute es desconocido. DOWN: el estado de nova-computación es anormal. MAINTENANCE: El nova-compute se encuentra en estado de mantenimiento. Null: El ECS no tiene información de host.
OS-EXT-SRV-ATTR:hostname	String	Especifica el nombre de host del ECS.
OS-EXT-SRV-ATTR:reservation_id	String	Especifica el ID reservado para los ECS que se van a crear por lotes. Puede utilizar este ID para obtener todos los ECS creados por lotes.
OS-EXT-SRV-ATTR:launch_index	Integer	Especifica la secuencia en la que se inician los ECS si los ECS se crean en un lote. El valor varía entre 0 y el número de ECS creados por lotes.
OS-EXT-SRV-ATTR:kernel_id	String	Especifica el UUID de la imagen del núcleo si se utiliza una imagen AMI. En otros escenarios, deje este parámetro en blanco.
OS-EXT-SRV-ATTR:ramdisk_id	String	Especifica el UUID de la imagen Ramdisk si se utiliza una imagen AMI. En otros escenarios, deje este parámetro en blanco.
OS-EXT-SRV-ATTR:root_device_name	String	Especifica el nombre del dispositivo del disco del sistema ECS. Por ejemplo, si el tipo de dispositivo del disco del sistema es VDB, el valor de este parámetro es /dev/vda. Si el tipo de dispositivo del disco del sistema es SCSI, el valor de este parámetro es /dev/sda.
OS-EXT-SRV-ATTR:user_data	String	Especifica los datos de usuario (información después de la codificación) configurados durante la creación de ECS.
locked	Boolean	Especifica si un ECS está bloqueado. true: El ECS está bloqueado. false: el ECS no está bloqueado.
tags	Array of strings	Especifica las etiquetas ECS.
os:scheduler_hints	Object	Especifica la información de programación de ECS. Para más detalles, consulte Tabla 13.
sys_tags	Array of objects	Especifica las etiquetas de sistema ECS. Para más detalles, consulte Tabla 7.
auto_terminate_time	String	Especifica la hora en que se libera automáticamente un ECS. NOTA: El valor del parámetro es nulo para los ECS anuales/mensuales.
cpu_options	Object	Especifica las opciones de CPU. Para más detalles, consulte Tabla 4.
hypervisor	Object	Especifica la información de virtualización. Este es un atributo extendido. Para más detalles, consulte Tabla 5.

**Tabla 4** Descripción del campo **cpu_options**
Parámetro	Tipo	Descripción
hw:cpu_threads	Integer	Especifica el número de subprocesos de CPU, que determina si se debe habilitar el subproceso de CPU. Valores: 1 y 2 1: Deshabilitar el hiper-hilo. 2: Habilitar el hiper-hilo. El valor de este parámetro es el valor hw:cpu_threads en extra_specs de la variante. Tanto hw:cpu_policy como hw:cpu_threads deben existir en el tipo de destino y deben establecerse en dedicated y 2, respectivamente.

**Tabla 5** Descripción del campo **hypervisor**
Parámetro	Tipo	Descripción
hypervisor_type	String	Especifica un tipo de virtualización.
csd_hypervisor	String	Este es un parámetro reservado.

Ejemplo de la solicitud

GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}

Ejemplo de la respuesta

{
	"server": {
		"id": "4f4b3dfa-eb70-47cf-a60a-998a53bd598a",
		"name": "ecs-2ecf",
		"addresses": {
			"0431c5e5-bc94-4a44-8263-15da2a642435": [{
				"version": "4",
				"addr": "192.168.1.99",
				"OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:df:18:6d",
				"OS-EXT-IPS:port_id": "23037c18-027a-44e5-b6b9-f8d8f113fe02",
				"OS-EXT-IPS:type": "fixed"
			}]
		},
		"flavor": {
			"disk": "0",
			"vcpus": "1",
			"ram": "1024",
			"id": "s3.small.1",
			"name": "s3.small.1"
		},
		"accessIPv4": "",
		"accessIPv6": "",
		"status": "ACTIVE",
		"progress": 0,
		"hostId": "c7145889b2e3202cd295ceddb1742ff8941b827b586861fd0acedf64",
		"updated": "2018-09-13T07:06:51Z",
		"created": "2018-09-13T07:03:44Z",
                "image": {
                        "id": "1ce5800a-e487-4c1b-b264-3353a39e2b4b"
                },
		"metadata": {
			"metering.order_id": "CS1809131459IGC24",
			"metering.image_id": "c71b64e7-4767-4406-afde-2c7c7ac2242c",
			"metering.imagetype": "gold",
			"metering.resourcespeccode": "s3.small.1.linux",
			"image_name": "HEC_Public_Cloudinit_Oracle_Linux_7.4_64bit_40G",
			"metering.resourcetype": "1",
			"metering.product_id": "00301-117024-0--0",
			"cascaded.instance_extrainfo": "pcibridge:2",
			"os_bit": "64",
			"vpc_id": "0431c5e5-bc94-4a44-8263-15da2a642435",
			"os_type": "Linux",
			"charging_mode": "1"
		},
		"tags": [],
		"description": "",
		"locked": false,
		"config_drive": "",
		"tenant_id": "ff2eb406effc455aba53174463eb9322",
		"user_id": "0bc5e11f91dd48849bb03b7c8a263b2c",
		"key_name": "KeyPair-d750",
		"os-extended-volumes:volumes_attached": [{
			"device": "/dev/vda",
			"bootIndex": "0",
			"id": "80c15cff-2473-4982-a816-d760cad6c42c",
			"delete_on_termination": "false"
		}],
                "OS-EXT-STS:task_state": null,
		"OS-EXT-STS:power_state": 1,
		"OS-EXT-STS:vm_state": "active",
		"OS-EXT-SRV-ATTR:host": "az21.dc1",
		"OS-EXT-SRV-ATTR:instance_name": "instance-0015147f",
		"OS-EXT-SRV-ATTR:hypervisor_hostname": "nova003@74",
                "OS-EXT-SRV-ATTR:user_data": null,
		"OS-DCF:diskConfig": "MANUAL",
		"OS-EXT-AZ:availability_zone":"az1-dc1", //AZ name
		"os:scheduler_hints": {
		},
		"OS-EXT-SRV-ATTR:root_device_name": "/dev/vda",
		"OS-EXT-SRV-ATTR:ramdisk_id": "",
		
		"OS-SRV-USG:launched_at": "2018-09-13T07:04:09.197749",
		"OS-EXT-SRV-ATTR:kernel_id": "",
		"OS-EXT-SRV-ATTR:launch_index": 0,
		"host_status": "UP",
		"OS-EXT-SRV-ATTR:reservation_id": "r-nrd8b5c4",
		"OS-EXT-SRV-ATTR:hostname": "ecs-2ecf",
		"sys_tags": [{
			"key": "_sys_enterprise_project_id",
			"value": "0"
		}],
		"security_groups": [{
			"name": "sg-95ec",
                        "id": "6505b5d1-7837-41eb-8a1c-869d4355baa3"
		}]
	}
}