Lists information for all Block Storage API versions.
Normal response codes: 300
Error response codes: computeFault(400, 500), serviceUnavailable(503), badRequest(400), unauthorized(401), forbidden(403), badMethod(405), itemNotFound(404), conflict(409)
Example List Api Versions: JSON request
{
"versions": [
{
"status": "DEPRECATED",
"updated": "2014-06-28T12:20:21Z",
"links": [
{
"href": "http://docs.openstack.org/",
"type": "text/html",
"rel": "describedby"
},
{
"href": "http://10.0.2.15:8776/v1/",
"rel": "self"
}
],
"min_version": "",
"version": "",
"media-types": [
{
"base": "application/json",
"type": "application/vnd.openstack.volume+json;version=1"
}
],
"id": "v1.0"
},
{
"status": "SUPPORTED",
"updated": "2014-06-28T12:20:21Z",
"links": [
{
"href": "http://docs.openstack.org/",
"type": "text/html",
"rel": "describedby"
},
{
"href": "http://10.0.2.15:8776/v2/",
"rel": "self"
}
],
"min_version": "",
"version": "",
"media-types": [
{
"base": "application/json",
"type": "application/vnd.openstack.volume+json;version=2"
}
],
"id": "v2.0"
},
{
"status": "CURRENT",
"updated": "2016-02-08T12:20:21Z",
"links": [
{
"href": "http://docs.openstack.org/",
"type": "text/html",
"rel": "describedby"
},
{
"href": "http://10.0.2.15:8776/v3/",
"rel": "self"
}
],
"min_version": "3.0",
"version": "{Current_Max_Version}",
"media-types": [
{
"base": "application/json",
"type": "application/vnd.openstack.volume+json;version=3"
}
],
"id": "v3.0"
}
]
}
Shows details for Block Storage API v3.
Normal response codes: 200 Error response codes:203,
Name | In | Type | Description |
---|---|---|---|
location | body | string | Full URL to a service or server. |
{
"versions": [
{
"id": "v1.0",
"links": [
{
"href": "http://docs.openstack.org/",
"rel": "describedby",
"type": "text/html"
},
{
"href": "http://23.253.248.171:8776/v1/",
"rel": "self"
}
],
"media-types": [
{
"base": "application/json",
"type": "application/vnd.openstack.volume+json;version=1"
}
],
"min_version": "",
"status": "DEPRECATED",
"updated": "2014-06-28T12:20:21Z",
"version": ""
},
{
"id": "v2.0",
"links": [
{
"href": "http://docs.openstack.org/",
"rel": "describedby",
"type": "text/html"
},
{
"href": "http://23.253.248.171:8776/v2/",
"rel": "self"
}
],
"media-types": [
{
"base": "application/json",
"type": "application/vnd.openstack.volume+json;version=1"
}
],
"min_version": "",
"status": "SUPPORTED",
"updated": "2014-06-28T12:20:21Z",
"version": ""
},
{
"id": "v3.0",
"links": [
{
"href": "http://docs.openstack.org/",
"rel": "describedby",
"type": "text/html"
},
{
"href": "http://23.253.248.171:8776/v3/",
"rel": "self"
}
],
"media-types": [
{
"base": "application/json",
"type": "application/vnd.openstack.volume+json;version=1"
}
],
"min_version": "3.0",
"status": "CURRENT",
"updated": "2016-02-08T12:20:21Z",
"version": "3.0"
}
]
}
Lists Block Storage API extensions.
Normal response codes: 200 Error response codes:300,
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
Name | In | Type | Description |
---|---|---|---|
updated | body | string | The date and time stamp when the extension was last updated. |
description | body | string | The backup description or null. |
links | body | array | Links for the volume transfer. |
namespace | body | string | Link associated to the extension. |
alias | body | string | The alias for the extension. For example, “FOXNSOX”, “os- availability-zone”, “os-extended-quotas”, “os- share-unmanage” or “os-used-limits.” |
name | body | string | The name of the Volume Transfer. |
{
"extensions": [
{
"updated": "2013-04-18T00:00:00+00:00",
"name": "SchedulerHints",
"links": [],
"namespace": "http://docs.openstack.org/block-service/ext/scheduler-hints/api/v3",
"alias": "OS-SCH-HNT",
"description": "Pass arbitrary key/value pairs to the scheduler."
},
{
"updated": "2011-06-29T00:00:00+00:00",
"name": "Hosts",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/hosts/api/v1.1",
"alias": "os-hosts",
"description": "Admin-only host administration."
},
{
"updated": "2011-11-03T00:00:00+00:00",
"name": "VolumeTenantAttribute",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/volume_tenant_attribute/api/v1",
"alias": "os-vol-tenant-attr",
"description": "Expose the internal project_id as an attribute of a volume."
},
{
"updated": "2011-08-08T00:00:00+00:00",
"name": "Quotas",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/quotas-sets/api/v1.1",
"alias": "os-quota-sets",
"description": "Quota management support."
},
{
"updated": "2011-08-24T00:00:00+00:00",
"name": "TypesManage",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/types-manage/api/v1",
"alias": "os-types-manage",
"description": "Types manage support."
},
{
"updated": "2013-07-10T00:00:00+00:00",
"name": "VolumeEncryptionMetadata",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/os-volume-encryption-metadata/api/v1",
"alias": "os-volume-encryption-metadata",
"description": "Volume encryption metadata retrieval support."
},
{
"updated": "2012-12-12T00:00:00+00:00",
"name": "Backups",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/backups/api/v1",
"alias": "backups",
"description": "Backups support."
},
{
"updated": "2013-07-16T00:00:00+00:00",
"name": "SnapshotActions",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/snapshot-actions/api/v1.1",
"alias": "os-snapshot-actions",
"description": "Enable snapshot manager actions."
},
{
"updated": "2012-05-31T00:00:00+00:00",
"name": "VolumeActions",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/volume-actions/api/v1.1",
"alias": "os-volume-actions",
"description": "Enable volume actions\n "
},
{
"updated": "2013-10-03T00:00:00+00:00",
"name": "UsedLimits",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/used-limits/api/v1.1",
"alias": "os-used-limits",
"description": "Provide data on limited resources that are being used."
},
{
"updated": "2012-05-31T00:00:00+00:00",
"name": "VolumeUnmanage",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/volume-unmanage/api/v1.1",
"alias": "os-volume-unmanage",
"description": "Enable volume unmanage operation."
},
{
"updated": "2011-11-03T00:00:00+00:00",
"name": "VolumeHostAttribute",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/volume_host_attribute/api/v1",
"alias": "os-vol-host-attr",
"description": "Expose host as an attribute of a volume."
},
{
"updated": "2013-07-01T00:00:00+00:00",
"name": "VolumeTypeEncryption",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/volume-type-encryption/api/v1",
"alias": "encryption",
"description": "Encryption support for volume types."
},
{
"updated": "2013-06-27T00:00:00+00:00",
"name": "AvailabilityZones",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/os-availability-zone/api/v1",
"alias": "os-availability-zone",
"description": "Describe Availability Zones."
},
{
"updated": "2013-08-02T00:00:00+00:00",
"name": "Qos_specs_manage",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/qos-specs/api/v1",
"alias": "qos-specs",
"description": "QoS specs support."
},
{
"updated": "2011-08-24T00:00:00+00:00",
"name": "TypesExtraSpecs",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/types-extra-specs/api/v1",
"alias": "os-types-extra-specs",
"description": "Type extra specs support."
},
{
"updated": "2013-08-08T00:00:00+00:00",
"name": "VolumeMigStatusAttribute",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/volume_mig_status_attribute/api/v1",
"alias": "os-vol-mig-status-attr",
"description": "Expose migration_status as an attribute of a volume."
},
{
"updated": "2012-08-13T00:00:00+00:00",
"name": "CreateVolumeExtension",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/image-create/api/v1",
"alias": "os-image-create",
"description": "Allow creating a volume from an image in the Create Volume v1 API."
},
{
"updated": "2014-01-10T00:00:00-00:00",
"name": "ExtendedServices",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/extended_services/api/v3",
"alias": "os-extended-services",
"description": "Extended services support."
},
{
"updated": "2012-06-19T00:00:00+00:00",
"name": "ExtendedSnapshotAttributes",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/extended_snapshot_attributes/api/v1",
"alias": "os-extended-snapshot-attributes",
"description": "Extended SnapshotAttributes support."
},
{
"updated": "2012-12-07T00:00:00+00:00",
"name": "VolumeImageMetadata",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/volume_image_metadata/api/v1",
"alias": "os-vol-image-meta",
"description": "Show image metadata associated with the volume."
},
{
"updated": "2012-03-12T00:00:00+00:00",
"name": "QuotaClasses",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/quota-classes-sets/api/v1.1",
"alias": "os-quota-class-sets",
"description": "Quota classes management support."
},
{
"updated": "2013-05-29T00:00:00+00:00",
"name": "VolumeTransfer",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/volume-transfer/api/v1.1",
"alias": "os-volume-transfer",
"description": "Volume transfer management support."
},
{
"updated": "2014-02-10T00:00:00+00:00",
"name": "VolumeManage",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/os-volume-manage/api/v1",
"alias": "os-volume-manage",
"description": "Allows existing backend storage to be 'managed' by Cinder."
},
{
"updated": "2012-08-25T00:00:00+00:00",
"name": "AdminActions",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/admin-actions/api/v1.1",
"alias": "os-admin-actions",
"description": "Enable admin actions."
},
{
"updated": "2012-10-28T00:00:00-00:00",
"name": "Services",
"links": [],
"namespace": "http://docs.openstack.org/volume/ext/services/api/v3",
"alias": "os-services",
"description": "Services support."
}
]
}
Updates a volume type.
To create an environment with multiple-storage back ends, you must
specify a volume type. The API spawns Block Storage volume back
ends as children to cinder-volume
, and keys them from a unique
queue. The API names the back ends cinder-volume.HOST.BACKEND
.
For example, cinder-volume.ubuntu.lvmdriver
. When you create a
volume, the scheduler chooses an appropriate back end for the
volume type to handle the request.
For information about how to use volume types to create multiple- storage back ends, see Configure multiple-storage back ends.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
volume_type_id (Optional) | path | string | The UUID for an existing volume type. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"volume_type": {
"name": "vol-type-001",
"description": "volume type 0001",
"is_public": true,
"extra_specs": {
"capabilities": "gpu"
}
}
}
Name | In | Type | Description |
---|---|---|---|
is_public (Optional) | body | boolean | Volume type which is accessible to the public. |
extra_specs | body | object | A set of key and value pairs that contains the specifications for a volume type. |
description | body | string | The backup description or null. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
name | body | string | The name of the Volume Transfer. |
{
"volume_type": {
"id": "6685584b-1eac-4da6-b5c3-555430cf68ff",
"name": "vol-type-001",
"description": "volume type 001",
"is_public": "true",
"extra_specs": {
"capabilities": "gpu"
}
}
}
Updates the extra specifications that are assigned to a volume type.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
extra_specs | body | object | A set of key and value pairs that contains the specifications for a volume type. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
volume_type_id (Optional) | path | string | The UUID for an existing volume type. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"volume_type": {
"name": "vol-type-001",
"description": "volume type 0001",
"is_public": true,
"extra_specs": {
"capabilities": "gpu"
}
}
}
Name | In | Type | Description |
---|---|---|---|
is_public (Optional) | body | boolean | Volume type which is accessible to the public. |
extra_specs | body | object | A set of key and value pairs that contains the specifications for a volume type. |
description | body | string | The backup description or null. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
name | body | string | The name of the Volume Transfer. |
{
"volume_type": {
"id": "6685584b-1eac-4da6-b5c3-555430cf68ff",
"name": "vol-type-001",
"description": "volume type 001",
"is_public": "true",
"extra_specs": {
"capabilities": "gpu"
}
}
}
Shows details for a volume type.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
volume_type_id (Optional) | path | string | The UUID for an existing volume type. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
Name | In | Type | Description |
---|---|---|---|
is_public (Optional) | body | boolean | Volume type which is accessible to the public. |
extra_specs | body | object | A set of key and value pairs that contains the specifications for a volume type. |
description | body | string | The backup description or null. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
name | body | string | The name of the Volume Transfer. |
{
"volume_type": {
"id": "6685584b-1eac-4da6-b5c3-555430cf68ff",
"name": "vol-type-001",
"description": "volume type 001",
"is_public": "true",
"extra_specs": {
"capabilities": "gpu"
}
}
}
Deletes a volume type.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
volume_type_id (Optional) | path | string | The UUID for an existing volume type. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
Lists volume types.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
volume_types | body | array | The list of volume types. In an environment with multiple-storage back ends, the scheduler determines where to send the volume based on the volume type. For information about how to use volume types to create multiple- storage back ends, see Configure multiple-storage back ends. |
extra_specs | body | object | A set of key and value pairs that contains the specifications for a volume type. |
name | body | string | The name of the Volume Transfer. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
{
"volume_types": [
{
"extra_specs": {
"capabilities": "gpu"
},
"id": "6685584b-1eac-4da6-b5c3-555430cf68ff",
"name": "SSD"
},
{
"extra_specs": {},
"id": "8eb69a46-df97-4e41-9586-9a40a7533803",
"name": "SATA"
}
]
}
Creates a volume type.
To create an environment with multiple-storage back ends, you must
specify a volume type. Block Storage volume back ends are spawned
as children to cinder-volume
, and they are keyed from a unique
queue. They are named cinder-volume.HOST.BACKEND
. For example,
cinder-volume.ubuntu.lvmdriver
. When a volume is created, the
scheduler chooses an appropriate back end to handle the request
based on the volume type.
For information about how to use volume types to create multiple- storage back ends, see Configure multiple-storage back ends.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"volume_type": {
"name": "vol-type-001",
"description": "volume type 0001",
"os-volume-type-access:is_public": true,
"extra_specs": {
"capabilities": "gpu"
}
}
}
Name | In | Type | Description |
---|---|---|---|
is_public (Optional) | body | boolean | Volume type which is accessible to the public. |
extra_specs | body | object | A set of key and value pairs that contains the specifications for a volume type. |
description | body | string | The backup description or null. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
name | body | string | The name of the Volume Transfer. |
{
"volume_type": {
"id": "6685584b-1eac-4da6-b5c3-555430cf68ff",
"name": "vol-type-001",
"description": "volume type 001",
"is_public": "true",
"extra_specs": {
"capabilities": "gpu"
}
}
}
Show an encryption type.
To show an encryption type for an existing volume type.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
volume_type_id (Optional) | path | string | The UUID for an existing volume type. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
Name | In | Type | Description |
---|---|---|---|
volume_type_id | body | string | The UUID of the volume type. |
encryption_id | path | string | The ID of the encryption type. |
encryption | body | object | The encryption information. |
key_size (Optional) | body | integer | Size of encryption key, in bits. For example, 128 or 256. The default value is None. |
provider | body | string | The class that provides encryption support. |
control_location (Optional) | body | string | Notional service where encryption is performed. Valid values are “front-end” or “back-end”. The default value is “front-end”. |
cipher (Optional) | body | string | The encryption algorithm or mode. For example, aes-xts-plain64. The default value is None. |
deleted | body | boolean | The resource is deleted or not. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
updated_at | body | string | The date and time when the resource was updated. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The If the |
deleted_at | body | string | The date and time when the resource was deleted. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The If the |
{
"volume_type_id": "2d29462d-76cb-417c-8a9f-fb23140f1577",
"control_location": "front-end",
"deleted": false,
"created_at": "2016-12-28T02:32:25.000000",
"updated_at": null,
"encryption_id": "81e069c6-7394-4856-8df7-3b237ca61f74",
"key_size": 128,
"provider": "nova.volume.encryptors.luks.LuksEncryptor",
"deleted_at": null,
"cipher": "aes-xts-plain64"
}
Delete an encryption type.
To delete an encryption type for an existing volume type.
Normal response codes: 202 Error response codes:
Name | In | Type | Description |
---|---|---|---|
volume_type_id (Optional) | path | string | The UUID for an existing volume type. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
encryption_id | path | string | The ID of the encryption type. |
Creates an encryption type.
To create an encryption type for an existing volume type.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
volume_type_id (Optional) | path | string | The UUID for an existing volume type. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
encryption | body | object | The encryption information. |
key_size (Optional) | body | integer | Size of encryption key, in bits. For example, 128 or 256. The default value is None. |
provider | body | string | The class that provides encryption support. |
control_location (Optional) | body | string | Notional service where encryption is performed. Valid values are “front-end” or “back-end”. The default value is “front-end”. |
cipher (Optional) | body | string | The encryption algorithm or mode. For example, aes-xts-plain64. The default value is None. |
{
"encryption":{
"key_size": 128,
"provider": "nova.volume.encryptors.luks.LuksEncryptor",
"control_location":"front-end",
"cipher": "aes-xts-plain64"
}
}
Name | In | Type | Description |
---|---|---|---|
volume_type_id | body | string | The UUID of the volume type. |
encryption_id | path | string | The ID of the encryption type. |
encryption | body | object | The encryption information. |
key_size (Optional) | body | integer | Size of encryption key, in bits. For example, 128 or 256. The default value is None. |
provider | body | string | The class that provides encryption support. |
control_location (Optional) | body | string | Notional service where encryption is performed. Valid values are “front-end” or “back-end”. The default value is “front-end”. |
cipher (Optional) | body | string | The encryption algorithm or mode. For example, aes-xts-plain64. The default value is None. |
{
"encryption": {
"volume_type_id": "2d29462d-76cb-417c-8a9f-fb23140f1577",
"control_location": "front-end",
"encryption_id": "81e069c6-7394-4856-8df7-3b237ca61f74",
"key_size": 128,
"provider": "nova.volume.encryptors.luks.LuksEncryptor",
"cipher": "aes-xts-plain64"
}
}
Update an encryption type.
To update an encryption type for an existing volume type.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
volume_type_id (Optional) | path | string | The UUID for an existing volume type. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
encryption_id | path | string | The ID of the encryption type. |
encryption | body | object | The encryption information. |
key_size (Optional) | body | integer | Size of encryption key, in bits. For example, 128 or 256. The default value is None. |
provider (Optional) | body | string | The class that provides encryption support. |
control_location (Optional) | body | string | Notional service where encryption is performed. Valid values are “front-end” or “back-end”. The default value is “front-end”. |
cipher (Optional) | body | string | The encryption algorithm or mode. For example, aes-xts-plain64. The default value is None. |
{
"encryption":{
"key_size": 64,
"provider": "cinder.keymgr.conf_key_mgr.ConfKeyManager",
"control_location":"back-end"
}
}
Name | In | Type | Description |
---|---|---|---|
encryption | body | object | The encryption information. |
key_size (Optional) | body | integer | Size of encryption key, in bits. For example, 128 or 256. The default value is None. |
provider (Optional) | body | string | The class that provides encryption support. |
control_location (Optional) | body | string | Notional service where encryption is performed. Valid values are “front-end” or “back-end”. The default value is “front-end”. |
cipher (Optional) | body | string | The encryption algorithm or mode. For example, aes-xts-plain64. The default value is None. |
{
"encryption":{
"key_size": 64,
"provider": "cinder.keymgr.conf_key_mgr.ConfKeyManager",
"control_location":"back-end"
}
}
Private volume type access to project.
By default, volumes types are public. To create a private volume
type, set the is_public
boolean field to false
at volume
type creation time. To control access to a private volume type,
user needs to add a project to or remove a project from the volume
type. Private volume types without projects are only accessible by
users with the administrative role and context.
Adds private volume type access to a project.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
project | body | string | The ID of the project. Volume Type access to be added to this project ID. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
{
"addProjectAccess": {
"project": "f270b245cb11498ca4031deb7e141cfa"
}
}
Removes private volume type access from a project.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
project | body | string | The ID of the project. Volume Type access to be added to this project ID. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
{
"removeProjectAccess": {
"project": "f270b245cb11498ca4031deb7e141cfa"
}
}
Lists project IDs that have access to private volume type.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
Name | In | Type | Description |
---|---|---|---|
project_id | body | string | The UUID of the project. |
{
"volume_type_access": {
"volume_type_id": "3c67e124-39ad-4ace-a507-8bb7bf510c26",
"project_id": "f270b245cb11498ca4031deb7e141cfa"
}
}
A volume is a detachable block storage device similar to a USB hard drive. You can attach a volume to one instance at a time.
The snapshot_id
and source_volid
parameters specify the ID
of the snapshot or volume from which this volume originates. If the
volume was not created from a snapshot or source volume, these
values are null.
When you create, list, update, or delete volumes, the possible status values are:
Volume statuses
Status | Description |
creating | The volume is being created. |
available | The volume is ready to attach to an instance. |
attaching | The volume is attaching to an instance. |
detaching | The volume is detaching from an instance. |
in-use | The volume is attached to an instance. |
maintenance | The volume is locked and being migrated. |
deleting | The volume is being deleted. |
awaiting-transfer | The volume is awaiting for transfer. |
error | A volume creation error occurred. |
error_deleting | A volume deletion error occurred. |
backing-up | The volume is being backed up. |
restoring-backup | A backup is being restored to the volume. |
error_backing-up | A backup error occurred. |
error_restoring | A backup restoration error occurred. |
error_extending | An error occurred while attempting to extend a volume. |
downloading | The volume is downloading an image. |
uploading | The volume is being uploaded to an image. |
retyping | The volume is changing type to another volume type. |
extending | The volume is being extended. |
Lists all Block Storage volumes, with details, that the project can access, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
migration_status | body | string | The volume migration status. |
attachments | body | array | Instance attachment information. If this volume is attached to a server instance, the attachments list includes the UUID of the attached server, an attachment UUID, the name of the attached host, if any, the volume UUID, the device, and the device UUID. Otherwise, this list is empty. |
links | body | array | Links for the volume transfer. |
availability_zone (Optional) | body | string | The name of the availability zone. |
os-vol-host-attr:host | body | string | Current back-end of the volume. |
encrypted | body | boolean | If true, this volume is encrypted. |
updated_at | body | string | The date and time when the resource was updated. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The If the |
os-volume-replication:extended_status (Optional) | body | string | The volume replication status managed by the driver of backend storage. |
replication_status | body | string | The volume replication status. |
snapshot_id (Optional) | body | string | To create a volume from an existing snapshot, specify the UUID of the volume snapshot. The volume is created in same availability zone and with same size as the snapshot. |
id | body | string | The UUID of the volume transfer. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
user_id | body | string | The UUID of the user. |
os-vol-tenant-attr:tenant_id | body | string | The tenant ID which the volume belongs to. |
os-vol-mig-status-attr:migstat | body | string | The status of this volume migration (None means that a migration is not currently in progress). |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
status | body | string | The volume status. |
description | body | string | The backup description or null. |
multiattach (Optional) | body | boolean | To enable this volume to attach to more than one
server, set this value to true . Default is false . |
source_volid (Optional) | body | string | The UUID of the source volume. The API creates a new volume with the same size as the source volume. |
consistencygroup_id | body | string | The UUID of the consistency group. |
os-vol-mig-status-attr:name_id | body | string | The volume ID that this volume name on the back- end is based on. |
name | body | string | The name of the Volume Transfer. |
bootable | body | string | Enables or disables the bootable attribute. You can boot an instance from a bootable volume. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
os-volume-replication:driver_data (Optional) | body | string | The name of the volume replication driver. |
volumes | body | array | A list of volume objects. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
{
"volumes": [
{
"migration_status": null,
"attachments": [
{
"server_id": "f4fda93b-06e0-4743-8117-bc8bcecd651b",
"attachment_id": "3b4db356-253d-4fab-bfa0-e3626c0b8405",
"host_name": null,
"volume_id": "6edbc2f4-1507-44f8-ac0d-eed1d2608d38",
"device": "/dev/vdb",
"id": "6edbc2f4-1507-44f8-ac0d-eed1d2608d38"
}
],
"links": [
{
"href": "http://23.253.248.171:8776/v3/bab7d5c60cd041a0a36f7c4b6e1dd978/volumes/6edbc2f4-1507-44f8-ac0d-eed1d2608d38",
"rel": "self"
},
{
"href": "http://23.253.248.171:8776/bab7d5c60cd041a0a36f7c4b6e1dd978/volumes/6edbc2f4-1507-44f8-ac0d-eed1d2608d38",
"rel": "bookmark"
}
],
"availability_zone": "nova",
"os-vol-host-attr:host": "difleming@lvmdriver-1#lvmdriver-1",
"encrypted": false,
"os-volume-replication:extended_status": null,
"replication_status": "disabled",
"snapshot_id": null,
"id": "6edbc2f4-1507-44f8-ac0d-eed1d2608d38",
"size": 2,
"user_id": "32779452fcd34ae1a53a797ac8a1e064",
"os-vol-tenant-attr:tenant_id": "bab7d5c60cd041a0a36f7c4b6e1dd978",
"os-vol-mig-status-attr:migstat": null,
"metadata": {
"readonly": false,
"attached_mode": "rw"
},
"status": "in-use",
"description": null,
"multiattach": true,
"os-volume-replication:driver_data": null,
"source_volid": null,
"consistencygroup_id": null,
"os-vol-mig-status-attr:name_id": null,
"name": "test-volume-attachments",
"bootable": "false",
"created_at": "2015-11-29T03:01:44.000000",
"volume_type": "lvmdriver-1"
},
{
"migration_status": null,
"attachments": [],
"links": [
{
"href": "http://23.253.248.171:8776/v3/bab7d5c60cd041a0a36f7c4b6e1dd978/volumes/173f7b48-c4c1-4e70-9acc-086b39073506",
"rel": "self"
},
{
"href": "http://23.253.248.171:8776/bab7d5c60cd041a0a36f7c4b6e1dd978/volumes/173f7b48-c4c1-4e70-9acc-086b39073506",
"rel": "bookmark"
}
],
"availability_zone": "nova",
"os-vol-host-attr:host": "difleming@lvmdriver-1#lvmdriver-1",
"encrypted": false,
"os-volume-replication:extended_status": null,
"replication_status": "disabled",
"snapshot_id": null,
"id": "173f7b48-c4c1-4e70-9acc-086b39073506",
"size": 1,
"user_id": "32779452fcd34ae1a53a797ac8a1e064",
"os-vol-tenant-attr:tenant_id": "bab7d5c60cd041a0a36f7c4b6e1dd978",
"os-vol-mig-status-attr:migstat": null,
"metadata": {},
"status": "available",
"volume_image_metadata": {
"kernel_id": "8a55f5f1-78f7-4477-8168-977d8519342c",
"checksum": "eb9139e4942121f22bbc2afc0400b2a4",
"min_ram": "0",
"ramdisk_id": "5f6bdf8a-92db-4988-865b-60bdd808d9ef",
"disk_format": "ami",
"image_name": "cirros-0.3.4-x86_64-uec",
"image_id": "b48c53e1-9a96-4a5a-a630-2e74ec54ddcc",
"container_format": "ami",
"min_disk": "0",
"size": "25165824"
},
"description": "",
"multiattach": false,
"os-volume-replication:driver_data": null,
"source_volid": null,
"consistencygroup_id": null,
"os-vol-mig-status-attr:name_id": null,
"name": "test-volume",
"bootable": "true",
"created_at": "2015-11-29T02:25:18.000000",
"volume_type": "lvmdriver-1"
}
]
}
Creates a volume.
To create a bootable volume, include the UUID of the image from
which you want to create the volume in the imageRef
attribute
in the request body.
Preconditions
Asynchronous Postconditions
available
through API calls.Troubleshooting
creating
or shows another error
status, the request failed. Ensure you meet the preconditions
then investigate the storage back end.Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
size | body | integer | The size of the volume, in gibibytes (GiB). |
description | body | string | The backup description or null. |
imageRef (Optional) | body | string | The UUID of the image from which you want to create the volume. Required to create a bootable volume. |
multiattach (Optional) | body | boolean | To enable this volume to attach to more than one
server, set this value to true . Default is false . |
availability_zone (Optional) | body | string | The name of the availability zone. |
source_volid (Optional) | body | string | The UUID of the source volume. The API creates a new volume with the same size as the source volume. |
name | body | string | The name of the Volume Transfer. |
volume | body | object | A volume object. |
consistencygroup_id | body | string | The UUID of the consistency group. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
snapshot_id (Optional) | body | string | To create a volume from an existing snapshot, specify the UUID of the volume snapshot. The volume is created in same availability zone and with same size as the snapshot. |
OS-SCH-HNT:scheduler_hints (Optional) | body | object | The dictionary of data to send to the scheduler. |
source_replica (Optional) | body | string | The UUID of the primary volume to clone. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"volume": {
"size": 10,
"availability_zone": null,
"source_volid": null,
"description": null,
"multiattach ": false,
"snapshot_id": null,
"name": null,
"imageRef": null,
"volume_type": null,
"metadata": {},
"source_replica": null,
"consistencygroup_id": null
},
"OS-SCH-HNT:scheduler_hints": {
"same_host": [
"a0cf03a5-d921-4877-bb5c-86d26cf818e1",
"8c19174f-4220-44f0-824a-cd1eeef10287"
]
}
}
Name | In | Type | Description |
---|---|---|---|
migration_status | body | string | The volume migration status. |
attachments | body | array | Instance attachment information. If this volume is attached to a server instance, the attachments list includes the UUID of the attached server, an attachment UUID, the name of the attached host, if any, the volume UUID, the device, and the device UUID. Otherwise, this list is empty. |
links | body | array | Links for the volume transfer. |
availability_zone (Optional) | body | string | The name of the availability zone. |
encrypted | body | boolean | If true, this volume is encrypted. |
updated_at | body | string | The date and time when the resource was updated. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The If the |
replication_status | body | string | The volume replication status. |
snapshot_id (Optional) | body | string | To create a volume from an existing snapshot, specify the UUID of the volume snapshot. The volume is created in same availability zone and with same size as the snapshot. |
id | body | string | The UUID of the volume transfer. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
user_id | body | string | The UUID of the user. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
status | body | string | The volume status. |
description | body | string | The backup description or null. |
multiattach (Optional) | body | boolean | To enable this volume to attach to more than one
server, set this value to true . Default is false . |
source_volid (Optional) | body | string | The UUID of the source volume. The API creates a new volume with the same size as the source volume. |
volume | body | object | A volume object. |
consistencygroup_id | body | string | The UUID of the consistency group. |
name | body | string | The name of the Volume Transfer. |
bootable | body | string | Enables or disables the bootable attribute. You can boot an instance from a bootable volume. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
Lists summary information for all Block Storage volumes that the project can access, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
volumes | body | array | A list of volume objects. |
id | body | string | The UUID of the volume transfer. |
links | body | array | Links for the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"volumes": [
{
"id": "45baf976-c20a-4894-a7c3-c94b7376bf55",
"links": [
{
"href": "http://localhost:8776/v3/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/45baf976-c20a-4894-a7c3-c94b7376bf55",
"rel": "self"
},
{
"href": "http://localhost:8776/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/45baf976-c20a-4894-a7c3-c94b7376bf55",
"rel": "bookmark"
}
],
"name": "vol-004"
},
{
"id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
"links": [
{
"href": "http://localhost:8776/v3/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635",
"rel": "self"
},
{
"href": "http://localhost:8776/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635",
"rel": "bookmark"
}
],
"name": "vol-003"
}
]
}
Shows details for a volume.
Preconditions
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | body | string | The UUID of the volume. |
Name | In | Type | Description |
---|---|---|---|
migration_status | body | string | The volume migration status. |
attachments | body | array | Instance attachment information. If this volume is attached to a server instance, the attachments list includes the UUID of the attached server, an attachment UUID, the name of the attached host, if any, the volume UUID, the device, and the device UUID. Otherwise, this list is empty. |
links | body | array | Links for the volume transfer. |
availability_zone (Optional) | body | string | The name of the availability zone. |
os-vol-host-attr:host | body | string | Current back-end of the volume. |
encrypted | body | boolean | If true, this volume is encrypted. |
updated_at | body | string | The date and time when the resource was updated. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The If the |
os-volume-replication:extended_status (Optional) | body | string | The volume replication status managed by the driver of backend storage. |
replication_status | body | string | The volume replication status. |
snapshot_id (Optional) | body | string | To create a volume from an existing snapshot, specify the UUID of the volume snapshot. The volume is created in same availability zone and with same size as the snapshot. |
id | body | string | The UUID of the volume transfer. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
user_id | body | string | The UUID of the user. |
os-vol-tenant-attr:tenant_id | body | string | The tenant ID which the volume belongs to. |
os-vol-mig-status-attr:migstat | body | string | The status of this volume migration (None means that a migration is not currently in progress). |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
status | body | string | The volume status. |
description | body | string | The backup description or null. |
multiattach (Optional) | body | boolean | To enable this volume to attach to more than one
server, set this value to true . Default is false . |
source_volid (Optional) | body | string | The UUID of the source volume. The API creates a new volume with the same size as the source volume. |
volume | body | object | A volume object. |
consistencygroup_id | body | string | The UUID of the consistency group. |
os-vol-mig-status-attr:name_id | body | string | The volume ID that this volume name on the back- end is based on. |
name | body | string | The name of the Volume Transfer. |
bootable | body | string | Enables or disables the bootable attribute. You can boot an instance from a bootable volume. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
os-volume-replication:driver_data (Optional) | body | string | The name of the volume replication driver. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
{
"volume": {
"status": "available",
"attachments": [],
"links": [
{
"href": "http://localhost:8776/v3/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635",
"rel": "self"
},
{
"href": "http://localhost:8776/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635",
"rel": "bookmark"
}
],
"availability_zone": "nova",
"bootable": "false",
"os-vol-host-attr:host": "ip-10-168-107-25",
"source_volid": null,
"snapshot_id": null,
"id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
"description": "Super volume.",
"name": "vol-002",
"created_at": "2013-02-25T02:40:21.000000",
"volume_type": "None",
"os-vol-tenant-attr:tenant_id": "0c2eba2c5af04d3f9e9d0d410b371fde",
"size": 1,
"os-volume-replication:driver_data": null,
"os-volume-replication:extended_status": null,
"metadata": {
"contents": "not junk"
}
}
}
Updates a volume.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
volume | body | object | A volume object. |
description | body | string | The backup description or null. |
name | body | string | The name of the Volume Transfer. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | body | string | The UUID of the volume. |
{
"volume": {
"name": "vol-003",
"description": "This is yet, another volume."
}
}
Name | In | Type | Description |
---|---|---|---|
migration_status | body | string | The volume migration status. |
attachments | body | array | Instance attachment information. If this volume is attached to a server instance, the attachments list includes the UUID of the attached server, an attachment UUID, the name of the attached host, if any, the volume UUID, the device, and the device UUID. Otherwise, this list is empty. |
links | body | array | Links for the volume transfer. |
availability_zone (Optional) | body | string | The name of the availability zone. |
encrypted | body | boolean | If true, this volume is encrypted. |
updated_at | body | string | The date and time when the resource was updated. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The If the |
replication_status | body | string | The volume replication status. |
snapshot_id (Optional) | body | string | To create a volume from an existing snapshot, specify the UUID of the volume snapshot. The volume is created in same availability zone and with same size as the snapshot. |
id | body | string | The UUID of the volume transfer. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
user_id | body | string | The UUID of the user. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
status | body | string | The volume status. |
description | body | string | The backup description or null. |
multiattach (Optional) | body | boolean | To enable this volume to attach to more than one
server, set this value to true . Default is false . |
source_volid (Optional) | body | string | The UUID of the source volume. The API creates a new volume with the same size as the source volume. |
volume | body | object | A volume object. |
consistencygroup_id | body | string | The UUID of the consistency group. |
name | body | string | The name of the Volume Transfer. |
bootable | body | string | Enables or disables the bootable attribute. You can boot an instance from a bootable volume. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
{
"volume": {
"status": "available",
"migration_status": null,
"user_id": "0eea4eabcf184061a3b6db1e0daaf010",
"attachments": [],
"links": [
{
"href": "http://localhost:8776/v3/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635",
"rel": "self"
},
{
"href": "http://localhost:8776/0c2eba2c5af04d3f9e9d0d410b371fde/volumes/5aa119a8-d25b-45a7-8d1b-88e127885635",
"rel": "bookmark"
}
],
"availability_zone": "nova",
"bootable": "false",
"encrypted": false,
"created_at": "2015-11-29T03:01:44.000000",
"description": "This is yet, another volume.",
"updated_at": null,
"volume_type": "lvmdriver-1",
"name": "vol-003",
"replication_status": "disabled",
"consistencygroup_id": null,
"source_volid": null,
"snapshot_id": null,
"multiattach": false,
"metadata": {
"contents": "not junk"
},
"id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
"size": 1
}
}
Deletes a volume.
Preconditions
available
, in-use
, error
, or
error_restoring
.Asynchronous Postconditions
Troubleshooting
deleting
or becomes
error_deleting
the request failed. Ensure you meet the
preconditions then investigate the storage back end.Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | body | string | The UUID of the volume. |
cascade (Optional) | path | boolean | Remove any snapshots along with the volume. Default=False. |
Creates or replaces metadata for a volume. Does not modify items that are not in the request.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
metadata | body | object | One or more metadata key and value pairs that are associated with the volume. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | body | string | The UUID of the volume. |
{
"metadata": {
"name": "metadata0"
}
}
Name | In | Type | Description |
---|---|---|---|
metadata | body | object | One or more metadata key and value pairs that are associated with the volume. |
{
"metadata": {
"name": "metadata0"
}
}
Shows metadata for a volume.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | body | string | The UUID of the volume. |
Name | In | Type | Description |
---|---|---|---|
metadata | body | object | One or more metadata key and value pairs that are associated with the volume. |
{
"metadata": {}
}
Replaces all the volume’s metadata with the key-value pairs in the request.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
metadata | body | object | One or more metadata key and value pairs that are associated with the volume. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | body | string | The UUID of the volume. |
{
"metadata": {
"name": "metadata1"
}
}
Name | In | Type | Description |
---|---|---|---|
metadata | body | object | One or more metadata key and value pairs that are associated with the volume. |
{
"metadata": {
"name": "metadata1"
}
}
Shows metadata for a volume for a specific key.
Normal response codes: 200
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | path | string | The UUID of the volume. |
key | path | string | The metadata key name for the metadata that you want to see. |
Name | In | Type | Description |
---|---|---|---|
metadata | body | object | One or more metadata key and value pairs that are associated with the volume. |
{
"metadata": {}
}
Deletes metadata for a volume.
Normal response codes: 200
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | path | string | The UUID of the volume. |
key | path | string | The metadata key name for the metadata that you want to remove. |
Display volumes summary with total number of volumes and total size in GB
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
all_tenants (Optional) | path | string | Shows details for all projects. |
Name | In | Type | Description |
---|---|---|---|
volume-summary | body | object | Dictionary of volume-summary objects. |
total_size | body | integer | Total size of volumes in GB. |
total_count | body | integer | Total number of volumes. |
{
"volume-summary": {
"total_size": 4,
"total_count": 4
}
}
Extends the size of, resets statuses for, sets image metadata for, and removes image metadata from a volume. Attaches a volume to a server, detaches a volume from a server, and removes a volume from Block Storage management without actually removing the back-end storage object associated with it.
Extends the size of a volume to a requested size, in gibibytes (GiB). Specify the os-extend
action in the request body.
Preconditions
available
.Troubleshooting
error_extending
volume status indicates that the request
failed. Ensure that you meet the preconditions and retry the
request. If the request fails again, investigate the storage back
end.Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
os-extend | body | object | The os-extend action. |
new_size | body | integer | The new size of the volume, in gibibytes (GiB). |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | path | string | The UUID of the volume. |
{
"os-extend": {
"new_size": 3
}
}
Administrator only. Resets the status, attach status, and migration status for a volume. Specify the os-reset_status
action in the request body.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
status | body | string | The volume status. |
migration_status | body | string | The volume migration status. |
os-reset_status | body | object | The os-reset_status action. |
attach_status (Optional) | body | string | The volume attach status. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | path | string | The UUID of the volume. |
{
"os-reset_status": {
"status": "available",
"attach_status": "detached",
"migration_status": "migrating"
}
}
Sets the image metadata for a volume. Specify the os-set_image_metadata
action in the request body.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
os-set_image_metadata | body | object | The os-set_image_metadata action. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | path | string | The UUID of the volume. |
{
"os-set_image_metadata": {
"metadata": {
"image_id": "521752a6-acf6-4b2d-bc7a-119f9148cd8c",
"image_name": "image",
"kernel_id": "155d900f-4e14-4e4c-a73d-069cbf4541e6",
"ramdisk_id": "somedisk"
}
}
}
Removes image metadata, by key, from a volume. Specify the os-unset_image_metadata
action in the request body and the key
for the metadata key and value pair that you want to remove.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
os-unset_image_metadata | body | object | The os-unset_image_metadata action. This
action removes the key-value pairs from the image metadata. |
key | body | string | The metadata key name for the metadata that you want to remove. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | path | string | The UUID of the volume. |
{
"os-unset_image_metadata": {
"key": "ramdisk_id"
}
}
Attaches a volume to a server. Specify the os-attach
action in the request body.
Preconditions
available
.instance_uuid
or host_name
.Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
instance_uuid (Optional) | body | string | The UUID of the attaching instance. |
mountpoint | body | string | The attaching mount point. |
host_name (Optional) | body | string | The name of the attaching host. |
os-attach | body | object | The os-attach action. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | path | string | The UUID of the volume. |
{
"os-attach": {
"instance_uuid": "95D9EF50-507D-11E5-B970-0800200C9A66",
"mountpoint": "/dev/vdc"
}
}
Detaches a volume from a server. Specify the os-detach
action in the request body.
Preconditions
in-use
.Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
attachment_id (Optional) | body | string | The interface ID. |
os-detach | body | object | The os-detach action. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | path | string | The UUID of the volume. |
{
"os-detach": {
"attachment_id": "d8777f54-84cf-4809-a679-468ffed56cf1"
}
}
Removes a volume from Block Storage management without removing the back-end storage object that is associated with it. Specify the os-unmanage
action in the request body.
Preconditions
available
.Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
os-unmanage | body | object | The os-unmanage action. This action removes
the specified volume from Cinder management. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | path | string | The UUID of the volume. |
{
"os-unmanage": {}
}
Forces a volume to detach. Specify the os-force_detach
action in the request body.
Rolls back an unsuccessful detach operation after you disconnect the volume.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
connector (Optional) | body | object | The connector object. |
attachment_id (Optional) | body | string | The interface ID. |
os-force_detach | body | object | The os-force_detach action. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | path | string | The UUID of the volume. |
{
"os-force_detach": {
"attachment_id": "d8777f54-84cf-4809-a679-468ffed56cf1",
"connector": {
"initiator": "iqn.2012-07.org.fake:01"
}
}
}
Change type of existing volume. Specify the os-retype
action in the request body.
Change the volume type of existing volume, Cinder may migrate the volume to proper volume host according to the new volume type.
Policy defaults enable only users with the administrative role or the owner of the volume to perform this operation. Cloud providers can change these permissions through the policy.json file.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
new_type | body | string | The new volume type that volume is changed with. |
migration_policy (Optional) | body | string | Specify if the volume should be migrated when it is re-typed.
Possible values are Note If the volume is attached to a server instance and will be migrated, then by default policy only users with the administrative role should attempt the retype operation. |
os-retype | body | object | The os-retype action. |
volume_id | path | string | The UUID of the volume. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"os-retype": {
"new_type": "dedup-tier-replicaton",
"migration_policy": "never"
}
}
Attempts force-delete of volume, regardless of state. Specify the os-force_delete
action
in the request body.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
os-force_delete | body | string | The os-force_delete action. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | path | string | The UUID of the volume. |
{
"os-force_delete": {}
}
Update the bootable status for a volume, mark it as a bootable volume. Specify the os-set_bootable
action in the request body.
Normal response codes: 200
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
volume_id | path | string | The UUID of the volume. |
os-set_bootable | body | object | The os-set_bootable action. |
bootable | body | boolean | Enables or disables the bootable attribute. You can boot an instance from a bootable volume. |
{
"os-set_bootable": {
"bootable": "True"
}
}
Shows image metadata that is associated with a volume.
Shows image metadata for a volume.
When the request is made, the caller must specify a reference to an
existing storage volume in the ref
element. Each storage driver
may interpret the existing storage volume reference differently but
should accept a reference structure containing either a source-
volume-id
or source-volume-name
element, if possible.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
description | body | string | The backup description or null. |
availability_zone (Optional) | body | string | The name of the availability zone. |
bootable | body | boolean | Enables or disables the bootable attribute. You can boot an instance from a bootable volume. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
name | body | string | The name of the Volume Transfer. |
volume | body | object | A volume object. |
host | body | string | The OpenStack Block Storage host where the existing volume resides. |
ref | body | string | A reference to the existing volume. The internal structure of this reference depends on the volume driver implementation. For details about the required elements in the structure, see the documentation for the volume driver. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"volume": {
"host": "geraint-VirtualBox",
"ref": {
"source-volume-name": "existingLV",
"source-volume-id": "1234"
},
"name": "New Volume",
"availability_zone": "az2",
"description": "Volume imported from existingLV",
"volume_type": null,
"bootable": true,
"metadata": {
"key1": "value1",
"key2": "value2"
}
}
}
Creates or lists volumes by using existing storage instead of allocating new storage.
Creates a Block Storage volume by using existing storage rather than allocating new storage.
The caller must specify a reference to an existing storage volume in the ref parameter in the request. Although each storage driver might interpret this reference differently, the driver should accept a reference structure that contains either a source-id or source-name element, if possible.
The API chooses the size of the volume by rounding up the size of the existing storage volume to the next gibibyte (GiB).
Prior to microversion 3.16 host field was required, with the possibility of defining the cluster it is no longer required, but we must have either a host or a cluster field but we cannot have them both with values.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
description | body | string | The backup description or null. |
availability_zone (Optional) | body | string | The name of the availability zone. |
bootable | body | boolean | Enables or disables the bootable attribute. You can boot an instance from a bootable volume. |
volume_type (Optional) | path | string | The ID of Volume Type to be accessed by project. |
name | body | string | The name of the Volume Transfer. |
volume | body | object | A volume object. |
host (Optional) | body | string | The OpenStack Block Storage host where the existing resource resides. Optional only if cluster field is provided. |
cluster (Optional) | body | string | The OpenStack Block Storage cluster where the resource resides. Optional only if host field is provided. |
ref | body | string | A reference to the existing volume. The internal structure of this reference depends on the volume driver implementation. For details about the required elements in the structure, see the documentation for the volume driver. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"volume": {
"host": "geraint-VirtualBox",
"ref": {
"source-name": "existingLV",
"source-id": "1234"
},
"name": "New Volume",
"availability_zone": "az2",
"description": "Volume imported from existingLV",
"volume_type": null,
"bootable": true,
"metadata": {
"key1": "value1",
"key2": "value2"
}
}
}
{
"volume": {
"host": null,
"cluster": "cluster@backend",
"ref": {
"source-name": "existingLV",
"source-id": "1234"
},
"name": "New Volume",
"availability_zone": "az2",
"description": "Volume imported from existingLV",
"volume_type": null,
"bootable": true,
"metadata": {
"key1": "value1",
"key2": "value2"
}
}
}
Search a volume backend and list summary of volumes which are available to manage.
Normal response codes: 200
Name | In | Type | Description |
---|---|---|---|
sort (Optional) | query | string | Comma-separated list of sort keys and optional
sort directions in the form of < key > [: < direction > ]. A valid
direction is asc (ascending) or desc (descending). |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
host | path | string | The name of the host that hosts the storage back end. |
Name | In | Type | Description |
---|---|---|---|
manageable-volumes | body | list | A list of manageable volumes. |
safe_to_manage | body | boolean | If the resource can be managed or not. |
reference | body | object | Some information for the resource. |
source-name | body | string | The resource’s name. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
{
"manageable-volumes": [
{
"safe_to_manage": false,
"reference": {
"source-name": "volume-3a81fdac-e8ae-4e61-b6a2-2e14ff316f19"
},
"size": 1
},
{
"safe_to_manage": true,
"reference": {
"source-name": "lvol0"
},
"size": 1
}
]
}
Search a volume backend and list detail of volumes which are available to manage.
Normal response codes: 200
Name | In | Type | Description |
---|---|---|---|
sort (Optional) | query | string | Comma-separated list of sort keys and optional
sort directions in the form of < key > [: < direction > ]. A valid
direction is asc (ascending) or desc (descending). |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
host | path | string | The name of the host that hosts the storage back end. |
Name | In | Type | Description |
---|---|---|---|
manageable-volumes | body | list | A list of manageable volumes. |
cinder_id (Optional) | body | string | The UUID of the snapshot in Cinder. |
safe_to_manage | body | boolean | If the resource can be managed or not. |
reason_not_safe (Optional) | body | string | The reason why the resource can’t be managed. |
reference | body | object | Some information for the resource. |
source-name | body | string | The resource’s name. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
extra_info (Optional) | body | string | More information about the resource. |
{
"manageable-volumes": [
{
"cinder_id": "9ba5bb53-4a18-4b38-be06-992999da338d",
"reason_not_safe": "already managed",
"reference": {
"source-name": "volume-9ba5bb53-4a18-4b38-be06-992999da338d"
},
"safe_to_manage": false,
"size": 1,
"extra_info": null
},
{
"cinder_id": null,
"reason_not_safe": null,
"reference": {
"source-name": "lvol0"
},
"safe_to_manage": true,
"size": 1,
"extra_info": null
}
]
}
A snapshot is a point-in-time copy of the data that a volume contains.
When you create, list, or delete snapshots, these status values are possible:
Snapshot statuses
Status | Description |
creating | The snapshot is being created. |
available | The snapshot is ready to use. |
deleting | The snapshot is being deleted. |
error | A snapshot creation error occurred. |
error_deleting | A snapshot deletion error occurred. |
Lists all Block Storage snapshots, with details, that the project can access, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status for the snapshot. |
os-extended-snapshot-attributes:progress | body | integer | A percentage value for the build progress. |
description | body | string | The backup description or null. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
name | body | string | The name of the Volume Transfer. |
volume_id | body | string | The UUID of the volume. |
os-extended-snapshot-attributes:project_id | body | string | The UUID of the owning project. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
id | body | string | The UUID of the volume transfer. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
{
"snapshots": [
{
"status": "available",
"metadata": {
"name": "test"
},
"os-extended-snapshot-attributes:progress": "100%",
"name": "test-volume-snapshot",
"volume_id": "173f7b48-c4c1-4e70-9acc-086b39073506",
"os-extended-snapshot-attributes:project_id": "bab7d5c60cd041a0a36f7c4b6e1dd978",
"created_at": "2015-11-29T02:25:51.000000",
"size": 1,
"id": "b1323cda-8e4b-41c1-afc5-2fc791809c8c",
"description": "volume snapshot"
}
]
}
Creates a volume snapshot, which is a point-in-time, complete copy of a volume. You can create a volume from a snapshot.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
snapshot | body | string | A partial representation of a snapshot used in the creation process. |
volume_id | body | string | The UUID of the volume. |
force (Optional) | body | boolean | Indicates whether to backup, even if the volume
is attached. Default is false . |
description | body | string | The backup description or null. |
name | body | string | The name of the Volume Transfer. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"snapshot": {
"name": "snap-001",
"description": "Daily backup",
"volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
"force": true
}
}
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status for the snapshot. |
description | body | string | The backup description or null. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
name | body | string | The name of the Volume Transfer. |
snapshot | body | string | A partial representation of a snapshot used in the creation process. |
volume_id | body | string | The UUID of the volume. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
id | body | string | The UUID of the volume transfer. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
Lists all Block Storage snapshots, with summary information, that the project can access, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status for the snapshot. |
description | body | string | The backup description or null. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
name | body | string | The name of the Volume Transfer. |
volume_id | body | string | The UUID of the volume. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
id | body | string | The UUID of the volume transfer. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
{
"snapshots": [
{
"status": "available",
"metadata": {
"name": "test"
},
"name": "test-volume-snapshot",
"volume_id": "173f7b48-c4c1-4e70-9acc-086b39073506",
"created_at": "2015-11-29T02:25:51.000000",
"size": 1,
"id": "b1323cda-8e4b-41c1-afc5-2fc791809c8c",
"description": "volume snapshot"
}
]
}
Shows metadata for a snapshot.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
snapshot_id (Optional) | body | string | To create a volume from an existing snapshot, specify the UUID of the volume snapshot. The volume is created in same availability zone and with same size as the snapshot. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status for the snapshot. |
os-extended-snapshot-attributes:progress | body | integer | A percentage value for the build progress. |
description | body | string | The backup description or null. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
name | body | string | The name of the Volume Transfer. |
snapshot | body | string | A partial representation of a snapshot used in the creation process. |
volume_id | body | string | The UUID of the volume. |
os-extended-snapshot-attributes:project_id | body | string | The UUID of the owning project. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
id | body | string | The UUID of the volume transfer. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
{
"metadata": {
"name": "test"
}
}
Updates metadata for a snapshot.
Creates or replaces metadata items that match keys. Does not modify items that are not in the request.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
snapshot_id (Optional) | body | string | To create a volume from an existing snapshot, specify the UUID of the volume snapshot. The volume is created in same availability zone and with same size as the snapshot. |
{
"metadata": {
"key": "v3"
}
}
{
"metadata": {
"key": "v3"
}
}
Replaces all the snapshot’s metadata with the key-value pairs in the request.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
snapshot_id (Optional) | body | string | To create a volume from an existing snapshot, specify the UUID of the volume snapshot. The volume is created in same availability zone and with same size as the snapshot. |
{
"metadata": {
"key": "v2"
}
}
{
"metadata": {
"key": "v2"
}
}
Shows details for a snapshot.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
snapshot_id (Optional) | body | string | To create a volume from an existing snapshot, specify the UUID of the volume snapshot. The volume is created in same availability zone and with same size as the snapshot. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status for the snapshot. |
os-extended-snapshot-attributes:progress | body | integer | A percentage value for the build progress. |
description | body | string | The backup description or null. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
name | body | string | The name of the Volume Transfer. |
snapshot | body | string | A partial representation of a snapshot used in the creation process. |
volume_id | body | string | The UUID of the volume. |
os-extended-snapshot-attributes:project_id | body | string | The UUID of the owning project. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
id | body | string | The UUID of the volume transfer. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
{
"snapshot": {
"status": "available",
"os-extended-snapshot-attributes:progress": "100%",
"description": "Daily backup",
"created_at": "2013-02-25T04:13:17.000000",
"metadata": {},
"volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
"os-extended-snapshot-attributes:project_id": "0c2eba2c5af04d3f9e9d0d410b371fde",
"size": 1,
"id": "2bb856e1-b3d8-4432-a858-09e4ce939389",
"name": "snap-001"
}
}
Updates a snapshot.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
snapshot | body | string | A partial representation of a snapshot used in the creation process. |
description | body | string | The backup description or null. |
name | body | string | The name of the Volume Transfer. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
snapshot_id (Optional) | body | string | To create a volume from an existing snapshot, specify the UUID of the volume snapshot. The volume is created in same availability zone and with same size as the snapshot. |
{
"snapshot": {
"name": "snap-002",
"description": "This is yet, another snapshot."
}
}
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status for the snapshot. |
description | body | string | The backup description or null. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
name | body | string | The name of the Volume Transfer. |
snapshot | body | string | A partial representation of a snapshot used in the creation process. |
volume_id | body | string | The UUID of the volume. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
id | body | string | The UUID of the volume transfer. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
{
"snapshot": {
"created_at": "2013-02-20T08:11:34.000000",
"description": "This is yet, another snapshot",
"name": "snap-002",
"id": "4b502fcb-1f26-45f8-9fe5-3b9a0a52eaf2",
"size": 1,
"status": "available",
"volume_id": "2402b902-0b7a-458c-9c07-7435a826f794"
}
}
Deletes a snapshot.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
snapshot_id (Optional) | body | string | To create a volume from an existing snapshot, specify the UUID of the volume snapshot. The volume is created in same availability zone and with same size as the snapshot. |
Creates or lists snapshots by using existing storage instead of allocating new storage.
Creates a snapshot by using existing storage rather than allocating new storage.
The caller must specify a reference to an existing storage volume in the ref parameter in the request. Although each storage driver might interpret this reference differently, the driver should accept a reference structure that contains either a source-id or source-name element, if possible.
The API chooses the size of the snapshot by rounding up the size of the existing snapshot to the next gibibyte (GiB).
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
description | body | string | The backup description or null. |
name | body | string | The name of the Volume Transfer. |
ref | body | string | A reference to the existing volume. The internal structure of this reference depends on the volume driver implementation. For details about the required elements in the structure, see the documentation for the volume driver. |
volume_id | body | string | The UUID of the volume. |
metadata | body | object | One or more metadata key and value pairs for the snapshot, if any. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"snapshot": {
"description": null,
"metadata": null,
"ref": {
"source-name": "lvol0"
},
"name": null,
"volume_id": "7c064b34-1e4b-40bd-93ca-4ac5a973661b"
}
}
Search a volume backend and list summary of snapshots which are available to manage.
Normal response codes: 200
Name | In | Type | Description |
---|---|---|---|
sort (Optional) | query | string | Comma-separated list of sort keys and optional
sort directions in the form of < key > [: < direction > ]. A valid
direction is asc (ascending) or desc (descending). |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
host | path | string | The name of the host that hosts the storage back end. |
Name | In | Type | Description |
---|---|---|---|
manageable-snapshots | body | list | A list of manageable snapshots. |
source_reference | body | object | The snapshot’s origin volume information. |
safe_to_manage | body | boolean | If the resource can be managed or not. |
reference | body | object | Some information for the resource. |
source-name | body | string | The resource’s name. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
{
"manageable-snapshots": [
{
"source_reference": {
"source-name": "volume-7c064b34-1e4b-40bd-93ca-4ac5a973661b"
},
"safe_to_manage": true,
"reference": {
"source-name": "lvol0"
},
"size": 1
},
{
"source_reference": {
"source-name": "volume-7c064b34-1e4b-40bd-93ca-4ac5a973661b"
},
"safe_to_manage": false,
"reference": {
"source-name": "_snapshot-d0c84570-a01f-4579-9789-5e9f266587cd"
},
"size": 1
}
]
}
Search a volume backend and list detail of snapshots which are available to manage.
Normal response codes: 200
Name | In | Type | Description |
---|---|---|---|
sort (Optional) | query | string | Comma-separated list of sort keys and optional
sort directions in the form of < key > [: < direction > ]. A valid
direction is asc (ascending) or desc (descending). |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
host | path | string | The name of the host that hosts the storage back end. |
Name | In | Type | Description |
---|---|---|---|
manageable-snapshots | body | list | A list of manageable snapshots. |
cinder_id (Optional) | body | string | The UUID of the snapshot in Cinder. |
source_reference | body | object | The snapshot’s origin volume information. |
safe_to_manage | body | boolean | If the resource can be managed or not. |
reason_not_safe (Optional) | body | string | The reason why the resource can’t be managed. |
reference | body | object | Some information for the resource. |
source-name | body | string | The resource’s name. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
extra_info (Optional) | body | string | More information about the resource. |
{
"manageable-snapshots": [
{
"cinder_id": null,
"reason_not_safe": null,
"reference": {
"source-name": "lvol0"
},
"source_reference": {
"source-name": "volume-7c064b34-1e4b-40bd-93ca-4ac5a973661b"},
"safe_to_manage": true,
"size": 1,
"extra_info": null
},
{
"cinder_id": "d0c84570-a01f-4579-9789-5e9f266587cd",
"reason_not_safe": "already managed",
"reference": {
"source-name":"_snapshot-d0c84570-a01f-4579-9789-5e9f266587cd"
},
"source_reference": {
"source-name": "volume-7c064b34-1e4b-40bd-93ca-4ac5a973661b"
},
"safe_to_manage": false,
"size": 1,
"extra_info": null
}
]
}
Transfers a volume from one user to another user.
Accepts a volume transfer.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
auth_key | body | string | The authentication key for the volume transfer. |
transfer_id (Optional) | path | string | The unique identifier for a volume transfer. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"accept": {
"auth_key": "9266c59563c84664"
}
}
Name | In | Type | Description |
---|---|---|---|
volume_id | body | string | The UUID of the volume. |
id | body | string | The UUID of the volume transfer. |
links | body | array | Links for the volume transfer. |
name | body | string | The name of the Volume Transfer. |
Creates a volume transfer.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
name | body | string | The name of the Volume Transfer. |
volume_id | body | string | The UUID of the volume. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"transfer": {
"volume_id": "c86b9af4-151d-4ead-b62c-5fb967af0e37",
"name": "first volume"
}
}
Name | In | Type | Description |
---|---|---|---|
auth_key | body | string | The authentication key for the volume transfer. |
links | body | array | Links for the volume transfer. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
volume_id | body | string | The UUID of the volume. |
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
Lists volume transfers.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
Name | In | Type | Description |
---|---|---|---|
volume_id | body | string | The UUID of the volume. |
id | body | string | The UUID of the volume transfer. |
links | body | array | Links for the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"transfers": [
{
"id": "cac5c677-73a9-4288-bb9c-b2ebfb547377",
"name": "first volume transfer",
"volume_id": "894623a6-e901-4312-aa06-4275e6321cce",
"links": [
{
"href": "http://localhost/v3/firstproject/volumes/1",
"rel": "self"
},
{
"href": "http://localhost/firstproject/volumes/1",
"rel": "bookmark"
}
]
},
{
"id": "f26c0dee-d20d-4e80-8dee-a8d91b9742a1",
"name": "second volume transfer",
"volume_id": "673db275-379f-41af-8371-e1652132b4c1",
"links": [
{
"href": "http://localhost/v3/firstproject/volumes/2",
"rel": "self"
},
{
"href": "http://localhost/firstproject/volumes/2",
"rel": "bookmark"
}
]
}
]
}
Shows details for a volume transfer.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
transfer_id (Optional) | path | string | The unique identifier for a volume transfer. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
Name | In | Type | Description |
---|---|---|---|
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
volume_id | body | string | The UUID of the volume. |
id | body | string | The UUID of the volume transfer. |
links | body | array | Links for the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"transfer": {
"id": "cac5c677-73a9-4288-bb9c-b2ebfb547377",
"created_at": "2015-02-25T03:56:53.081642",
"name": "first volume transfer",
"volume_id": "894623a6-e901-4312-aa06-4275e6321cce",
"links": [
{
"href": "http://localhost/v3/firstproject/volumes/1",
"rel": "self"
},
{
"href": "http://localhost/firstproject/volumes/1",
"rel": "bookmark"
}
]
}
}
Deletes a volume transfer.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
transfer_id (Optional) | path | string | The unique identifier for a volume transfer. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
Lists volume transfers, with details.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
Name | In | Type | Description |
---|---|---|---|
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
volume_id | body | string | The UUID of the volume. |
id | body | string | The UUID of the volume transfer. |
links | body | array | Links for the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"transfers": [
{
"id": "cac5c677-73a9-4288-bb9c-b2ebfb547377",
"created_at": "2015-02-25T03:56:53.081642",
"name": "first volume transfer",
"volume_id": "894623a6-e901-4312-aa06-4275e6321cce",
"links": [
{
"href": "http://localhost/v3/firstproject/volumes/1",
"rel": "self"
},
{
"href": "http://localhost/firstproject/volumes/1",
"rel": "bookmark"
}
]
},
{
"id": "f26c0dee-d20d-4e80-8dee-a8d91b9742a1",
"created_at": "2015-03-25T03:56:53.081642",
"name": "second volume transfer",
"volume_id": "673db275-379f-41af-8371-e1652132b4c1",
"links": [
{
"href": "http://localhost/v3/firstproject/volumes/2",
"rel": "self"
},
{
"href": "http://localhost/firstproject/volumes/2",
"rel": "bookmark"
}
]
}
]
}
Lists all, lists all with details, shows details for, creates, and deletes attachment.
Deletes an attachment.
Normal response codes: 200 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
attachment_id | path | string | The ID of the attachment. |
Shows details for an attachment.
Normal response codes: 200 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
attachment_id | path | string | The ID of the attachment. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status of the attachment. |
detached_at (Optional) | body | string | The time when attachment is detached. |
connection_info | body | object | The connection info used for server to connect the volume. |
attached_at (Optional) | body | string | The time when attachment is attached. |
attach_mode (Optional) | body | string | The attach mode of attachment, read-only (‘ro’) or read-and-write (‘rw’), default is ‘ro’. |
instance (Optional) | body | string | The UUID of the attaching instance. |
volume_id | body | string | The UUID of the volume which the attachment belongs to. |
id | body | string | The ID of attachment. |
{
"attachment": {
"status": "attaching",
"detached_at": "2015-09-16T09:28:52.000000",
"connection_info": {},
"attached_at": "2015-09-16T09:28:52.000000",
"attach_mode": "ro",
"instance": "3b8b6631-1cf7-4fd7-9afb-c01e541as345",
"volume_id": "462dcc2d-130d-4654-8db1-da0df2da6a0d",
"id": "3b8b6631-1cf7-4fd7-9afb-c01e541a073c"
}
}
Lists all attachments with details, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status of the attachment. |
detached_at (Optional) | body | string | The time when attachment is detached. |
connection_info | body | object | The connection info used for server to connect the volume. |
attached_at (Optional) | body | string | The time when attachment is attached. |
attach_mode (Optional) | body | string | The attach mode of attachment, read-only (‘ro’) or read-and-write (‘rw’), default is ‘ro’. |
instance (Optional) | body | string | The UUID of the attaching instance. |
volume_id | body | string | The UUID of the volume which the attachment belongs to. |
id | body | string | The ID of attachment. |
{
"attachments": [
{
"status": "attaching",
"detached_at": "2015-09-16T09:28:52.000000",
"connection_info": {},
"attached_at": "2015-09-16T09:28:52.000000",
"attach_mode": "ro",
"instance": "31c79baf-b59e-469c-979f-1df4ecb6eea7",
"volume_id": "462dcc2d-130d-4654-8db1-da0df2da6a0d",
"id": "3b8b6631-1cf7-4fd7-9afb-c01e541a073c"
}
]
}
Lists all attachments, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status of the attachment. |
instance (Optional) | body | string | The UUID of the attaching instance. |
volume_id | body | string | The UUID of the volume which the attachment belongs to. |
id | body | string | The ID of attachment. |
{
"attachments": [
{
"status": "attaching",
"instance": "31c79baf-b59e-469c-979f-1df4ecb6eea7",
"id": "3b8b6631-1cf7-4fd7-9afb-c01e541a073c",
"volume_id": "462dcc2d-130d-4654-8db1-da0df2da6a0d"
}
]
}
Creates an attachment.
Normal response codes: 202 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
instance_uuid | body | string | The UUID of the attaching instance. |
connector (Optional) | body | object | The connector object. |
volume_uuid | body | string | The UUID of the volume which the attachment belongs to. |
{
"attachment": {
"instance_uuid": "462dcc2d-130d-4654-8db1-da0df2da6a0d",
"connector": {
"initiator": "iqn.1993-08.org.debian: 01: cad181614cec",
"ip": "192.168.1.20",
"platform": "x86_64",
"host": "tempest-1",
"os_type": "linux2",
"multipath": false,
"mountpoint": "/dev/vdb",
"mode": "ro"
},
"volume_uuid": "462dcc2d-130d-4654-8db1-da0df2da6a0d"
}
}
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status of the attachment. |
detached_at (Optional) | body | string | The time when attachment is detached. |
connection_info | body | object | The connection info used for server to connect the volume. |
attached_at (Optional) | body | string | The time when attachment is attached. |
attach_mode (Optional) | body | string | The attach mode of attachment, read-only (‘ro’) or read-and-write (‘rw’), default is ‘ro’. |
instance (Optional) | body | string | The UUID of the attaching instance. |
volume_id | body | string | The UUID of the volume which the attachment belongs to. |
id | body | string | The ID of attachment. |
{
"attachment": {
"status": "attaching",
"detached_at": "2015-09-16T09:28:52.000000",
"connection_info": {},
"attached_at": "2015-09-16T09:28:52.000000",
"attach_mode": "ro",
"instance": "3b8b6631-1cf7-4fd7-9afb-c01e541as345",
"volume_id": "462dcc2d-130d-4654-8db1-da0df2da6a0d",
"id": "3b8b6631-1cf7-4fd7-9afb-c01e541a073c"
}
}
Update a reserved attachment record with connector information and set up the appropriate connection_info from the driver.
Normal response codes: 200 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
attachment_id | path | string | The ID of the attachment. |
connector (Optional) | body | object | The connector object. |
{
"attachment": {
"connector": {
"initiator": "iqn.1993-08.org.debian: 01: cad181614cec",
"ip": "192.168.1.20",
"platform": "x86_64",
"host": "tempest-1",
"os_type": "linux2",
"multipath": false,
"mountpoint": "/dev/vdb",
"mode": "ro"
}
}
}
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status of the attachment. |
detached_at (Optional) | body | string | The time when attachment is detached. |
connection_info | body | object | The connection info used for server to connect the volume. |
attached_at (Optional) | body | string | The time when attachment is attached. |
attach_mode (Optional) | body | string | The attach mode of attachment, read-only (‘ro’) or read-and-write (‘rw’), default is ‘ro’. |
instance (Optional) | body | string | The UUID of the attaching instance. |
volume_id | body | string | The UUID of the volume which the attachment belongs to. |
id | body | string | The ID of attachment. |
{
"attachment": {
"status": "attaching",
"detached_at": "2015-09-16T09:28:52.000000",
"connection_info": {},
"attached_at": "2015-09-16T09:28:52.000000",
"attach_mode": "ro",
"instance": "3b8b6631-1cf7-4fd7-9afb-c01e541as345",
"volume_id": "462dcc2d-130d-4654-8db1-da0df2da6a0d",
"id": "3b8b6631-1cf7-4fd7-9afb-c01e541a073c"
}
}
Administrator only. Lists all back-end storage pools that are known to the scheduler service.
Lists all back-end storage pools, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
detail (Optional) | query | boolean | Indicates whether to show pool details or only
pool names in the response. Set to true to show pool details.
Set to false to show only pool names. Default is false . |
Name | In | Type | Description |
---|---|---|---|
updated | body | string | The date and time stamp when the extension was last updated. |
QoS_support | body | boolean | The quality of service (QoS) support. |
name | body | string | The name of the Volume Transfer. |
total_capacity | body | string | The total capacity for the back-end volume, in
GBs. A valid value is a string, such as unknown , or an
integer. |
volume_backend_name | body | string | The name of the back-end volume. |
capabilities | body | object | The capabilities for the back end. The value is
either null or a string value that indicates the capabilities
for each pool. For example, total_capacity or QoS_support . |
free_capacity | body | string | The amount of free capacity for the back-end
volume, in GBs. A valid value is a string, such as unknown , or
an integer. |
driver_version | body | string | The driver version. |
reserved_percentage | body | integer | The percentage of the total capacity that is reserved for the internal use by the back end. |
storage_protocol | body | string | The storage back end for the back-end volume. For
example, iSCSI or FC . |
{
"pools": [
{
"name": "pool1",
"capabilities": {
"updated": "2014-10-28T00:00:00-00:00",
"total_capacity": 1024,
"free_capacity": 100,
"volume_backend_name": "pool1",
"reserved_percentage": 0,
"driver_version": "1.0.0",
"storage_protocol": "iSCSI",
"QoS_support": false
}
},
{
"name": "pool2",
"capabilities": {
"updated": "2014-10-28T00:00:00-00:00",
"total_capacity": 512,
"free_capacity": 200,
"volume_backend_name": "pool2",
"reserved_percentage": 0,
"driver_version": "1.0.1",
"storage_protocol": "iSER",
"QoS_support": true
}
}
]
}
A backup is a full copy of a volume stored in an external service. The service can be configured. The only supported service is Object Storage. A backup can subsequently be restored from the external service to either the same volume that the backup was originally taken from or to a new volume. Backup and restore operations can only be carried out on volumes that are in an unattached and available state.
When you create, list, or delete backups, these status values are possible:
Backup statuses
Status | Description |
creating | The backup is being created. |
available | The backup is ready to restore to a volume. |
deleting | The backup is being deleted. |
error | A backup error occurred. |
restoring | The backup is being restored to a volume. |
error_restoring | A backup restoration error occurred. |
If an error occurs, you can find more information about the error
in the fail_reason
field for the backup.
Lists Block Storage backups, with details, to which the project has access, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The backup status. Refer to Backup statuses table for the possible status value. |
object_count | body | integer | The number of objects in the backup. |
fail_reason | body | string | If the backup failed, the reason for the failure. Otherwise, null. |
description | body | string | The backup description or null. |
links | body | array | Links for the volume transfer. |
availability_zone (Optional) | body | string | The name of the availability zone. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
updated_at | body | string | The date and time when the resource was updated. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The If the |
name | body | string | The name of the Volume Transfer. |
has_dependent_backups (Optional) | body | boolean | If this value is true , the backup depends on
other backups. |
volume_id | body | string | The UUID of the volume. |
container | body | string | The container name or null. |
backups | body | array | A list of backup objects. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
id | body | string | The UUID of the volume transfer. |
is_incremental (Optional) | body | boolean | Indicates whether the backup mode is incremental.
If this value is true , the backup mode is incremental. If this
value is false , the backup mode is full. |
data_timestamp | body | string | The time when the data on the volume was first saved. If it is
a backup from volume, it will be the same as created_at
for a backup. If it is a backup from a snapshot, it will be the
same as created_at for the snapshot. |
snapshot_id | body | string | The UUID of the source volume snapshot. |
{
"backups": [
{
"availability_zone": "az1",
"container": "volumebackups",
"created_at": "2013-04-02T10:35:27.000000",
"description": null,
"fail_reason": null,
"id": "2ef47aee-8844-490c-804d-2a8efe561c65",
"links": [
{
"href": "http://localhost:8776/v1/c95fc3e4afe248a49a28828f286a7b38/backups/2ef47aee-8844-490c-804d-2a8efe561c65",
"rel": "self"
},
{
"href": "http://localhost:8776/c95fc3e4afe248a49a28828f286a7b38/backups/2ef47aee-8844-490c-804d-2a8efe561c65",
"rel": "bookmark"
}
],
"name": "backup001",
"object_count": 22,
"size": 1,
"status": "available",
"volume_id": "e5185058-943a-4cb4-96d9-72c184c337d6",
"is_incremental": true,
"has_dependent_backups": false
},
{
"availability_zone": "az1",
"container": "volumebackups",
"created_at": "2013-04-02T10:21:48.000000",
"description": null,
"fail_reason": null,
"id": "4dbf0ec2-0b57-4669-9823-9f7c76f2b4f8",
"links": [
{
"href": "http://localhost:8776/v1/c95fc3e4afe248a49a28828f286a7b38/backups/4dbf0ec2-0b57-4669-9823-9f7c76f2b4f8",
"rel": "self"
},
{
"href": "http://localhost:8776/c95fc3e4afe248a49a28828f286a7b38/backups/4dbf0ec2-0b57-4669-9823-9f7c76f2b4f8",
"rel": "bookmark"
}
],
"name": "backup002",
"object_count": 22,
"size": 1,
"status": "available",
"volume_id": "e5185058-943a-4cb4-96d9-72c184c337d6",
"is_incremental": true,
"has_dependent_backups": false
}
]
}
Shows details for a backup.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
backup_id (Optional) | path | string | The UUID for a backup. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The backup status. Refer to Backup statuses table for the possible status value. |
object_count | body | integer | The number of objects in the backup. |
container | body | string | The container name or null. |
description | body | string | The backup description or null. |
links | body | array | Links for the volume transfer. |
availability_zone (Optional) | body | string | The name of the availability zone. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
updated_at | body | string | The date and time when the resource was updated. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The If the |
name | body | string | The name of the Volume Transfer. |
has_dependent_backups (Optional) | body | boolean | If this value is true , the backup depends on
other backups. |
volume_id | body | string | The UUID of the volume. |
fail_reason | body | string | If the backup failed, the reason for the failure. Otherwise, null. |
size | body | integer | The size of the volume, in gibibytes (GiB). |
backup | body | object | A backup object. |
id | body | string | The UUID of the volume transfer. |
is_incremental (Optional) | body | boolean | Indicates whether the backup mode is incremental.
If this value is true , the backup mode is incremental. If this
value is false , the backup mode is full. |
data_timestamp | body | string | The time when the data on the volume was first saved. If it is
a backup from volume, it will be the same as created_at
for a backup. If it is a backup from a snapshot, it will be the
same as created_at for the snapshot. |
snapshot_id | body | string | The UUID of the source volume snapshot. |
{
"backup": {
"availability_zone": "az1",
"container": "volumebackups",
"created_at": "2013-04-02T10:35:27.000000",
"description": null,
"fail_reason": null,
"id": "2ef47aee-8844-490c-804d-2a8efe561c65",
"links": [
{
"href": "http://localhost:8776/v1/c95fc3e4afe248a49a28828f286a7b38/backups/2ef47aee-8844-490c-804d-2a8efe561c65",
"rel": "self"
},
{
"href": "http://localhost:8776/c95fc3e4afe248a49a28828f286a7b38/backups/2ef47aee-8844-490c-804d-2a8efe561c65",
"rel": "bookmark"
}
],
"name": "backup001",
"object_count": 22,
"size": 1,
"status": "available",
"volume_id": "e5185058-943a-4cb4-96d9-72c184c337d6",
"is_incremental": true,
"has_dependent_backups": false
}
}
Deletes a backup.
Normal response codes: 202, Error response codes: Bad Request(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
backup_id (Optional) | path | string | The UUID for a backup. |
Restores a Block Storage backup to an existing or new Block Storage volume.
You must specify either the UUID or name of the volume. If you specify both the UUID and name, the UUID takes priority.
Normal response codes: 202, Error response codes: Bad Request(400), Request Entity Too Large(413)
Name | In | Type | Description |
---|---|---|---|
restore | body | object | A restore object. |
name | body | string | The name of the Volume Transfer. |
volume_id | body | string | The UUID of the volume. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
backup_id (Optional) | path | string | The UUID for a backup. |
{
"restore": {
"name": "vol-01",
"volume_id": "64f5d2fb-d836-4063-b7e2-544d5c1ff607"
}
}
Name | In | Type | Description |
---|---|---|---|
restore | body | object | A restore object. |
backup_id (Optional) | path | string | The UUID for a backup. |
volume_id | body | string | The UUID of the volume. |
volume_name | body | string | The volume name. |
Creates a Block Storage backup from a volume.
Normal response codes: 202, Error response codes: Bad Request(400), Internal Server Error(500)
Name | In | Type | Description |
---|---|---|---|
container | body | string | The container name or null. |
description | body | string | The backup description or null. |
incremental (Optional) | body | boolean | The backup mode. A valid value is true for
incremental backup mode or false for full backup mode. Default
is false . |
volume_id | body | string | The UUID of the volume. |
force (Optional) | body | boolean | Indicates whether to backup, even if the volume
is attached. Default is false . |
backup | body | object | A backup object. |
name (Optional) | body | string | The name of the Volume Backup. |
snapshot_id | body | string | The UUID of the source volume snapshot. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"backup": {
"container": null,
"description": null,
"name": "backup001",
"volume_id": "64f5d2fb-d836-4063-b7e2-544d5c1ff607",
"incremental": true
}
}
Name | In | Type | Description |
---|---|---|---|
backup | body | object | A backup object. |
id | body | string | The UUID of the volume transfer. |
links | body | array | Links for the volume transfer. |
name | body | string | The name of the Volume Transfer. |
Update a Block Storage backup. This API is available since v3.9.
Normal response codes: 202, Error response codes: Bad Request(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
backup_id (Optional) | path | string | The UUID for a backup. |
backup | body | object | A backup object. |
description | body | string | The backup description or null. |
name (Optional) | body | string | The name of the Volume Backup. |
{
"backup":{
"name":"test",
"description": "this is a backup"
}
}
Name | In | Type | Description |
---|---|---|---|
backup | body | object | A backup object. |
id | body | string | The UUID of the volume transfer. |
links | body | array | Links for the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"backup": {
"id": "fad41a83-203d-4998-9d3b-444fd5da5aba",
"links": [
{
"href": "http://10.3.150.25:8776/v3/a7090a26bc554d93aa845a4d41808251/backups/fad41a83-203d-4998-9d3b-444fd5da5aba",
"rel": "self"
},
{
"href": "http://10.3.150.25:8776/a7090a26bc554d93aa845a4d41808251/backups/fad41a83-203d-4998-9d3b-444fd5da5aba",
"rel": "bookmark"
}
],
"name": "test"
}
}
Lists Block Storage backups to which the project has access, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
backups | body | array | A list of backup objects. |
id | body | string | The UUID of the volume transfer. |
links | body | array | Links for the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"backups": [
{
"id": "2ef47aee-8844-490c-804d-2a8efe561c65",
"links": [
{
"href": "http://localhost:8776/v1/c95fc3e4afe248a49a28828f286a7b38/backups/2ef47aee-8844-490c-804d-2a8efe561c65",
"rel": "self"
},
{
"href": "http://localhost:8776/c95fc3e4afe248a49a28828f286a7b38/backups/2ef47aee-8844-490c-804d-2a8efe561c65",
"rel": "bookmark"
}
],
"name": "backup001"
},
{
"id": "4dbf0ec2-0b57-4669-9823-9f7c76f2b4f8",
"links": [
{
"href": "http://localhost:8776/v1/c95fc3e4afe248a49a28828f286a7b38/backups/4dbf0ec2-0b57-4669-9823-9f7c76f2b4f8",
"rel": "self"
},
{
"href": "http://localhost:8776/c95fc3e4afe248a49a28828f286a7b38/backups/4dbf0ec2-0b57-4669-9823-9f7c76f2b4f8",
"rel": "bookmark"
}
],
"name": "backup002"
}
]
}
Force-deletes a backup.
Force-deletes a backup. Specify the os-force_delete
action in the request body.
This operations deletes the backup and any backup data.
The backup driver returns the 405
status code if it does not
support this operation.
Error response codes:404,405,202,
Name | In | Type | Description |
---|---|---|---|
os-force_delete | body | string | The os-force_delete action. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
backup_id (Optional) | path | string | The UUID for a backup. |
{
"os-force_delete": {}
}
Shows capabilities for a storage back end.
Shows capabilities for a storage back end on the host.
The hostname
takes the form of hostname@volume_backend_name
.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
hostname | path | string | The name of the host that hosts the storage back end. |
Name | In | Type | Description |
---|---|---|---|
pool_name | body | string | The name of the storage pool. |
description | body | string | The backup description or null. |
volume_backend_name | body | string | The name of the back-end volume. |
namespace | body | string | Link associated to the extension. |
visibility | body | string | The volume type access. |
driver_version | body | string | The driver version. |
vendor_name | body | string | The name of the vendor. |
properties | body | object | The backend volume capabilities list, which is consisted of cinder standard capabilities and vendor unique properties. |
storage_protocol | body | string | The storage back end for the back-end volume. For
example, iSCSI or FC . |
replication_targets | body | list | A list of volume backends used to replicate volumes on this backend. |
display_name | body | string | The name of volume backend capabilities. |
{
"namespace": "OS::Storage::Capabilities::fake",
"vendor_name": "OpenStack",
"volume_backend_name": "lvmdriver-1",
"pool_name": "pool",
"driver_version": "2.0.0",
"storage_protocol": "iSCSI",
"display_name": "Capabilities of Cinder LVM driver",
"description": "These are volume type options provided by Cinder LVM driver, blah, blah.",
"visibility": "public",
"replication_targets": [],
"properties": {
"compression": {
"title": "Compression",
"description": "Enables compression.",
"type": "boolean"
},
"qos": {
"title": "QoS",
"description": "Enables QoS.",
"type": "boolean"
},
"replication": {
"title": "Replication",
"description": "Enables replication.",
"type": "boolean"
},
"thin_provisioning": {
"title": "Thin Provisioning",
"description": "Sets thin provisioning.",
"type": "boolean"
}
}
}
Consistency groups enable you to create snapshots at the exact same point in time from multiple volumes. For example, a database might place its tables, logs, and configuration on separate volumes. To restore this database from a previous point in time, it makes sense to restore the logs, tables, and configuration together from the exact same point in time.
Use the policy.json
file to grant permissions for these actions
to limit roles.
Lists consistency groups.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"consistencygroups": [
{
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"name": "my-cg1"
},
{
"id": "aed36625-a6d7-4681-ba59-c7ba3d18c148",
"name": "my-cg2"
}
]
}
Creates a consistency group.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
description | body | string | The consistency group description. |
availability_zone (Optional) | body | string | The name of the availability zone. |
volume_types | body | string | The list of volume types separated by commas. In an environment with multiple-storage back ends, the scheduler determines where to send the volume based on the volume type. For information about how to use volume types to create multiple-storage back ends, see Configure multiple-storage back ends. |
name (Optional) | body | string | The consistency group name. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status of the consistency group. |
description (Optional) | body | string | The consistency group description. |
availability_zone (Optional) | body | string | The name of the availability zone. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
volume_types | body | array | The list of volume types. In an environment with multiple-storage back ends, the scheduler determines where to send the volume based on the volume type. For information about how to use volume types to create multiple- storage back ends, see Configure multiple-storage back ends. |
name (Optional) | body | string | The consistency group name. |
id (Optional) | body | string | The UUID of the consistency group. |
{
"consistencygroup": {
"name": "firstcg",
"description": "first consistency group",
"volume_types": "type1,type2",
"availability_zone": "az0"
}
}
{
"consistencygroup": {
"status": "error",
"description": "first consistency group",
"availability_zone": "az0",
"created_at": "2016-08-19T19:32:19.000000",
"volume_types": ["type1", "type2"],
"id": "63d1a274-de38-4384-a97e-475306777027",
"name": "firstcg"
}
}
Shows details for a consistency group.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
consistencygroup_id | body | string | The UUID of the consistency group. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status of the consistency group. |
description | body | string | The backup description or null. |
availability_zone (Optional) | body | string | The name of the availability zone. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
volume_types | body | array | The list of volume types. In an environment with multiple-storage back ends, the scheduler determines where to send the volume based on the volume type. For information about how to use volume types to create multiple- storage back ends, see Configure multiple-storage back ends. |
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"consistencygroup": {
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"status": "available",
"availability_zone": "az1",
"created_at": "2015-09-16T09:28:52.000000",
"name": "my-cg1",
"description": "my first consistency group",
"volume_types": [
"123456"
]
}
}
Creates a consistency group from source.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status of the consistency group. |
user_id | body | string | The UUID of the user. |
description | body | string | The backup description or null. |
cgsnapshot_id (Optional) | body | string | The UUID of the consistency group snapshot. |
source_cgid (Optional) | body | string | The UUID of the source consistency group. |
project_id | body | string | The UUID of the project. |
name | body | string | The name of the Volume Transfer. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"consistencygroup-from-src": {
"name": "firstcg",
"description": "first consistency group",
"cgsnapshot_id": "6f519a48-3183-46cf-a32f-41815f813986",
"source_cgid": "6f519a48-3183-46cf-a32f-41815f814546",
"user_id": "6f519a48-3183-46cf-a32f-41815f815555",
"project_id": "6f519a48-3183-46cf-a32f-41815f814444",
"status": "creating"
}
}
Deletes a consistency group.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
force (Optional) | body | boolean | Indicates whether to backup, even if the volume
is attached. Default is false . |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
consistencygroup_id | body | string | The UUID of the consistency group. |
{
"consistencygroup": {
"force": false
}
}
Lists consistency groups with details.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status of the consistency group. |
description | body | string | The backup description or null. |
availability_zone (Optional) | body | string | The name of the availability zone. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
volume_types | body | array | The list of volume types. In an environment with multiple-storage back ends, the scheduler determines where to send the volume based on the volume type. For information about how to use volume types to create multiple- storage back ends, see Configure multiple-storage back ends. |
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"consistencygroups": [
{
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"status": "available",
"availability_zone": "az1",
"created_at": "2015-09-16T09:28:52.000000",
"name": "my-cg1",
"description": "my first consistency group",
"volume_types": [
"123456"
]
},
{
"id": "aed36625-a6d7-4681-ba59-c7ba3d18c148",
"status": "error",
"availability_zone": "az2",
"created_at": "2015-09-16T09:31:15.000000",
"name": "my-cg2",
"description": "Edited description",
"volume_types": [
"234567"
]
}
]
}
Updates a consistency group.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
remove_volumes (Optional) | body | string | One or more volume UUIDs, separated by commas, to remove from the volume group or consistency group. |
description | body | string | The backup description or null. |
add_volumes (Optional) | body | string | One or more volume UUIDs, separated by commas, to add to the volume group or consistency group. |
name | body | string | The name of the Volume Transfer. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
consistencygroup_id | body | string | The UUID of the consistency group. |
{
"consistencygroup": {
"name": "my_cg",
"description": "My consistency group",
"add_volumes": "volume-uuid-1,volume-uuid-2",
"remove_volumes": "volume-uuid-8,volume-uuid-9"
}
}
Lists all, lists all with details, shows details for, creates, and deletes consistency group snapshots.
Deletes a consistency group snapshot.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
cgsnapshot_id (Optional) | body | string | The UUID of the consistency group snapshot. |
Shows details for a consistency group snapshot.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
cgsnapshot_id (Optional) | body | string | The UUID of the consistency group snapshot. |
Name | In | Type | Description |
---|---|---|---|
status (Optional) | body | string | The status of the consistency group snapshot. |
description | body | string | The backup description or null. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
consistencygroup_id | body | string | The UUID of the consistency group. |
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"cgsnapshot": {
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"consistencygroup_id": "6f519a48-3183-46cf-a32f-41815f814444",
"status": "available",
"created_at": "2015-09-16T09:28:52.000000",
"name": "my-cg1",
"description": "my first consistency group"
}
}
Lists all consistency group snapshots with details.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
Name | In | Type | Description |
---|---|---|---|
status (Optional) | body | string | The status of the consistency group snapshot. |
description | body | string | The backup description or null. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
consistencygroup_id | body | string | The UUID of the consistency group. |
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"cgsnapshots": [
{
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"consistencygroup_id": "6f519a48-3183-46cf-a32f-41815f814444",
"status": "available",
"created_at": "2015-09-16T09:28:52.000000",
"name": "my-cg1",
"description": "my first consistency group"
},
{
"id": "aed36625-a6d7-4681-ba59-c7ba3d18c148",
"consistencygroup_id": "aed36625-a6d7-4681-ba59-c7ba3d18dddd",
"status": "error",
"created_at": "2015-09-16T09:31:15.000000",
"name": "my-cg2",
"description": "Edited description"
}
]
}
Lists all consistency group snapshots.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
Name | In | Type | Description |
---|---|---|---|
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"cgsnapshots": [
{
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"name": "my-cg1"
},
{
"id": "aed36625-a6d7-4681-ba59-c7ba3d18c148",
"name": "my-cg2"
}
]
}
Creates a consistency group snapshot.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
name | body | string | The name of the Volume Transfer. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"cgsnapshot": {
"consistencygroup_id": "6f519a48-3183-46cf-a32f-41815f814546",
"name": "firstcg",
"description": "first consistency group",
"user_id": "6f519a48-3183-46cf-a32f-41815f814444",
"project_id": "6f519a48-3183-46cf-a32f-41815f815555",
"status": "creating"
}
}
Name | In | Type | Description |
---|---|---|---|
status (Optional) | body | string | The status of the consistency group snapshot. |
description | body | string | The backup description or null. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
consistencygroup_id | body | string | The UUID of the consistency group. |
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
Generic volume groups enable you to create a group of volumes and manage them together.
How is generic volume groups different from consistency groups? Currently consistency groups in cinder only support consistent group snapshot. It cannot be extended easily to serve other purposes. A project may want to put volumes used in the same application together in a group so that it is easier to manage them together, and this group of volumes may or may not support consistent group snapshot. Generic volume group is introduced to solve this problem. By decoupling the tight relationship between the group construct and the consistency concept, generic volume groups can be extended to support other features in the future.
Lists groups, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"groups": [
{
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"name": "my_group1"
},
{
"id": "aed36625-a6d7-4681-ba59-c7ba3d18c148",
"name": "my_group2"
}
]
}
Creates a group.
Normal response codes: 202 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
description | body | string | The backup description or null. |
availability_zone (Optional) | body | string | The name of the availability zone. |
group_type | body | object | A group_type object. |
volume_types | body | array | The list of volume types. In an environment with multiple-storage back ends, the scheduler determines where to send the volume based on the volume type. For information about how to use volume types to create multiple- storage back ends, see Configure multiple-storage back ends. |
name | body | string | The name of the Volume Transfer. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"group": {
"name": "first_group",
"description": "first group",
"group_type": "29514915-5208-46ab-9ece-1cc4688ad0c1",
"volume_types": [
"4e9e6d23-eed0-426d-b90a-28f87a94b6fe",
"c4daaf47-c530-4901-b28e-f5f0a359c4e6"
],
"availability_zone": "az0",
}
}
Shows details for a group.
Normal response codes: 200 Error response codes: itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
group_id (Optional) | path | string | The ID of the group. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status of the generic group. |
description | body | string | The backup description or null. |
availability_zone (Optional) | body | string | The name of the availability zone. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
group_type | body | object | A group_type object. |
volume_types | body | array | The list of volume types. In an environment with multiple-storage back ends, the scheduler determines where to send the volume based on the volume type. For information about how to use volume types to create multiple- storage back ends, see Configure multiple-storage back ends. |
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"group": {
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"status": "available",
"availability_zone": "az1",
"created_at": "2015-09-16T09:28:52.000000",
"name": "first_group",
"description": "my first group",
"group_type": "29514915-5208-46ab-9ece-1cc4688ad0c1",
"volume_types": [
"c4daaf47-c530-4901-b28e-f5f0a359c4e6"
],
"group_snapshot_id": None,
"source_group_id": None
}
}
Creates a group from source.
Normal response codes: 202 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
description | body | string | The backup description or null. |
group_snapshot_id (Optional) | path | string | The ID of the group snapshot. |
source_group_id (Optional) | body | string | The UUID of the source group. |
name | body | string | The name of the Volume Transfer. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"create-from-src": {
"name": "first_group",
"description": "first group",
"group_snapshot_id": "6f519a48-3183-46cf-a32f-41815f813986",
"source_group_id": None,
"user_id": "6f519a48-3183-46cf-a32f-41815f815555",
"project_id": "6f519a48-3183-46cf-a32f-41815f814444",
"status": "creating"
}
}
Deletes a group.
Normal response codes: 202 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
delete-volumes (Optional) | body | boolean | If set to true , allows deletion of a
group as well as all volumes in the group. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
group_id (Optional) | path | string | The ID of the group. |
{
"delete": {
"delete-volumes": False
}
}
Lists groups with details, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
status | body | string | The status of the generic group. |
description | body | string | The backup description or null. |
availability_zone (Optional) | body | string | The name of the availability zone. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
group_type | body | object | A group_type object. |
volume_types | body | array | The list of volume types. In an environment with multiple-storage back ends, the scheduler determines where to send the volume based on the volume type. For information about how to use volume types to create multiple- storage back ends, see Configure multiple-storage back ends. |
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"groups": [
{
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"status": "available",
"availability_zone": "az1",
"created_at": "2015-09-16T09:28:52.000000",
"name": "my_group1",
"description": "my first group",
"group_type": "29514915-5208-46ab-9ece-1cc4688ad0c1",
"volume_types": [
"4e9e6d23-eed0-426d-b90a-28f87a94b6fe",
"a3d55d15-eeb1-4816-ada9-bf82decc09b3"
]
},
{
"id": "aed36625-a6d7-4681-ba59-c7ba3d18c148",
"status": "error",
"availability_zone": "az2",
"created_at": "2015-09-16T09:31:15.000000",
"name": "my_group2",
"description": "Edited description",
"group_type": "f8645498-1323-47a2-9442-5c57724d2e3c",
"volume_types": [
"c4daaf47-c530-4901-b28e-f5f0a359c4e6"
]
}
]
}
Updates a group.
Normal response codes: 202 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
remove_volumes (Optional) | body | string | One or more volume UUIDs, separated by commas, to remove from the volume group or consistency group. |
description | body | string | The backup description or null. |
add_volumes (Optional) | body | string | One or more volume UUIDs, separated by commas, to add to the volume group or consistency group. |
name | body | string | The name of the Volume Transfer. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
group_id (Optional) | path | string | The ID of the group. |
{
"group": {
"name": "my_group",
"description": "My group",
"add_volumes": "volume-uuid-1,volume-uuid-2",
"remove_volumes": "volume-uuid-8,volume-uuid-9"
}
}
Resets the status for a group. Specify the reset_status
action in the request body.
Normal response codes: 202 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
reset_status | body | object | The reset_status action. |
status (Optional) | body | string | The status of the consistency group snapshot. |
project_id | body | string | The UUID of the project. |
group_id (Optional) | path | string | The ID of the group. |
{
"reset_status": {
"status": "available"
}
}
Lists all, lists all with details, shows details for, creates, and deletes group snapshots.
Deletes a group snapshot.
Normal response codes: 202 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
group_snapshot_id (Optional) | path | string | The ID of the group snapshot. |
Shows details for a group snapshot.
Normal response codes: 200 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
group_snapshot_id (Optional) | path | string | The ID of the group snapshot. |
Name | In | Type | Description |
---|---|---|---|
status (Optional) | body | string | The status of the generic group snapshot. |
description | body | string | The backup description or null. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
group_id (Optional) | path | string | The ID of the group. |
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"group_snapshot": {
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"group_id": "6f519a48-3183-46cf-a32f-41815f814444",
"status": "available",
"created_at": "2015-09-16T09:28:52.000000",
"name": "my_group_snapshot1",
"description": "my first group snapshot"
}
}
Lists all group snapshots with details, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
status (Optional) | body | string | The status of the generic group snapshot. |
description | body | string | The backup description or null. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
group_id (Optional) | path | string | The ID of the group. |
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"group_snapshots": [
{
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"group_id": "6f519a48-3183-46cf-a32f-41815f814444",
"status": "available",
"created_at": "2015-09-16T09:28:52.000000",
"name": "my_group_snapshot1",
"description": "my first group snapshot"
},
{
"id": "aed36625-a6d7-4681-ba59-c7ba3d18c148",
"group_id": "aed36625-a6d7-4681-ba59-c7ba3d18dddd",
"status": "error",
"created_at": "2015-09-16T09:31:15.000000",
"name": "my_group_snapshot2",
"description": "Edited description"
}
]
}
Lists all group snapshots, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"group_snapshots": [
{
"id": "6f519a48-3183-46cf-a32f-41815f813986",
"name": "my_group_snapshot1"
},
{
"id": "aed36625-a6d7-4681-ba59-c7ba3d18c148",
"name": "my_group_snapshot2"
}
]
}
Creates a group snapshot.
Normal response codes: 202 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
name | body | string | The name of the Volume Transfer. |
description | body | string | The backup description or null. |
group_id (Optional) | path | string | The ID of the group. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"group_snapshot": {
"group_id": "6f519a48-3183-46cf-a32f-41815f814546",
"name": "first_group_snapshot",
"description": "first group snapshot",
}
}
Name | In | Type | Description |
---|---|---|---|
status (Optional) | body | string | The status of the generic group snapshot. |
description | body | string | The backup description or null. |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
group_id (Optional) | path | string | The ID of the group. |
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
Resets the status for a group snapshot. Specifies the reset_status
action in the request body.
Normal response codes: 202 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
reset_status | body | object | The reset_status action. |
status (Optional) | body | string | The status of the consistency group snapshot. |
project_id | body | string | The UUID of the project. |
group_snapshot_id (Optional) | path | string | The ID of the group snapshot. |
{
"reset_status": {
"status": "available"
}
}
Updates a group type.
To create a generic volume group, you must specify a group type.
Normal response codes: 200 Error response codes: badRequest(400), forbidden(403), itemNotFound(404), conflict(409), computeFault(500)
Name | In | Type | Description |
---|---|---|---|
group_type | body | object | A group_type object. |
group_type_id (Optional) | path | string | The UUID for an existing group type. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"group_type": {
"name": "grp-type-001",
"description": "group type 0001",
"is_public": true,
}
}
Name | In | Type | Description |
---|---|---|---|
is_public (Optional) | body | boolean | Volume type which is accessible to the public. |
group_specs (Optional) | body | object | A set of key and value pairs that contains the specifications for a group type. |
description | body | string | The backup description or null. |
group_type | body | object | A group_type object. |
name | body | string | The name of the Volume Transfer. |
{
"group_type": {
"id": "6685584b-1eac-4da6-b5c3-555430cf68ff",
"name": "grp-type-001",
"description": "group type 001",
"is_public": "true",
"group_specs": {
"consistent_group_snapshot_enabled": "<is> False"
}
}
}
Create group specs for a group type.
Normal response codes: 202 Error response codes: badRequest(400), forbidden(403), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
group_specs (Optional) | body | object | A set of key and value pairs that contains the specifications for a group type. |
group_type | body | object | A group_type object. |
group_type_id (Optional) | path | string | The UUID for an existing group type. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"group_specs": {
"key1": "value1",
"key2": "value2",
}
}
Name | In | Type | Description |
---|---|---|---|
is_public (Optional) | body | boolean | Volume type which is accessible to the public. |
group_specs (Optional) | body | object | A set of key and value pairs that contains the specifications for a group type. |
description | body | string | The backup description or null. |
group_type | body | object | A group_type object. |
name | body | string | The name of the Volume Transfer. |
{
"group_type": {
"id": "6685584b-1eac-4da6-b5c3-555430cf68ff",
"name": "grp-type-001",
"description": "group type 001",
"is_public": "true",
"group_specs": {
"consistent_group_snapshot_enabled": "<is> False"
}
}
}
Shows details for a group type.
Normal response codes: 200 Error response codes: itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
group_type_id (Optional) | path | string | The UUID for an existing group type. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
Name | In | Type | Description |
---|---|---|---|
is_public (Optional) | body | boolean | Volume type which is accessible to the public. |
group_specs (Optional) | body | object | A set of key and value pairs that contains the specifications for a group type. |
description | body | string | The backup description or null. |
group_type | body | object | A group_type object. |
name | body | string | The name of the Volume Transfer. |
{
"group_type": {
"id": "6685584b-1eac-4da6-b5c3-555430cf68ff",
"name": "grp-type-001",
"description": "group type 001",
"is_public": "true",
"group_specs": {
"consistent_group_snapshot_enabled": "<is> False"
}
}
}
Deletes a group type.
Normal response codes: 202 Error response codes: badRequest(400), forbidden(403), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
group_type_id (Optional) | path | string | The UUID for an existing group type. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
Lists group types.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
group_types | body | array | The list of group types. |
group_specs (Optional) | body | object | A set of key and value pairs that contains the specifications for a group type. |
name | body | string | The name of the Volume Transfer. |
group_type | body | object | A group_type object. |
{
"group_types": [
{
"group_specs": {
"consistent_group_snapshot_enabled": "<is> False"
},
"id": "6685584b-1eac-4da6-b5c3-555430cf68ff",
"name": "group_type1"
},
{
"group_specs": {},
"id": "8eb69a46-df97-4e41-9586-9a40a7533803",
"name": "group_type2"
}
]
}
Creates a group type.
To create a generic volume group, you must specify a group type.
Normal response codes: 202 Error response codes: badRequest(400), forbidden(403), itemNotFound(404), conflict(409)
Name | In | Type | Description |
---|---|---|---|
group_type | body | object | A group_type object. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"group_type": {
"name": "grp-type-001",
"description": "group type 0001",
"is_public": True,
"group_specs": {
"consistent_group_snapshot_enabled": "<is> False"
}
}
}
Name | In | Type | Description |
---|---|---|---|
is_public (Optional) | body | boolean | Volume type which is accessible to the public. |
group_specs (Optional) | body | object | A set of key and value pairs that contains the specifications for a group type. |
description | body | string | The backup description or null. |
group_type | body | object | A group_type object. |
name | body | string | The name of the Volume Transfer. |
{
"group_type": {
"id": "6685584b-1eac-4da6-b5c3-555430cf68ff",
"name": "grp-type-001",
"description": "group type 001",
"is_public": "true",
"group_specs": {
"consistent_group_snapshot_enabled": "<is> False"
}
}
}
Administrators only, depending on policy settings.
Lists, shows hosts.
Lists all hosts summary info that is not disabled.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
admin_project_id | path | string | The UUID of the administrative project. |
Name | In | Type | Description |
---|---|---|---|
service-status | body | string | The status of the service. One of enabled or disabled . |
service | body | string | The name of the service which is running on the host. |
zone | body | string | The availability zone name. |
service-state | body | string | The state of the service. One of available or unavailable . |
host_name | path | string | The name of the host that hosts the storage back end. |
last-update | body | string | The date and time when the resource was updated. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The If the |
{
"hosts": [{
"service-status": "available",
"service": "cinder-backup",
"zone": "nova",
"service-state": "enabled",
"host_name": "node1",
"last-update": "2017-03-09T21:38:41.000000"
},
{
"service-status": "available",
"service": "cinder-scheduler",
"zone": "nova",
"service-state": "enabled",
"host_name": "node1",
"last-update": "2017-03-09T21:38:38.000000"
},
{
"service-status": "available",
"service": "cinder-volume",
"zone": "nova",
"service-state": "enabled",
"host_name": "node1@lvm",
"last-update": "2017-03-09T21:38:35.000000"
}]
}
Shows details for a host.
Normal response codes: 200
Error response codes: unauthorized(401), forbidden(403), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
admin_project_id | path | string | The UUID of the administrative project. |
host_name | path | string | The name of the host that hosts the storage back end. |
Name | In | Type | Description |
---|---|---|---|
volume_count | body | integer | Total number of volumes. |
total_volume_gb | body | integer | The total number of gibibytes (GiB) used. |
total_snapshot_gb | body | integer | The total number of snapshots used. |
project | path | string | The UUID of the administrative project. |
host | body | string | The OpenStack Block Storage host where the existing volume resides. |
snapshot_count | body | integer | The total number of snapshots used. |
Example Show Host Details
{
"host": [{
"resource": {
"volume_count": "8",
"total_volume_gb": "11",
"total_snapshot_gb": "1",
"project": "(total)",
"host": "node1@rbd-sas",
"snapshot_count": "1"
}
},
{
"resource": {
"volume_count": "8",
"total_volume_gb": "11",
"total_snapshot_gb": "1",
"project": "f21a9c86d7114bf99c711f4874d80474",
"host": "node1@rbd-sas",
"snapshot_count": "1"
}
}]
}
Shows absolute limits for a project.
An absolute limit value of -1
indicates that the absolute limit
for the item is infinite.
Shows absolute limits for a project.
An absolute limit value of -1
indicates that the absolute limit
for the item is infinite.
Normal response codes: 200 Error response codes:203,
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
Name | In | Type | Description |
---|---|---|---|
totalSnapshotsUsed | body | integer | The total number of snapshots used. |
maxTotalBackups | body | integer | The maximum number of backups. |
maxTotalVolumeGigabytes | body | integer | The maximum total amount of volumes, in gibibytes (GiB). |
limits | body | object | A list of limit objects. |
maxTotalSnapshots | body | integer | The maximum number of snapshots. |
maxTotalBackupGigabytes | body | integer | The maximum total amount of backups, in gibibytes (GiB). |
totalBackupGigabytesUsed | body | integer | The total number of backups gibibytes (GiB) used. |
maxTotalVolumes | body | integer | The maximum number of volumes. |
totalVolumesUsed | body | integer | The total number of volumes used. |
rate | body | array | Rate-limit volume copy bandwidth, used to mitigate slow down of data access from the instances. |
totalBackupsUsed | body | integer | The total number of backups used. |
totalGigabytesUsed | body | integer | The total number of gibibytes (GiB) used. |
absolute | body | object | An absolute limits object. |
{
"limits": {
"rate": [],
"absolute": {
"totalSnapshotsUsed": 0,
"maxTotalBackups": 10,
"maxTotalVolumeGigabytes": 1000,
"maxTotalSnapshots": 10,
"maxTotalBackupGigabytes": 1000,
"totalBackupGigabytesUsed": 0,
"maxTotalVolumes": 10,
"totalVolumesUsed": 0,
"totalBackupsUsed": 0,
"totalGigabytesUsed": 0
}
}
}
Lists all, shows, and deletes messages.
Deletes a message.
Normal response codes: 202 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
message_id | query | string | The UUID of the message. |
Shows details for a message.
Normal response codes: 200 Error response codes: badRequest(400), itemNotFound(404)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
message_id | query | string | The UUID of the message. |
Name | In | Type | Description |
---|---|---|---|
request_id | body | string | The id of the request during which the message was created. |
links (Optional) | body | array | Links for the message. |
message_level | body | string | The level of the message, possible value is only ‘ERROR’ now. |
event_id | body | string | The id of the event to this message, this id could
eventually be translated into user_message . |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
guaranteed_until (Optional) | body | string | The expire time of the message, this message could be be deleted after this time. |
resource_uuid (Optional) | body | string | The UUID of the resource during whose operation the message was created. |
id | body | integer | The ID for the message. |
resource_type (Optional) | body | string | The resource type corresponding to resource_uuid . |
user_message (Optional) | body | string | The translated readable message corresponding to event_id . |
{
"message": {
"request_id": "req-c1216709-afba-4703-a1a3-22eda88f2f5a",
"links": [
{
"href": "http://localhost:8776/v3/cd609134301246f0a3faa9c3da22082e/messages/c506cd4b-9048-43bc-97ef-0d7dec369b42",
"rel": "self"
},
{
"href": "http://localhost:8776/cd609134301246f0a3faa9c3da22082e/messages/c506cd4b-9048-43bc-97ef-0d7dec369b42",
"rel": "bookmark"
}
],
"message_level": "ERROR",
"event_id": "VOLUME_000002",
"created_at": "2014-10-28T00:00:00-00:00",
"guaranteed_until": "2014-10-28T00:00:00-00:00",
"resource_uuid": "d5f6c517-c3e8-45fe-b994-b11118e4cacf",
"id": "c506cd4b-9048-43bc-97ef-0d7dec369b42",
"resource_type": "VOLUME",
"user_message": "No storage could be allocated for this volume request."
}
}
Lists all messages, since v3.31 if non-admin users specify invalid filters in the url, API will return bad request.
Normal response codes: 200 Error response codes: badRequest(400)
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
offset (Optional) | query | integer | Used in conjunction with limit to return a slice of items. offset
is where to start in the list. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
request_id | body | string | The id of the request during which the message was created. |
links (Optional) | body | array | Links for the message. |
message_level | body | string | The level of the message, possible value is only ‘ERROR’ now. |
event_id | body | string | The id of the event to this message, this id could
eventually be translated into user_message . |
created_at | body | string | The date and time when the resource was created. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm
For example, The |
guaranteed_until (Optional) | body | string | The expire time of the message, this message could be be deleted after this time. |
resource_uuid (Optional) | body | string | The UUID of the resource during whose operation the message was created. |
id | body | integer | The ID for the message. |
resource_type (Optional) | body | string | The resource type corresponding to resource_uuid . |
user_message (Optional) | body | string | The translated readable message corresponding to event_id . |
{
"messages": [{
"request_id": "req-c1216709-afba-4703-a1a3-22eda88f2f5a",
"links": [
{
"href": "http://localhost:8776/v3/cd609134301246f0a3faa9c3da22082e/messages/c506cd4b-9048-43bc-97ef-0d7dec369b42",
"rel": "self"
},
{
"href": "http://localhost:8776/cd609134301246f0a3faa9c3da22082e/messages/c506cd4b-9048-43bc-97ef-0d7dec369b42",
"rel": "bookmark"
}
],
"message_level": "ERROR",
"event_id": "VOLUME_000002",
"created_at": "2014-10-28T00:00:00-00:00",
"guaranteed_until": "2014-10-28T00:00:00-00:00",
"resource_uuid": "d5f6c517-c3e8-45fe-b994-b11118e4cacf",
"id": "c506cd4b-9048-43bc-97ef-0d7dec369b42",
"resource_type": "VOLUME",
"user_message": "No storage could be allocated for this volume request."
},{
"request_id": "req-c1216709-afba-4703-a1a3-22eda88f2f5a",
"links": [
{
"href": "http://localhost:8776/v3/cd609134301246f0a3faa9c3da22082e/messages/c506cd4b-9048-43bc-97ef-0d7dec369b42",
"rel": "self"
},
{
"href": "http://localhost:8776/cd609134301246f0a3faa9c3da22082e/messages/c506cd4b-9048-43bc-97ef-0d7dec369b42",
"rel": "bookmark"
}
],
"message_level": "ERROR",
"event_id": "VOLUME_000002",
"created_at": "2014-10-28T00:00:00-00:00",
"guaranteed_until": "2014-10-28T00:00:00-00:00",
"resource_uuid": "d5f6c517-c3e8-45fe-b994-b11118e4df4e",
"id": "c506cd4b-9048-43bc-97ef-0d7dec36d5gt",
"resource_type": "VOLUME",
"user_message": "No storage could be allocated for this volume request."
}]
}
Lists all resource filters, available since microversion 3.33.
List filters.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
resource (Optional) | path | string | Filter filters by resource name. |
Name | In | Type | Description |
---|---|---|---|
filters | body | array | The resource filter array. |
resource | body | string | Resource which the filters will be applied to. |
{
"resource_filters": [
{
"filters": [
"name",
"status",
"image_metadata", "bootable",
"migration_status"
],
"resource": "volume"
},
{
"filters": [
"name",
"status",
"volume_id"
],
"resource": "snapshot"
}
]
}
Administrators only, depending on policy settings.
Creates, lists, shows details for, associates, disassociates, sets keys, unsets keys, and deletes quality of service (QoS) specifications.
Disassociates a QoS specification from all associations.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
qos_id | path | string | The ID of the QoS specification. |
Unsets keys in a QoS specification.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
keys | body | array | List of Keys. For example, CryptsetupEncryptor, LuksEncryptor or NoOpEncryptor. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
qos_id | path | string | The ID of the QoS specification. |
{
"keys": [
"key1"
]
}
Lists all associations for a QoS specification.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
qos_id | path | string | The ID of the QoS specification. |
{
"qos_specs": {
"specs": {
"availability": "100",
"numberOfFailures": "0"
},
"consumer": "back-end",
"name": "reliability-spec",
"id": "0388d6c6-d5d4-42a3-b289-95205c50dd15"
},
"links": [
{
"href": "http://23.253.228.211:8776/v3/e1cf63117ae74309a5bcc2002a23be8b/qos_specs/0388d6c6-d5d4-42a3-b289-95205c50dd15",
"rel": "self"
},
{
"href": "http://23.253.228.211:8776/e1cf63117ae74309a5bcc2002a23be8b/qos_specs/0388d6c6-d5d4-42a3-b289-95205c50dd15",
"rel": "bookmark"
}
]
}
Associates a QoS specification with a volume type.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
qos_id | path | string | The ID of the QoS specification. |
vol_type_id | path | string | The UUID for an existing volume type. |
Disassociates a QoS specification from a volume type.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
qos_id | path | string | The ID of the QoS specification. |
vol_type_id | path | string | The UUID for an existing volume type. |
Shows details for a QoS specification.
Normal response codes: 200 Error response codes:413,405,404,403,401,400,503,
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
qos_id | path | string | The ID of the QoS specification. |
Name | In | Type | Description |
---|---|---|---|
name | body | string | The name of the Volume Transfer. |
links | body | array | Links for the volume transfer. |
id | body | string | The UUID of the volume transfer. |
qos_specs | body | object | A qos_specs object. |
consumer (Optional) | body | string | The consumer type. |
specs | body | object | A specs object. |
{
"qos_specs": {
"specs": {
"availability": "100",
"numberOfFailures": "0"
},
"consumer": "back-end",
"name": "reliability-spec",
"id": "0388d6c6-d5d4-42a3-b289-95205c50dd15"
},
"links": [
{
"href": "http://23.253.228.211:8776/v3/e1cf63117ae74309a5bcc2002a23be8b/qos_specs/0388d6c6-d5d4-42a3-b289-95205c50dd15",
"rel": "self"
},
{
"href": "http://23.253.228.211:8776/e1cf63117ae74309a5bcc2002a23be8b/qos_specs/0388d6c6-d5d4-42a3-b289-95205c50dd15",
"rel": "bookmark"
}
]
}
Sets keys in a QoS specification.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
qos_specs | body | object | A qos_specs object. |
specs | body | object | A specs object. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
qos_id | path | string | The ID of the QoS specification. |
{
"qos_specs": {
"delay": "1"
}
}
{
"qos_specs": {
"delay": "1"
}
}
Deletes a QoS specification.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
qos_id | path | string | The ID of the QoS specification. |
force (Optional) | body | boolean | Indicates whether to backup, even if the volume
is attached. Default is false . |
Creates a QoS specification.
Specify one or more key and value pairs in the request body.
Normal response codes: 202
Name | In | Type | Description |
---|---|---|---|
qos_specs | body | object | A qos_specs object. |
consumer (Optional) | body | string | The consumer type. |
name | body | string | The name of the Volume Transfer. |
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
{
"qos_specs": {
"availability": "100",
"name": "reliability-spec",
"numberOfFailures": "0"
}
}
Name | In | Type | Description |
---|---|---|---|
name | body | string | The name of the Volume Transfer. |
links | body | array | Links for the volume transfer. |
id | body | string | The UUID of the volume transfer. |
qos_specs | body | object | A qos_specs object. |
consumer (Optional) | body | string | The consumer type. |
specs | body | object | A specs object. |
Lists quality of service (QoS) specifications.
Normal response codes: 200 Error response codes:300,
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
sort_key (Optional) | query | string | Sorts by an attribute. A valid value is name ,
status , container_format , disk_format , size ,
id , created_at , or updated_at . Default is
created_at . The API uses the natural sorting direction of the
sort_key attribute value. |
sort_dir (Optional) | query | string | Sorts by one or more sets of attribute and sort
direction combinations. If you omit the sort direction in a set,
default is desc . |
limit (Optional) | query | integer | Requests a page size of items. Returns a number
of items up to a limit value. Use the limit parameter to make
an initial limited request and use the ID of the last-seen item
from the response as the marker parameter value in a
subsequent limited request. |
marker (Optional) | query | string | The ID of the last-seen item. Use the limit
parameter to make an initial limited request and use the ID of the
last-seen item from the response as the marker parameter value
in a subsequent limited request. |
Name | In | Type | Description |
---|---|---|---|
specs | body | object | A specs object. |
qos_specs | body | object | A qos_specs object. |
consumer (Optional) | body | string | The consumer type. |
id | body | string | The UUID of the volume transfer. |
name | body | string | The name of the Volume Transfer. |
{
"qos_specs": [
{
"specs": {
"availability": "100",
"numberOfFailures": "0"
},
"consumer": "back-end",
"name": "reliability-spec",
"id": "0388d6c6-d5d4-42a3-b289-95205c50dd15"
},
{
"specs": {
"delay": "0",
"throughput": "100"
},
"consumer": "back-end",
"name": "performance-spec",
"id": "ecfc6e2e-7117-44a4-8eec-f84d04f531a8"
}
]
}
Administrators only, depending on policy settings.
Shows, updates, and deletes quotas for a project.
Shows quotas for a project.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the tenant in a multi-tenancy cloud. |
admin_project_id | path | string | The UUID of the administrative project. |
usage (Optional) | query | boolean | Set to usage=true to show quota usage.
Default is false . |
Name | In | Type | Description |
---|---|---|---|
injected_file_content_bytes | body | integer | The number of bytes of content that are allowed for each injected file. |
metadata_items | body | integer | The number of metadata items that are allowed for each instance. |
reserved (Optional) | body | integer | Reserved volume size. Visible only if you set the
usage=true query parameter. |
in_use (Optional) | body | string | The in use data size. Visible only if you set the
usage=true query parameter. |
ram | body | integer | The amount of instance RAM in megabytes that are allowed for each project. |
floating_ips | body | integer | The number of floating IP addresses that are allowed for each project. |
key_pairs | body | integer | The number of key pairs that are allowed for each user. |
injected_file_path_bytes | body | integer | The number of bytes that are allowed for each injected file path. |
instances | body | integer | The number of instances that are allowed for each project. |
security_group_rules (Optional) | body | integer | The number of rules that are allowed for each security group. |
injected_files | body | integer | The number of injected files that are allowed for each project. |
quota_set | body | object | A quota_set object. |
cores | body | integer | The number of instance cores that are allowed for each project. |
fixed_ips | body | integer | The number of fixed IP addresses that are allowed for each project. Must be equal to or greater than the number of allowed instances. |
id | body | string | The UUID of the volume transfer. |
security_groups | body | integer | The number of security groups that are allowed for each project. |
{
"quota_set": {
"gigabytes": 5,
"snapshots": 10,
"volumes": 20
}
}
Updates quotas for a project.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
injected_file_content_bytes | body | integer | The number of bytes of content that are allowed for each injected file. |
metadata_items | body | integer | The number of metadata items that are allowed for each instance. |
reserved (Optional) | body | integer | Reserved volume size. Visible only if you set the
usage=true query parameter. |
in_use (Optional) | body | string | The in use data size. Visible only if you set the
usage=true query parameter. |
ram | body | integer | The amount of instance RAM in megabytes that are allowed for each project. |
floating_ips | body | integer | The number of floating IP addresses that are allowed for each project. |
key_pairs | body | integer | The number of key pairs that are allowed for each user. |
injected_file_path_bytes | body | integer | The number of bytes that are allowed for each injected file path. |
instances | body | integer | The number of instances that are allowed for each project. |
security_group_rules (Optional) | body | integer | The number of rules that are allowed for each security group. |
injected_files | body | integer | The number of injected files that are allowed for each project. |
quota_set | body | object | A quota_set object. |
cores | body | integer | The number of instance cores that are allowed for each project. |
fixed_ips | body | integer | The number of fixed IP addresses that are allowed for each project. Must be equal to or greater than the number of allowed instances. |
id | body | string | The UUID of the volume transfer. |
security_groups | body | integer | The number of security groups that are allowed for each project. |
project_id | path | string | The UUID of the tenant in a multi-tenancy cloud. |
admin_project_id | path | string | The UUID of the administrative project. |
{
"quota_set": {
"snapshots": 45
}
}
Name | In | Type | Description |
---|---|---|---|
injected_file_content_bytes | body | integer | The number of bytes of content that are allowed for each injected file. |
metadata_items | body | integer | The number of metadata items that are allowed for each instance. |
reserved (Optional) | body | integer | Reserved volume size. Visible only if you set the
usage=true query parameter. |
in_use (Optional) | body | string | The in use data size. Visible only if you set the
usage=true query parameter. |
ram | body | integer | The amount of instance RAM in megabytes that are allowed for each project. |
floating_ips | body | integer | The number of floating IP addresses that are allowed for each project. |
key_pairs | body | integer | The number of key pairs that are allowed for each user. |
injected_file_path_bytes | body | integer | The number of bytes that are allowed for each injected file path. |
instances | body | integer | The number of instances that are allowed for each project. |
security_group_rules (Optional) | body | integer | The number of rules that are allowed for each security group. |
injected_files | body | integer | The number of injected files that are allowed for each project. |
quota_set | body | object | A quota_set object. |
cores | body | integer | The number of instance cores that are allowed for each project. |
fixed_ips | body | integer | The number of fixed IP addresses that are allowed for each project. Must be equal to or greater than the number of allowed instances. |
id | body | string | The UUID of the volume transfer. |
security_groups | body | integer | The number of security groups that are allowed for each project. |
{
"quota_set": {
"snapshots": 45
}
}
Deletes quotas for a project so the quotas revert to default values.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the tenant in a multi-tenancy cloud. |
admin_project_id | path | string | The UUID of the administrative project. |
Gets default quotas for a project.
Normal response codes: 200 Error response codes:
Name | In | Type | Description |
---|---|---|---|
project_id | path | string | The UUID of the project in a multi-tenancy cloud. |
admin_project_id | path | string | The UUID of the administrative project. |
Name | In | Type | Description |
---|---|---|---|
injected_file_content_bytes | body | integer | The number of bytes of content that are allowed for each injected file. |
metadata_items | body | integer | The number of metadata items that are allowed for each instance. |
reserved (Optional) | body | integer | Reserved volume size. Visible only if you set the
usage=true query parameter. |
in_use (Optional) | body | string | The in use data size. Visible only if you set the
usage=true query parameter. |
ram | body | integer | The amount of instance RAM in megabytes that are allowed for each project. |
floating_ips | body | integer | The number of floating IP addresses that are allowed for each project. |
key_pairs | body | integer | The number of key pairs that are allowed for each user. |
injected_file_path_bytes | body | integer | The number of bytes that are allowed for each injected file path. |
instances | body | integer | The number of instances that are allowed for each project. |
security_group_rules (Optional) | body | integer | The number of rules that are allowed for each security group. |
injected_files | body | integer | The number of injected files that are allowed for each project. |
quota_set | body | object | A quota_set object. |
cores | body | integer | The number of instance cores that are allowed for each project. |
fixed_ips | body | integer | The number of fixed IP addresses that are allowed for each project. Must be equal to or greater than the number of allowed instances. |
id | body | string | The UUID of the volume transfer. |
security_groups | body | integer | The number of security groups that are allowed for each project. |
{
"quota_set": {
"gigabytes": 5,
"snapshots": 10,
"volumes": 20
}
}
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.