华为云计算 云知识 查询弹性云服务器详情列表NovaListServersDetails
查询弹性云服务器详情列表NovaListServersDetails

 

接口说明

查询 云服务器 详情信息列表。

约束说明

URL
GET  https://ecs.cn-north-1.myhuaweicloud.com/v2.1/{project_id}/servers/detail 
请求参数
名称 类型 IN 必选
OpenStack-API-Version
 
string header
X-Auth-Token
 
string header
project_id
 
string path
changes-since
 
string query
flavor
 
string query
image
 
string query
ip
 
string query
limit
 
integer query
marker
 
string query
name
 
string query
not-tags
 
string query
reservation_id
 
string query
sort_key
 
string query
status
 
string query
tags
 
string query
返回参数
返回码: 200

OK

名称 类型 必选 描述
servers
 
Array of NovaServer objects

查询云服务器信息列表。

servers_links
 
Array of PageLink objects

分页查询时,查询下一页数据链接。

200 servers
名称 类型 必选
name
 
string
id
 
string
status
 
string
created
 
string
updated
 
string
flavor
 
NovaServerFlavor object
image
 
NovaServerImage object
tenant_id
 
string
key_name
 
string
user_id
 
string
metadata
 
Map<String,String>
hostId
 
string
addresses
 
Map<String,Array<Object>>
security_groups
 
Array of NovaServerSecurityGroup objects
links
 
Array of NovaLink objects
OS-DCF:diskConfig
 
string
OS-EXT-AZ:availability_zone
 
string
OS-EXT-SRV-ATTR:host
 
string
OS-EXT-SRV-ATTR:hypervisor_hostname
 
string
OS-EXT-SRV-ATTR:instance_name
 
string
OS-EXT-STS:power_state
 
integer
OS-EXT-STS:task_state
 
string
OS-EXT-STS:vm_state
 
string
OS-SRV-USG:launched_at
 
string
OS-SRV-USG:terminated_at
 
string
os-extended-volumes:volumes_attached
 
Array of NovaServerVolume objects
fault
 
NovaServerFault object
description
 
string
host_status
 
string
OS-EXT-SRV-ATTR:hostname
 
string
OS-EXT-SRV-ATTR:reservation_id
 
string
OS-EXT-SRV-ATTR:launch_index
 
integer
OS-EXT-SRV-ATTR:kernel_id
 
string
OS-EXT-SRV-ATTR:ramdisk_id
 
string
OS-EXT-SRV-ATTR:root_device_name
 
string
OS-EXT-SRV-ATTR:user_data
 
string
tags
 
Array of strings
locked
 
boolean
accessIPv4
 
string
accessIPv6
 
string
config_drive
 
string
progress
 
integer
os:scheduler_hints
 
NovaServerSchedulerHints object
200 servers.flavor
名称 类型 必选 描述
id
 
string

云服务器类型ID。

微版本2.47后不支持。

links
 
Array of NovaLink objects

云服务器类型相关标记快捷链接信息。

微版本2.47后不支持。

vcpus
 
integer

该云服务器规格对应的CPU核数。

在微版本2.47后支持。

ram
 
integer

该云服务器规格对应的内存大小,单位为MB。

在微版本2.47后支持。

disk
 
integer

该云服务器规格对应要求系统盘大小,0为不限制。

在微版本2.47后支持。

ephemeral
 
integer

未使用。

在微版本2.47后支持。

swap
 
integer

未使用。

在微版本2.47后支持。

original_name
 
string

云服务器规格名称。

在微版本2.47后支持。

extra_specs
 
Map<String,String>

flavor扩展字段。

在微版本2.47后支持。

200 servers.image
名称 类型 必选 描述
id
 
string

镜像 ID。

links
 
Array of NovaLink objects

云服务器类型相关标记快捷链接信息。

200 servers.addresses: Map<String,Array>
名称 类型 必选 描述
addr
 
string

IP地址。

version
 
integer

IP地址类型,值为4或6。

4:IP地址类型是IPv4 6:IP地址类型是IPv6

OS-EXT-IPS-MAC:mac_addr
 
string

扩展属性,MAC地址。

OS-EXT-IPS:type
 
string

扩展属性,分配IP地址方式。

200 servers.security_groups
名称 类型 必选 描述
name
 
string

安全组名称或者uuid。

200 servers.os-extended-volumes:volumes_attached
名称 类型 必选 描述
id
 
string

云磁盘ID。

delete_on_termination
 
boolean

一个标志,指示在删除服务器时是否删除附加的卷。、

默认情况下,这是False

微版本2.3后支持

200 servers.fault
名称 类型 必选 描述
code
 
integer

错误码。

created
 
string

异常出现的时间。

message
 
string

异常描述信息。

details
 
string

异常详情信息。

200 servers.os:scheduler_hints
名称 类型 必选 描述
tenancy
 
Array of strings

在指定的 专属主机 或者共享主机上创建弹性云服务器。 参数值为shared或者dedicated。

dedicated_host_id
 
Array of strings

专属主机ID。 此属性仅在tenancy值为dedicated时有效。

请求示例
示例 1
 
"GET https://{endpoint}/v2.1/{project_id}/servers/detail?limit=10"
返回示例
返回码:200

OK

示例 1
 
{
"servers": [
{
"addresses": {
"68269e6e-4a27-441b-8029-35373ad50bd9": [
{
"addr": "192.168.0.3",
"version": 4
}
]
},
"created": "2012-09-07T16:56:37Z",
"flavor": {
"id": "1",
"links": [
{
"href": "http://openstack.example.com/openstack/flavors/1",
"rel": "bookmark"
}
]
},
"hostId": "16d193736a5cfdb60c697ca27ad071d6126fa13baeb670fc9d10645e",
"id": "05184ba3-00ba-4fbc-b7a2-03b62b884931",
"image": "",
"links": [
{
"href": "http://openstack.example.com/v2/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "self"
},
{
"href": "http://openstack.example.com/openstack/servers/05184ba3-00ba-4fbc-b7a2-03b62b884931",
"rel": "bookmark"
}
],
"metadata": {},
"name": "new-server-test",
"progress": 0,
"status": "ACTIVE",
"tenant_id": "openstack",
"updated": "2012-09-07T16:56:37Z",
"user_id": "fake"
}
]
}
SDK
点击 弹性云服务器 (ECS) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明

上一篇:什么是全量备份 下一篇:大数据离线处理场景化解决方案

弹性云服务器 ECS

 

弹性云服务器(Elastic Cloud Server)是一种可随时自助获取、可弹性伸缩的云服务器,帮助用户打造可靠、安全、灵活、高效的应用环境,确保服务持久稳定运行,提升运维效率