Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda/ Elastic Cloud Server/ Referência de API/ As API (recomendado)/ Gerenciamento de ciclo de vida/ Consulta de detalhes sobre um ECS

Atualizado em 2025-08-25 GMT+08:00

Ver PDF

Consulta de detalhes sobre um ECS

Função

Essa API é usada para consultar detalhes sobre um ECS.

As informações que podem ser consultadas incluem o modo de cobrança do ECS e o status de congelamento do ECS.

URI

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

Tabela 1 descreve os parâmetros no URI.

**Tabela 1** Descrição do parâmetro
Parâmetro	Obrigatório	Descrição
project_id	Sim	Especifica a ID do projeto. Para obter detalhes de como conseguir o ID de domínio, consulte Obtenção de um ID de projeto.
server_id	Sim	Especifica a ID de ECS.

Solicitação

Nenhum

Resposta

Tabela 2 descreve os parâmetros de resposta.

**Tabela 2** Parâmetros de resposta
Parâmetro	Tipo	Descrição
server	Object	Especifica as informações de ECS. Para mais detalhes, consulte Tabela 3.

**Tabela 3** descrição do campo **server**
Parâmetro	Tipo	Descrição
status	String	Especifica o status do ECS. Opções: ACTIVE, BUILD, ERROR, HARD_REBOOT, MIGRATING, REBOOT, REBUILD, RESIZE, REVERT_RESIZE, SHUTOFF, VERIFY_RESIZE, e DELETED Para mais detalhes, consulte Estados de ECS.
updated	String	Especifica a hora em que o ECS foi atualizado pela última vez. Esta hora está no formato "2019-05-22T03:30:52Z".
hostId	String	Especifica a ID do host em que o ECS está implantado.
OS-EXT-SRV-ATTR:host	String	Especifica o nome do host no qual o ECS é implantado.
addresses	Object	Especifica o atributo de rede do ECS. A estrutura é Map<String, Object>. A chave indica o ID da sub-rede da VPC. O valor indica os atributos de rede especificados em Tabela 1.
key_name	String	Especifica o par de chaves usado para autenticar um ECS.
image	Object	Especifica a imagem do ECS. Para mais detalhes, consulte Tabela 8.
OS-EXT-STS:task_state	String	Especifica o status da tarefa do ECS. Este é um atributo estendido. Para mais detalhes, consulte Estados de ECS.
OS-EXT-STS:vm_state	String	Especifica o status da tarefa do ECS. Este é um atributo estendido. Para mais detalhes, consulte Estados de ECS.
OS-EXT-SRV-ATTR:instance_name	String	Especifica o alias do ECS. Este é um atributo estendido.
OS-EXT-SRV-ATTR:hypervisor_hostname	String	Especifica o nome do host no qual o ECS é implantado. Este é um atributo estendido.
flavor	Object	Especifica a variação ECS. Para mais detalhes, consulte Tabela 2.
id	String	Especifica a ID do ECS no formato UUID.
security_groups	Array of objects	Especifica os grupos de segurança do ECS. Para mais detalhes, consulte Tabela 3.
OS-EXT-AZ:availability_zone	String	Especifica a AZ de um ECS. Este é um atributo estendido.
user_id	String	Especifica o ID do usuário para criar o ECS. O valor está no formato UUID.
name	String	Especifica o nome da ECS.
created	String	Especifica a hora em que o ECS foi criado. Essas horas estão no formato "2019-05-22T03:19:19Z".
tenant_id	String	Especifica o ID do locatário ao qual o ECS pertence, que é o ID do projeto no formato UUID.
OS-DCF:diskConfig	String	Especifica o tipo de configuração do disco. Este é um atributo estendido. Opções: MANUAL: O espaço da imagem não é expandido. AUTO: O espaço de imagem do disco do sistema será expandido para ser o mesmo que o sabor.
accessIPv4	String	Reservado
accessIPv6	String	Reservado
fault	Object	Especifica a causa da falha do ECS. Para mais detalhes, consulte Tabela 4.
progress	Integer	Especifica o andamento da criação do ECS. O valor varia de 0 a 100.
OS-EXT-STS:power_state	Integer	Especifica o status de energia do ECS. Este é um atributo estendido. Opções: 0: NOSTATE 1: RUNNING 4: SHUTDOWN
config_drive	String	Especifica o driver de configuração.
metadata	Map<String,String>	Especifica os metadados do ECS. Para mais detalhes, consulte Tabela 6. NOTA: Os metadados incluem campos padrão do sistema e os campos definidos pelos usuários.
OS-SRV-USG:launched_at	String	Especifica a hora em que o ECS foi iniciado. Esta hora está no formato "2019-05-22T03:23:59.000000".
OS-SRV-USG:terminated_at	String	Especifica a hora em que o ECS foi excluído. Esta hora está no formato "2019-05-22T03:23:59.000000".
os-extended-volumes:volumes_attached	Array of objects	Especifica os discos conectados a um ECS. Para mais detalhes, consulte Tabela 5.
description	String	Descreve o ECS.
host_status	String	Especifica o status do host que acomoda o ECS. UP: O estado de computação nova é normal. UNKNOWN: O estado da nova-computação é desconhecido. DOWN: o status da nova-computação é anormal. MAINTENANCE: O nova-computador está em estado de manutenção. Null: O ECS não tem informações de host.
OS-EXT-SRV-ATTR:hostname	String	Especifica o nome do host do ECS.
OS-EXT-SRV-ATTR:reservation_id	String	Especifica a ID reservada para os ECS a serem criados em um lote. Você pode usar esse ID para obter todos os ECS criados no lote.
OS-EXT-SRV-ATTR:launch_index	Integer	Especifica a seqüência na qual os ECS são iniciados se os ECS forem criados em um lote. O valor varia de 0 até o número dos ECS criados no lote.
OS-EXT-SRV-ATTR:kernel_id	String	Especifica o UUID da imagem do kernel se uma imagem AMI for usada. Em outros cenários, deixe esse parâmetro em branco.
OS-EXT-SRV-ATTR:ramdisk_id	String	Especifica o UUID da imagem Ramdisk se uma imagem AMI for usada. Em outros cenários, deixe esse parâmetro em branco.
OS-EXT-SRV-ATTR:root_device_name	String	Especifica o nome do dispositivo do disco do sistema ECS. Por exemplo, se o tipo de dispositivo do disco do sistema for VDB, o valor desse parâmetro será /dev/vda. Se o tipo de dispositivo do disco do sistema for SCSI, o valor deste parâmetro será /dev/sda.
OS-EXT-SRV-ATTR:user_data	String	Especifica os dados do usuário (informações após a codificação) configurados durante a criação do ECS.
locked	Boolean	Especifica se um ECS está bloqueado. true: O ECS está bloqueado. false: O ECS não está bloqueado.
tags	Array of strings	Especifica as marcas ECS.
os:scheduler_hints	Object	Especifica as informações de agendamento do ECS. Para mais detalhes, consulte Tabela 13.
sys_tags	Array of objects	Especifica marcas de sistema ECS. Para mais detalhes, consulte Tabela 7.
auto_terminate_time	String	Especifica a hora em que um ECS é liberado automaticamente. NOTA: O valor do parâmetro é nulo para os ECS anuais/mensais.
cpu_options	Object	Especifica as opções de CPU. Para mais detalhes, consulte Tabela 4.
hypervisor	Object	Especifica as informações de virtualização. Este é um atributo estendido. Para mais detalhes, consulte Tabela 5.

**Tabela 4** Descrição do campo **cpu_options**
Parâmetro	Tipo	Descrição
hw:cpu_threads	Integer	Especifica o número de hyperthreads da CPU, que determina se deve ativar o hyper-threading da CPU. Valores: 1 e 2 1: Desative o hyper-threading. 2: Habilite o hyper-threading. O valor deste parâmetro é o valor hw:cpu_threads em extra_specs da sabor. Ambos hw:cpu_policy e hw:cpu_threads devem existir no sabor de destino e devem ser definidos como dedicated e 2, respectivamente.

**Tabela 5** descrição do campo do **hypervisor**
Parâmetro	Tipo	Descrição
hypervisor_type	String	Especifica um tipo de virtualização.
csd_hypervisor	String	Este é um parâmetro reservado.

Exemplo de solicitação

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

Exemplo de resposta

{
	"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"
		}]
	}
}