文档首页> > API参考> OpenStack Nova API> 生命周期管理> 查询云服务器列表

查询云服务器列表

更新时间: 2018-11-19 16:52

功能介绍

查询云服务器信息列表。

URI

GET /v2/{project_id}/servers{?changes-since,image,flavor,name,status,limit,marker,not-tags,reservation_id}

GET /v2.1/{project_id}/servers{?changes-since,image,flavor,name,status,limit,marker,not-tags,reservation_id}

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

参数

是否必选

描述

project_id

项目ID。

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

请求消息

请求参数

请求参数如表2所示。

表2 请求参数

参数

是否必选

参数类型

描述

changes-since

String:DateTime

云服务器上次更新状态的时间戳信息。格式符合ISO 8601,例如:

CCYY-MM-DDThh:mm:ss+/-hh:mm

说明:

可以查询到“deleted”状态的弹性云服务器。

image

String

镜像ID。

在使用image作为条件过滤时,不能同时支持其他过滤条件和分页条件。如果同时指定image及其他条件,则以image条件为准;当条件不含image时,接口功能不受限制。

flavor

String

云服务器类型ID。

name

String

云服务器名称。

status

String

云服务器状态。

取值范围:

ACTIVE, BUILD,ERROR,HARD_REBOOT,MIGRATING,REBOOT,RESIZE,REVERT_RESIZE,SHELVED,SHELVED_OFFLOADED,SHUTOFF,UNKNOWN,VERIFY_RESIZE

limit

Integer

查询返回云服务器数量限制。

marker

String

从marker指定的云服务器ID的下一条数据开始查询。

not-tags

String

查询tag字段中不包含该值的云服务器,值为标签的Key。

说明:

系统近期对标签功能进行了升级。如果之前添加的Tag为“Key.Value”的形式,则查询的时候需要使用“Key”来查询。

例如:之前添加的tag为“a.b”,则升级后,查询时需使用“not-tags=a”。

reservation_id

String

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

sort_key

String

查询结果按弹性云服务器属性排序,默认排序顺序为create_at逆序。

响应消息

响应参数

响应参数如表3所示。

表3 响应参数

参数

参数类型

描述

servers

列表数据结构

查询云服务器信息列表,请参见表4

表4 servers字段数据结构说明

参数

参数类型

描述

name

String

云服务器名称。

id

String

云服务器唯一标识。

links

列表数据结构

云服务器相关快捷链接信息,详情请参见表5

表5 links字段数据结构说明

参数

参数类型

描述

rel

String

快捷链接标记名称。

href

String

对应快捷链接。

示例

  • 响应示例
    {
        "servers": [
            {
                "id": "616fb98f-46ca-475e-917e-2563e5a8cd19", 
                "links": [
                    {
                        "href": "http://openstack.example.com/v2/openstack/servers/616fb98f-46ca-475e-917e-2563e5a8cd19", 
                        "rel": "self"
                    }, 
                    {
                        "href": "http://openstack.example.com/openstack/servers/616fb98f-46ca-475e-917e-2563e5a8cd19", 
                        "rel": "bookmark"
                    }
                ], 
                "name": "new-server-test"
            }
        ]
    }

返回值

请参考通用请求返回值

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

提交成功!

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

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

在文档使用中是否遇到以下问题







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

字符长度不能超过100

反馈内容不能为空!

提交反馈 取消

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

跳转到云社区