服务器列表 API 支持指定多状态¶

https://blueprints.launchpad.net/nova/+spec/servers-list-support-multi-status

允许在服务器列表 API 中同时指定多个状态值。

问题描述¶

目前服务器列表 API 允许用户指定一个可选的状态值作为过滤器 - 例如，将列表限制为仅具有“Active”状态的服务器。

然而，用户通常希望通过一组状态值来过滤列表，例如列出状态为“Active”或“Error”的服务器，这需要两个单独的 API 调用。

允许 API 接受状态值列表将减少到单个 API 调用。

提议的变更¶

启用服务器列表 API 以支持同时指定多个状态值。

备选方案¶

无

数据模型影响¶

无

REST API 影响¶

允许在请求中多次指定状态值。

例如

GET /v2/{tenant_id}/servers?status=ACTIVE&status=ERROR
GET /v3/servers?status=ACTIVE&status=ERROR

V2 API 扩展

{
    "alias": "os-server-list-multi-status",
    "description": "Allow to filter the
        servers by a set of status values.",
    "links": [],
    "name": "ServerListMultiStatus",
    "namespace": "https://docs.openstack.org/compute/ext/
        os-server-list-multi-status/api/v2",
    "updated": "2014-05-11T00:00:00Z"
}

安全影响¶

无

通知影响¶

无

其他最终用户影响¶

无

性能影响¶

无

其他部署者影响¶

无

开发人员影响¶

无

实现¶

负责人¶

主要负责人: boh.ricky

工作项¶

实现服务器列表 API 对同时指定多个状态值的支持。

依赖项¶

无

测试¶

无

文档影响¶

需要在 API 文档中进行记录。

参考资料¶

无

servers list API 支持指定多状态