Add ‘volume_type’ parameter to instance create

Add ‘volume_type’ parameter to instance create

Cinder allows for multiple storage backends. When creating a volume, the ‘volume_type’ parameter will be used in determining which type of backend to send to. 1 The user should be allowed to specify the backends for Trove volumes on instance/cluster creation.

Launchpad Blueprint:

Problem Description

Trove operators would like to expose different types of storage to their Trove users to provide more flexibility in the types of configurations they can use for their database instances and database clusters

Proposed Change

An optional ‘volume_type’ property will be added to the volume information accepted by the API for instance and cluster create API calls. This property will be passed to the Cinder client when a new Trove volume gets created. Default configuration value will be used if no volume_type is specified by the user.





Public API

An optional ‘volume_type’ property will be added to the volume information structure accepted by the instance and cluster create API calls.

API payload defining a volume of size ‘1’ and Cinder volume type ‘my-type-1’:

'volume': {'size': '1', 'type': 'my-type-1'}

API payload defining a volume of size ‘1’ and no Cinder volume type:

'volume': {'size': '1', 'type': None}
'volume': {'size': '1'}

Public API Security


Python API


CLI (python-troveclient)

The volume_type value is a string name of the volume type as returned by the ‘cinder type-list’ command. The value won’t be validated on the client site.

For instance creation an optional ‘–volume_type’ argument will be added. The volume type will be appended to the volume size in the volume information structure. If volume support is disabled or ‘–size’ argument is not specified on instance create the ‘volume_type’ argument will be ignored.

trove create ... --size 1 --volume_type my-type-1 ...

For cluster creation the ‘–instance’ argument will be extended with a ‘volume_type’ option. If volume support is not enabled or volume size is not specified the ‘volume_type’ option will be ignored.

trove cluster-create ... --instance volume=1,volume_type=my-type-1 ...

Internal API

A new ‘volume_type’ argument will be added where necessary.

Guest Agent




Dashboard Impact (UX)

TBD (section added after approval)






Work Items

This work will consist of updates to the Trove client and server code.

Upgrade Implications





The existing Trove tests will be extended to test the ‘volume_type’ argument. New client tests will be added to cover the added arguments.

Documentation Impact

The new ‘volume_type’ arguments on instance and cluster create commands need to be documented.



Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.

trove-specs 0.0.1.dev177