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

查询云服务器详情列表

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

功能介绍

根据用户请求条件从数据库筛选、查询所有的弹性云服务器,并关联相关表获取到弹性云服务器的详细信息。

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

URI

GET /v1/{project_id}/cloudservers/detail{?flavor,name,status,limit,offset,not-tags,reservation_id,enterprise_project_id,tags,ip}

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

参数

是否必选

描述

project_id

项目ID。

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

表2 查询参数

参数

是否必选

参数类型

描述

offset

Integer

页码。

当前页面数,默认为1。

取值大于等于0,取值为0时返回第1页。

flavor

String

云服务器规格ID,已上线的规格请参见《弹性云服务器用户指南》的“实例和应用场景”章节。

name

String

云服务器名称,匹配规则为模糊匹配。

status

String

云服务器状态。

取值范围:

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

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

limit

Integer

查询返回云服务器列表当前页面的数量。

最多返回1000台云服务器的信息。

tags

String

查询tag字段中包含该值的云服务器。

not-tags

String

查询tag字段中不包含该值的云服务器。

reservation_id

String

批量创建弹性云服务器时,指定返回的ID,用于查询本次批量创建的弹性云服务器。

enterprise_project_id

String

查询绑定某个企业项目的弹性云服务器。

若需要查询当前用户所有企业项目绑定的弹性云服务,请传参all_granted_eps

ip

String

IPv4地址过滤结果。

请求消息

响应消息

响应参数如 表3所示。
表3 响应参数

参数

参数类型

描述

servers

List(Dict)

弹性云服务器详情列表,具体参照查询云服务器详情接口。

查询级别不同,返回的详情不同。

count

Int

弹性云服务器的总数。

请求示例

GET https://{endpoint}/v1/{project_id}/cloudservers/detail?offset=1&limit=2&not-tags=__type_baremetal

响应示例

{
	"count": 4,
	"servers": [{
		"id": "b37fd80e-ac67-4d02-b9f1-9891c9c0fabf",
		"name": "ecs-yuankai2",
		"addresses": {
			"164489f6-cbf7-45b4-b6d0-d407c48cf7fc": [{
				"version": "4",
				"addr": "192.168.0.206",
				"OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:95:88:3f",
				"OS-EXT-IPS:port_id": "7b5d615c-186d-4646-9cb8-444addfe9b92",
				"OS-EXT-IPS:type": "fixed"
			},
			{
				"version": "4",
				"addr": "192.168.0.8",
				"OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:1d:88:43",
				"OS-EXT-IPS:port_id": "dda2027b-2f03-497b-8d42-620da2baacc3",
				"OS-EXT-IPS:type": "fixed"
			}]
		},
		"flavor": {
			"disk": "0",
			"vcpus": "1",
			"ram": "1024",
			"id": "c1.medium",
			"name": "c1.medium"
		},
		"accessIPv4": "",
		"accessIPv6": "",
		"status": "SHUTOFF",
                "image": {
                           "id": "1ce5800a-e487-4c1b-b264-3353a39e2b4b"
                          },
		"hostId": "f92345b97fd291f67a29ed735a82a8983f370175d2ba3d18d66893f4",
		"updated": "2018-08-14T07:26:49Z",
		"created": "2018-08-13T13:46:09Z",
		"metadata": {
			"metering.image_id": "af60e0d5-6952-4f3d-b0ed-31bb19d4a692",
			"metering.resourcespeccode": "c1.medium.linux",
			"image_name": "HEC_Public_Cloudinit_CentOS_7.4_64bit",
			"metering.product_id": "00301-253164-0--0",
			"os_bit": "64",
			"lockSourceId": "",
			"lockScene": "",
			"metering.order_id": "CS1808132145NRVRE",
			"lockCheckEndpoint": "",
			"metering.imagetype": "gold",
			"lockSource": "",
			"metering.resourcetype": "1",
			"vpc_id": "164489f6-cbf7-45b4-b6d0-d407c48cf7fc",
			"os_type": "Linux",
			"charging_mode": "1"
		},
		"tags": [],
		"description": "ecs-4cff",
		"locked": false,
		"config_drive": "",
		"tenant_id": "edcb94a885a84ed3a3fdf8ea4d2741da",
		"user_id": "bb7f23e27e7e46f3aaceb5f53a158bdc",
		"os-extended-volumes:volumes_attached": [{
			"device": "/dev/sda",
			"bootIndex": "0",
			"id": "2edc879f-022e-4bd6-b079-95a27564d449",
			"delete_on_termination": "false"
		}],
		"OS-EXT-STS:power_state": 4,
		"OS-EXT-STS:vm_state": "stopped",
		"OS-EXT-SRV-ATTR:host": "az1.dc1",
		"OS-EXT-SRV-ATTR:instance_name": "instance-00137941",
		"OS-EXT-SRV-ATTR:hypervisor_hostname": "nova001@248",
		"OS-DCF:diskConfig": "MANUAL",
		"OS-EXT-AZ:availability_zone":"az1-dc1", //可用区名称
		"os:scheduler_hints": {
			
		},
		"OS-EXT-SRV-ATTR:root_device_name": "/dev/sda",
		"OS-EXT-SRV-ATTR:ramdisk_id": "",
		"enterprise_project_id": "441d5677-b76a-4dd4-a97a-ef7fd633c095",
		"OS-EXT-SRV-ATTR:user_data": "IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiRKQ2FzUWQkbm5wVmhJUFZlNVMwc3pXbnJGLnZVZ1FCWk4xTEo5Vy8wd09WTmFZaWpBRXdtRnhuQmZaTllVZXhBWktVWFVTeVhEeERuSUMzV2JjZEJyQUVBZkZvLy8nIHwgY2hwYXNzd2QgLWU7",
		"OS-SRV-USG:launched_at": "2018-08-13T13:46:46.000000",
		"OS-EXT-SRV-ATTR:kernel_id": "",
		"OS-EXT-SRV-ATTR:launch_index": 0,
		"host_status": "UP",
		"OS-EXT-SRV-ATTR:reservation_id": "r-a8mg9vwr",
		"OS-EXT-SRV-ATTR:hostname": "ecs-4cff",
		"sys_tags": [{
			"key": "_sys_enterprise_project_id",
			"value": "441d5677-b76a-4dd4-a97a-ef7fd633c095"
		}],
		"security_groups": [{
			"name": "test"
		},
		{
			"name": "test"
		},
		{
			"name": "b1786350-da65-11e7-b312-0255ac101b03-mxwluo-port"
		},
		{
			"name": "default"
		}]
	},
	{
		"id": "8380dcc9-0eac-4407-9f9e-df8c9eddeacd",
		"name": "ecs-f680",
		"addresses": {
			"164489f6-cbf7-45b4-b6d0-d407c48cf7fc": [{
				"version": "4",
				"addr": "192.168.0.218",
				"OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:bb:b3:fe",
				"OS-EXT-IPS:port_id": "240c696f-68d8-4f3f-941d-fecf2b375132",
				"OS-EXT-IPS:type": "fixed"
			}]
		},
		"flavor": {
			"disk": "0",
			"vcpus": "1",
			"ram": "1024",
			"id": "c1.medium",
			"name": "c1.medium"
		},
		"accessIPv4": "",
		"accessIPv6": "",
		"status": "SHUTOFF",
		"hostId": "f92345b97fd291f67a29ed735a82a8983f370175d2ba3d18d66893f4",
		"updated": "2018-08-14T03:01:00Z",
		"created": "2018-08-13T13:38:29Z",
		"metadata": {
			"metering.image_id": "af60e0d5-6952-4f3d-b0ed-31bb19d4a692",
			"metering.imagetype": "gold",
			"metering.resourcespeccode": "c1.medium.linux",
			"image_name": "HEC_Public_Cloudinit_CentOS_7.4_64bit",
			"metering.resourcetype": "1",
			"os_bit": "64",
			"vpc_id": "164489f6-cbf7-45b4-b6d0-d407c48cf7fc",
			"os_type": "Linux",
			"charging_mode": "0"
		},
		"tags": [],
		"description": "ecs-f680",
		"locked": false,
		"config_drive": "",
		"tenant_id": "edcb94a885a84ed3a3fdf8ea4d2741da",
		"user_id": "61ee747d36bf421fa25c51a3b9565046",
		"os-extended-volumes:volumes_attached": [{
			"device": "/dev/sda",
			"bootIndex": "0",
			"id": "3721b948-9c2f-4980-90ad-b2a16811f58c",
			"delete_on_termination": "false"
		}],
		"OS-EXT-STS:power_state": 4,
		"OS-EXT-STS:vm_state": "stopped",
		"OS-EXT-SRV-ATTR:host": "az1.dc1",
		"OS-EXT-SRV-ATTR:instance_name": "instance-00137937",
		"OS-EXT-SRV-ATTR:hypervisor_hostname": "nova001@248",
		"OS-DCF:diskConfig": "MANUAL",
		"OS-EXT-AZ:availability_zone":"az1-dc1", //可用区名称
		"os:scheduler_hints": {
			
		},
		"OS-EXT-SRV-ATTR:root_device_name": "/dev/sda",
		"OS-EXT-SRV-ATTR:ramdisk_id": "",
		"enterprise_project_id": "441d5677-b76a-4dd4-a97a-ef7fd633c095",
		"OS-EXT-SRV-ATTR:user_data": "IyEvYmluL2Jhc2gKZWNobyAncm9vdDokNiR5aG9aeFIkVE00OWlwSGQ2OEFWcjlTMTFXNEZrZmFYTENVbEkvd0xVTmdSVjhOb0dCem5WOWFsU1lEN0ZNSHc0VmtwdU9GOERyLncudGUzVmRHLnVmY005elVZSDEnIHwgY2hwYXNzd2QgLWU7",
		"OS-SRV-USG:launched_at": "2018-08-13T13:38:53.000000",
		"OS-EXT-SRV-ATTR:kernel_id": "",
		"OS-EXT-SRV-ATTR:launch_index": 0,
		"host_status": "UP",
		"OS-EXT-SRV-ATTR:reservation_id": "r-7e2g78rq",
		"OS-EXT-SRV-ATTR:hostname": "ecs-f680",
		"sys_tags": [{
			"key": "_sys_enterprise_project_id",
			"value": "441d5677-b76a-4dd4-a97a-ef7fd633c095"
		}],
		"security_groups": [{
			"name": "test"
		}]
	},
	{
		"id": "fb70fed9-5774-44a7-ad4a-af3ea2c2da61",
		"name": "ecs-3993",
		"addresses": {
			"00159d7d-b3c3-4108-8bc4-6658814e6422": [{
				"version": "4",
				"addr": "192.168.20.83",
				"OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:a9:8d:88",
				"OS-EXT-IPS:port_id": "579ab762-bf89-435e-80ad-a8bdd25119c5",
				"OS-EXT-IPS:type": "fixed"
			}]
		},
		"flavor": {
			"disk": "0",
			"vcpus": "1",
			"ram": "1024",
			"id": "c1.medium",
			"name": "c1.medium"
		},
		"accessIPv4": "",
		"accessIPv6": "",
		"status": "SHUTOFF",
		"hostId": "f92345b97fd291f67a29ed735a82a8983f370175d2ba3d18d66893f4",
		"updated": "2018-08-14T03:01:03Z",
		"created": "2018-08-13T13:38:02Z",
		"metadata": {
			"metering.image_id": "af60e0d5-6952-4f3d-b0ed-31bb19d4a692",
			"metering.imagetype": "gold",
			"metering.resourcespeccode": "c1.medium.linux",
			"image_name": "HEC_Public_Cloudinit_CentOS_7.4_64bit",
			"metering.resourcetype": "1",
			"os_bit": "64",
			"vpc_id": "00159d7d-b3c3-4108-8bc4-6658814e6422",
			"os_type": "Linux",
			"charging_mode": "0"
		},
		"tags": [],
		"description": "ecs-3993",
		"locked": false,
		"config_drive": "",
		"tenant_id": "edcb94a885a84ed3a3fdf8ea4d2741da",
		"user_id": "eb4698fe015848e9a3e86cc9956e54fa",
		"key_name": "KeyPair-3b38",
		"os-extended-volumes:volumes_attached": [{
			"device": "/dev/sda",
			"bootIndex": "0",
			"id": "85bfbc4f-7733-419a-b171-c00585abf926",
			"delete_on_termination": "false"
		}],
		"OS-EXT-STS:power_state": 4,
		"OS-EXT-STS:vm_state": "stopped",
		"OS-EXT-SRV-ATTR:host": "az1.dc1",
		"OS-EXT-SRV-ATTR:instance_name": "instance-00137936",
		"OS-EXT-SRV-ATTR:hypervisor_hostname": "nova001@248",
		"OS-DCF:diskConfig": "MANUAL",
		"OS-EXT-AZ:availability_zone":"az1-dc1", //可用区名称
		"os:scheduler_hints": {
			
		},
		"OS-EXT-SRV-ATTR:root_device_name": "/dev/sda",
		"OS-EXT-SRV-ATTR:ramdisk_id": "",
		"enterprise_project_id": "441d5677-b76a-4dd4-a97a-ef7fd633c095",
		"OS-SRV-USG:launched_at": "2018-08-13T13:38:24.000000",
		"OS-EXT-SRV-ATTR:kernel_id": "",
		"OS-EXT-SRV-ATTR:launch_index": 0,
		"host_status": "UP",
		"OS-EXT-SRV-ATTR:reservation_id": "r-uzsewxii",
		"OS-EXT-SRV-ATTR:hostname": "ecs-3993",
		"sys_tags": [{
			"key": "_sys_enterprise_project_id",
			"value": "441d5677-b76a-4dd4-a97a-ef7fd633c095"
		}],
		"security_groups": [{
			"name": "test"
		},
		{
			"name": "default"
		}]
	},
	{
		"id": "e3d3f219-b445-4a7a-8f00-e31412481f8c",
		"name": "ecs-1f30",
		"addresses": {
			"00159d7d-b3c3-4108-8bc4-6658814e6422": [{
				"version": "4",
				"addr": "192.168.20.197",
				"OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:41:5a:32",
				"OS-EXT-IPS:port_id": "cfa2e055-54fb-427a-bde4-128bda47ae5c",
				"OS-EXT-IPS:type": "fixed"
			}]
		},
		"flavor": {
			"disk": "0",
			"vcpus": "1",
			"ram": "1024",
			"id": "c1.medium",
			"name": "c1.medium"
		},
		"accessIPv4": "",
		"accessIPv6": "",
		"status": "ACTIVE",
		"progress": 0,
		"hostId": "f92345b97fd291f67a29ed735a82a8983f370175d2ba3d18d66893f4",
		"updated": "2018-08-15T08:16:01Z",
		"created": "2018-08-13T11:57:29Z",
		"metadata": {
			"sadfasfasf": "sdffffd",
			"metering.order_id": "CS180813193577ORO",
			"metering.imagetype": "gold",
			"metering.resourcespeccode": "c1.medium.win",
			"metering.image_id": "65cb40e6-f67e-4bef-a1e7-808166a5999d",
			"image_name": "HEC_Public_Windows2008R2_Ent_64bit40G_English",
			"aaaaaa": "0",
			"metering.resourcetype": "1",
			"aaaa": "0",
			"metering.product_id": "00301-146042-0--0",
			"os_bit": "64",
			"vpc_id": "00159d7d-b3c3-4108-8bc4-6658814e6422",
			"os_type": "Windows",
			"charging_mode": "1"
		},
		"tags": [],
		"description": "ecs-1f30",
		"locked": false,
		"config_drive": "",
		"tenant_id": "edcb94a885a84ed3a3fdf8ea4d2741da",
		"user_id": "bb7f23e27e7e46f3aaceb5f53a158bdc",
		"key_name": "Autotest_Init_TC_OriginalAPI_Create_Keypairs_02_keypair",
		"os-extended-volumes:volumes_attached": [{
			"device": "/dev/sda",
			"bootIndex": "0",
			"id": "5043f66b-a0d8-4eb2-8c48-49976bcdc253",
			"delete_on_termination": "false"
		}],
		"OS-EXT-STS:power_state": 1,
		"OS-EXT-STS:vm_state": "active",
		"OS-EXT-SRV-ATTR:host": "az1.dc1",
		"OS-EXT-SRV-ATTR:instance_name": "instance-0013772d",
		"OS-EXT-SRV-ATTR:hypervisor_hostname": "nova001@248",
		"OS-DCF:diskConfig": "MANUAL",
		"OS-EXT-AZ:availability_zone":"az1-dc1", //可用区名称
		"os:scheduler_hints": {
			
		},
		"OS-EXT-SRV-ATTR:root_device_name": "/dev/sda",
		"OS-EXT-SRV-ATTR:ramdisk_id": "",
		"enterprise_project_id": "441d5677-b76a-4dd4-a97a-ef7fd633c095",
		"OS-SRV-USG:launched_at": "2018-08-13T11:57:53.576640",
		"OS-EXT-SRV-ATTR:kernel_id": "",
		"OS-EXT-SRV-ATTR:launch_index": 0,
		"host_status": "UP",
		"OS-EXT-SRV-ATTR:reservation_id": "r-xmjj4pnm",
		"OS-EXT-SRV-ATTR:hostname": "ecs-1f30",
		"sys_tags": [{
			"key": "_sys_enterprise_project_id",
			"value": "441d5677-b76a-4dd4-a97a-ef7fd633c095"
		}],
		"security_groups": [{
			"name": "default"
		}]
	}]
}

返回值

请参考通用请求返回值

错误码

请参考错误码说明

分享:

    相关文档

    相关产品

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

提交成功!

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

跳转到云社区