文档首页 > > API参考> API(推荐)> 生命周期管理> 查询云服务器详情

查询云服务器详情

分享
更新时间: 2019/11/20 GMT+08:00

功能介绍

查询弹性云服务器的详细信息。

该接口支持查询弹性云服务器的计费方式,以及是否被冻结。

URI

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

参数说明请参见 表1
表1 参数说明

参数

是否必选

描述

project_id

项目ID。

获取方法请参见获取项目ID

server_id

云服务器ID。

请求消息

响应消息

响应参数如表2所示。

表2 响应参数

参数

参数类型

描述

status

String

弹性云服务器状态。

取值范围:

ACTIVE、BUILD、DELETED、ERROR、HARD_REBOOT、MIGRATING、PAUSED、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、SHELVED、SHELVED_OFFLOADED、SOFT_DELETED、SUSPENDED、VERIFY_RESIZE

弹性云服务器状态说明请参考云服务器状态

updated

String

弹性云服务器更新时间。

时间格式例如:2019-05-22T03:30:52Z

hostId

String

弹性云服务器所在主机的主机ID。

OS-EXT-SRV-ATTR:host

String

弹性云服务器所在主机的主机名称。

addresses

Dict(str:list)

弹性云服务器的网络属性。

详情请参见表1

key_name

String

弹性云服务器使用的密钥对名称。

image

Dict

弹性云服务器镜像信息。详情请参见:表9

OS-EXT-STS:task_state

String

扩展属性,弹性云服务器当前任务的状态。

OS-EXT-STS:vm_state

String

扩展属性,弹性云服务器当前状态。

OS-EXT-SRV-ATTR:instance_name

String

扩展属性,弹性云服务器别名。

OS-EXT-SRV-ATTR:hypervisor_hostname

String

扩展属性,弹性云服务器所在虚拟化主机名。

flavor

Dict

弹性云服务器规格信息。

详情请参见表3

id

String

弹性云服务器ID,格式为UUID。

security_groups

List(Dict)

弹性云服务器所属安全组列表。

详情请参见表4

OS-EXT-AZ:availability_zone

String

扩展属性,弹性云服务器所在可用区名称。

user_id

String

创建弹性云服务器的用户ID,格式为UUID。

name

String

弹性云服务器名称。

created

String

弹性云服务器创建时间。

时间格式例如:2019-05-22T03:19:19Z

tenant_id

String

弹性云服务器所属租户ID,即项目id,和project_id表示相同的概念,格式为UUID。

OS-DCF:diskConfig

String

扩展属性, diskConfig的类型。

  • MANUAL,镜像空间不会扩展。
  • AUTO,系统盘镜像空间会自动扩展为与flavor大小一致。

accessIPv4

String

预留属性。

accessIPv6

String

预留属性。

fault

Dict

弹性云服务器故障原因。

progress

Int

弹性云服务器进度。

OS-EXT-STS:power_state

Int

扩展属性,弹性云服务器电源状态。

config_drive

String

config drive信息。

metadata

Dict

弹性云服务器元数据。详情请参见表7

说明:

元数据包含系统默认添加字段和用户设置的字段。

OS-SRV-USG:launched_at

String

弹性云服务器启动时间。时间格式例如:2019-05-22T03:23:59.000000

OS-SRV-USG:terminated_at

String

弹性云服务器删除时间。

时间格式例如:2019-05-22T03:23:59.000000

os-extended-volumes:volumes_attached

List(Dict)

挂载到弹性云服务器上的磁盘。

详情请参见表6

description

String

弹性云服务器的描述信息。

host_status

String

nova-compute状态。

  • UP:服务正常
  • UNKNOWN:状态未知
  • DOWN:服务异常
  • MAINTENANCE:维护状态
  • 空字符串:弹性云服务器无主机信息

OS-EXT-SRV-ATTR:hostname

String

弹性云服务器的主机名。

OS-EXT-SRV-ATTR:reservation_id

String

批量创建场景,弹性云服务器的预留ID。

OS-EXT-SRV-ATTR:launch_index

Int

批量创建场景,弹性云服务器的启动顺序。

OS-EXT-SRV-ATTR:kernel_id

String

若使用AMI格式的镜像,则表示kernel image的UUID;否则,留空。

OS-EXT-SRV-ATTR:ramdisk_id

String

若使用AMI格式镜像,则表示ramdisk image的UUID;否则,留空。

OS-EXT-SRV-ATTR:root_device_name

String

弹性云服务器系统盘的设备名称。

OS-EXT-SRV-ATTR:user_data

String

创建弹性云服务器时指定的user_data。

locked

boolean

弹性云服务器是否为锁定状态。

  • true:锁定
  • false:未锁定
  • 微版本2.9后支持

tags

List(String)

弹性云服务器标签。

os:scheduler_hints

Dict

弹性云服务器调度信息,详情请参见表8

enterprise_project_id

String

弹性云服务器所属的企业项目ID。

sys_tags

List(Dict)

弹性云服务器系统标签。

详情请参见表8

请求示例

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

响应示例

{
	"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: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-DCF:diskConfig": "MANUAL",
		"OS-EXT-AZ:availability_zone":"az1-dc1", //可用区名称
		"os:scheduler_hints": {
			
		},
		"OS-EXT-SRV-ATTR:root_device_name": "/dev/vda",
		"OS-EXT-SRV-ATTR:ramdisk_id": "",
		"enterprise_project_id": "0",
		"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
		}]
	}
}

返回值

请参考通用请求返回值

错误码

请参考错误码说明

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区