Cinder API v2.0

The purpose of this blueprint is to record the API improvements discussed at the Grizzley design summit to create the v2.0 cinder API. The etherpad from the original discussion is available at:

https://etherpad.openstack.org/grizzly-cinder-api2-0

General Requirements
====================

1. The current v1.0 cinder API will still be made available for backwards compatibility, but marked and documented as deprecated.
2. The v2.0 API will start with the current v1.0 API, updated with the new features.
3. The v2.0 API will have a version prefix of /v2/

New API Features
================

The following features must be made available in the v2.0 api (in no particular order)

1. Add capability to update metadata for volumes and snapshots
2. Add filtering of API requests by attributes and metadata (for example list volumes or snapshots by name, date, etc.)
3. Add Markers and Pagination in line with the other openstack projects
4. Add capability to delete volumes that have snapshots
5. Add capability to list snapshots filtred by volume ID
6. Update /volumes and /volumes/details to match behavior of other openstack projects
7. Update limits and quotas to key on volume_type and not be global
8. Change ID of volume types to be a UUID and change all references to volume type in the API to use the UUID rather than the volume type name
9. Change "display_name" attribute to "name" in the API for consistency with other services.
10. Add a field to display what instance is being attached to when in the "attaching" state.

Nice to Have Features
=====================

The following features would be nice to have, but are not absolutely required for the v2.0 API:

1. Add capability to create a volume and attach to an instance in a single API call
2. Add better error messaging when an attach or detach fails