Volume types#

Use volume type operations to list volume types and show volume type details.

Retrieve volume types#

GET /v1/{tenant_id}/types

This operation retrieves volume types.

Request#

The request has the following URI parameters.

Name

Type

Description

{tenant_id}

String

The unique identifier of the tenant or account.

This operation does not accept a request body.

Response examples#

The following example shows the XML response for retrieving volume types.

<?xml version='1.0' encoding='UTF-8'?>
<volume_types xmlns="http://docs.rackspace.com/volume/api/v1">>
    <volume_type id="1" name="SATA">
         <extra_specs/>
     </volume_type>
     <volume_type id="2" name="SSD">
         <extra_specs/>
    </volume_type>
</volume_types>

The following example shows the JSON response for retrieving volume types.

{
    "volume_types": [
        {
            "id": 1,
            "name": "SATA",
            "extra_specs": {}
        },
        {
            "id": 2,
            "name": "SSD",
            "extra_specs": {}
        }
    ]
}

Note

Two storage types are currently supported: SATA and SSD. SATA is the standard performance storage option and SSD is the high performance option.

Response codes#

This operation can have the following response codes.

Response Code

Name

Description

200

OK

Success

Retrieve volume type details#

GET /v1/{tenant_id}/types/{volume_type_id}

This operation retrieves details for a specified volume type.

Request#

The request has the following URI parameters.

Name

Type

Description

{tenant_id}

String

The unique identifier of the tenant or account.

{volume_type_id}

String

The unique identifier of an existing volume type.

This operation does not accept a request body.

Response examples#

The following example shows the XML response for retrieving details for a specified volume type.

<?xml version='1.0' encoding='UTF-8'?>
    <volume_type xmlns="http://docs.rackspace.com/volume/api/v1"
        id="1" name="SATA">
        <extra_specs/>
    </volume_type>

The following example shows the JSON response for retrieving details for a specified volume type.

{
    "volume_type": {
        "id": "1",
        "name": "SATA",
        "extra_specs": {}
    }
}

Response codes#

This operation can have the following response codes.

Response Code

Name

Description

200

OK

Success