Nova/ImageFilterSpec
- Launchpad 条目：NovaSpec:osapi-image-filtering
- 创建时间：2011年5月26日
- 贡献者：AlexMeade
目录
总结
Glance REST API 最近实现了在 /images 和 /images/detail 资源上添加查询参数的功能。 本规范旨在提出通过 Nova REST API 暴露这些更改的建议。
发布说明
Nova API 扩展了对查询参数的支持，允许用户在使用 Glance 镜像服务时过滤返回的镜像集合。
原理
返回大量的镜像集合可能会使有效地利用信息变得困难。 允许过滤这些结果可以帮助用户缩小返回结果的范围，使其易于管理。
用户故事
作为具有特定镜像要求的服务提供商，我只需要列出具有特定元数据的镜像。
作为想要重建服务器的客户，我需要找到一个具有特定名称的镜像。
前提条件
Glance 支持将过滤参数添加到 /images 和 /images/detail 资源上的查询中。
设计
Glance 镜像参数有两种类型：描述每个镜像的核心参数和用户自定义参数。
核心参数
核心参数是与镜像一起存储的值，可以通过 API 查询字符串进行查询。
支持以下核心查询参数
| 参数 |
| name |
| status |
用户自定义参数
用户自定义值通过 x-image-meta-* HTTP 标头设置，并通过相同的标头（通过 GET 请求）进行查询。
要根据其他元数据参数检索镜像，请使用查询字符串 ?property-{name}，其中 {name} 是用于 x-image-meta-property-* 标头的值。 例如，如果镜像使用如下标头存储：
x-image-meta-property-rax-managed: Yes
那么可以使用以下查询检索该镜像：
/images?property-rax-managed=Yes
实现
代码变更
更新 nova/images 以允许过滤参数，对测试进行少量添加
测试/演示计划
这不必在规范接近 Beta 之前添加或完成。
未解决的问题
这应该突出显示需要在进一步的规范中解决的任何问题，而不是规范本身的问题；因为任何存在问题的规范都无法获得批准。
BoF 议程和讨论
使用本节记录 BoF 期间的笔记；如果将其保留在批准的规范中，请用于总结讨论内容并记录任何被拒绝的选项。
