2015/07/20 - Apache Deltacloud has been retired.

For more information, please explore the Attic.

Deltacloud API


Volume Configuration

The Volume Configuration resource represents the set of configuration values needed to create a Volume with certain characteristics. Volume Configurations are created by Providers and may, at the Providers discretion, be created by Consumers.

A Volume Configuration Collection resource represents the collection of Volume Configuration resources within a Provider.

Retrieve the Volume Configuration Collection

Example request:

GET /cimi/volume_configurations HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu)
Host: localhost:3001
Accept: application/xml

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
CIMI-Specification-Version: 1.0.1
Content-Length: 1112
ETag: 5aee339b405efd86f41f33105c62623e
Cache-Control: max-age=0, private, must-revalidate
Date: Wed, 09 Jan 2013 16:08:51 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Collection xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeConfigurationCollection">
  <id>http://localhost:3001/cimi/volume_configurations</id>
  <count>2</count>
  <VolumeConfiguration>
    <id>http://localhost:3001/cimi/volume_configurations/6</id>
    <name>marios_volume_config</name>
    <description>a volume configuration</description>
    <format>qcow2</format>
    <capacity>10485760</capacity>
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_configurations/6" />
  </VolumeConfiguration>
  <VolumeConfiguration>
    <id>http://localhost:3001/cimi/volume_configurations/7</id>
    <name>YAVC</name>
    <description> yet another volume configuration</description>
    <format>ext3</format>
    <capacity>1073741824</capacity>
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_configurations/7" />
  </VolumeConfiguration>
  <operation rel="add" href="http://localhost:3001/cimi/volume_configurations" />
</Collection>

Retrieve a single Volume Configuration

Example request:

GET /cimi/volume_configurations/2 HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu)
Host: localhost:3001
Accept: application/xml

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
CIMI-Specification-Version: 1.0.1
Content-Length: 386
ETag: 72e733ff826d0a3e486df8de3fe8c57c
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 10 Jan 2013 08:51:03 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeConfiguration xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeConfiguration">
  <id>http://localhost:3001/cimi/volume_configurations/2</id>
  <name>volume-2</name>
  <description>Volume configuration with 2097152 kibibytes</description>
  <created>2013-01-10T10:51:03+02:00</created>
  <capacity>2097152</capacity>
</VolumeConfiguration>

Create a Volume Configuration

Example request:

POST /cimi/volume_configurations HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu)
Host: localhost:3001
Content-Type: application/xml
Accept: application/xml
Content-Length: 183

<VolumeConfigurationCreate>
  <name>marios_volume_config</name>
  <description>a volume configuration</description>
  <format>qcow2</format>
  <capacity>10</capacity>
</VolumeConfigurationCreate>

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/volume_configurations/6
CIMI-Specification-Version: 1.0.1
Content-Length: 481
ETag: 536caa3e459fc2aa9a0796f317317369
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 11 Jan 2013 13:25:35 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeConfiguration xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeConfiguration">
  <id>http://localhost:3001/cimi/volume_configurations/6</id>
  <name>marios_volume_config</name>
  <description>a volume configuration</description>
  <format>qcow2</format>
  <capacity>10485760</capacity>
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_configurations/6" />
</VolumeConfiguration>

Delete a Volume Configuration

Example request:

DELETE /cimi/volume_configurations/7 HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu)
Host: localhost:3001
Accept: application/xml

Server response:

HTTP/1.1 200 OK
X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block
X-Content-Type-Options: nosniff
Content-Type: text/html;charset=utf-8
CIMI-Specification-Version: 1.0.1
Content-Length: 0
Date: Fri, 11 Jan 2013 13:27:35 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife