cinder-specs/specs/mitaka/support-volume-glance-metadata-query.rst
Allison Randal 91392d5432 Minor format fixes for Cinder Mitaka specs
Several small RST format fixes, which cause parsing warnings and
errors, and render oddly on specs.openstack.org. Discovered while
working on a spec parsing tool to replace the retired releasestatus
tool.

Change-Id: Ice06999e51f1dd997d370273aae750b3c5ad2ee2
2016-03-15 13:39:15 -04:00

2.5 KiB

Support query volume detail with glance metadata

https://blueprints.launchpad.net/cinder/+spec/support-volume-glance-metadata-query

Provide a function to support query volume detail filter by glance metadata.

Problem description

The purpose of this feature is to make user to query volume detail more conveniently. User can query a specific bootable volume quickly filtering by image_name or other glance metadata.

Use Cases

At large scale deployment, there could be many bootable volumes in a tenant. So if user want query some bootable volume detail filtering by the image name or other info came from glance metadata, they could use this feature to query it more conveniently. No need to list all volumes and find what you want tiring.

Proposed change

  • Add DB query filter using volume_glance_metadata in api of sqlaclchemy.

  • User can use glance metadata to filter volume detail in cinder api. The query url is like this:

    "volumes/detail?glance_metadata={"image_name":"xxx"}"

Alternatives

None

Data model impact

None

REST API impact

Add query filter support using glance metadata:
  • GET /v2/{project_id}/volumes/detail?glance_metadata={"image_name":"xxx"}

Security impact

None

Notifications impact

None.

Other end user impact

None

Performance Impact

Search a lot of glance metadata may take longer than other querying. It may need add new index to column key and value in volume_glance_metadata table to improve searching performance.

Other deployer impact

None

Developer impact

None

Implementation

Assignee(s)

Primary assignee:

wanghao<wanghao749@huawei.com>

Work Items

  • Implement code in db query filter.
  • Update cinderclient to support this function.
  • Add change API doc.

Dependencies

None

Testing

Both unit and Tempest tests need to be created to cover the code change that mentioned in "Proposed change".

Documentation Impact

  1. The cinder API documentation will need to be updated to reflect the REST API changes.

References

None