{: data{�I"/download/:ET{:default{ : lastI"�) Download

Download

Version 1.1.0 of Apache Deltacloud is available. See the release notes.

Use the links below to download a distribution of Apache Deltacloud. Alternatively you can use one of the Apache mirrors. It is good practice to verify the integrity of the distribution files, especially if you are using one of our mirror sites. To do this, you must use the signatures from our main distribution directory.

Current release

server-gem	deltacloud-core-1.1.0.gem ( PGP MD5 SHA1 )
server-sources	deltacloud-core-1.1.0.tgz ( PGP MD5 SHA1 )
client-gem	deltacloud-client-1.1.0.gem ( PGP MD5 SHA1 )
client-sources	deltacloud-client-1.1.0.tgz ( PGP MD5 SHA1 )

Old releases

Older releases of Apache Deltacloud can be found here. We highly recommend to not use those releases but upgrade to the latest release.

Rubygems

RubyGems.org is the Ruby community's gem hosting service. For most of the Ruby developers it is the most convenient way how to download Apache Deltacloud. We always push the major releases to Rubygems.org page. To download Apache Deltacloud from there you can use gem fetch deltacloud-core or gem fetch deltacloud-client commands. Please mind to verify the downloaded sources.

Getting the sources

We provide an extensive amount of information about how to use the Apache Deltacloud GIT repository on this page.

Verify the integrity of the files

Note: When downloading from a mirror please check the md5sum and verify the OpenPGP compatible signature from the main Apache site. Links are provided above (next to the release download link).

The PGP signatures can be verified using PGP or GPG. First download the KEYS as well as the asc signature file for the relevant distribution. Make sure you get these files from the main distribution directory, rather than from a mirror. Then verify the signatures using:

$ pgpk -a KEYS
$ pgpv deltacloud-core-1.1.0.tar.gz.asc

$ pgp -ka KEYS
$ pgp deltacloud-core-1.1.0.tar.gz.asc

$ gpg --import KEYS
$ gpg --verify deltacloud-core-1.1.0.tar.gz.asc

;T:rawI"�

Download

Version 1.1.0 of Apache Deltacloud is available. See the release notes.

Current release

server-gem	deltacloud-core-1.1.0.gem ( PGP MD5 SHA1 )
server-sources	deltacloud-core-1.1.0.tgz ( PGP MD5 SHA1 )
client-gem	deltacloud-client-1.1.0.gem ( PGP MD5 SHA1 )
client-sources	deltacloud-client-1.1.0.tgz ( PGP MD5 SHA1 )

Old releases

Older releases of Apache Deltacloud can be found here. We highly recommend to not use those releases but upgrade to the latest release.

Rubygems

Getting the sources

We provide an extensive amount of information about how to use the Apache Deltacloud GIT repository on this page.

Verify the integrity of the files

Note: When downloading from a mirror please check the md5sum and verify the OpenPGP compatible signature from the main Apache site. Links are provided above (next to the release download link).

$ pgpk -a KEYS
$ pgpv deltacloud-core-1.1.0.tar.gz.asc

$ pgp -ka KEYS
$ pgp deltacloud-core-1.1.0.tar.gz.asc

$ gpg --import KEYS
$ gpg --verify deltacloud-core-1.1.0.tar.gz.asc

;T:preI"t

Download

Version 1.1.0 of Apache Deltacloud is available. See the release notes.

Current release

server-gem	deltacloud-core-1.1.0.gem ( PGP MD5 SHA1 )
server-sources	deltacloud-core-1.1.0.tgz ( PGP MD5 SHA1 )
client-gem	deltacloud-client-1.1.0.gem ( PGP MD5 SHA1 )
client-sources	deltacloud-client-1.1.0.tgz ( PGP MD5 SHA1 )

Old releases

Older releases of Apache Deltacloud can be found here. We highly recommend to not use those releases but upgrade to the latest release.

Rubygems

Getting the sources

We provide an extensive amount of information about how to use the Apache Deltacloud GIT repository on this page.

Verify the integrity of the files

Note: When downloading from a mirror please check the md5sum and verify the OpenPGP compatible signature from the main Apache site. Links are provided above (next to the release download link).

$ pgpk -a KEYS
$ pgpv deltacloud-core-1.1.0.tar.gz.asc

$ pgp -ka KEYS
$ pgp deltacloud-core-1.1.0.tar.gz.asc

$ gpg --import KEYS
$ gpg --verify deltacloud-core-1.1.0.tar.gz.asc

;T: post@ I"/getting-sources/;T{;{ ;I" Getting the Sources

Setting up a developement environment

Installing dependencies

First, you will need all the installation dependencies for Deltacloud. Follow the steps in Install Deltacloud section to get these dependencies.

Getting the sources

The Deltacloud repository is hosted at the Apache Software Foundation, using the Git version control system. If you don’t have Git already, use the yum or apt package managers:

$ sudo yum install git

$ sudo apt-get install git

Go to your root directory and run git to get the latest version of Deltacloud source code from git repository. You can also use a different directory, but remember, where you clone the code:

$ git clone git://git.apache.org/deltacloud.git

This will pull the latest version to the directory ~/deltacloud.

Development dependencies

Apart from installation dependecies, you have to install some additional libraries, in order to develop for Deltacloud. The Deltacloud source includes a Gemfile: /path/to/deltacloud/server/Gemfile, which lists these development dependencies.

You can easily get all the development dependecies with Bundler:

Install Bundler (if you don't have it yet):

$ gem install bundler

Then, get the required dependencies:

$ cd /path/to/deltacloud/server
$ bundle

Building from source and installing the Deltacloud gem

Build and install the Deltacloud server gem:

$ cd path/to/DeltacloudProject/deltacloud/server
$ rake package
$ gem install pkg/deltacloud-core-<version>.gem

Then install the Deltacloud client gem:

$ cd path/to/DeltacloudProject/deltacloud/client
$ rake package
$ gem install pkg/deltacloud-client-<version>.gem

Contribute

;T; I"^

Setting up a developement environment

Installing dependencies

First, you will need all the installation dependencies for Deltacloud. Follow the steps in Install Deltacloud section to get these dependencies.

Getting the sources

The Deltacloud repository is hosted at the Apache Software Foundation, using the Git version control system. If you don't have Git already, use the yum or apt package managers:

$ sudo yum install git

$ sudo apt-get install git

The canonical Deltacloud repository is located at https://git-wip-us.apache.org/repos/asf/deltacloud.git with read-only mirrors at git://git.apache.org/deltacloud.git and git://github.com/apache/deltacloud. Go to your root directory and run git to get the latest version of Deltacloud source code from git repository. You can also use a different directory, but remember, where you clone the code:

$ git clone git://git.apache.org/deltacloud.git

This will pull the latest version to the directory ~/deltacloud.

Development dependencies

You can easily get all the development dependecies with Bundler:

Install Bundler (if you don't have it yet):

$ gem install bundler

Then, get the required dependencies:

$ cd /path/to/deltacloud/server
$ bundle

Building from source and installing the Deltacloud gem

Build and install the Deltacloud server gem:

$ cd path/to/DeltacloudProject/deltacloud/server
$ rake package
$ gem install pkg/deltacloud-core-<version>.gem

Then install the Deltacloud client gem:

$ cd path/to/DeltacloudProject/deltacloud/client
$ rake package
$ gem install pkg/deltacloud-client-<version>.gem

Contribute
;T; I"�

Setting up a developement environment

Installing dependencies

First, you will need all the installation dependencies for Deltacloud. Follow the steps in Install Deltacloud section to get these dependencies.

Getting the sources

The Deltacloud repository is hosted at the Apache Software Foundation, using the Git version control system. If you don’t have Git already, use the yum or apt package managers:

$ sudo yum install git

$ sudo apt-get install git

Go to your root directory and run git to get the latest version of Deltacloud source code from git repository. You can also use a different directory, but remember, where you clone the code:

$ git clone git://git.apache.org/deltacloud.git

This will pull the latest version to the directory ~/deltacloud.

Development dependencies

You can easily get all the development dependecies with Bundler:

Install Bundler (if you don't have it yet):

$ gem install bundler

Then, get the required dependencies:

$ cd /path/to/deltacloud/server
$ bundle

Building from source and installing the Deltacloud gem

Build and install the Deltacloud server gem:

$ cd path/to/DeltacloudProject/deltacloud/server
$ rake package
$ gem install pkg/deltacloud-core-<version>.gem

Then install the Deltacloud client gem:

$ cd path/to/DeltacloudProject/deltacloud/client
$ rake package
$ gem install pkg/deltacloud-client-<version>.gem

Contribute

;T;@I"/install-deltacloud/;T{;{ ;I"�+ Install Deltacloud

Installation dependencies

First of all, you have to install several dependecies. The Deltacloud server relies on a number of external rubygems and other libraries. The following packages are neccessary for running the Deltacloud server. The installation of dependencies slightly differs from distribution to distribution. You will need:

ruby and ruby-devel,
gem (RubyGems),
gcc-c++
libxml2 and libxml2-devel,
libxslt and libxslt-devel,
sqlite and sqlite-devel
rake

Fedora and Red Hat Enterprise Linux

Ruby and Ruby-devel

Check if you already have a Ruby installation by typing the following command. You should see something that looks like:

$ ruby -v
ruby 1.8.7 (2010-08-16 patchlevel 302) [i686-linux]

Deltacloud requires at least Ruby 1.8.7. You need to install also the development headers (ruby-devel) because Deltacloud relies on some rubygems with C extensions. According to your package manager use commands:

$ sudo yum install ruby
$ sudo yum install ruby-devel

RubyGems

Deltacloud relies on a number of RubyGems. You can check if you already have gem executable (similarly to ruby) by typing $ gem -v. Otherwise use your package manager for the installation:

$ sudo yum install rubygems

GCC-C++, Libxml2, Libxml2-devel, Libxslt, Libxslt-devel, sqlite, sqlite-devel

These libraries are required to build RubyGems that have C extensions (the last two are for the CIMI persistence layer). Use commands:

$ sudo yum install gcc-c++
$ sudo yum install libxml libxml2-devel
$ sudo yum install libxslt libxslt-devel
$ sudo yum install sqlite sqlite-devel

Rake

Rake is Ruby's Make and is itself a ruby gem. Once you have RubyGems installed you can get rake with:

$ sudo gem install rake

Debian and Ubuntu

Ruby and RubyGems

The following instructions focus on installing Ruby 1.9 (Deltacloud requires at least ruby 1.8.7.). Install ruby and rubygem by typing:

$ sudo apt-get install ruby1.9.1-full

Use the following command to check, whether the installation was successful. You should see a similar response:

$ ruby -v
ruby 1.9.2p290 (2011-07-09 revision 32553) [i686-linux]

You can check the installation of Rubygems the same way:

$ gem -v
1.3.7

g++, libxml2, libxml2-dev, libxslt, libxslt-dev, sqlite, sqlite-devel

These libraries are required to build RubyGems that have C extensions (last two are for CIMI persistence layer). Use commands:

$ sudo apt-get install g++
$ sudo apt-get install libxml libxml2-dev
$ sudo apt-get install libxslt libxslt-dev
$ sudo apt-get install sqlite sqlite-dev

Gem dependecies

Debian and Ubuntu distributions also require to install following gem dependencies:

gem install thin sinatra rack-accept rest-client sinatra-content-for nokogiri

Once these gems are installed, go to the directory (normally /var/lib/gems/1.9.1/gems), where gems are located and check that you have following gems listed. You may see more gems than you directly installed, because RubyGems install gem dependecies automaticly.

Aws-2.5.6, builder-3.0.0, bundler-1.1.3, daemons-1.1.8, eventmachine-0.12.10, haml-3.1.4, http_connection-1.4.1, json-1.6.6, mime-types-1.18, net-ssh-2.3.0, nokogiri-1.5.2, rack-1.4.1, rake-0.9.2.2, rack-accept-0.4.4, rack-protection-1.2.0, rest-client-1.6.7, sinatra-1.3.2, sinatra-content-for-0.1, thin-1.3.1, tilt-1.3.3, uuidtools-2.1.2, xml-simple-1.1.1

You may have trouble with the installation, if the Makefile is missing. Then, you need to install make:

$ sudo apt-get install make

OS X

Instructions on setting up Deltacloud on Apple’s OS X can be found on the Wiki. Note that they require using homebrew.

Installation of Deltacloud itself

Once you've setup all the dependencies listed above, installing Deltacloud is as easy. Type:

$ sudo gem install deltacloud-core

And thats it! The gem install command will automatically fetch and install all other gems that the Deltacloud server needs. As an alternative you can get the latest releases of Deltacloud from the Apache website.

Note: When installing and running Deltacloud on platforms with Ruby versions 1.8.x, the 'require_relative' gem needs to be installed. This gem should be automatically installed with the deltacloud-core gem however, if this does not occur, the follow error will be thrown when starting Deltacloud:

/usr/lib/ruby/site_ruby/1.8/rubygems/custom_require.rb:31:in `gem_original_require': no such file to load -- require_relative (LoadError)

The fix is to explicitly install the 'require_relative' gem:

$ sudo gem install require_relative

Run Deltacloud

;T; I"/

Installation dependencies

ruby and ruby-devel,
gem (RubyGems),
gcc-c++
libxml2 and libxml2-devel,
libxslt and libxslt-devel,
sqlite and sqlite-devel
rake

Fedora and Red Hat Enterprise Linux

Ruby and Ruby-devel

Check if you already have a Ruby installation by typing the following command. You should see something that looks like:

$ ruby -v
ruby 1.8.7 (2010-08-16 patchlevel 302) [i686-linux]

$ sudo yum install ruby
$ sudo yum install ruby-devel

RubyGems

Deltacloud relies on a number of RubyGems. You can check if you already have gem executable (similarly to ruby) by typing $ gem -v. Otherwise use your package manager for the installation:

$ sudo yum install rubygems

GCC-C++, Libxml2, Libxml2-devel, Libxslt, Libxslt-devel, sqlite, sqlite-devel

These libraries are required to build RubyGems that have C extensions (the last two are for the CIMI persistence layer). Use commands:

$ sudo yum install gcc-c++
$ sudo yum install libxml libxml2-devel
$ sudo yum install libxslt libxslt-devel
$ sudo yum install sqlite sqlite-devel

Rake

Rake is Ruby's Make and is itself a ruby gem. Once you have RubyGems installed you can get rake with:

$ sudo gem install rake

Debian and Ubuntu

Ruby and RubyGems

The following instructions focus on installing Ruby 1.9 (Deltacloud requires at least ruby 1.8.7.). Install ruby and rubygem by typing:

$ sudo apt-get install ruby1.9.1-full

Use the following command to check, whether the installation was successful. You should see a similar response:

$ ruby -v
ruby 1.9.2p290 (2011-07-09 revision 32553) [i686-linux]

You can check the installation of Rubygems the same way:

$ gem -v
1.3.7

g++, libxml2, libxml2-dev, libxslt, libxslt-dev, sqlite, sqlite-devel

These libraries are required to build RubyGems that have C extensions (last two are for CIMI persistence layer). Use commands:

$ sudo apt-get install g++
$ sudo apt-get install libxml libxml2-dev
$ sudo apt-get install libxslt libxslt-dev
$ sudo apt-get install sqlite sqlite-dev

Gem dependecies

Debian and Ubuntu distributions also require to install following gem dependencies:

gem install thin sinatra rack-accept rest-client sinatra-content-for nokogiri

Aws-2.5.6, builder-3.0.0, bundler-1.1.3, daemons-1.1.8, eventmachine-0.12.10, haml-3.1.4, http_connection-1.4.1, json-1.6.6, mime-types-1.18, net-ssh-2.3.0, nokogiri-1.5.2, rack-1.4.1, rake-0.9.2.2, rack-accept-0.4.4, rack-protection-1.2.0, rest-client-1.6.7, sinatra-1.3.2, sinatra-content-for-0.1, thin-1.3.1, tilt-1.3.3, uuidtools-2.1.2, xml-simple-1.1.1

You may have trouble with the installation, if the Makefile is missing. Then, you need to install make:

$ sudo apt-get install make

OS X

Instructions on setting up Deltacloud on Apple's OS X can be found on the Wiki. Note that they require using homebrew.

Installation of Deltacloud itself

Once you've setup all the dependencies listed above, installing Deltacloud is as easy. Type:

$ sudo gem install deltacloud-core

/usr/lib/ruby/site_ruby/1.8/rubygems/custom_require.rb:31:in `gem_original_require': no such file to load -- require_relative (LoadError)

The fix is to explicitly install the 'require_relative' gem:

$ sudo gem install require_relative

Run Deltacloud
;T; I"s

Installation dependencies

ruby and ruby-devel,
gem (RubyGems),
gcc-c++
libxml2 and libxml2-devel,
libxslt and libxslt-devel,
sqlite and sqlite-devel
rake

Fedora and Red Hat Enterprise Linux

Ruby and Ruby-devel

Check if you already have a Ruby installation by typing the following command. You should see something that looks like:

$ ruby -v
ruby 1.8.7 (2010-08-16 patchlevel 302) [i686-linux]

$ sudo yum install ruby
$ sudo yum install ruby-devel

RubyGems

Deltacloud relies on a number of RubyGems. You can check if you already have gem executable (similarly to ruby) by typing $ gem -v. Otherwise use your package manager for the installation:

$ sudo yum install rubygems

GCC-C++, Libxml2, Libxml2-devel, Libxslt, Libxslt-devel, sqlite, sqlite-devel

These libraries are required to build RubyGems that have C extensions (the last two are for the CIMI persistence layer). Use commands:

$ sudo yum install gcc-c++
$ sudo yum install libxml libxml2-devel
$ sudo yum install libxslt libxslt-devel
$ sudo yum install sqlite sqlite-devel

Rake

Rake is Ruby's Make and is itself a ruby gem. Once you have RubyGems installed you can get rake with:

$ sudo gem install rake

Debian and Ubuntu

Ruby and RubyGems

The following instructions focus on installing Ruby 1.9 (Deltacloud requires at least ruby 1.8.7.). Install ruby and rubygem by typing:

$ sudo apt-get install ruby1.9.1-full

Use the following command to check, whether the installation was successful. You should see a similar response:

$ ruby -v
ruby 1.9.2p290 (2011-07-09 revision 32553) [i686-linux]

You can check the installation of Rubygems the same way:

$ gem -v
1.3.7

g++, libxml2, libxml2-dev, libxslt, libxslt-dev, sqlite, sqlite-devel

These libraries are required to build RubyGems that have C extensions (last two are for CIMI persistence layer). Use commands:

$ sudo apt-get install g++
$ sudo apt-get install libxml libxml2-dev
$ sudo apt-get install libxslt libxslt-dev
$ sudo apt-get install sqlite sqlite-dev

Gem dependecies

Debian and Ubuntu distributions also require to install following gem dependencies:

gem install thin sinatra rack-accept rest-client sinatra-content-for nokogiri

Aws-2.5.6, builder-3.0.0, bundler-1.1.3, daemons-1.1.8, eventmachine-0.12.10, haml-3.1.4, http_connection-1.4.1, json-1.6.6, mime-types-1.18, net-ssh-2.3.0, nokogiri-1.5.2, rack-1.4.1, rake-0.9.2.2, rack-accept-0.4.4, rack-protection-1.2.0, rest-client-1.6.7, sinatra-1.3.2, sinatra-content-for-0.1, thin-1.3.1, tilt-1.3.3, uuidtools-2.1.2, xml-simple-1.1.1

You may have trouble with the installation, if the Makefile is missing. Then, you need to install make:

$ sudo apt-get install make

OS X

Instructions on setting up Deltacloud on Apple’s OS X can be found on the Wiki. Note that they require using homebrew.

Installation of Deltacloud itself

Once you've setup all the dependencies listed above, installing Deltacloud is as easy. Type:

$ sudo gem install deltacloud-core

/usr/lib/ruby/site_ruby/1.8/rubygems/custom_require.rb:31:in `gem_original_require': no such file to load -- require_relative (LoadError)

The fix is to explicitly install the 'require_relative' gem:

$ sudo gem install require_relative

Run Deltacloud

;T;@I"/;T{;{ ;I"] Deltacloud API

What does Deltacloud give you?

an opportunity to manage cloud instances the way you want

a way to protect your apps from cloud API changes and incompatitibilities

three frontends: 'classic' Deltacloud, DMTF CIMI, and EC2

support for all major cloud service providers

makes it easy for cloud providers to add their cloud

lets you use your RHEV-M and vSphere installations as a cloud

Learn more

For developers

Deltacloud:

is an open source Apache project

is a REST-based API for simple any-platform access

is written in Ruby with love

comes with client libraries for your favourite programming language

Contribute

Current release:
deltacloud-core-1.1.0
More about installation...

Found a bug?

;T; I"

What does Deltacloud give you?

an opportunity to manage cloud instances the way you want

a way to protect your apps from cloud API changes and incompatitibilities

three frontends: 'classic' Deltacloud, DMTF CIMI, and EC2

support for all major cloud service providers

makes it easy for cloud providers to add their cloud

lets you use your RHEV-M and vSphere installations as a cloud

Learn more

For developers

Deltacloud:

is an open source Apache project

is a REST-based API for simple any-platform access

is written in Ruby with love

comes with client libraries for your favourite programming language

Contribute

Current release:
deltacloud-core-1.1.0
More about installation...

Found a bug?

;T; I"�

What does Deltacloud give you?

an opportunity to manage cloud instances the way you want

a way to protect your apps from cloud API changes and incompatitibilities

three frontends: 'classic' Deltacloud, DMTF CIMI, and EC2

support for all major cloud service providers

makes it easy for cloud providers to add their cloud

lets you use your RHEV-M and vSphere installations as a cloud

Learn more

For developers

Deltacloud:

is an open source Apache project

is a REST-based API for simple any-platform access

is written in Ruby with love

comes with client libraries for your favourite programming language

Contribute

Current release:
deltacloud-core-1.1.0
More about installation...

Found a bug?

;T;@I"/instance-states/;T{;{ ;I"' Instance states

Instance states

Each cloud defines a slightly different lifecycle model for instances. In some clouds, instances start running immediately after creation, in others, they enter a pending state and you need to start them explicitly.

Differences between clouds are modelled by expressing the lifecycle of an instance as a finite state machine and capturing it in an instance states entity.The API defines the following states for an instance:

State	Meaning
start	an instance state before creation of an instance
pending	creation of an instance is in progress
running	an instance is running
shutting-down	an instance is stopped
stopped	an instance is stopped
finished	all resources for an instance have now been freed

Storage resources

The details of a particular instance describes also the actions (state transitions) which can be performed on the instance. If the state transition is marked as auto, the transition from one state to another is done automatically. The possible instance actions are:

Action	Meaning
start	starts the instance
stop	stops (and for some providers shutdown) the instance
reboot	reboots the instance
destroy	stops the instance and completely destroys it

Get an instance states entity

To retrieve the instance states entity for a back-end cloud use call GET /api/instance_states. The instance states entity defines possible transitions between various states of an instance, specific for each back-end cloud. As a result, instance states defines the finite state machine for instances from the given cloud.

Example request:

GET /api/instance_states?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 583

<states>
  <state name='start'>
    <transition action='create' to='pending'></transition>
  </state>
  <state name='pending'>
    <transition auto='true' to='running'></transition>
  </state>
  <state name='running'>
    <transition action='reboot' to='running'></transition>
    <transition action='stop' to='shutting_down'></transition>
  </state>
  <state name='shutting_down'>
    <transition auto='true' to='stopped'></transition>
  </state>
  <state name='stopped'>
    <transition auto='true' to='finish'></transition>
  </state>
  <state name='finish'>
  </state>
</states>

Instances

;T; I"

Instance states

State	Meaning
start	an instance state before creation of an instance
pending	creation of an instance is in progress
running	an instance is running
shutting-down	an instance is stopped
stopped	an instance is stopped
finished	all resources for an instance have now been freed

Storage resources

Action	Meaning
start	starts the instance
stop	stops (and for some providers shutdown) the instance
reboot	reboots the instance
destroy	stops the instance and completely destroys it

Get an instance states entity

Example request:

GET /api/instance_states?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 583

<states>
  <state name='start'>
    <transition action='create' to='pending'></transition>
  </state>
  <state name='pending'>
    <transition auto='true' to='running'></transition>
  </state>
  <state name='running'>
    <transition action='reboot' to='running'></transition>
    <transition action='stop' to='shutting_down'></transition>
  </state>
  <state name='shutting_down'>
    <transition auto='true' to='stopped'></transition>
  </state>
  <state name='stopped'>
    <transition auto='true' to='finish'></transition>
  </state>
  <state name='finish'>
  </state>
</states>

Instances
;T; I"�

Instance states

State	Meaning
start	an instance state before creation of an instance
pending	creation of an instance is in progress
running	an instance is running
shutting-down	an instance is stopped
stopped	an instance is stopped
finished	all resources for an instance have now been freed

Storage resources

Action	Meaning
start	starts the instance
stop	stops (and for some providers shutdown) the instance
reboot	reboots the instance
destroy	stops the instance and completely destroys it

Get an instance states entity

Example request:

GET /api/instance_states?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 583

<states>
  <state name='start'>
    <transition action='create' to='pending'></transition>
  </state>
  <state name='pending'>
    <transition auto='true' to='running'></transition>
  </state>
  <state name='running'>
    <transition action='reboot' to='running'></transition>
    <transition action='stop' to='shutting_down'></transition>
  </state>
  <state name='shutting_down'>
    <transition auto='true' to='stopped'></transition>
  </state>
  <state name='stopped'>
    <transition auto='true' to='finish'></transition>
  </state>
  <state name='finish'>
  </state>
</states>

Instances

;T;@"I" /images/;T{;{ ;I"�C Images

Images

Images are used to launch instances. Each image represents a virtual machine image in the back-end cloud, containing the root partition and initial storage for an instance operating system. An image has these attributes:

a human-readable name
a description
an owner_id
an architecture
a state

The owner_id identifies the user account to which the image belongs. The architecture attribute refers to whether the image will create an instance with 32 or 64-bit processor. The values that the Deltacloud server returns for this attribute are thus i386 and x86_64 respectively. The state attribute varies between back-end clouds (it depends on a cloud provider). For example, AWS EC2 image state can be one of AVAILABLE, PENDING or FAILED, whereas Rackspace Cloudservers image state can be one of UNKNOWN, PREPARING, ACTIVE, QUEUED or FAILED. Finally, each image also contains an <actions> attribute which specifies the URI to which a client may issue a HTTP POST for creation of an instance from the given image.

Storage resources

Get the list of all images

To return a list of all images available in the back-end cloud use call GET /api/images. By default this call will return all images that are available to the given user account. Optionally a client may restrict the list of images returned by specifying the owner_id or architecture parameters in the request (architecture is one of x86_64 for 64-bit processors or i386 for 32-bit processors). The example below restricts the image list to 64-bit architecture images belonging to owner_id 023801271342.

Example request:

GET /api/images?owner_id=023801271342&architecture=x86_64&format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1971

<?xml version='1.0' encoding='utf-8' ?>
<images>
  <image href='http://localhost:3001/api/images/ami-eea35787' id='ami-eea35787'>
    <name>sles-10-sp3-v1.00.x86_64</name>
    <owner_id>013907871322</owner_id>
    <description>SUSE Linux Enterprise Server 10 Service Pack 3 for x86_64 (v1.00)</description>
    <architecture>x86_64</architecture>
    <state></state>
    <actions>
      <link href='http://localhost:3001/api/instances;image_id=ami-eea35787' method='post' rel='create_instance' />
    </actions>
  </image>
  <image href='http://localhost:3001/api/images/ami-6e649707' id='ami-6e649707'>
    <name>sles-11-sp1-hvm-v1.00.x86_64</name>
    <owner_id>013907871322</owner_id>
    <description>SUSE Linux Enterprise Server 11 Service Pack 1 for HVM x86_64 (v1.00)</description>
    <architecture>x86_64</architecture>
    <state></state>
    <actions>
      <link href='http://localhost:3001/api/instances;image_id=ami-6e649707' method='post' rel='create_instance' />
    </actions>
  </image>
  <image href='http://localhost:3001/api/images/ami-e4a7558d' id='ami-e4a7558d'>
    <name>sles-11-sp1-hvm-v1.01.x86_64</name>
    <owner_id>013907871322</owner_id>
    <description>SUSE Linux Enterprise Server 11 Service Pack 1 for HVM x86_64 (v1.01)</description>
    <architecture>x86_64</architecture>
    <state></state>
    <actions>
      <link href='http://localhost:3001/api/instances;image_id=ami-e4a7558d' method='post' rel='create_instance' />
    </actions>
  </image>
  <image href='http://localhost:3001/api/images/ami-e4a3578d' id='ami-e4a3578d'>
    <name>sles-11-sp1-v1.00.x86_64</name>
    <owner_id>013907871322</owner_id>
    <description>SUSE Linux Enterprise Server 11 Service Pack 1 for x86_64 (v1.00)</description>
    <architecture>x86_64</architecture>
    <state></state>
    <actions>
      <link href='http://localhost:3001/api/instances;image_id=ami-e4a3578d' method='post' rel='create_instance' />
    </actions>
  </image>
</images>

Get details of an image

To retrieve the description of a specific image use call GET /api/images/:id.

Example request:

GET /api/images/14?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 433

<?xml version='1.0' encoding='utf-8' ?>
<image href='http://localhost:3002/api/images/14' id='14'>
  <name>Red Hat Enterprise Linux 5.4</name>
  <owner_id>jsmith</owner_id>
  <description>Red Hat Enterprise Linux 5.4</description>
  <architecture>x86_64</architecture>
  <state>ACTIVE</state>
  <actions>
    <link href='http://localhost:3002/api/instances;image_id=14' method='post' rel='create_instance' />
  </actions>
</image>

Create an image

To create a new image from an existing running instance use call POST /api/images. This operation is not available to all cloud providers and for some cloud providers this operation is not possible for all instances. For example, in the Amazon EC2 cloud, you can create a custom image from EBS backed instances but not from root-store instances.

× Note:

RHVE-M, vSphere and Fujitsu GCP providers allow you to create an image only from a stopped instance, not from a running instance.

The Deltacloud API provides a mechanism with which clients can determine whether a given instance may be saved as a custom image. If an instance snapshot is possible, the instance XML <actions> list contains a create_image action. This action defines the client's URI which is used in creating the new image. For example:

...
<actions>
  <link href='http://localhost:3002/api/instances/20109341/reboot' method='post' rel='reboot' />
  <link href='http://localhost:3002/api/instances/20109341/stop' method='post' rel='stop' />
  <link href='http://localhost:3002/api/instances/20109341/run;id=20109341' method='post' rel='run' />
  <link href='http://localhost:3002/api/images;instance_id=20109341' method='post' rel='create_image' />
</actions>
...

To create a new image the client must specify the instance_id of the running instance. Optionally, the client may also provide a name and a description. The parameters may be defined as multipart/form-data fields in the client POST.

Alternatively, clients may also specify parameters using a content-type of application/x-www-form-urlencoded. The Deltacloud server will respond to a successful operation with HTTP 201 Created and provide details of the newly created image.

Example request:

POST /api/images?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*
Content-Length: 96
Content-Type: application/x-www-form-urlencoded

instance_id=20109341&name=customisedserver&description=jsmith%20cu
stomised%20web%20server%20July%2021%202011

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Content-Length: 427

<?xml version='1.0' encoding='utf-8' ?>
<image href='http://localhost:3002/api/images/12346145' id='12346145'>
  <name>customisedserver</name>
  <owner_id>mandreou</owner_id>
  <description>customisedserver</description>
  <architecture>x86_64</architecture>
  <state>QUEUED</state>
  <actions>
    <link href='http://localhost:3002/api/instances;image_id=12346145' method='post' rel='create_instance' />
  </actions>
</image>

× Note:

When you create an image from a stopped instance in vSphere cloud, this particular instance is marked as template and it is also removed from Instances.

Unlike other providers, vSphere does not support assigning a name and a description to the image when you create an image from a stopped instance. The image created in vSphere ignores these attributes passed to the API during the creation.

Fujitsu GCP does not return an ID that can be used to track the state of the image creation. Poll the list of all images until your image appears. This will contain the proper image id that can be used in other image actions.

Delete an image

To delete the specified image from the back-end cloud use call DELETE /api/images/:id. The Deltacloud server will return a HTTP 204 No Content after a succesful operation:

Example request:

DELETE /api/images/12346145?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 204 No Content

Instance states

;T; I"'.

Images

a human-readable name
a description
an owner_id
an architecture
a state

Storage resources

Get the list of all images

Example request:

GET /api/images?owner_id=023801271342&architecture=x86_64&format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1971

<?xml version='1.0' encoding='utf-8' ?>
<images>
  <image href='http://localhost:3001/api/images/ami-eea35787' id='ami-eea35787'>
    <name>sles-10-sp3-v1.00.x86_64</name>
    <owner_id>013907871322</owner_id>
    <description>SUSE Linux Enterprise Server 10 Service Pack 3 for x86_64 (v1.00)</description>
    <architecture>x86_64</architecture>
    <state></state>
    <actions>
      <link href='http://localhost:3001/api/instances;image_id=ami-eea35787' method='post' rel='create_instance' />
    </actions>
  </image>
  <image href='http://localhost:3001/api/images/ami-6e649707' id='ami-6e649707'>
    <name>sles-11-sp1-hvm-v1.00.x86_64</name>
    <owner_id>013907871322</owner_id>
    <description>SUSE Linux Enterprise Server 11 Service Pack 1 for HVM x86_64 (v1.00)</description>
    <architecture>x86_64</architecture>
    <state></state>
    <actions>
      <link href='http://localhost:3001/api/instances;image_id=ami-6e649707' method='post' rel='create_instance' />
    </actions>
  </image>
  <image href='http://localhost:3001/api/images/ami-e4a7558d' id='ami-e4a7558d'>
    <name>sles-11-sp1-hvm-v1.01.x86_64</name>
    <owner_id>013907871322</owner_id>
    <description>SUSE Linux Enterprise Server 11 Service Pack 1 for HVM x86_64 (v1.01)</description>
    <architecture>x86_64</architecture>
    <state></state>
    <actions>
      <link href='http://localhost:3001/api/instances;image_id=ami-e4a7558d' method='post' rel='create_instance' />
    </actions>
  </image>
  <image href='http://localhost:3001/api/images/ami-e4a3578d' id='ami-e4a3578d'>
    <name>sles-11-sp1-v1.00.x86_64</name>
    <owner_id>013907871322</owner_id>
    <description>SUSE Linux Enterprise Server 11 Service Pack 1 for x86_64 (v1.00)</description>
    <architecture>x86_64</architecture>
    <state></state>
    <actions>
      <link href='http://localhost:3001/api/instances;image_id=ami-e4a3578d' method='post' rel='create_instance' />
    </actions>
  </image>
</images>

Get details of an image

To retrieve the description of a specific image use call GET /api/images/:id.

Example request:

GET /api/images/14?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 433

<?xml version='1.0' encoding='utf-8' ?>
<image href='http://localhost:3002/api/images/14' id='14'>
  <name>Red Hat Enterprise Linux 5.4</name>
  <owner_id>jsmith</owner_id>
  <description>Red Hat Enterprise Linux 5.4</description>
  <architecture>x86_64</architecture>
  <state>ACTIVE</state>
  <actions>
    <link href='http://localhost:3002/api/instances;image_id=14' method='post' rel='create_instance' />
  </actions>
</image>

Create an image

× Note:

RHVE-M, vSphere and Fujitsu GCP providers allow you to create an image only from a stopped instance, not from a running instance.

...
<actions>
  <link href='http://localhost:3002/api/instances/20109341/reboot' method='post' rel='reboot' />
  <link href='http://localhost:3002/api/instances/20109341/stop' method='post' rel='stop' />
  <link href='http://localhost:3002/api/instances/20109341/run;id=20109341' method='post' rel='run' />
  <link href='http://localhost:3002/api/images;instance_id=20109341' method='post' rel='create_image' />
</actions>
...

Example request:

POST /api/images?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*
Content-Length: 96
Content-Type: application/x-www-form-urlencoded

instance_id=20109341&name=customisedserver&description=jsmith%20cu
stomised%20web%20server%20July%2021%202011

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Content-Length: 427

<?xml version='1.0' encoding='utf-8' ?>
<image href='http://localhost:3002/api/images/12346145' id='12346145'>
  <name>customisedserver</name>
  <owner_id>mandreou</owner_id>
  <description>customisedserver</description>
  <architecture>x86_64</architecture>
  <state>QUEUED</state>
  <actions>
    <link href='http://localhost:3002/api/instances;image_id=12346145' method='post' rel='create_instance' />
  </actions>
</image>

× Note:

When you create an image from a stopped instance in vSphere cloud, this particular instance is marked as template and it is also removed from Instances.

Delete an image

To delete the specified image from the back-end cloud use call DELETE /api/images/:id. The Deltacloud server will return a HTTP 204 No Content after a succesful operation:

Example request:

DELETE /api/images/12346145?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 204 No Content

Instance states
;T; I"3.

Images

a human-readable name
a description
an owner_id
an architecture
a state

Storage resources

Get the list of all images

Example request:

GET /api/images?owner_id=023801271342&architecture=x86_64&format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1971

<?xml version='1.0' encoding='utf-8' ?>
<images>
  <image href='http://localhost:3001/api/images/ami-eea35787' id='ami-eea35787'>
    <name>sles-10-sp3-v1.00.x86_64</name>
    <owner_id>013907871322</owner_id>
    <description>SUSE Linux Enterprise Server 10 Service Pack 3 for x86_64 (v1.00)</description>
    <architecture>x86_64</architecture>
    <state></state>
    <actions>
      <link href='http://localhost:3001/api/instances;image_id=ami-eea35787' method='post' rel='create_instance' />
    </actions>
  </image>
  <image href='http://localhost:3001/api/images/ami-6e649707' id='ami-6e649707'>
    <name>sles-11-sp1-hvm-v1.00.x86_64</name>
    <owner_id>013907871322</owner_id>
    <description>SUSE Linux Enterprise Server 11 Service Pack 1 for HVM x86_64 (v1.00)</description>
    <architecture>x86_64</architecture>
    <state></state>
    <actions>
      <link href='http://localhost:3001/api/instances;image_id=ami-6e649707' method='post' rel='create_instance' />
    </actions>
  </image>
  <image href='http://localhost:3001/api/images/ami-e4a7558d' id='ami-e4a7558d'>
    <name>sles-11-sp1-hvm-v1.01.x86_64</name>
    <owner_id>013907871322</owner_id>
    <description>SUSE Linux Enterprise Server 11 Service Pack 1 for HVM x86_64 (v1.01)</description>
    <architecture>x86_64</architecture>
    <state></state>
    <actions>
      <link href='http://localhost:3001/api/instances;image_id=ami-e4a7558d' method='post' rel='create_instance' />
    </actions>
  </image>
  <image href='http://localhost:3001/api/images/ami-e4a3578d' id='ami-e4a3578d'>
    <name>sles-11-sp1-v1.00.x86_64</name>
    <owner_id>013907871322</owner_id>
    <description>SUSE Linux Enterprise Server 11 Service Pack 1 for x86_64 (v1.00)</description>
    <architecture>x86_64</architecture>
    <state></state>
    <actions>
      <link href='http://localhost:3001/api/instances;image_id=ami-e4a3578d' method='post' rel='create_instance' />
    </actions>
  </image>
</images>

Get details of an image

To retrieve the description of a specific image use call GET /api/images/:id.

Example request:

GET /api/images/14?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 433

<?xml version='1.0' encoding='utf-8' ?>
<image href='http://localhost:3002/api/images/14' id='14'>
  <name>Red Hat Enterprise Linux 5.4</name>
  <owner_id>jsmith</owner_id>
  <description>Red Hat Enterprise Linux 5.4</description>
  <architecture>x86_64</architecture>
  <state>ACTIVE</state>
  <actions>
    <link href='http://localhost:3002/api/instances;image_id=14' method='post' rel='create_instance' />
  </actions>
</image>

Create an image

× Note:

RHVE-M, vSphere and Fujitsu GCP providers allow you to create an image only from a stopped instance, not from a running instance.

...
<actions>
  <link href='http://localhost:3002/api/instances/20109341/reboot' method='post' rel='reboot' />
  <link href='http://localhost:3002/api/instances/20109341/stop' method='post' rel='stop' />
  <link href='http://localhost:3002/api/instances/20109341/run;id=20109341' method='post' rel='run' />
  <link href='http://localhost:3002/api/images;instance_id=20109341' method='post' rel='create_image' />
</actions>
...

Example request:

POST /api/images?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*
Content-Length: 96
Content-Type: application/x-www-form-urlencoded

instance_id=20109341&name=customisedserver&description=jsmith%20cu
stomised%20web%20server%20July%2021%202011

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Content-Length: 427

<?xml version='1.0' encoding='utf-8' ?>
<image href='http://localhost:3002/api/images/12346145' id='12346145'>
  <name>customisedserver</name>
  <owner_id>mandreou</owner_id>
  <description>customisedserver</description>
  <architecture>x86_64</architecture>
  <state>QUEUED</state>
  <actions>
    <link href='http://localhost:3002/api/instances;image_id=12346145' method='post' rel='create_instance' />
  </actions>
</image>

× Note:

When you create an image from a stopped instance in vSphere cloud, this particular instance is marked as template and it is also removed from Instances.

Delete an image

To delete the specified image from the back-end cloud use call DELETE /api/images/:id. The Deltacloud server will return a HTTP 204 No Content after a succesful operation:

Example request:

DELETE /api/images/12346145?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 204 No Content

Instance states

;T;@(I"/join-deltacloud/;T{;{ ;I"r

;T; I" ;T; I";F;@.I"/load-balancers/;T{;{ ;I"�G Load balancers

Load balancers

Load balancers allow distribution of ingress network traffic received by a specified IP address to a number of running instances. For example, a number of instances that are fulfilling the role of web servers can be attached to a single load balancer. It allows you to handle a large number of requests without influence on website performance.

This collection is not supported by all back-end cloud providers and at present, it is implemented for the Fujitsu GCP, Gogrid and Amazon EC2 cloud drivers. A load balancer is launched into a specific realm. Only instances within this specific realm may be attached to the balancer. Each load balancer has

a list of instances;
a public address representing the IP address that the balancer will respond on to client requests;
a created_at timestamp; and
a list of listeners.

Each listener has a protocol (e.g. TCP), a load balancer port and an instance port. The load balancer represents the port on which the balancer accepts connections. The instance port represents the port on which network traffic is forwarded to instances in the instance list.

Storage resources

Get the details of all load balancers

To retrieve details of all load balancers use call GET /api/load_balancers.

Example request:

GET /api/load_balancers?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 13:37:19 GMT
Content-Length: 1844

<?xml version='1.0' encoding='utf-8' ?>
<load_balancers>
  <load_balancer href='http://localhost:3001/api/load_balancers/webtraffic-balancer' id='webtraffic-balancer'>
    <actions>
      <link href='http://localhost:3001/api/load_balancers/webtraffic-balancer' method='delete' rel='destroy' />
      <link href='http://localhost:3001/api/load_balancers/webtraffic-balancer/register' method='post' rel='register' />
    </actions>
    <public_addresses>
      <address>webtraffic-balancer-1306196965.us-east-1.elb.amazonaws.com</address>
    </public_addresses>
    <created_at>Thu Jul 28 13:29:52 UTC 2011</created_at>
    <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'></realm>
    <listeners>
      <listener protocol='HTTP'>
        <load_balancer_port>80</load_balancer_port>
        <instance_port>3001</instance_port>
      </listener>
    </listeners>
    <instances>
    </instances>
  </load_balancer>
  <load_balancer href='http://localhost:3001/api/load_balancers/secure-site-balancer' id='secure-site-balancer'>
    <actions>
      <link href='http://localhost:3001/api/load_balancers/secure-site-balancer' method='delete' rel='destroy' />
      <link href='http://localhost:3001/api/load_balancers/secure-site-balancer/register' method='post' rel='register' />
    </actions>
    <public_addresses>
      <address>secure-site-balancer-1347100846.us-east-1.elb.amazonaws.com</address>
    </public_addresses>
    <created_at>Thu Jul 28 13:36:29 UTC 2011</created_at>
    <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'></realm>
    <listeners>
      <listener protocol='HTTP'>
        <load_balancer_port>443</load_balancer_port>
        <instance_port>443</instance_port>
      </listener>
    </listeners>
    <instances>
    </instances>
  </load_balancer>
</load_balancers>

Get the details for a load balancer

To retrieve details for a specific load balancer use call GET /api/load_balancers/:id.

Example request:

GET /api/load_balancers/secure-site-balancer?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 18:11:49 GMT
Content-Length: 1361

<?xml version='1.0' encoding='utf-8' ?>
<load_balancer href='http://localhost:3001/api/load_balancers/secure-site-balancer' id='secure-site-balancer'>
  <actions>
    <link href='http://localhost:3001/api/load_balancers/secure-site-balancer' method='delete' rel='destroy' />
    <link href='http://localhost:3001/api/load_balancers/secure-site-balancer/register' method='post' rel='register' />
  </actions>
  <public_addresses>
    <address>secure-site-balancer-1347100846.us-east-1.elb.amazonaws.com</address>
  </public_addresses>
  <created_at>Thu Jul 28 13:36:29 UTC 2011</created_at>
  <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'></realm>
  <listeners>
    <listener protocol='HTTP'>
      <load_balancer_port>443</load_balancer_port>
      <instance_port>443</instance_port>
    </listener>
  </listeners>
  <instances>
    <instance href='http://localhost:3001/api/instances/i-4f06b52e' id='i-4f06b52e'>
      <link href='http://localhost:3001/api/load_balancers/secure-site-balancer/unregister?instance_id=i-4f06b52e' rel='unregister' />
    </instance>
    <instance href='http://localhost:3001/api/instances/i-d706b5b6' id='i-d706b5b6'>
      <link href='http://localhost:3001/api/load_balancers/secure-site-balancer/unregister?instance_id=i-d706b5b6' rel='unregister' />
    </instance>
  </instances>
</load_balancer>

Create a load balancer

To create a new load balancer use call POST /api/load_balancers. Clients must provide the load balancer name, the realm_id to which the balancer is applied, a listener_protocol which the balancer will respond to (one of HTTP or TCP), the listener_balancer_port which specifies the port that the load balancer will be expecting network traffic on and finally the listener_instance_port which specifies the port on which instances will be receiving network traffic forwarded by the load balancer. As with other operations in the Deltacloud API, parameters may be specified by a requesting client using multipart/form-data or as application/x-www-form-urlencoded data.

Example request:

OST /api/load_balancers?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 121
Content-Type: application/x-www-form-urlencoded

name=webtraffic-balancer&realm_id=us-east-1c&listener_protocol=HTTP&
listener_balancer_port=80&listener_instance_port=3001

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Date: Thu, 28 Jul 2011 13:30:05 GMT
Content-Length: 884

<?xml version='1.0' encoding='utf-8' ?>
<load_balancer href='http://localhost:3001/api/load_balancers/webtraffic-balancer' id='webtraffic-balancer'>
  <actions>
    <link href='http://localhost:3001/api/load_balancers/webtraffic-balancer' method='delete' rel='destroy' />
    <link href='http://localhost:3001/api/load_balancers/webtraffic-balancer/register' method='post' rel='register' />
  </actions>
  <public_addresses>
    <address>webtraffic-balancer-1306196965.us-east-1.elb.amazonaws.com</address>
  </public_addresses>
  <created_at>Thu Jul 28 13:29:52 UTC 2011</created_at>
  <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'></realm>
  <listeners>
    <listener protocol='HTTP'>
      <load_balancer_port>80</load_balancer_port>
      <instance_port>3001</instance_port>
    </listener>
  </listeners>
  <instances>
  </instances>
</load_balancer>

Delete a load balancer

To delete the specified load balancer from the back-end cloud provider use call DELETE /api/load_balancers/:id. The Deltacloud server will respond with HTTP 204 No Content for a succesful operation

Example request:

DELETE /api/load_balancers/webtraffic-balancer?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 13:23:33 GMT

Register an instance with a load balancer

To register a running instance with a specified load balancer use call POST /api/load_balancers/:id/register. Clients must provide the instance_id as a parameter to the request. The Deltacloud server will respond with a HTTP 204 No Content after a succesful operation. The Deltacloud server will accept client request parameters encoded as multipart/form-data or as application/x-www-form-urlencoded data.

Example request:

POST /api/load_balancers/secure-site-balancer/register?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 22
Content-Type: application/x-www-form-urlencoded

instance_id=i-4f06b52e

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 18:20:03 GMT

Unreagister an instance from a load balancer

To unregister a specified instance from the given load balancer use call POST /api/load_balancers/:id/unregister. The client must supply the instance_id parameter to identify the instance, either as multipart/form-data or as application/x-www-form-urlencoded data.

Example request:

POST /api/load_balancers/secure-site-balancer/unregister?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 22
Content-Type: application/x-www-form-urlencoded

instance_id=i-4f06b52e

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 19:09:17 GMT

Storage resources

;T; I"G2

Load balancers

a list of instances;
a public address representing the IP address that the balancer will respond on to client requests;
a created_at timestamp; and
a list of listeners.

Storage resources

Get the details of all load balancers

To retrieve details of all load balancers use call GET /api/load_balancers.

Example request:

GET /api/load_balancers?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 13:37:19 GMT
Content-Length: 1844

<?xml version='1.0' encoding='utf-8' ?>
<load_balancers>
  <load_balancer href='http://localhost:3001/api/load_balancers/webtraffic-balancer' id='webtraffic-balancer'>
    <actions>
      <link href='http://localhost:3001/api/load_balancers/webtraffic-balancer' method='delete' rel='destroy' />
      <link href='http://localhost:3001/api/load_balancers/webtraffic-balancer/register' method='post' rel='register' />
    </actions>
    <public_addresses>
      <address>webtraffic-balancer-1306196965.us-east-1.elb.amazonaws.com</address>
    </public_addresses>
    <created_at>Thu Jul 28 13:29:52 UTC 2011</created_at>
    <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'></realm>
    <listeners>
      <listener protocol='HTTP'>
        <load_balancer_port>80</load_balancer_port>
        <instance_port>3001</instance_port>
      </listener>
    </listeners>
    <instances>
    </instances>
  </load_balancer>
  <load_balancer href='http://localhost:3001/api/load_balancers/secure-site-balancer' id='secure-site-balancer'>
    <actions>
      <link href='http://localhost:3001/api/load_balancers/secure-site-balancer' method='delete' rel='destroy' />
      <link href='http://localhost:3001/api/load_balancers/secure-site-balancer/register' method='post' rel='register' />
    </actions>
    <public_addresses>
      <address>secure-site-balancer-1347100846.us-east-1.elb.amazonaws.com</address>
    </public_addresses>
    <created_at>Thu Jul 28 13:36:29 UTC 2011</created_at>
    <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'></realm>
    <listeners>
      <listener protocol='HTTP'>
        <load_balancer_port>443</load_balancer_port>
        <instance_port>443</instance_port>
      </listener>
    </listeners>
    <instances>
    </instances>
  </load_balancer>
</load_balancers>

Get the details for a load balancer

To retrieve details for a specific load balancer use call GET /api/load_balancers/:id.

Example request:

GET /api/load_balancers/secure-site-balancer?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 18:11:49 GMT
Content-Length: 1361

<?xml version='1.0' encoding='utf-8' ?>
<load_balancer href='http://localhost:3001/api/load_balancers/secure-site-balancer' id='secure-site-balancer'>
  <actions>
    <link href='http://localhost:3001/api/load_balancers/secure-site-balancer' method='delete' rel='destroy' />
    <link href='http://localhost:3001/api/load_balancers/secure-site-balancer/register' method='post' rel='register' />
  </actions>
  <public_addresses>
    <address>secure-site-balancer-1347100846.us-east-1.elb.amazonaws.com</address>
  </public_addresses>
  <created_at>Thu Jul 28 13:36:29 UTC 2011</created_at>
  <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'></realm>
  <listeners>
    <listener protocol='HTTP'>
      <load_balancer_port>443</load_balancer_port>
      <instance_port>443</instance_port>
    </listener>
  </listeners>
  <instances>
    <instance href='http://localhost:3001/api/instances/i-4f06b52e' id='i-4f06b52e'>
      <link href='http://localhost:3001/api/load_balancers/secure-site-balancer/unregister?instance_id=i-4f06b52e' rel='unregister' />
    </instance>
    <instance href='http://localhost:3001/api/instances/i-d706b5b6' id='i-d706b5b6'>
      <link href='http://localhost:3001/api/load_balancers/secure-site-balancer/unregister?instance_id=i-d706b5b6' rel='unregister' />
    </instance>
  </instances>
</load_balancer>

Create a load balancer

Example request:

OST /api/load_balancers?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 121
Content-Type: application/x-www-form-urlencoded

name=webtraffic-balancer&realm_id=us-east-1c&listener_protocol=HTTP&
listener_balancer_port=80&listener_instance_port=3001

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Date: Thu, 28 Jul 2011 13:30:05 GMT
Content-Length: 884

<?xml version='1.0' encoding='utf-8' ?>
<load_balancer href='http://localhost:3001/api/load_balancers/webtraffic-balancer' id='webtraffic-balancer'>
  <actions>
    <link href='http://localhost:3001/api/load_balancers/webtraffic-balancer' method='delete' rel='destroy' />
    <link href='http://localhost:3001/api/load_balancers/webtraffic-balancer/register' method='post' rel='register' />
  </actions>
  <public_addresses>
    <address>webtraffic-balancer-1306196965.us-east-1.elb.amazonaws.com</address>
  </public_addresses>
  <created_at>Thu Jul 28 13:29:52 UTC 2011</created_at>
  <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'></realm>
  <listeners>
    <listener protocol='HTTP'>
      <load_balancer_port>80</load_balancer_port>
      <instance_port>3001</instance_port>
    </listener>
  </listeners>
  <instances>
  </instances>
</load_balancer>

Delete a load balancer

Example request:

DELETE /api/load_balancers/webtraffic-balancer?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 13:23:33 GMT

Register an instance with a load balancer

Example request:

POST /api/load_balancers/secure-site-balancer/register?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 22
Content-Type: application/x-www-form-urlencoded

instance_id=i-4f06b52e

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 18:20:03 GMT

Unreagister an instance from a load balancer

Example request:

POST /api/load_balancers/secure-site-balancer/unregister?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 22
Content-Type: application/x-www-form-urlencoded

instance_id=i-4f06b52e

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 19:09:17 GMT

Storage resources
;T; I"O2

Load balancers

a list of instances;
a public address representing the IP address that the balancer will respond on to client requests;
a created_at timestamp; and
a list of listeners.

Storage resources

Get the details of all load balancers

To retrieve details of all load balancers use call GET /api/load_balancers.

Example request:

GET /api/load_balancers?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 13:37:19 GMT
Content-Length: 1844

<?xml version='1.0' encoding='utf-8' ?>
<load_balancers>
  <load_balancer href='http://localhost:3001/api/load_balancers/webtraffic-balancer' id='webtraffic-balancer'>
    <actions>
      <link href='http://localhost:3001/api/load_balancers/webtraffic-balancer' method='delete' rel='destroy' />
      <link href='http://localhost:3001/api/load_balancers/webtraffic-balancer/register' method='post' rel='register' />
    </actions>
    <public_addresses>
      <address>webtraffic-balancer-1306196965.us-east-1.elb.amazonaws.com</address>
    </public_addresses>
    <created_at>Thu Jul 28 13:29:52 UTC 2011</created_at>
    <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'></realm>
    <listeners>
      <listener protocol='HTTP'>
        <load_balancer_port>80</load_balancer_port>
        <instance_port>3001</instance_port>
      </listener>
    </listeners>
    <instances>
    </instances>
  </load_balancer>
  <load_balancer href='http://localhost:3001/api/load_balancers/secure-site-balancer' id='secure-site-balancer'>
    <actions>
      <link href='http://localhost:3001/api/load_balancers/secure-site-balancer' method='delete' rel='destroy' />
      <link href='http://localhost:3001/api/load_balancers/secure-site-balancer/register' method='post' rel='register' />
    </actions>
    <public_addresses>
      <address>secure-site-balancer-1347100846.us-east-1.elb.amazonaws.com</address>
    </public_addresses>
    <created_at>Thu Jul 28 13:36:29 UTC 2011</created_at>
    <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'></realm>
    <listeners>
      <listener protocol='HTTP'>
        <load_balancer_port>443</load_balancer_port>
        <instance_port>443</instance_port>
      </listener>
    </listeners>
    <instances>
    </instances>
  </load_balancer>
</load_balancers>

Get the details for a load balancer

To retrieve details for a specific load balancer use call GET /api/load_balancers/:id.

Example request:

GET /api/load_balancers/secure-site-balancer?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 18:11:49 GMT
Content-Length: 1361

<?xml version='1.0' encoding='utf-8' ?>
<load_balancer href='http://localhost:3001/api/load_balancers/secure-site-balancer' id='secure-site-balancer'>
  <actions>
    <link href='http://localhost:3001/api/load_balancers/secure-site-balancer' method='delete' rel='destroy' />
    <link href='http://localhost:3001/api/load_balancers/secure-site-balancer/register' method='post' rel='register' />
  </actions>
  <public_addresses>
    <address>secure-site-balancer-1347100846.us-east-1.elb.amazonaws.com</address>
  </public_addresses>
  <created_at>Thu Jul 28 13:36:29 UTC 2011</created_at>
  <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'></realm>
  <listeners>
    <listener protocol='HTTP'>
      <load_balancer_port>443</load_balancer_port>
      <instance_port>443</instance_port>
    </listener>
  </listeners>
  <instances>
    <instance href='http://localhost:3001/api/instances/i-4f06b52e' id='i-4f06b52e'>
      <link href='http://localhost:3001/api/load_balancers/secure-site-balancer/unregister?instance_id=i-4f06b52e' rel='unregister' />
    </instance>
    <instance href='http://localhost:3001/api/instances/i-d706b5b6' id='i-d706b5b6'>
      <link href='http://localhost:3001/api/load_balancers/secure-site-balancer/unregister?instance_id=i-d706b5b6' rel='unregister' />
    </instance>
  </instances>
</load_balancer>

Create a load balancer

Example request:

OST /api/load_balancers?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 121
Content-Type: application/x-www-form-urlencoded

name=webtraffic-balancer&realm_id=us-east-1c&listener_protocol=HTTP&
listener_balancer_port=80&listener_instance_port=3001

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Date: Thu, 28 Jul 2011 13:30:05 GMT
Content-Length: 884

<?xml version='1.0' encoding='utf-8' ?>
<load_balancer href='http://localhost:3001/api/load_balancers/webtraffic-balancer' id='webtraffic-balancer'>
  <actions>
    <link href='http://localhost:3001/api/load_balancers/webtraffic-balancer' method='delete' rel='destroy' />
    <link href='http://localhost:3001/api/load_balancers/webtraffic-balancer/register' method='post' rel='register' />
  </actions>
  <public_addresses>
    <address>webtraffic-balancer-1306196965.us-east-1.elb.amazonaws.com</address>
  </public_addresses>
  <created_at>Thu Jul 28 13:29:52 UTC 2011</created_at>
  <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'></realm>
  <listeners>
    <listener protocol='HTTP'>
      <load_balancer_port>80</load_balancer_port>
      <instance_port>3001</instance_port>
    </listener>
  </listeners>
  <instances>
  </instances>
</load_balancer>

Delete a load balancer

Example request:

DELETE /api/load_balancers/webtraffic-balancer?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 13:23:33 GMT

Register an instance with a load balancer

Example request:

POST /api/load_balancers/secure-site-balancer/register?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 22
Content-Type: application/x-www-form-urlencoded

instance_id=i-4f06b52e

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 18:20:03 GMT

Unreagister an instance from a load balancer

Example request:

POST /api/load_balancers/secure-site-balancer/unregister?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 22
Content-Type: application/x-www-form-urlencoded

instance_id=i-4f06b52e

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 19:09:17 GMT

Storage resources

;T;@4I"/firewalls/;T{;{ ;I"*[ Firewalls

Firewalls

Firewalls represent sets of rules that govern the accessibility of a running instance over the public Internet. At present, only Amazon EC2 cloud (Amazon EC2 'Security Groups') and Fujitsu GCP support this collection. A firewall has these attributes:

a name
a description
an owner_id
set of rules

For Amazon EC2, an instance is launched into a firewall by specifying the firewalls1 ... firewallsN parameters in the POST /api/instances operation (see the Create an instance section).

Each firewall rule has a number of attributes describing the access granted to clients that want to communicate with the instance over the Internet. Each rule consists of

an allow_protocol (tcp, udp or icmp);
a port_from and a port_to that delimit the port range for access; and
a sources list, which can contain firewalls (i.e. allow instances in another firewall to communicate with instances in the firewall in which this rule exists), or a number of IP addresses in CIDR format, or a mix of both.

Storage resources

Each rule also specifies a direction, indicating whether it applies to ingress or egress traffic. A rule can also specify a rule_action (accept, deny), to indicate whether the firewall should accept or deny access for this traffic, and log_rule (true, false), to indicate whether an entry should be added to the log.

As Amazon EC2 has no notion of a firewall rule ID, the Deltacloud server constructs one ID for each rule as the concatenation of its attributes. The format used is: owner_id~protocol~from_port~to_port~@sources.

As explained above a source can be the address type in which case it defines an IP type (ipv4/ipv6), an IP address and routing prefix (CIDR netmask). Sources of type group have an owner_id and a name. The owner_id is the identifier of the account that created the specified firewall. The name defines the firewall to which the access is being granted.

An example of a rule id is:

393485797142~tcp~22~22~@group,393485797142,default,@address,ipv4,10.1.2.3,24
          {owner_id~protocol~from_port~to_port~@sources}

By creating the rule identifier abstraction, the Deltacloud API supports deletion of an entire firewall rule as one operation.

Get a list of all firewalls

To retrieve a list of all firewalls use call GET /api/firewalls.

Example request:

GET /api/firewalls?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Tue, 26 Jul 2011 15:56:04 GMT
Content-Length: 1640

<?xml version='1.0' encoding='utf-8' ?>
<firewalls>
  <firewall href='http://localhost:3001/api/firewalls/default' id='default'>
    <name><![CDATA[default]]></name>
    <description><![CDATA[default group]]></description>
    <owner_id>393485797142</owner_id>
    <rules>
      <rule id='393485797142~tcp~22~22~@address,ipv4,87.228.192.251,32'>
        <allow_protocol>tcp</allow_protocol>
        <port_from>22</port_from>
        <port_to>22</port_to>
        <direction>ingress</direction>
        <sources>
          <source address='87.228.192.251' family='ipv4' prefix='32' type='address'></source>
        </sources>
      </rule>
    </rules>
  </firewall>
  <firewall href='http://localhost:3001/api/firewalls/test' id='test'>
    <name><![CDATA[test]]></name>
    <description><![CDATA[this is just a test]]></description>
    <owner_id>393485797142</owner_id>
    <rules>
      <rule id='393485797142~tcp~22~22~@group,393485797142,default,@address,ipv4,10.1.2.3,24'>
        <allow_protocol>tcp</allow_protocol>
        <port_from>22</port_from>
        <port_to>22</port_to>
        <direction>ingress</direction>
        <sources>
          <source name='default' owner='393485797142' type='group'></source>
          <source address='10.1.2.3' family='ipv4' prefix='24' type='address'></source>
        </sources>
      </rule>
    </rules>
  </firewall>
  <firewall href='http://localhost:3001/api/firewalls/new_firewall' id='new_firewall'>
    <name><![CDATA[new_firewall]]></name>
    <description><![CDATA[new_one]]></description>
    <owner_id>393485797142</owner_id>
    <rules>
    </rules>
  </firewall>
</firewalls>

Get the details of a specified firewall

To retrieve details of a single specified firewall use call GET /api/firewalls/:id.

Example request:

GET /api/firewalls/test?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server reponse:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Wed, 27 Jul 2011 08:20:29 GMT
Content-Length: 835

<?xml version='1.0' encoding='utf-8' ?>
<firewall href='http://localhost:3001/api/firewalls/test' id='test'>
  <name><![CDATA[test]]></name>
  <description><![CDATA[this is just a test]]></description>
  <owner_id>393485797142</owner_id>
  <rules>
    <rule href='http://localhost:3001/api/firewalls/test/393485797142~tcp~22~22~@group,393485797142,default,@address,ipv4,10.1.2.3,24' id='393485797142~tcp~22~22~@group,393485797142,default,@address,ipv4,10.1.2.3,24'>
      <allow_protocol>tcp</allow_protocol>
      <port_from>22</port_from>
      <port_to>22</port_to>
      <direction>ingress</direction>
      <sources>
        <source name='default' owner='393485797142' type='group'></source>
        <source address='10.1.2.3' family='ipv4' prefix='24' type='address'></source>
      </sources>
    </rule>
  </rules>
</firewall>

Create a new firewall

To create a new firewall use call GET /api/firewalls/:id. Clients must specify the firewall name and description as parameters to the request. The Deltacloud server will respond with HTTP 201 Created to a succesful completion and return details of the newly created firewall. As with other POST operations in the Deltacloud API, a client may specify parameters as multipart/form-data or using the application/x-www-form-urlencoded content-type.

Example request:

POST /api/firewalls?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 64
Content-Type: application/x-www-form-urlencoded

name=Devel_Group&description=Access%20for%20all%20development%20machines

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Date: Wed, 27 Jul 2011 08:35:43 GMT
Content-Length: 296

<?xml version='1.0' encoding='utf-8' ?>
<firewall href='http://localhost:3001/api/firewalls/Devel_Group' id='Devel_Group'>
  <name><![CDATA[Devel_Group]]></name>
  <description><![CDATA[Access for all development machines]]></description>
  <owner_id></owner_id>
  <rules>
  </rules>
</firewall>

Delete a firewall

To delete the specified firewall from the back-end cloud provider use call DELETE /api/firewalls/:id. The Deltacloud server will respond with HTTP 204 No Content after a successful deletion:

Example request:

DELETE /api/firewalls/test?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Client response:

HTTP/1.1 204 No Content
Date: Wed, 27 Jul 2011 09:47:43 GMT

The rules governing the deletion of a firewall are back-end cloud specific.

For Fujitsu GCP, as this operation destroys the virtual system with it, all instances in the system, including the firewall need to be in the STOPPED state.

For Amazon EC2, it is permitted to delete a firewall that has rules defined within it, with two exceptions. You cannot delete a firewall if it is referenced by another firewall; for instance firewall_1 has a rule giving access to firewall_2. An attempt to delete firewall_2 will result in the error InvalidGroup.InUse, as you can see in the example below. The second exception is that you cannot delete a firewall if there are currently any running instances within that firewall (i.e. instances that specified the given firewall when they were launched). The error message in that case would be InvalidGroup.InUse: There are active instances using security group. In both cases the error messages are propagated from the back-end cloud provider to the requesting client.

Example request (error deleting a firewall referenced by another firewall):

DELETE /api/firewalls/firewall_2?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 502 Bad Gateway
Content-Type: application/xml
Content-Length: 626

<error status='502' url='/api/firewalls/firewall_2?format=xml'>
  <kind>backend_error</kind>
  <backend driver='ec2'>
    <code>502</code>
  </backend>
  <message><![CDATA[InvalidGroup.InUse: Group 393485797142:firewall_2 is used by groups: 393485797142:firewall_1
  REQUEST=ec2.us-east-1.amazonaws.com:443/?AWSAccessKeyId=AGG332FWWR5A11F327Q&Action=DeleteSecurityGroup&GroupName=firewall_2&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2011-07-27T08%3A50%3A50.000Z&Version=2010-08-31&Signature=g613223efwv5WAVhAosmPcrsfHqApAuw\nnwfYnZp0k3U%3D
  REQUEST ID=8591fa20-a6ee-4db7-b30f-3022ecc9a9f5]]></message>
</error>

Create a firewall rule

To create a new firewall rule within a specified firewall use call POST /api/firewalls/:id/rules. This operation of the firewalls collection is not supported by Fujitsu GCP. A client must supply the protocol (one of udp, tcp or icmp), port_from and port_to as parameters. Of course the client must also specify the sources to which the given rule is applied. IP addresses are specified in CIDR format sequentially: ip_address1=192.168.10.10/24, ip_address2=10.1.1.1/16 ... ip_addressN=.... The IP address '0.0.0.0/0' acts as a wildcard to specify any IP address. Source firewalls are also specified sequentially, but the owner_id of the firewall prepared for authorization must also be supplied (this is an Amazon EC2 requirement): group1=name1, group1owner=1234567890, group2=name2, group2owner=0987654321, ... groupN=nameN, groupNowner=...

The Deltacloud server responds with a HTTP 201 Created after a successful operation and adds the details of the given firewall. The example client request below specifies the required parameters as multipart/form-data. However clients may also legitimately use the application/x-www-form-urlencoded to provide firewall rule parameters.

Example request:

POST /api/firewalls/default/rules?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 1005
Expect: 100-continue
Content-Type: multipart/form-data; boundary=----------------------------4c9e7fa0a35e

------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="protocol"

tcp
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="port_from"

22
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="port_to"

22
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="group1"

devel_group
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="group1owner"

393485797142
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="group2"

outside
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="group2owner"

393485797142
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="ip_address1"

192.168.1.1/24
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="ip_address2"

65.128.31.27/32
------------------------------4c9e7fa0a35e--

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Date: Wed, 27 Jul 2011 10:18:51 GMT
Content-Length: 1143

<firewall href='http://localhost:3001/api/firewalls/default' id='default'>
  <name><![CDATA[default]]></name>
  <description><![CDATA[default group]]></description>
  <owner_id>393485797142</owner_id>
  <rules>
    <rule href='http://localhost:3001/api/firewalls/default/393485797142~tcp~22~22~@group,393485797142,devel_group,@group,393485797142,outside,@address,ipv4,192.168.1.1,24,@address,ipv4,65.128.31.27,32' id='393485797142~tcp~22~22~@group,393485797142,devel_group,@group,393485797142,outside,@address,ipv4,192.168.1.1,24,@address,ipv4,65.128.31.27,32'>
      <allow_protocol>tcp</allow_protocol>
      <port_from>22</port_from>
      <port_to>22</port_to>
      <direction>ingress</direction>
      <sources>
        <source name='devel_group' owner='393485797142' type='group'></source>
        <source name='outside' owner='393485797142' type='group'></source>
        <source address='192.168.1.1' family='ipv4' prefix='24' type='address'></source>
        <source address='65.128.31.27' family='ipv4' prefix='32' type='address'></source>
      </sources>
    </rule>
  </rules>
</firewall>

Delete a firewall rule

To delete the specified firewall rule use call DELETE /api/firewalls/:id/:rule_id. The Deltacloud server will respond with HTTP 204 No Content on completion of a successful delete operation:

Example request:

DELETE /api/firewalls/default/393485797142~tcp~0~0~@group,393485797142,devel_group,@group,393485797142,outside,@address,ipv4,192.168.1.1,24,@address,ipv4,65.128.31.27,32?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Wed, 27 Jul 2011 10:39:52 GMT

Addresses

;T; I"�E

Firewalls

a name
a description
an owner_id
set of rules

For Amazon EC2, an instance is launched into a firewall by specifying the firewalls1 ... firewallsN parameters in the POST /api/instances operation (see the Create an instance section).

Each firewall rule has a number of attributes describing the access granted to clients that want to communicate with the instance over the Internet. Each rule consists of

an allow_protocol (tcp, udp or icmp);
a port_from and a port_to that delimit the port range for access; and
a sources list, which can contain firewalls (i.e. allow instances in another firewall to communicate with instances in the firewall in which this rule exists), or a number of IP addresses in CIDR format, or a mix of both.

Storage resources

An example of a rule id is:

393485797142~tcp~22~22~@group,393485797142,default,@address,ipv4,10.1.2.3,24
          {owner_id~protocol~from_port~to_port~@sources}

By creating the rule identifier abstraction, the Deltacloud API supports deletion of an entire firewall rule as one operation.

Get a list of all firewalls

To retrieve a list of all firewalls use call GET /api/firewalls.

Example request:

GET /api/firewalls?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Tue, 26 Jul 2011 15:56:04 GMT
Content-Length: 1640

<?xml version='1.0' encoding='utf-8' ?>
<firewalls>
  <firewall href='http://localhost:3001/api/firewalls/default' id='default'>
    <name><![CDATA[default]]></name>
    <description><![CDATA[default group]]></description>
    <owner_id>393485797142</owner_id>
    <rules>
      <rule id='393485797142~tcp~22~22~@address,ipv4,87.228.192.251,32'>
        <allow_protocol>tcp</allow_protocol>
        <port_from>22</port_from>
        <port_to>22</port_to>
        <direction>ingress</direction>
        <sources>
          <source address='87.228.192.251' family='ipv4' prefix='32' type='address'></source>
        </sources>
      </rule>
    </rules>
  </firewall>
  <firewall href='http://localhost:3001/api/firewalls/test' id='test'>
    <name><![CDATA[test]]></name>
    <description><![CDATA[this is just a test]]></description>
    <owner_id>393485797142</owner_id>
    <rules>
      <rule id='393485797142~tcp~22~22~@group,393485797142,default,@address,ipv4,10.1.2.3,24'>
        <allow_protocol>tcp</allow_protocol>
        <port_from>22</port_from>
        <port_to>22</port_to>
        <direction>ingress</direction>
        <sources>
          <source name='default' owner='393485797142' type='group'></source>
          <source address='10.1.2.3' family='ipv4' prefix='24' type='address'></source>
        </sources>
      </rule>
    </rules>
  </firewall>
  <firewall href='http://localhost:3001/api/firewalls/new_firewall' id='new_firewall'>
    <name><![CDATA[new_firewall]]></name>
    <description><![CDATA[new_one]]></description>
    <owner_id>393485797142</owner_id>
    <rules>
    </rules>
  </firewall>
</firewalls>

Get the details of a specified firewall

To retrieve details of a single specified firewall use call GET /api/firewalls/:id.

Example request:

GET /api/firewalls/test?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server reponse:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Wed, 27 Jul 2011 08:20:29 GMT
Content-Length: 835

<?xml version='1.0' encoding='utf-8' ?>
<firewall href='http://localhost:3001/api/firewalls/test' id='test'>
  <name><![CDATA[test]]></name>
  <description><![CDATA[this is just a test]]></description>
  <owner_id>393485797142</owner_id>
  <rules>
    <rule href='http://localhost:3001/api/firewalls/test/393485797142~tcp~22~22~@group,393485797142,default,@address,ipv4,10.1.2.3,24' id='393485797142~tcp~22~22~@group,393485797142,default,@address,ipv4,10.1.2.3,24'>
      <allow_protocol>tcp</allow_protocol>
      <port_from>22</port_from>
      <port_to>22</port_to>
      <direction>ingress</direction>
      <sources>
        <source name='default' owner='393485797142' type='group'></source>
        <source address='10.1.2.3' family='ipv4' prefix='24' type='address'></source>
      </sources>
    </rule>
  </rules>
</firewall>

Create a new firewall

Example request:

POST /api/firewalls?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 64
Content-Type: application/x-www-form-urlencoded

name=Devel_Group&description=Access%20for%20all%20development%20machines

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Date: Wed, 27 Jul 2011 08:35:43 GMT
Content-Length: 296

<?xml version='1.0' encoding='utf-8' ?>
<firewall href='http://localhost:3001/api/firewalls/Devel_Group' id='Devel_Group'>
  <name><![CDATA[Devel_Group]]></name>
  <description><![CDATA[Access for all development machines]]></description>
  <owner_id></owner_id>
  <rules>
  </rules>
</firewall>

Delete a firewall

To delete the specified firewall from the back-end cloud provider use call DELETE /api/firewalls/:id. The Deltacloud server will respond with HTTP 204 No Content after a successful deletion:

Example request:

DELETE /api/firewalls/test?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Client response:

HTTP/1.1 204 No Content
Date: Wed, 27 Jul 2011 09:47:43 GMT

The rules governing the deletion of a firewall are back-end cloud specific.

For Fujitsu GCP, as this operation destroys the virtual system with it, all instances in the system, including the firewall need to be in the STOPPED state.

Example request (error deleting a firewall referenced by another firewall):

DELETE /api/firewalls/firewall_2?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 502 Bad Gateway
Content-Type: application/xml
Content-Length: 626

<error status='502' url='/api/firewalls/firewall_2?format=xml'>
  <kind>backend_error</kind>
  <backend driver='ec2'>
    <code>502</code>
  </backend>
  <message><![CDATA[InvalidGroup.InUse: Group 393485797142:firewall_2 is used by groups: 393485797142:firewall_1
  REQUEST=ec2.us-east-1.amazonaws.com:443/?AWSAccessKeyId=AGG332FWWR5A11F327Q&Action=DeleteSecurityGroup&GroupName=firewall_2&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2011-07-27T08%3A50%3A50.000Z&Version=2010-08-31&Signature=g613223efwv5WAVhAosmPcrsfHqApAuw\nnwfYnZp0k3U%3D
  REQUEST ID=8591fa20-a6ee-4db7-b30f-3022ecc9a9f5]]></message>
</error>

Create a firewall rule

Example request:

POST /api/firewalls/default/rules?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 1005
Expect: 100-continue
Content-Type: multipart/form-data; boundary=----------------------------4c9e7fa0a35e

------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="protocol"

tcp
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="port_from"

22
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="port_to"

22
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="group1"

devel_group
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="group1owner"

393485797142
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="group2"

outside
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="group2owner"

393485797142
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="ip_address1"

192.168.1.1/24
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="ip_address2"

65.128.31.27/32
------------------------------4c9e7fa0a35e--

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Date: Wed, 27 Jul 2011 10:18:51 GMT
Content-Length: 1143

<firewall href='http://localhost:3001/api/firewalls/default' id='default'>
  <name><![CDATA[default]]></name>
  <description><![CDATA[default group]]></description>
  <owner_id>393485797142</owner_id>
  <rules>
    <rule href='http://localhost:3001/api/firewalls/default/393485797142~tcp~22~22~@group,393485797142,devel_group,@group,393485797142,outside,@address,ipv4,192.168.1.1,24,@address,ipv4,65.128.31.27,32' id='393485797142~tcp~22~22~@group,393485797142,devel_group,@group,393485797142,outside,@address,ipv4,192.168.1.1,24,@address,ipv4,65.128.31.27,32'>
      <allow_protocol>tcp</allow_protocol>
      <port_from>22</port_from>
      <port_to>22</port_to>
      <direction>ingress</direction>
      <sources>
        <source name='devel_group' owner='393485797142' type='group'></source>
        <source name='outside' owner='393485797142' type='group'></source>
        <source address='192.168.1.1' family='ipv4' prefix='24' type='address'></source>
        <source address='65.128.31.27' family='ipv4' prefix='32' type='address'></source>
      </sources>
    </rule>
  </rules>
</firewall>

Delete a firewall rule

To delete the specified firewall rule use call DELETE /api/firewalls/:id/:rule_id. The Deltacloud server will respond with HTTP 204 No Content on completion of a successful delete operation:

Example request:

DELETE /api/firewalls/default/393485797142~tcp~0~0~@group,393485797142,devel_group,@group,393485797142,outside,@address,ipv4,192.168.1.1,24,@address,ipv4,65.128.31.27,32?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Wed, 27 Jul 2011 10:39:52 GMT

Addresses
;T; I"�E

Firewalls

a name
a description
an owner_id
set of rules

For Amazon EC2, an instance is launched into a firewall by specifying the firewalls1 ... firewallsN parameters in the POST /api/instances operation (see the Create an instance section).

Each firewall rule has a number of attributes describing the access granted to clients that want to communicate with the instance over the Internet. Each rule consists of

an allow_protocol (tcp, udp or icmp);
a port_from and a port_to that delimit the port range for access; and
a sources list, which can contain firewalls (i.e. allow instances in another firewall to communicate with instances in the firewall in which this rule exists), or a number of IP addresses in CIDR format, or a mix of both.

Storage resources

An example of a rule id is:

393485797142~tcp~22~22~@group,393485797142,default,@address,ipv4,10.1.2.3,24
          {owner_id~protocol~from_port~to_port~@sources}

By creating the rule identifier abstraction, the Deltacloud API supports deletion of an entire firewall rule as one operation.

Get a list of all firewalls

To retrieve a list of all firewalls use call GET /api/firewalls.

Example request:

GET /api/firewalls?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Tue, 26 Jul 2011 15:56:04 GMT
Content-Length: 1640

<?xml version='1.0' encoding='utf-8' ?>
<firewalls>
  <firewall href='http://localhost:3001/api/firewalls/default' id='default'>
    <name><![CDATA[default]]></name>
    <description><![CDATA[default group]]></description>
    <owner_id>393485797142</owner_id>
    <rules>
      <rule id='393485797142~tcp~22~22~@address,ipv4,87.228.192.251,32'>
        <allow_protocol>tcp</allow_protocol>
        <port_from>22</port_from>
        <port_to>22</port_to>
        <direction>ingress</direction>
        <sources>
          <source address='87.228.192.251' family='ipv4' prefix='32' type='address'></source>
        </sources>
      </rule>
    </rules>
  </firewall>
  <firewall href='http://localhost:3001/api/firewalls/test' id='test'>
    <name><![CDATA[test]]></name>
    <description><![CDATA[this is just a test]]></description>
    <owner_id>393485797142</owner_id>
    <rules>
      <rule id='393485797142~tcp~22~22~@group,393485797142,default,@address,ipv4,10.1.2.3,24'>
        <allow_protocol>tcp</allow_protocol>
        <port_from>22</port_from>
        <port_to>22</port_to>
        <direction>ingress</direction>
        <sources>
          <source name='default' owner='393485797142' type='group'></source>
          <source address='10.1.2.3' family='ipv4' prefix='24' type='address'></source>
        </sources>
      </rule>
    </rules>
  </firewall>
  <firewall href='http://localhost:3001/api/firewalls/new_firewall' id='new_firewall'>
    <name><![CDATA[new_firewall]]></name>
    <description><![CDATA[new_one]]></description>
    <owner_id>393485797142</owner_id>
    <rules>
    </rules>
  </firewall>
</firewalls>

Get the details of a specified firewall

To retrieve details of a single specified firewall use call GET /api/firewalls/:id.

Example request:

GET /api/firewalls/test?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server reponse:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Wed, 27 Jul 2011 08:20:29 GMT
Content-Length: 835

<?xml version='1.0' encoding='utf-8' ?>
<firewall href='http://localhost:3001/api/firewalls/test' id='test'>
  <name><![CDATA[test]]></name>
  <description><![CDATA[this is just a test]]></description>
  <owner_id>393485797142</owner_id>
  <rules>
    <rule href='http://localhost:3001/api/firewalls/test/393485797142~tcp~22~22~@group,393485797142,default,@address,ipv4,10.1.2.3,24' id='393485797142~tcp~22~22~@group,393485797142,default,@address,ipv4,10.1.2.3,24'>
      <allow_protocol>tcp</allow_protocol>
      <port_from>22</port_from>
      <port_to>22</port_to>
      <direction>ingress</direction>
      <sources>
        <source name='default' owner='393485797142' type='group'></source>
        <source address='10.1.2.3' family='ipv4' prefix='24' type='address'></source>
      </sources>
    </rule>
  </rules>
</firewall>

Create a new firewall

Example request:

POST /api/firewalls?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 64
Content-Type: application/x-www-form-urlencoded

name=Devel_Group&description=Access%20for%20all%20development%20machines

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Date: Wed, 27 Jul 2011 08:35:43 GMT
Content-Length: 296

<?xml version='1.0' encoding='utf-8' ?>
<firewall href='http://localhost:3001/api/firewalls/Devel_Group' id='Devel_Group'>
  <name><![CDATA[Devel_Group]]></name>
  <description><![CDATA[Access for all development machines]]></description>
  <owner_id></owner_id>
  <rules>
  </rules>
</firewall>

Delete a firewall

To delete the specified firewall from the back-end cloud provider use call DELETE /api/firewalls/:id. The Deltacloud server will respond with HTTP 204 No Content after a successful deletion:

Example request:

DELETE /api/firewalls/test?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Client response:

HTTP/1.1 204 No Content
Date: Wed, 27 Jul 2011 09:47:43 GMT

The rules governing the deletion of a firewall are back-end cloud specific.

For Fujitsu GCP, as this operation destroys the virtual system with it, all instances in the system, including the firewall need to be in the STOPPED state.

Example request (error deleting a firewall referenced by another firewall):

DELETE /api/firewalls/firewall_2?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 502 Bad Gateway
Content-Type: application/xml
Content-Length: 626

<error status='502' url='/api/firewalls/firewall_2?format=xml'>
  <kind>backend_error</kind>
  <backend driver='ec2'>
    <code>502</code>
  </backend>
  <message><![CDATA[InvalidGroup.InUse: Group 393485797142:firewall_2 is used by groups: 393485797142:firewall_1
  REQUEST=ec2.us-east-1.amazonaws.com:443/?AWSAccessKeyId=AGG332FWWR5A11F327Q&Action=DeleteSecurityGroup&GroupName=firewall_2&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2011-07-27T08%3A50%3A50.000Z&Version=2010-08-31&Signature=g613223efwv5WAVhAosmPcrsfHqApAuw\nnwfYnZp0k3U%3D
  REQUEST ID=8591fa20-a6ee-4db7-b30f-3022ecc9a9f5]]></message>
</error>

Create a firewall rule

Example request:

POST /api/firewalls/default/rules?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 1005
Expect: 100-continue
Content-Type: multipart/form-data; boundary=----------------------------4c9e7fa0a35e

------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="protocol"

tcp
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="port_from"

22
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="port_to"

22
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="group1"

devel_group
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="group1owner"

393485797142
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="group2"

outside
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="group2owner"

393485797142
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="ip_address1"

192.168.1.1/24
------------------------------4c9e7fa0a35e
Content-Disposition: form-data; name="ip_address2"

65.128.31.27/32
------------------------------4c9e7fa0a35e--

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Date: Wed, 27 Jul 2011 10:18:51 GMT
Content-Length: 1143

<firewall href='http://localhost:3001/api/firewalls/default' id='default'>
  <name><![CDATA[default]]></name>
  <description><![CDATA[default group]]></description>
  <owner_id>393485797142</owner_id>
  <rules>
    <rule href='http://localhost:3001/api/firewalls/default/393485797142~tcp~22~22~@group,393485797142,devel_group,@group,393485797142,outside,@address,ipv4,192.168.1.1,24,@address,ipv4,65.128.31.27,32' id='393485797142~tcp~22~22~@group,393485797142,devel_group,@group,393485797142,outside,@address,ipv4,192.168.1.1,24,@address,ipv4,65.128.31.27,32'>
      <allow_protocol>tcp</allow_protocol>
      <port_from>22</port_from>
      <port_to>22</port_to>
      <direction>ingress</direction>
      <sources>
        <source name='devel_group' owner='393485797142' type='group'></source>
        <source name='outside' owner='393485797142' type='group'></source>
        <source address='192.168.1.1' family='ipv4' prefix='24' type='address'></source>
        <source address='65.128.31.27' family='ipv4' prefix='32' type='address'></source>
      </sources>
    </rule>
  </rules>
</firewall>

Delete a firewall rule

To delete the specified firewall rule use call DELETE /api/firewalls/:id/:rule_id. The Deltacloud server will respond with HTTP 204 No Content on completion of a successful delete operation:

Example request:

DELETE /api/firewalls/default/393485797142~tcp~0~0~@group,393485797142,devel_group,@group,393485797142,outside,@address,ipv4,192.168.1.1,24,@address,ipv4,65.128.31.27,32?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Wed, 27 Jul 2011 10:39:52 GMT

Addresses

;T;@:I"/htaccess/;T{;{;I"�Redirect 301 /documentation.html /usage.html Redirect 301 /api.html /rest-api.html Redirect 301 /developers.html /how-to-contribute.html ;T; @@; @@I"/addresses/;T{;{ ;I"�5 Addresses

Addresses

The addresses collection represents IP addresses and allows IP address management.

This collection is currently implemented for Amazon EC2 and Fujitsu GCP drivers. For EC2, IP address management corresponds to Amazon's 'Elastic IP' feature.

The addresses collection supports these operations:

creating an address
destroying an address
association an address with a running instance
dissociating an address from a running instance

Storage resources

Get a list of all addresses

To retrieve a list of all addresses use call GET /api/addresses.

Example request:

GET /api/addresses?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Wed, 27 Jul 2011 12:55:16 GMT
Content-Length: 817

<?xml version='1.0' encoding='utf-8' ?>
<addresses>
  <address href='http://localhost:3001/api/addresses/107.20.232.251' id='107.20.232.251'>
    <ip>107.20.232.251</ip>
    <actions>
      <link href='http://localhost:3001/api/addresses/107.20.232.251' method='delete' rel='destroy' />
      <link href='http://localhost:3001/api/addresses/107.20.232.251/associate' method='post' rel='associate' />
    </actions>
  </address>
  <address href='http://localhost:3001/api/addresses/107.20.234.161' id='107.20.234.161'>
    <ip>107.20.234.161</ip>
    <actions>
      <link href='http://localhost:3001/api/addresses/107.20.234.161' method='delete' rel='destroy' />
      <link href='http://localhost:3001/api/addresses/107.20.234.161/associate' method='post' rel='associate' />
    </actions>
  </address>
</addresses>

Get the details of an address

To retrieve details for a specific address use call GET /api/addresses/:id.

Example request:

GET /api/addresses/107.20.232.251?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Wed, 27 Jul 2011 12:57:27 GMT
Content-Length: 402

<?xml version='1.0' encoding='utf-8' ?>
<address href='http://localhost:3001/api/addresses/107.20.232.251' id='107.20.232.251'>
  <ip>107.20.232.251</ip>
  <actions>
    <link href='http://localhost:3001/api/addresses/107.20.232.251' method='delete' rel='destroy' />
    <link href='http://localhost:3001/api/addresses/107.20.232.251/associate' method='post' rel='associate' />
  </actions>
</address>

Create an address

To create a new address use call POST /api/addresses. The Deltacloud server will respond with HTTP 201 Created and provide the details of the new address after a succesful operation:

Example request:

POST /api/addresses?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Content-Length: 388

<?xml version='1.0' encoding='utf-8' ?>
<address href='http://localhost:3001/api/addresses/107.20.232.251' id='107.20.232.251'>
  <ip>107.20.232.251</ip>
  <actions>
    <link href='http://localhost:3001/api/addresses/107.20.232.251' method='delete' rel='destroy' />
    <link href='http://localhost:3001/api/addresses/107.20.232.251/associate' method='post' rel='associate' />
  </actions>
</address>

Delete an address

To delete a specified address use call DELETE /api/addresses/:id. The Deltacloud server responds with a HTTP 204 No Content after a succesful operation.

Example request:

DELETE /api/addresses/107.20.232.251?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Wed, 27 Jul 2011 13:29:00 GMT

Associate an address with an instance

To associate a given address with a running instance use call POST /api/addresses/:id/associate. The client must specify the instance_id as a parameter to this call. For Amazon EC2, the specified address will replace the currently assigned public_address of the instance, while for the Fujitsu GCP it is added. A succesful operation results in a HTTP 202 Accepted response. The example client request below specifies the required instance_id parameter using the application/x-www-form-urlencoded content-type, however client can also use multipart/form-data.

Example request:

POST /api/addresses/107.20.232.251/associate?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 22
Content-Type: application/x-www-form-urlencoded

instance_id=i-9d8a3dfc

Server response:

HTTP/1.1 202 Accepted
Content-Type: application/xml
Date: Wed, 27 Jul 2011 13:01:11 GMT
Content-Length: 0

Disassociate an address from an instance

To disassociate a given address from the instance to which it is currently assigned use call POST /api/addresses/:id/disassociate.

Example request:

POST /api/addresses/107.20.232.251/disassociate?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 202 Accepted
Content-Type: application/xml
Date: Wed, 27 Jul 2011 13:05:38 GMT
Content-Length: 0

Load Balancers

;T; I"I

Addresses

The addresses collection represents IP addresses and allows IP address management.

This collection is currently implemented for Amazon EC2 and Fujitsu GCP drivers. For EC2, IP address management corresponds to Amazon's 'Elastic IP' feature.

The addresses collection supports these operations:

creating an address
destroying an address
association an address with a running instance
dissociating an address from a running instance

Storage resources

Get a list of all addresses

To retrieve a list of all addresses use call GET /api/addresses.

Example request:

GET /api/addresses?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Wed, 27 Jul 2011 12:55:16 GMT
Content-Length: 817

<?xml version='1.0' encoding='utf-8' ?>
<addresses>
  <address href='http://localhost:3001/api/addresses/107.20.232.251' id='107.20.232.251'>
    <ip>107.20.232.251</ip>
    <actions>
      <link href='http://localhost:3001/api/addresses/107.20.232.251' method='delete' rel='destroy' />
      <link href='http://localhost:3001/api/addresses/107.20.232.251/associate' method='post' rel='associate' />
    </actions>
  </address>
  <address href='http://localhost:3001/api/addresses/107.20.234.161' id='107.20.234.161'>
    <ip>107.20.234.161</ip>
    <actions>
      <link href='http://localhost:3001/api/addresses/107.20.234.161' method='delete' rel='destroy' />
      <link href='http://localhost:3001/api/addresses/107.20.234.161/associate' method='post' rel='associate' />
    </actions>
  </address>
</addresses>

Get the details of an address

To retrieve details for a specific address use call GET /api/addresses/:id.

Example request:

GET /api/addresses/107.20.232.251?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Wed, 27 Jul 2011 12:57:27 GMT
Content-Length: 402

<?xml version='1.0' encoding='utf-8' ?>
<address href='http://localhost:3001/api/addresses/107.20.232.251' id='107.20.232.251'>
  <ip>107.20.232.251</ip>
  <actions>
    <link href='http://localhost:3001/api/addresses/107.20.232.251' method='delete' rel='destroy' />
    <link href='http://localhost:3001/api/addresses/107.20.232.251/associate' method='post' rel='associate' />
  </actions>
</address>

Create an address

To create a new address use call POST /api/addresses. The Deltacloud server will respond with HTTP 201 Created and provide the details of the new address after a succesful operation:

Example request:

POST /api/addresses?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Content-Length: 388

<?xml version='1.0' encoding='utf-8' ?>
<address href='http://localhost:3001/api/addresses/107.20.232.251' id='107.20.232.251'>
  <ip>107.20.232.251</ip>
  <actions>
    <link href='http://localhost:3001/api/addresses/107.20.232.251' method='delete' rel='destroy' />
    <link href='http://localhost:3001/api/addresses/107.20.232.251/associate' method='post' rel='associate' />
  </actions>
</address>

Delete an address

To delete a specified address use call DELETE /api/addresses/:id. The Deltacloud server responds with a HTTP 204 No Content after a succesful operation.

Example request:

DELETE /api/addresses/107.20.232.251?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Wed, 27 Jul 2011 13:29:00 GMT

Associate an address with an instance

Example request:

POST /api/addresses/107.20.232.251/associate?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 22
Content-Type: application/x-www-form-urlencoded

instance_id=i-9d8a3dfc

Server response:

HTTP/1.1 202 Accepted
Content-Type: application/xml
Date: Wed, 27 Jul 2011 13:01:11 GMT
Content-Length: 0

Disassociate an address from an instance

To disassociate a given address from the instance to which it is currently assigned use call POST /api/addresses/:id/disassociate.

Example request:

POST /api/addresses/107.20.232.251/disassociate?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 202 Accepted
Content-Type: application/xml
Date: Wed, 27 Jul 2011 13:05:38 GMT
Content-Length: 0

Load Balancers
;T; I"3

Addresses

The addresses collection represents IP addresses and allows IP address management.

This collection is currently implemented for Amazon EC2 and Fujitsu GCP drivers. For EC2, IP address management corresponds to Amazon's 'Elastic IP' feature.

The addresses collection supports these operations:

creating an address
destroying an address
association an address with a running instance
dissociating an address from a running instance

Storage resources

Get a list of all addresses

To retrieve a list of all addresses use call GET /api/addresses.

Example request:

GET /api/addresses?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Wed, 27 Jul 2011 12:55:16 GMT
Content-Length: 817

<?xml version='1.0' encoding='utf-8' ?>
<addresses>
  <address href='http://localhost:3001/api/addresses/107.20.232.251' id='107.20.232.251'>
    <ip>107.20.232.251</ip>
    <actions>
      <link href='http://localhost:3001/api/addresses/107.20.232.251' method='delete' rel='destroy' />
      <link href='http://localhost:3001/api/addresses/107.20.232.251/associate' method='post' rel='associate' />
    </actions>
  </address>
  <address href='http://localhost:3001/api/addresses/107.20.234.161' id='107.20.234.161'>
    <ip>107.20.234.161</ip>
    <actions>
      <link href='http://localhost:3001/api/addresses/107.20.234.161' method='delete' rel='destroy' />
      <link href='http://localhost:3001/api/addresses/107.20.234.161/associate' method='post' rel='associate' />
    </actions>
  </address>
</addresses>

Get the details of an address

To retrieve details for a specific address use call GET /api/addresses/:id.

Example request:

GET /api/addresses/107.20.232.251?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Wed, 27 Jul 2011 12:57:27 GMT
Content-Length: 402

<?xml version='1.0' encoding='utf-8' ?>
<address href='http://localhost:3001/api/addresses/107.20.232.251' id='107.20.232.251'>
  <ip>107.20.232.251</ip>
  <actions>
    <link href='http://localhost:3001/api/addresses/107.20.232.251' method='delete' rel='destroy' />
    <link href='http://localhost:3001/api/addresses/107.20.232.251/associate' method='post' rel='associate' />
  </actions>
</address>

Create an address

To create a new address use call POST /api/addresses. The Deltacloud server will respond with HTTP 201 Created and provide the details of the new address after a succesful operation:

Example request:

POST /api/addresses?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Content-Length: 388

<?xml version='1.0' encoding='utf-8' ?>
<address href='http://localhost:3001/api/addresses/107.20.232.251' id='107.20.232.251'>
  <ip>107.20.232.251</ip>
  <actions>
    <link href='http://localhost:3001/api/addresses/107.20.232.251' method='delete' rel='destroy' />
    <link href='http://localhost:3001/api/addresses/107.20.232.251/associate' method='post' rel='associate' />
  </actions>
</address>

Delete an address

To delete a specified address use call DELETE /api/addresses/:id. The Deltacloud server responds with a HTTP 204 No Content after a succesful operation.

Example request:

DELETE /api/addresses/107.20.232.251?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Wed, 27 Jul 2011 13:29:00 GMT

Associate an address with an instance

Example request:

POST /api/addresses/107.20.232.251/associate?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 22
Content-Type: application/x-www-form-urlencoded

instance_id=i-9d8a3dfc

Server response:

HTTP/1.1 202 Accepted
Content-Type: application/xml
Date: Wed, 27 Jul 2011 13:01:11 GMT
Content-Length: 0

Disassociate an address from an instance

To disassociate a given address from the instance to which it is currently assigned use call POST /api/addresses/:id/disassociate.

Example request:

POST /api/addresses/107.20.232.251/disassociate?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 202 Accepted
Content-Type: application/xml
Date: Wed, 27 Jul 2011 13:05:38 GMT
Content-Length: 0

Load Balancers

;T;@DI"/usage/;T{;{ ;I"@- Usage

Using API

Clients

Instead of dealing with HTTP interface you can use various clients to communicate with Deltacloud server.

The Deltacloud Ruby Client

You need to install Ruby client seperately to the Deltacloud API server. Assuming you already have Ruby and RubyGems setup, you can install the Deltacloud client by simply typing:

$ sudo gem install deltacloud-client

The Deltacloud client consists of a Ruby library (packaged as a Ruby gem) which you can use to interact with the Deltacloud server and control your cloud infrastructure across cloud providers.

To use the client, you must require deltacloud:

require 'deltacloud'

Connect to a Deltacloud provider:

require 'deltacloud'

api_url      = 'http://localhost:3001/api'
api_name     = 'mockuser'
api_password = 'mockpassword'

client = DeltaCloud.new( api_name, api_password, api_url )

# work with client here

In addition to creating a client, you can specify operations within a block included on the initialization.

DeltaCloud.new( api_name, api_password, api_url ) do |client|
  # work with client here
end

In case of a failure, any underlying HTTP transport exceptions will be thrown away and returned back to the caller.

To work with another driver, just switch the client:

client = DeltaCloud.new( api_name, api_password, api_url )

# switch the client to use EC2 driver
ec2 = client.with_config(:driver => :ec2)

# switch the client to use OpenStack driver
openstack = client.with_config(:driver => :openstack)

Work with the Ruby client

HTTP clients - cURL

Basically, you interact with the Deltacloud server via HTTP calls, so you can use any HTTP client to talk to Deltacloud using the Deltacloud REST API.

cURL is a popular command line tool available on most modern linux distributions. See the following examples to learn how to use cURL to interact with Deltacloud. There is an assumption that the Deltacloud server is running on locahost:3001 and was started with the 'ec2' driver (i.e., deltacloudd -i ec2 ).

Get a list of all images available in the back-end cloud:

curl  --user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
"http://localhost:3001/api/images?format=xml"

The cURL --user option is used to specify the username:password credentials for access to the back-end cloud provider (Amazon EC2 in this case).

Create a new instance from the image with id 'ami-f51aff9c', in realm 'us-east-1c', with the hardware profile 'c1.medium', in firewall 'default':

curl -X POST -F "keyname=eftah" -F "image_id=ami-f51aff9c"
-F "realm_id=us-east-1c" -F "hwp_id=c1.medium" -F "firewalls1=default"
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
"http://localhost:3001/api/instances?format=xml"

Delete a firewall called 'develgroup':

curl -X DELETE
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/firewalls/develgroup?format=xml

Create a blob called 'my_new_blob' within the bucket 'mybucket' from a local file with HTTP PUT specifying its content type and setting some metadata key:value pairs:

curl -H 'content-type: text/html' -H 'X-Deltacloud-Blobmeta-Name:mariosblob'
-H 'X-Deltacloud-Blobmeta-Version:2.1' --upload-file
"/home/marios/Desktop/somefile.html"
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/buckets/mybucket/my_new_blob?format=xml

Retrieve blob metadata for the blob called 'my_new_blob':

curl -iv -X HEAD
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/buckets/mybucket/my_new_blob?format=xml

The '-iv' flags will ensure that cURL displays the request and response headers (blob metadata are reported in the response headers with an empty response body).

Working with cURL

Libdeltacloud Client (C library)

Libdeltacloud is a C/C++ library for accessing the Deltacloud API. It exports convenient structures and functions for manipulating cloud objects through the Deltacloud API.

Get the source code:

$ git clone git://git.fedorahosted.org/deltacloud/libdeltacloud.git

As of version 0.9, libdeltacloud is mostly API stable, but not ABI stable. The difference between the two is subtle but important. A library that is ABI (Application Binary Interface) stable means, that programs using the library don't need to be modified nor re-compiled when a new version of the library comes out. A library that is API (Application Programming Interface) stable means that programs using the library don't need to be modified, but may need to be re-compiled when a new version of the library comes out. The reason is that the sizes of structures in the library might change, which can lead to a misunderstanding between what the library and the program thinks the size of a structure is.

Due to the magic of libtool versioning, programs built against an older version of libdeltacloud will refuse to run against a newer version of libdeltacloud if the size of the structures has changed. If this happens, then the program must be recompiled against the newer libdeltacloud.

Libdeltacloud documentation

;T; I"�

Using API

Clients

Instead of dealing with HTTP interface you can use various clients to communicate with Deltacloud server.

The Deltacloud Ruby Client

You need to install Ruby client seperately to the Deltacloud API server. Assuming you already have Ruby and RubyGems setup, you can install the Deltacloud client by simply typing:

$ sudo gem install deltacloud-client

The Deltacloud client consists of a Ruby library (packaged as a Ruby gem) which you can use to interact with the Deltacloud server and control your cloud infrastructure across cloud providers.

To use the client, you must require deltacloud:

require 'deltacloud'

Connect to a Deltacloud provider:

require 'deltacloud'

api_url      = 'http://localhost:3001/api'
api_name     = 'mockuser'
api_password = 'mockpassword'

client = DeltaCloud.new( api_name, api_password, api_url )

# work with client here

In addition to creating a client, you can specify operations within a block included on the initialization.

DeltaCloud.new( api_name, api_password, api_url ) do |client|
  # work with client here
end

In case of a failure, any underlying HTTP transport exceptions will be thrown away and returned back to the caller.

To work with another driver, just switch the client:

client = DeltaCloud.new( api_name, api_password, api_url )

# switch the client to use EC2 driver
ec2 = client.with_config(:driver => :ec2)

# switch the client to use OpenStack driver
openstack = client.with_config(:driver => :openstack)

Work with the Ruby client

HTTP clients - cURL

Basically, you interact with the Deltacloud server via HTTP calls, so you can use any HTTP client to talk to Deltacloud using the Deltacloud REST API.

Get a list of all images available in the back-end cloud:

curl  --user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
"http://localhost:3001/api/images?format=xml"

The cURL --user option is used to specify the username:password credentials for access to the back-end cloud provider (Amazon EC2 in this case).

Create a new instance from the image with id 'ami-f51aff9c', in realm 'us-east-1c', with the hardware profile 'c1.medium', in firewall 'default':

curl -X POST -F "keyname=eftah" -F "image_id=ami-f51aff9c"
-F "realm_id=us-east-1c" -F "hwp_id=c1.medium" -F "firewalls1=default"
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
"http://localhost:3001/api/instances?format=xml"

Delete a firewall called 'develgroup':

curl -X DELETE
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/firewalls/develgroup?format=xml

Create a blob called 'my_new_blob' within the bucket 'mybucket' from a local file with HTTP PUT specifying its content type and setting some metadata key:value pairs:

curl -H 'content-type: text/html' -H 'X-Deltacloud-Blobmeta-Name:mariosblob'
-H 'X-Deltacloud-Blobmeta-Version:2.1' --upload-file
"/home/marios/Desktop/somefile.html"
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/buckets/mybucket/my_new_blob?format=xml

Retrieve blob metadata for the blob called 'my_new_blob':

curl -iv -X HEAD
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/buckets/mybucket/my_new_blob?format=xml

The '-iv' flags will ensure that cURL displays the request and response headers (blob metadata are reported in the response headers with an empty response body).

Working with cURL

Libdeltacloud Client (C library)

Libdeltacloud is a C/C++ library for accessing the Deltacloud API. It exports convenient structures and functions for manipulating cloud objects through the Deltacloud API.

Get the source code:

$ git clone git://git.fedorahosted.org/deltacloud/libdeltacloud.git

Libdeltacloud documentation
;T; I"�

Using API

Clients

Instead of dealing with HTTP interface you can use various clients to communicate with Deltacloud server.

The Deltacloud Ruby Client

You need to install Ruby client seperately to the Deltacloud API server. Assuming you already have Ruby and RubyGems setup, you can install the Deltacloud client by simply typing:

$ sudo gem install deltacloud-client

The Deltacloud client consists of a Ruby library (packaged as a Ruby gem) which you can use to interact with the Deltacloud server and control your cloud infrastructure across cloud providers.

To use the client, you must require deltacloud:

require 'deltacloud'

Connect to a Deltacloud provider:

require 'deltacloud'

api_url      = 'http://localhost:3001/api'
api_name     = 'mockuser'
api_password = 'mockpassword'

client = DeltaCloud.new( api_name, api_password, api_url )

# work with client here

In addition to creating a client, you can specify operations within a block included on the initialization.

DeltaCloud.new( api_name, api_password, api_url ) do |client|
  # work with client here
end

In case of a failure, any underlying HTTP transport exceptions will be thrown away and returned back to the caller.

To work with another driver, just switch the client:

client = DeltaCloud.new( api_name, api_password, api_url )

# switch the client to use EC2 driver
ec2 = client.with_config(:driver => :ec2)

# switch the client to use OpenStack driver
openstack = client.with_config(:driver => :openstack)

Work with the Ruby client

HTTP clients - cURL

Basically, you interact with the Deltacloud server via HTTP calls, so you can use any HTTP client to talk to Deltacloud using the Deltacloud REST API.

Get a list of all images available in the back-end cloud:

curl  --user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
"http://localhost:3001/api/images?format=xml"

The cURL --user option is used to specify the username:password credentials for access to the back-end cloud provider (Amazon EC2 in this case).

Create a new instance from the image with id 'ami-f51aff9c', in realm 'us-east-1c', with the hardware profile 'c1.medium', in firewall 'default':

curl -X POST -F "keyname=eftah" -F "image_id=ami-f51aff9c"
-F "realm_id=us-east-1c" -F "hwp_id=c1.medium" -F "firewalls1=default"
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
"http://localhost:3001/api/instances?format=xml"

Delete a firewall called 'develgroup':

curl -X DELETE
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/firewalls/develgroup?format=xml

Create a blob called 'my_new_blob' within the bucket 'mybucket' from a local file with HTTP PUT specifying its content type and setting some metadata key:value pairs:

curl -H 'content-type: text/html' -H 'X-Deltacloud-Blobmeta-Name:mariosblob'
-H 'X-Deltacloud-Blobmeta-Version:2.1' --upload-file
"/home/marios/Desktop/somefile.html"
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/buckets/mybucket/my_new_blob?format=xml

Retrieve blob metadata for the blob called 'my_new_blob':

curl -iv -X HEAD
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/buckets/mybucket/my_new_blob?format=xml

The '-iv' flags will ensure that cURL displays the request and response headers (blob metadata are reported in the response headers with an empty response body).

Working with cURL

Libdeltacloud Client (C library)

Libdeltacloud is a C/C++ library for accessing the Deltacloud API. It exports convenient structures and functions for manipulating cloud objects through the Deltacloud API.

Get the source code:

$ git clone git://git.fedorahosted.org/deltacloud/libdeltacloud.git

Libdeltacloud documentation
;T;@JI"/contact/;T{;{ ;I"�! Contact

Contact us!

We'd love to hear about your experiences with Deltacloud.

dev@deltacloud.apache.org is our mailing list where you can ask questions or see all the latest patches and development activity at the bleeding edge of the project.
The #deltacloud irc channel on Freenode is a place where the developers hang out and where you can usually get the fastest answers to your questions.

Please don't hesitate to get in touch if you have any questions about the project, if you've had any issues with installing or using Deltacloud or even just to tell us how great you think Deltacloud is!

Deltacloud Community Calls

For now we’re using an etherpad to keep track of the agenda. Feel free to add items there that you’d like to see addressed in future calls. Calls and agenda are announced on the dev@deltacloud.apache.org mailing list.

Past Calls:

Deltacloud Community Call #1

Working with Deltacloud API clients, Contributing patches, review process, etc

Deltacloud Community Call #2

Networking API discussion, Writing Deltacloud API tests

Deltacloud Community Call #3

Adding state to Deltacloud for the CIMI frontend - Datamapper

Deltacloud Community Call #4

Debugging deltacloud - how to chase a bug - common steps, debugging tools. Mailing list questions: i) ovirt and the User Level API, ii) Plans for CIMI back-end driver?

Deltacloud Community Call #5

How to file bug reports for Deltacloud - process, what to report, following up and CIMI resourceMetadata (implementation, why it is important?) - testing scenarios.

Deltacloud Community Call #7

The Deltacloud website - how it works, how to submit changes etc - Deltacloud exceptions and error handling introduction, how to catch provider errors and raise specific HTTP response codes.

Deltacloud Community Call #8

Deep dive into a Deltacloud API call, a look at the Deltacloud server gemspec - gems used as clients to cloud providers

;T; I"�

Contact us!

We'd love to hear about your experiences with Deltacloud.

dev@deltacloud.apache.org is our mailing list where you can ask questions or see all the latest patches and development activity at the bleeding edge of the project.
The #deltacloud irc channel on Freenode is a place where the developers hang out and where you can usually get the fastest answers to your questions.

Deltacloud Community Calls

We are trying to establish regular community calls - right now they are held weekly every Thursday - at @ 1700 CET (Prague, Brno, GMT+1) - which means 0800 PST (US West Coast, GMT-8) or 1100 EST (US East Coast, GMT-5). These calls are open to anyone that is interested in Deltacloud - please contact us if you'd like to join the next call. For now we're using an etherpad to keep track of the agenda. Feel free to add items there that you'd like to see addressed in future calls. Calls and agenda are announced on the dev@deltacloud.apache.org mailing list.

Past Calls:

Deltacloud Community Call #1 Working with Deltacloud API clients, Contributing patches, review process, etc
Deltacloud Community Call #2 Networking API discussion, Writing Deltacloud API tests
Deltacloud Community Call #3 Adding state to Deltacloud for the CIMI frontend - Datamapper
Deltacloud Community Call #4 Debugging deltacloud - how to chase a bug - common steps, debugging tools. Mailing list questions: i) ovirt and the User Level API, ii) Plans for CIMI back-end driver?
Deltacloud Community Call #5 How to file bug reports for Deltacloud - process, what to report, following up and CIMI resourceMetadata (implementation, why it is important?) - testing scenarios.
Deltacloud Community Call #7 The Deltacloud website - how it works, how to submit changes etc - Deltacloud exceptions and error handling introduction, how to catch provider errors and raise specific HTTP response codes.
Deltacloud Community Call #8 Deep dive into a Deltacloud API call, a look at the Deltacloud server gemspec - gems used as clients to cloud providers;T; I"9

Contact us!

We'd love to hear about your experiences with Deltacloud.

dev@deltacloud.apache.org is our mailing list where you can ask questions or see all the latest patches and development activity at the bleeding edge of the project.
The #deltacloud irc channel on Freenode is a place where the developers hang out and where you can usually get the fastest answers to your questions.

Deltacloud Community Calls

Past Calls:

Deltacloud Community Call #1

Working with Deltacloud API clients, Contributing patches, review process, etc

Deltacloud Community Call #2

Networking API discussion, Writing Deltacloud API tests

Deltacloud Community Call #3

Adding state to Deltacloud for the CIMI frontend - Datamapper

Deltacloud Community Call #4

Debugging deltacloud - how to chase a bug - common steps, debugging tools. Mailing list questions: i) ovirt and the User Level API, ii) Plans for CIMI back-end driver?

Deltacloud Community Call #5

How to file bug reports for Deltacloud - process, what to report, following up and CIMI resourceMetadata (implementation, why it is important?) - testing scenarios.

Deltacloud Community Call #7

The Deltacloud website - how it works, how to submit changes etc - Deltacloud exceptions and error handling introduction, how to catch provider errors and raise specific HTTP response codes.

Deltacloud Community Call #8

Deep dive into a Deltacloud API call, a look at the Deltacloud server gemspec - gems used as clients to cloud providers

;T;@PI"/curl-examples/;T{;{ ;I"�A Working with cURL

Working with cURL as a command line client

The cURL documentation is pretty comprehensive, but the following are some general points to remember for using cURL against Deltacloud. All the examples on this page assume the deltacloud server is running at localhost:3001:

Credentials are specified with --user "name:password"
Request headers are specified with -H "header: value" . For the "Accept" header Deltacloud offers a convenient way of specifying the desired response format; you can include the "?format=" parameter into the request URL rather than setting the Accept header
HTTP verbs are specified with -X VERB
The -i flag will show you the response headers and the -v flag will show you request and response headers as well as info about cURL activity:
```
curl -v -X DELETE --user "username:password" -H "Accept: application/xml" http://localhost:3001/api/keys/mykey
      
```

Working with instances

Display a complete list of instances in xml format:

 curl --user "user:pass" http://localhost:3001/api/instances?format=xml

Alternatively and if you prefer you can manually specify the Accept header:

 curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/api/instances

Launch an instance. Note that in this example parameters are specified as application/x-www-form-urlencoded through the use of the -d flag:

 curl -X POST --user "user:pass" -d "image_id=ami-84db39ed&hwp_id=m1.small&keyname=marios_key"  http://localhost:3001/api/instances?format=xml

Alternatively, you can use the -F flag to specify the parameters as multipart/form-data:

 curl -X POST --user "user:pass" -F "image_id=ami-84db39ed" -F "hwp_id=m1.small" -F "keyname=marios_key"  http://localhost:3001/api/instances?format=xml

Launch an instance action - reboot:

 curl -X POST --user "user:pass" http://localhost:3001/api/instances/reboot?format=xml

Run command on an instance (where available):

 curl -X POST --user "user:pass" -F "cmd=uname -a; ls -l" -F "private_key=`cat /location/of/ssh/keyfile`" http://localhost:3001/api/instances/i-d77cd0ac/run?format=xml

Working with images

Get the details of a specific image:

 curl --user "user:pass" http://localhost:3001/api/images/ami-3dc06a54?format=xml

Create an image from an existing instance (where available):

curl -X POST --user "user:pass" -d "instance_id=i-d77cd0ac&name=mariostestimage" http://localhost:3001/api/images?format=xml

Delete an image:

curl -X DELETE --user "user:pass" http://localhost:3001/api/images/ami-3dc06a54?format=xml

Working with hardware profiles

Get a list of all hardware profiles:

 curl --user "user:pass" http://localhost:3001/api/hardware_profiles?format=xml

Get the details of a specific hardware profile:

 curl --user "user:pass" http://localhost:3001/api/hardware_profiles/m2.4xlarge?format=xml

Working with realms

Get a list of all realms:

 curl --user "user:pass" http://localhost:3001/api/realms?format=xml

Get the details of a specific realm:

 curl --user "user:pass" http://localhost:3001/api/realms/us-east-1a?format=xml

Working with keys

Get a list of all keys:

 curl --user "user:pass" http://localhost:3001/api/keys?format=xml

Create a new key (where available):

 curl -X POST --user "user:pass" -d "name=mynewkey" http://localhost:3001/api/keys?format=xml

Import an existing key (where available):

 curl -X POST --user "user:pass" -F "name=mynewkey" -F "public_key=`cat /location/of/public/key/id_rsa.pub`" http://localhost:3001/api/keys?format=xml

Delete a key:

 curl -X DELETE --user "user:pass" http://localhost:3001/api/keys/mynewkey?format=xml

Working with firewalls

Get a list of all firewalls:

 curl -v --user "user:pass" http://localhost:3001/api/firewalls?format=xml

Create a new firewall:

 curl -v -X POST --user "user:pass" -d "name=my_new_firewall&description=a test firewall" http://localhost:3001/api/firewalls?format=xml

Create a new firewall rule - port 22 tcp, with one source firewall (group) and 2 IP addresses:

 curl -v -X POST --user "user:pass" -F "protocol=tcp" -F "port_from=22" -F "port_to=22" -F "group1=default" -F "group1owner=821108636519" -F "ip_address1=192.168.1.1/24" -F "ip_address2=65.128.31.27/32" http://localhost:3001/api/firewalls/my_new_firewall/rules

Delete a firewall rule:

 curl -v -X DELETE --user "user:pass" http://localhost:3001/api/firewalls/marios_test_firewall/821108636519~tcp~22~22~@group,821108636519,default,@address,ipv4,192.168.1.1,24,@address,ipv4,65.128.31.27,32?format=xml

Delete a firewall:

curl -v -X DELETE --user "user:pass" http://localhost:3001/api/firewalls/marios_test_firewall?format=xml

Working with addresses

Get a list of all addresses:

 curl -v --user "user:pass" http://localhost:3001/api/addresses?format=xml

Create a new address:

 curl -v --user "user:pass" -X POST http://localhost:3001/api/addresses?format=xml

Associate an address with an instance:

 curl -v -X POST --user "user:pass" -d "instance_id=i-d77cd0ac" http://localhost:3001/api/addresses/23.23.176.127/associate?format=xml

Disassociate an address from an instance:

curl -v -X POST --user "user:pass" http://localhost:3001/api/addresses/23.23.176.127/disassociate?format=xml

Delete an address:

curl -v -X DELETE --user "user:pass" http://localhost:3001/api/addresses/23.23.176.127?format=xml

Working with load balancers

Get a list of all load balancers:

 curl -v --user "user:pass" http://localhost:3001/api/load_balancers?format=xml

Create a load balancer:

 curl -v -X POST --user "user:pass" -d "name=webtraffic-balancer&realm_id=us-east-1c&listener_protocol=HTTP&
listener_balancer_port=80&listener_instance_port=3001" http://localhost:3001/api/load_balancers?format=xml

 curl -v -X POST --user "user:pass" -d "instance_id=i-4f06b52e" http://localhost:3001/api/load_balancers/webtraffic-balancer/register?format=xml

Unregister an instance from a load balancer:

 curl -v -X POST --user "user:pass" -d  "instance_id=i-4f06b52e" http://localhost:3001/api/load_balancers/webtraffic-balancer/unregister?format=xml

Delete a load balancer:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/load_balancers/web-traffic-balancer

Working with buckets

Get the details of a bucket:

curl -v --user "user:pass" http://localhost:3001/api/buckets/my_bucket?format=xml

Create a new bucket:

curl -v --user "user:pass" -X POST -d "name=shinynewbucket" http://localhost:3001/api/buckets?format=xml

Create a new blob, specifying a content-type and some metadata:

curl -v --user "user:pass" -H "content-type: image/jpg" -H 'X-Deltacloud-Blobmeta-Name:mariosblob' -H 'X-Deltacloud-Blobmeta-Author:me' --upload-file "/some/location/image.jpg" http://localhost:3001/api/buckets/shinynewbucket/newblob?format=xml

Note that the --upload-file parameter above causes cURL to issue a HTTP PUT

Get blob metadata:

 curl -v --user "user:pass" -X HEAD http://localhost:3001/api/buckets/shinynewbucket/newblob

Note that blob metadata is returned in the HTTP response headers. So the use of the -v flag is important here or you will not see the metadata.

Update blob metadata:

curl -v --user "user:pass" -X POST -H 'X-Deltacloud-Blobmeta-Name:mariosblobV2' -H 'X-Deltacloud-Blobmeta-Version:v2.1.1'  http://localhost:3001/api/buckets/shinynewbucket/newblob?format=xml

Delete a blob:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/buckets/shinynewbucket/newblob?format=xml

Delete a bucket:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/bucket/shinynewbucket

Working with storage volumes

Get a list of all storage volumes:

curl -v --user "user:pass" http://localhost:3001/api/storage_volumes?format=xml

Create a new storage volume:

curl -v --user "user:pass" -X POST -d "capacity=10&realm_id=us-east-1c" http://localhost:3001/api/storage_volumes?format=xml

Attach a volume to a running instance:

curl -v --user "user:pass" -X POST -d "instance_id=i-b100b3d0&device=/dev/sdi" http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach?format=xml

Detach a volume (from whichever instance it is connected to):

curl -v --user "user:pass" -X POST  http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach?format=xml

Delete a storage volume:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/storage_volumes/vol-0bc0de60?format=xml

Working with storage snapshots

Get details about a specific storage snapshot:

curl -v --user "user:pass" http://localhost:3001/api/storage_snapshots/snap-45b8d024?format=xml

Create a new storage snapshot:

curl -v --user "user:pass" -X POST -d "volume_id=vol-99fbe5f2" http://localhost:3001/api/storage_snapshots?format=xml

Delete a storage snapshot:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/storage_snapshots/snap-dda6cebc?format=xml

;T; I"�+

Working with cURL as a command line client

Credentials are specified with --user "name:password"
Request headers are specified with -H "header: value" . For the "Accept" header Deltacloud offers a convenient way of specifying the desired response format; you can include the "?format=" parameter into the request URL rather than setting the Accept header
HTTP verbs are specified with -X VERB
The -i flag will show you the response headers and the -v flag will show you request and response headers as well as info about cURL activity:
```
curl -v -X DELETE --user "username:password" -H "Accept: application/xml" http://localhost:3001/api/keys/mykey
      
```

Working with instances

Display a complete list of instances in xml format:

 curl --user "user:pass" http://localhost:3001/api/instances?format=xml

Alternatively and if you prefer you can manually specify the Accept header:

 curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/api/instances

Launch an instance. Note that in this example parameters are specified as application/x-www-form-urlencoded through the use of the -d flag:

 curl -X POST --user "user:pass" -d "image_id=ami-84db39ed&hwp_id=m1.small&keyname=marios_key"  http://localhost:3001/api/instances?format=xml

Alternatively, you can use the -F flag to specify the parameters as multipart/form-data:

 curl -X POST --user "user:pass" -F "image_id=ami-84db39ed" -F "hwp_id=m1.small" -F "keyname=marios_key"  http://localhost:3001/api/instances?format=xml

Launch an instance action - reboot:

 curl -X POST --user "user:pass" http://localhost:3001/api/instances/reboot?format=xml

Run command on an instance (where available):

 curl -X POST --user "user:pass" -F "cmd=uname -a; ls -l" -F "private_key=`cat /location/of/ssh/keyfile`" http://localhost:3001/api/instances/i-d77cd0ac/run?format=xml

Working with images

Get the details of a specific image:

 curl --user "user:pass" http://localhost:3001/api/images/ami-3dc06a54?format=xml

Create an image from an existing instance (where available):

curl -X POST --user "user:pass" -d "instance_id=i-d77cd0ac&name=mariostestimage" http://localhost:3001/api/images?format=xml

Delete an image:

curl -X DELETE --user "user:pass" http://localhost:3001/api/images/ami-3dc06a54?format=xml

Working with hardware profiles

Get a list of all hardware profiles:

 curl --user "user:pass" http://localhost:3001/api/hardware_profiles?format=xml

Get the details of a specific hardware profile:

 curl --user "user:pass" http://localhost:3001/api/hardware_profiles/m2.4xlarge?format=xml

Working with realms

Get a list of all realms:

 curl --user "user:pass" http://localhost:3001/api/realms?format=xml

Get the details of a specific realm:

 curl --user "user:pass" http://localhost:3001/api/realms/us-east-1a?format=xml

Working with keys

Get a list of all keys:

 curl --user "user:pass" http://localhost:3001/api/keys?format=xml

Create a new key (where available):

 curl -X POST --user "user:pass" -d "name=mynewkey" http://localhost:3001/api/keys?format=xml

Import an existing key (where available):

 curl -X POST --user "user:pass" -F "name=mynewkey" -F "public_key=`cat /location/of/public/key/id_rsa.pub`" http://localhost:3001/api/keys?format=xml

Delete a key:

 curl -X DELETE --user "user:pass" http://localhost:3001/api/keys/mynewkey?format=xml

Working with firewalls

Get a list of all firewalls:

 curl -v --user "user:pass" http://localhost:3001/api/firewalls?format=xml

Create a new firewall:

 curl -v -X POST --user "user:pass" -d "name=my_new_firewall&description=a test firewall" http://localhost:3001/api/firewalls?format=xml

Create a new firewall rule - port 22 tcp, with one source firewall (group) and 2 IP addresses:

 curl -v -X POST --user "user:pass" -F "protocol=tcp" -F "port_from=22" -F "port_to=22" -F "group1=default" -F "group1owner=821108636519" -F "ip_address1=192.168.1.1/24" -F "ip_address2=65.128.31.27/32" http://localhost:3001/api/firewalls/my_new_firewall/rules

Delete a firewall rule:

 curl -v -X DELETE --user "user:pass" http://localhost:3001/api/firewalls/marios_test_firewall/821108636519~tcp~22~22~@group,821108636519,default,@address,ipv4,192.168.1.1,24,@address,ipv4,65.128.31.27,32?format=xml

Delete a firewall:

curl -v -X DELETE --user "user:pass" http://localhost:3001/api/firewalls/marios_test_firewall?format=xml

Working with addresses

Get a list of all addresses:

 curl -v --user "user:pass" http://localhost:3001/api/addresses?format=xml

Create a new address:

 curl -v --user "user:pass" -X POST http://localhost:3001/api/addresses?format=xml

Associate an address with an instance:

 curl -v -X POST --user "user:pass" -d "instance_id=i-d77cd0ac" http://localhost:3001/api/addresses/23.23.176.127/associate?format=xml

Disassociate an address from an instance:

curl -v -X POST --user "user:pass" http://localhost:3001/api/addresses/23.23.176.127/disassociate?format=xml

Delete an address:

curl -v -X DELETE --user "user:pass" http://localhost:3001/api/addresses/23.23.176.127?format=xml

Working with load balancers

Get a list of all load balancers:

 curl -v --user "user:pass" http://localhost:3001/api/load_balancers?format=xml

Create a load balancer:

 curl -v -X POST --user "user:pass" -d "name=webtraffic-balancer&realm_id=us-east-1c&listener_protocol=HTTP&
listener_balancer_port=80&listener_instance_port=3001" http://localhost:3001/api/load_balancers?format=xml

 curl -v -X POST --user "user:pass" -d "instance_id=i-4f06b52e" http://localhost:3001/api/load_balancers/webtraffic-balancer/register?format=xml

Unregister an instance from a load balancer:

 curl -v -X POST --user "user:pass" -d  "instance_id=i-4f06b52e" http://localhost:3001/api/load_balancers/webtraffic-balancer/unregister?format=xml

Delete a load balancer:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/load_balancers/web-traffic-balancer

Working with buckets

Get the details of a bucket:

curl -v --user "user:pass" http://localhost:3001/api/buckets/my_bucket?format=xml

Create a new bucket:

curl -v --user "user:pass" -X POST -d "name=shinynewbucket" http://localhost:3001/api/buckets?format=xml

Create a new blob, specifying a content-type and some metadata:

curl -v --user "user:pass" -H "content-type: image/jpg" -H 'X-Deltacloud-Blobmeta-Name:mariosblob' -H 'X-Deltacloud-Blobmeta-Author:me' --upload-file "/some/location/image.jpg" http://localhost:3001/api/buckets/shinynewbucket/newblob?format=xml

Note that the --upload-file parameter above causes cURL to issue a HTTP PUT

Get blob metadata:

 curl -v --user "user:pass" -X HEAD http://localhost:3001/api/buckets/shinynewbucket/newblob

Note that blob metadata is returned in the HTTP response headers. So the use of the -v flag is important here or you will not see the metadata.

Update blob metadata:

curl -v --user "user:pass" -X POST -H 'X-Deltacloud-Blobmeta-Name:mariosblobV2' -H 'X-Deltacloud-Blobmeta-Version:v2.1.1'  http://localhost:3001/api/buckets/shinynewbucket/newblob?format=xml

Delete a blob:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/buckets/shinynewbucket/newblob?format=xml

Delete a bucket:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/bucket/shinynewbucket

Working with storage volumes

Get a list of all storage volumes:

curl -v --user "user:pass" http://localhost:3001/api/storage_volumes?format=xml

Create a new storage volume:

curl -v --user "user:pass" -X POST -d "capacity=10&realm_id=us-east-1c" http://localhost:3001/api/storage_volumes?format=xml

Attach a volume to a running instance:

curl -v --user "user:pass" -X POST -d "instance_id=i-b100b3d0&device=/dev/sdi" http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach?format=xml

Detach a volume (from whichever instance it is connected to):

curl -v --user "user:pass" -X POST  http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach?format=xml

Delete a storage volume:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/storage_volumes/vol-0bc0de60?format=xml

Working with storage snapshots

Get details about a specific storage snapshot:

curl -v --user "user:pass" http://localhost:3001/api/storage_snapshots/snap-45b8d024?format=xml

Create a new storage snapshot:

curl -v --user "user:pass" -X POST -d "volume_id=vol-99fbe5f2" http://localhost:3001/api/storage_snapshots?format=xml

Delete a storage snapshot:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/storage_snapshots/snap-dda6cebc?format=xml

;T; I",

Working with cURL as a command line client

Credentials are specified with --user "name:password"
Request headers are specified with -H "header: value" . For the "Accept" header Deltacloud offers a convenient way of specifying the desired response format; you can include the "?format=" parameter into the request URL rather than setting the Accept header
HTTP verbs are specified with -X VERB
The -i flag will show you the response headers and the -v flag will show you request and response headers as well as info about cURL activity:
```
curl -v -X DELETE --user "username:password" -H "Accept: application/xml" http://localhost:3001/api/keys/mykey
      
```

Working with instances

Display a complete list of instances in xml format:

 curl --user "user:pass" http://localhost:3001/api/instances?format=xml

Alternatively and if you prefer you can manually specify the Accept header:

 curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/api/instances

Launch an instance. Note that in this example parameters are specified as application/x-www-form-urlencoded through the use of the -d flag:

 curl -X POST --user "user:pass" -d "image_id=ami-84db39ed&hwp_id=m1.small&keyname=marios_key"  http://localhost:3001/api/instances?format=xml

Alternatively, you can use the -F flag to specify the parameters as multipart/form-data:

 curl -X POST --user "user:pass" -F "image_id=ami-84db39ed" -F "hwp_id=m1.small" -F "keyname=marios_key"  http://localhost:3001/api/instances?format=xml

Launch an instance action - reboot:

 curl -X POST --user "user:pass" http://localhost:3001/api/instances/reboot?format=xml

Run command on an instance (where available):

 curl -X POST --user "user:pass" -F "cmd=uname -a; ls -l" -F "private_key=`cat /location/of/ssh/keyfile`" http://localhost:3001/api/instances/i-d77cd0ac/run?format=xml

Working with images

Get the details of a specific image:

 curl --user "user:pass" http://localhost:3001/api/images/ami-3dc06a54?format=xml

Create an image from an existing instance (where available):

curl -X POST --user "user:pass" -d "instance_id=i-d77cd0ac&name=mariostestimage" http://localhost:3001/api/images?format=xml

Delete an image:

curl -X DELETE --user "user:pass" http://localhost:3001/api/images/ami-3dc06a54?format=xml

Working with hardware profiles

Get a list of all hardware profiles:

 curl --user "user:pass" http://localhost:3001/api/hardware_profiles?format=xml

Get the details of a specific hardware profile:

 curl --user "user:pass" http://localhost:3001/api/hardware_profiles/m2.4xlarge?format=xml

Working with realms

Get a list of all realms:

 curl --user "user:pass" http://localhost:3001/api/realms?format=xml

Get the details of a specific realm:

 curl --user "user:pass" http://localhost:3001/api/realms/us-east-1a?format=xml

Working with keys

Get a list of all keys:

 curl --user "user:pass" http://localhost:3001/api/keys?format=xml

Create a new key (where available):

 curl -X POST --user "user:pass" -d "name=mynewkey" http://localhost:3001/api/keys?format=xml

Import an existing key (where available):

 curl -X POST --user "user:pass" -F "name=mynewkey" -F "public_key=`cat /location/of/public/key/id_rsa.pub`" http://localhost:3001/api/keys?format=xml

Delete a key:

 curl -X DELETE --user "user:pass" http://localhost:3001/api/keys/mynewkey?format=xml

Working with firewalls

Get a list of all firewalls:

 curl -v --user "user:pass" http://localhost:3001/api/firewalls?format=xml

Create a new firewall:

 curl -v -X POST --user "user:pass" -d "name=my_new_firewall&description=a test firewall" http://localhost:3001/api/firewalls?format=xml

Create a new firewall rule - port 22 tcp, with one source firewall (group) and 2 IP addresses:

 curl -v -X POST --user "user:pass" -F "protocol=tcp" -F "port_from=22" -F "port_to=22" -F "group1=default" -F "group1owner=821108636519" -F "ip_address1=192.168.1.1/24" -F "ip_address2=65.128.31.27/32" http://localhost:3001/api/firewalls/my_new_firewall/rules

Delete a firewall rule:

 curl -v -X DELETE --user "user:pass" http://localhost:3001/api/firewalls/marios_test_firewall/821108636519~tcp~22~22~@group,821108636519,default,@address,ipv4,192.168.1.1,24,@address,ipv4,65.128.31.27,32?format=xml

Delete a firewall:

curl -v -X DELETE --user "user:pass" http://localhost:3001/api/firewalls/marios_test_firewall?format=xml

Working with addresses

Get a list of all addresses:

 curl -v --user "user:pass" http://localhost:3001/api/addresses?format=xml

Create a new address:

 curl -v --user "user:pass" -X POST http://localhost:3001/api/addresses?format=xml

Associate an address with an instance:

 curl -v -X POST --user "user:pass" -d "instance_id=i-d77cd0ac" http://localhost:3001/api/addresses/23.23.176.127/associate?format=xml

Disassociate an address from an instance:

curl -v -X POST --user "user:pass" http://localhost:3001/api/addresses/23.23.176.127/disassociate?format=xml

Delete an address:

curl -v -X DELETE --user "user:pass" http://localhost:3001/api/addresses/23.23.176.127?format=xml

Working with load balancers

Get a list of all load balancers:

 curl -v --user "user:pass" http://localhost:3001/api/load_balancers?format=xml

Create a load balancer:

 curl -v -X POST --user "user:pass" -d "name=webtraffic-balancer&realm_id=us-east-1c&listener_protocol=HTTP&
listener_balancer_port=80&listener_instance_port=3001" http://localhost:3001/api/load_balancers?format=xml

 curl -v -X POST --user "user:pass" -d "instance_id=i-4f06b52e" http://localhost:3001/api/load_balancers/webtraffic-balancer/register?format=xml

Unregister an instance from a load balancer:

 curl -v -X POST --user "user:pass" -d  "instance_id=i-4f06b52e" http://localhost:3001/api/load_balancers/webtraffic-balancer/unregister?format=xml

Delete a load balancer:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/load_balancers/web-traffic-balancer

Working with buckets

Get the details of a bucket:

curl -v --user "user:pass" http://localhost:3001/api/buckets/my_bucket?format=xml

Create a new bucket:

curl -v --user "user:pass" -X POST -d "name=shinynewbucket" http://localhost:3001/api/buckets?format=xml

Create a new blob, specifying a content-type and some metadata:

curl -v --user "user:pass" -H "content-type: image/jpg" -H 'X-Deltacloud-Blobmeta-Name:mariosblob' -H 'X-Deltacloud-Blobmeta-Author:me' --upload-file "/some/location/image.jpg" http://localhost:3001/api/buckets/shinynewbucket/newblob?format=xml

Note that the --upload-file parameter above causes cURL to issue a HTTP PUT

Get blob metadata:

 curl -v --user "user:pass" -X HEAD http://localhost:3001/api/buckets/shinynewbucket/newblob

Note that blob metadata is returned in the HTTP response headers. So the use of the -v flag is important here or you will not see the metadata.

Update blob metadata:

curl -v --user "user:pass" -X POST -H 'X-Deltacloud-Blobmeta-Name:mariosblobV2' -H 'X-Deltacloud-Blobmeta-Version:v2.1.1'  http://localhost:3001/api/buckets/shinynewbucket/newblob?format=xml

Delete a blob:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/buckets/shinynewbucket/newblob?format=xml

Delete a bucket:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/bucket/shinynewbucket

Working with storage volumes

Get a list of all storage volumes:

curl -v --user "user:pass" http://localhost:3001/api/storage_volumes?format=xml

Create a new storage volume:

curl -v --user "user:pass" -X POST -d "capacity=10&realm_id=us-east-1c" http://localhost:3001/api/storage_volumes?format=xml

Attach a volume to a running instance:

curl -v --user "user:pass" -X POST -d "instance_id=i-b100b3d0&device=/dev/sdi" http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach?format=xml

Detach a volume (from whichever instance it is connected to):

curl -v --user "user:pass" -X POST  http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach?format=xml

Delete a storage volume:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/storage_volumes/vol-0bc0de60?format=xml

Working with storage snapshots

Get details about a specific storage snapshot:

curl -v --user "user:pass" http://localhost:3001/api/storage_snapshots/snap-45b8d024?format=xml

Create a new storage snapshot:

curl -v --user "user:pass" -X POST -d "volume_id=vol-99fbe5f2" http://localhost:3001/api/storage_snapshots?format=xml

Delete a storage snapshot:

curl -v --user "user:pass" -X DELETE http://localhost:3001/api/storage_snapshots/snap-dda6cebc?format=xml

;T;@VI"/send-patch/;T{;{ ;I"�/ Send a Patch

Formatting and sending patches

The Deltacloud community works with Git. The process of contributing to the project we prefer contains these steps: local_branch → patch → review → accept → commit process for contributing to the project. This is how the typical workflow used by the core developers looks like:

Set the following settings inside the git configuration file. The config file is located in the root of the Deltacloud project in a hidden .git directory. Open the config file with your preferred editor:
```
$ vim deltacloud/.git/config
```
Add the following information to the configuration file and replace the relevant values with your own ones:
```
[sendemail]
signedoffbycc = no
chainreplyto = no
smtpserver = your_smpt.server.address
thread = yes
from = your_email_address
suppresscc = all
to = dev@deltacloud.apache.org

[core]
whitespace = trailing-space,space-before-tab

[apply]
whitespace = error-all
```
Get the latest HEAD of the Deltacloud git repo. You will gain one local branch called master:
```
$ git branch
* master
```
Fetch the latest changes from the git repo:
```
$ git pull
```
Create a new local branch for your edits and give it a name:
```
$ git checkout -b my_new_branch
```
Make your changes and then check, what you've edited:
```
$ git status
```
Commit these changes to your local branch:
```
$ git commit -a
```
This will open an editor (e.g. vi). Enter a commit message. The message should be short and succinct and individual lines shouldn't be longer than 80 characters. See the recent commits with their commit messages to find an inspiration:
```
$ git log
```
When you commit your changes to your local branch, the local branch will be different from your local master branch. Other developers may have already committed their changes to the remote master branch in the Apache git repo in the meantime. Thus, you need to fetch any new changes and merge them into your local master.
Change to master and fetch upstream changes (it there are any):
```
$ git checkout master
$ git pull
```
Your local master is now up-to-date with the remote master in the git repo.
Rebase the local master onto the branch containing your changes:
```
$ git rebase master my_new_branch
```
This allows you to make patches against master and send them to the Deltacloud mailing list.
```
$ git format-patch -o /path/to/where/you/keep/patches/ master
$ git send-email --compose --subject 'some subject'
  --thread /path/to/where/you/keep/patches/*
```
The other members of the community will review your patches. The patch has to receive at least one ACK and no NACK to be approved. Then the patch will be committed by one of the Deltacloud developers with commit rights to the Apache repo. If noone is responding to your patch sent to mailing list, feel free to remind yourself after few days.

You can also contribute to the project by reviewing patches sent by other contributors:

Make a new branch where you will apply the patches and test:
```
$ git checkout -b jsmith_patches
```
Save the patches to a known location and make sure you're on the right branch . Then apply.
```
$ git checkout jsmith_patches

$ cat /path/to/patches/0001-name-of-patch.txt | git apply
```
or
```
$ git am /path/to/patches/0001-name-of-patch.eml
```
You can use git am ("apply mail") to apply patches in mail format, or git apply for plain-text patches. If you use git apply, you will only apply the patches, whereas git am will also commit the patches to the local branch (preserving the author's commit messages). However, the difference between git am and git apply is insignificant for the purpose of reviewing patches. It depends on whether you want to save the patches as plain-text or in .mbox email format.
If you think the patches are working correctly, send an ACK to the Deltacloud mailing list. Similarly, if you think the patches could cause a problem, send a NACK and explain the issue you have found.

Test the patch Back

;T; I"a

Formatting and sending patches

Set the following settings inside the git configuration file. The config file is located in the root of the Deltacloud project in a hidden .git directory. Open the config file with your preferred editor:
```
$ vim deltacloud/.git/config
```
Add the following information to the configuration file and replace the relevant values with your own ones:
```
[sendemail]
signedoffbycc = no
chainreplyto = no
smtpserver = your_smpt.server.address
thread = yes
from = your_email_address
suppresscc = all
to = dev@deltacloud.apache.org

[core]
whitespace = trailing-space,space-before-tab

[apply]
whitespace = error-all
```
Get the latest HEAD of the Deltacloud git repo. You will gain one local branch called master:
```
$ git branch
* master
```
Fetch the latest changes from the git repo:
```
$ git pull
```
Create a new local branch for your edits and give it a name:
```
$ git checkout -b my_new_branch
```
Make your changes and then check, what you've edited:
```
$ git status
```
Commit these changes to your local branch:
```
$ git commit -a
```
This will open an editor (e.g. vi). Enter a commit message. The message should be short and succinct and individual lines shouldn't be longer than 80 characters. See the recent commits with their commit messages to find an inspiration:
```
$ git log
```
When you commit your changes to your local branch, the local branch will be different from your local master branch. Other developers may have already committed their changes to the remote master branch in the Apache git repo in the meantime. Thus, you need to fetch any new changes and merge them into your local master.
Change to master and fetch upstream changes (it there are any):
```
$ git checkout master
$ git pull
```
Your local master is now up-to-date with the remote master in the git repo.
Rebase the local master onto the branch containing your changes:
```
$ git rebase master my_new_branch
```
This allows you to make patches against master and send them to the Deltacloud mailing list.
```
$ git format-patch -o /path/to/where/you/keep/patches/ master
$ git send-email --compose --subject 'some subject'
  --thread /path/to/where/you/keep/patches/*
```
The other members of the community will review your patches. The patch has to receive at least one ACK and no NACK to be approved. Then the patch will be committed by one of the Deltacloud developers with commit rights to the Apache repo. If noone is responding to your patch sent to mailing list, feel free to remind yourself after few days.

You can also contribute to the project by reviewing patches sent by other contributors:

Make a new branch where you will apply the patches and test:
```
$ git checkout -b jsmith_patches
```
Save the patches to a known location and make sure you're on the right branch . Then apply.
```
$ git checkout jsmith_patches

$ cat /path/to/patches/0001-name-of-patch.txt | git apply
```
or
```
$ git am /path/to/patches/0001-name-of-patch.eml
```
You can use git am ("apply mail") to apply patches in mail format, or git apply for plain-text patches. If you use git apply, you will only apply the patches, whereas git am will also commit the patches to the local branch (preserving the author's commit messages). However, the difference between git am and git apply is insignificant for the purpose of reviewing patches. It depends on whether you want to save the patches as plain-text or in .mbox email format.
If you think the patches are working correctly, send an ACK to the Deltacloud mailing list. Similarly, if you think the patches could cause a problem, send a NACK and explain the issue you have found.

Test the patch Back

;T; I"Y

Formatting and sending patches

Set the following settings inside the git configuration file. The config file is located in the root of the Deltacloud project in a hidden .git directory. Open the config file with your preferred editor:
```
$ vim deltacloud/.git/config
```
Add the following information to the configuration file and replace the relevant values with your own ones:
```
[sendemail]
signedoffbycc = no
chainreplyto = no
smtpserver = your_smpt.server.address
thread = yes
from = your_email_address
suppresscc = all
to = dev@deltacloud.apache.org

[core]
whitespace = trailing-space,space-before-tab

[apply]
whitespace = error-all
```
Get the latest HEAD of the Deltacloud git repo. You will gain one local branch called master:
```
$ git branch
* master
```
Fetch the latest changes from the git repo:
```
$ git pull
```
Create a new local branch for your edits and give it a name:
```
$ git checkout -b my_new_branch
```
Make your changes and then check, what you've edited:
```
$ git status
```
Commit these changes to your local branch:
```
$ git commit -a
```
This will open an editor (e.g. vi). Enter a commit message. The message should be short and succinct and individual lines shouldn't be longer than 80 characters. See the recent commits with their commit messages to find an inspiration:
```
$ git log
```
When you commit your changes to your local branch, the local branch will be different from your local master branch. Other developers may have already committed their changes to the remote master branch in the Apache git repo in the meantime. Thus, you need to fetch any new changes and merge them into your local master.
Change to master and fetch upstream changes (it there are any):
```
$ git checkout master
$ git pull
```
Your local master is now up-to-date with the remote master in the git repo.
Rebase the local master onto the branch containing your changes:
```
$ git rebase master my_new_branch
```
This allows you to make patches against master and send them to the Deltacloud mailing list.
```
$ git format-patch -o /path/to/where/you/keep/patches/ master
$ git send-email --compose --subject 'some subject'
  --thread /path/to/where/you/keep/patches/*
```
The other members of the community will review your patches. The patch has to receive at least one ACK and no NACK to be approved. Then the patch will be committed by one of the Deltacloud developers with commit rights to the Apache repo. If noone is responding to your patch sent to mailing list, feel free to remind yourself after few days.

You can also contribute to the project by reviewing patches sent by other contributors:

Make a new branch where you will apply the patches and test:
```
$ git checkout -b jsmith_patches
```
Save the patches to a known location and make sure you're on the right branch . Then apply.
```
$ git checkout jsmith_patches

$ cat /path/to/patches/0001-name-of-patch.txt | git apply
```
or
```
$ git am /path/to/patches/0001-name-of-patch.eml
```
You can use git am ("apply mail") to apply patches in mail format, or git apply for plain-text patches. If you use git apply, you will only apply the patches, whereas git am will also commit the patches to the local branch (preserving the author's commit messages). However, the difference between git am and git apply is insignificant for the purpose of reviewing patches. It depends on whether you want to save the patches as plain-text or in .mbox email format.
If you think the patches are working correctly, send an ACK to the Deltacloud mailing list. Similarly, if you think the patches could cause a problem, send a NACK and explain the issue you have found.

Test the patch Back

;T;@\I"/command-tools/;T{;{ ;I"�# Command Line Tools

deltacloudc is being deprecated

The deltacloud core developers use (almost exclusively) cURL as a command line client for working with a deltacloud server. You can find more information on working with cURL against deltacloud here.

/deprecated:

Using Deltacloud command tool

Installing the Deltacloud Ruby client also gives you the deltacloudc command line tool. This executable uses the Deltacloud client library to speak to the Deltacloud server through the Deltacloud REST API. This means that you can control your cloud infrastructure from the command line. The general usage pattern for deltacloudc is:

$ deltacloudc collection operation [options]

Collection: refers to the Deltacloud object collections, such as Instances, Images, Buckets, Realms etc., as described in a greater detail in the Deltacloud REST API documentation.
Operation: is collection dependant. All collections respond to 'index' and 'show' operations (retrieve details on all objects in a given collection or on a specific object). Some collections respond to 'create' and 'destroy' operations. The collection of instances (realized virtual servers) responds to operations for managing the instance lifecycle, such as 'stop' or 'reboot'.
Options: are listed by invoking deltacloudc -h. The important option is -u, which specifies the API_URL, where the Deltacloud server is running. The API_URL takes the form of http://[user]:[password]@[api_url]:[port]/[api]. Alternatively, you can set the API_URL environment variable (e.g., export API_URL=http://mockuser:mockpassword@localhost:3001/api). If your username or your password contains special characters, it's necessary to use options -U and -P in addition to the option -u. Check the list of credentials you need for each back-end cloud provider.

The following examples assume that the Deltacloud server is running on your local machine port 3001 (the deltacloudd server daemon defaults to 'localhost:3001') and that it was started with the 'mock' provider (i.e. deltacloudd -i mock ).

List all collections available in the current driver:

$ deltacloudc -l -u http://mockuser:mockpassword@localhost:3001/api

Get a list of all images:

$ deltacloudc images index -u http://mockuser:mockpassword@localhost:3001/api

List all operations for the buckets collection:

$ deltacloudc buckets -l -u http://mockuser:mockpassword@localhost:3001/api

Create a new blob in the bucket called 'bucket1':

$ deltacloudc blob create -i 'my_new_blob' -b 'bucket1' -f /home/marios/file.txt

;T; I"�

deltacloudc is being deprecated

The deltacloudc command line tool is being deprecated. For now the code making up deltacloudc has been moved to the /deltacloud/clients/console directory but will ultimately be removed from the repo. If the command line client is important to you then please let us know. A new command line client may be put onto the roadmap if there is demand for one. The deltacloud core developers use (almost exclusively) cURL as a command line client for working with a deltacloud server. You can find more information on working with cURL against deltacloud here.

/deprecated:

Using Deltacloud command tool

$ deltacloudc collection operation [options]

Collection: refers to the Deltacloud object collections, such as Instances, Images, Buckets, Realms etc., as described in a greater detail in the Deltacloud REST API documentation.
Operation: is collection dependant. All collections respond to 'index' and 'show' operations (retrieve details on all objects in a given collection or on a specific object). Some collections respond to 'create' and 'destroy' operations. The collection of instances (realized virtual servers) responds to operations for managing the instance lifecycle, such as 'stop' or 'reboot'.
Options: are listed by invoking deltacloudc -h. The important option is -u, which specifies the API_URL, where the Deltacloud server is running. The API_URL takes the form of http://[user]:[password]@[api_url]:[port]/[api]. Alternatively, you can set the API_URL environment variable (e.g., export API_URL=http://mockuser:mockpassword@localhost:3001/api). If your username or your password contains special characters, it's necessary to use options -U and -P in addition to the option -u. Check the list of credentials you need for each back-end cloud provider.

List all collections available in the current driver:

$ deltacloudc -l -u http://mockuser:mockpassword@localhost:3001/api

Get a list of all images:

$ deltacloudc images index -u http://mockuser:mockpassword@localhost:3001/api

List all operations for the buckets collection:

$ deltacloudc buckets -l -u http://mockuser:mockpassword@localhost:3001/api

Create a new blob in the bucket called 'bucket1':

$ deltacloudc blob create -i 'my_new_blob' -b 'bucket1' -f /home/marios/file.txt

;T; I"

deltacloudc is being deprecated

The deltacloud core developers use (almost exclusively) cURL as a command line client for working with a deltacloud server. You can find more information on working with cURL against deltacloud here.

/deprecated:

Using Deltacloud command tool

$ deltacloudc collection operation [options]

Collection: refers to the Deltacloud object collections, such as Instances, Images, Buckets, Realms etc., as described in a greater detail in the Deltacloud REST API documentation.
Operation: is collection dependant. All collections respond to 'index' and 'show' operations (retrieve details on all objects in a given collection or on a specific object). Some collections respond to 'create' and 'destroy' operations. The collection of instances (realized virtual servers) responds to operations for managing the instance lifecycle, such as 'stop' or 'reboot'.
Options: are listed by invoking deltacloudc -h. The important option is -u, which specifies the API_URL, where the Deltacloud server is running. The API_URL takes the form of http://[user]:[password]@[api_url]:[port]/[api]. Alternatively, you can set the API_URL environment variable (e.g., export API_URL=http://mockuser:mockpassword@localhost:3001/api). If your username or your password contains special characters, it's necessary to use options -U and -P in addition to the option -u. Check the list of credentials you need for each back-end cloud provider.

List all collections available in the current driver:

$ deltacloudc -l -u http://mockuser:mockpassword@localhost:3001/api

Get a list of all images:

$ deltacloudc images index -u http://mockuser:mockpassword@localhost:3001/api

List all operations for the buckets collection:

$ deltacloudc buckets -l -u http://mockuser:mockpassword@localhost:3001/api

Create a new blob in the bucket called 'bucket1':

$ deltacloudc blob create -i 'my_new_blob' -b 'bucket1' -f /home/marios/file.txt

;T;@bI"/use-the-api/;T{;{ ;I"} Use the API

;T; I";F; I";F;@hI"/clients/;T{;{ ;I"y Clients

;T; I";F; I";F;@nI"/supported-providers/;T{;{ ;I"#D Supported Providers

Driver functionality and Credentials

Compute Driver Functionality

	Create new instances	Start stopped instances	Stop running instances	Reboot running instances	Destroy instances	List all/get details about hardware profiles	List all/get details about realms	List all/get details about images	List all/get details about instances
Amazon EC2	yes	no	yes	yes	yes	yes	yes	yes	yes
Eucalyptus	yes	no	yes	yes	yes	yes	yes	yes	yes
IBM SmartCloud	yes	yes	yes	yes	yes	yes	yes	yes	yes
GoGrid	yes	no	yes	yes	yes	yes	yes	yes	yes
OpenNebula	yes	yes	yes	yes	yes	yes	yes	yes	yes
Rackspace	yes	no	yes	yes	yes	yes	yes	yes	yes
RHEV-M	yes	yes	yes	no	yes	yes	yes	yes	yes
RimuHosting	yes	yes	yes	yes	yes	yes	yes	yes	yes
Terremark	yes	yes	yes	yes	yes	yes	yes	yes	yes
vSphere	yes	yes	yes	yes	yes	yes	yes	yes	yes
OpenStack	yes	yes	yes	yes	yes	yes	yes	yes	yes
FGCP	yes	yes	yes	no	yes	yes	yes	yes	yes
Aruba cloud.it	yes	yes	yes	yes	yes	yes	yes	yes	yes

Storage Driver Functionality

	Create new buckets	Update/delete buckets	Create new blobs	Update/delete blobs	Read/write blob attributes	Read/write individual blob attributes
Amazon S3	yes	yes	yes	yes	yes	yes
Eucalyptus Walrus	yes	yes	yes	yes	yes	yes
Rackspace CloudFiles	yes	yes	yes	yes	yes	yes
Microsoft Azure	yes	yes	yes	yes	yes	yes
Google Storage	yes	yes	yes	yes	yes	yes

Cloud provider credentials

Cloud	Driver	Username	Password	Notes
mock	mock	mockuser	mockpassword	The mock driver doesn't talk to any cloud; it just pretends to be a cloud.
Amazon EC2/S3	ec2	Access Key ID	Secret Access Key	This information can be found on the Security Credentials page in your AWS account.
Eucalyptus	eucalyptus	Access Key ID	Secret Access Key
GoGrid	gogrid	API Key	Shared Secret	Go to My Account > API Keys for your account and click on the key you want to use to find the shared secret.
IBM SmartCloud	sbc	Username	Password
Microsoft Azure (Storage Account only)	azure	Public Storage Account Name	Primary Access Key	The Storage Account Name is chosen when you create the service (e.g. name in http://name.blob.core.windows.net/). This and the access key are available from the service control panel.
OpenNebula	opennebula	OpenNebula user	OpenNebula password	Set the environment variable OCCI_URL to the address on which OpenNebula's OCCI server is listening.
Rackspace Cloud Servers/Cloud Files	rackspace	Rackspace user name	API Key	Obtain the key from the API Access page in your control panel.
RHEV-M	rhevm	RHEV-M user name plus Windows domain, e.g., admin@rhevm.example.com	RHEV-M password	Set environment variable API_PROVIDER to the URL of the RHEV-M REST API endpoint.
Rimuhosting	rimuhosting	not used (?)	API Key
Terremark	terremark	Username	Password
VMware vSphere	vsphere	vSphere user	vSphere user password	Set environment variable API_PROVIDER to the hostname of the vSphere server.
OpenStack	openstack	OpenStack user	OpenStack user password	Set environment variable API_PROVIDER to the URL of OpenStack API entrypoint.
Aruba cloud.it	aruba	Username	Password

;T; I"0

Driver functionality and Credentials

Compute Driver Functionality

	Create new instances	Start stopped instances	Stop running instances	Reboot running instances	Destroy instances	List all/get details about hardware profiles	List all/get details about realms	List all/get details about images	List all/get details about instances
Amazon EC2	yes	no	yes	yes	yes	yes	yes	yes	yes
Eucalyptus	yes	no	yes	yes	yes	yes	yes	yes	yes
IBM SmartCloud	yes	yes	yes	yes	yes	yes	yes	yes	yes
GoGrid	yes	no	yes	yes	yes	yes	yes	yes	yes
OpenNebula	yes	yes	yes	yes	yes	yes	yes	yes	yes
Rackspace	yes	no	yes	yes	yes	yes	yes	yes	yes
RHEV-M	yes	yes	yes	no	yes	yes	yes	yes	yes
RimuHosting	yes	yes	yes	yes	yes	yes	yes	yes	yes
Terremark	yes	yes	yes	yes	yes	yes	yes	yes	yes
vSphere	yes	yes	yes	yes	yes	yes	yes	yes	yes
OpenStack	yes	yes	yes	yes	yes	yes	yes	yes	yes
FGCP	yes	yes	yes	no	yes	yes	yes	yes	yes
Aruba cloud.it	yes	yes	yes	yes	yes	yes	yes	yes	yes

Storage Driver Functionality

	Create new buckets	Update/delete buckets	Create new blobs	Update/delete blobs	Read/write blob attributes	Read/write individual blob attributes
Amazon S3	yes	yes	yes	yes	yes	yes
Eucalyptus Walrus	yes	yes	yes	yes	yes	yes
Rackspace CloudFiles	yes	yes	yes	yes	yes	yes
Microsoft Azure	yes	yes	yes	yes	yes	yes
Google Storage	yes	yes	yes	yes	yes	yes

Cloud provider credentials

Cloud	Driver	Username	Password	Notes
mock	mock	mockuser	mockpassword	The mock driver doesn't talk to any cloud; it just pretends to be a cloud.
Amazon EC2/S3	ec2	Access Key ID	Secret Access Key	This information can be found on the Security Credentials page in your AWS account.
Eucalyptus	eucalyptus	Access Key ID	Secret Access Key
GoGrid	gogrid	API Key	Shared Secret	Go to My Account > API Keys for your account and click on the key you want to use to find the shared secret.
IBM SmartCloud	sbc	Username	Password
Microsoft Azure (Storage Account only)	azure	Public Storage Account Name	Primary Access Key	The Storage Account Name is chosen when you create the service (e.g. name in http://name.blob.core.windows.net/). This and the access key are available from the service control panel.
OpenNebula	opennebula	OpenNebula user	OpenNebula password	Set the environment variable OCCI_URL to the address on which OpenNebula's OCCI server is listening.
Rackspace Cloud Servers/Cloud Files	rackspace	Rackspace user name	API Key	Obtain the key from the API Access page in your control panel.
RHEV-M	rhevm	RHEV-M user name plus Windows domain, e.g., admin@rhevm.example.com	RHEV-M password	Set environment variable API_PROVIDER to the URL of the RHEV-M REST API endpoint.
Rimuhosting	rimuhosting	not used (?)	API Key
Terremark	terremark	Username	Password
VMware vSphere	vsphere	vSphere user	vSphere user password	Set environment variable API_PROVIDER to the hostname of the vSphere server.
OpenStack	openstack	OpenStack user	OpenStack user password	Set environment variable API_PROVIDER to the URL of OpenStack API entrypoint.
Aruba cloud.it	aruba	Username	Password

;T; I"�.

Driver functionality and Credentials

Compute Driver Functionality

	Create new instances	Start stopped instances	Stop running instances	Reboot running instances	Destroy instances	List all/get details about hardware profiles	List all/get details about realms	List all/get details about images	List all/get details about instances
Amazon EC2	yes	no	yes	yes	yes	yes	yes	yes	yes
Eucalyptus	yes	no	yes	yes	yes	yes	yes	yes	yes
IBM SmartCloud	yes	yes	yes	yes	yes	yes	yes	yes	yes
GoGrid	yes	no	yes	yes	yes	yes	yes	yes	yes
OpenNebula	yes	yes	yes	yes	yes	yes	yes	yes	yes
Rackspace	yes	no	yes	yes	yes	yes	yes	yes	yes
RHEV-M	yes	yes	yes	no	yes	yes	yes	yes	yes
RimuHosting	yes	yes	yes	yes	yes	yes	yes	yes	yes
Terremark	yes	yes	yes	yes	yes	yes	yes	yes	yes
vSphere	yes	yes	yes	yes	yes	yes	yes	yes	yes
OpenStack	yes	yes	yes	yes	yes	yes	yes	yes	yes
FGCP	yes	yes	yes	no	yes	yes	yes	yes	yes
Aruba cloud.it	yes	yes	yes	yes	yes	yes	yes	yes	yes

Storage Driver Functionality

	Create new buckets	Update/delete buckets	Create new blobs	Update/delete blobs	Read/write blob attributes	Read/write individual blob attributes
Amazon S3	yes	yes	yes	yes	yes	yes
Eucalyptus Walrus	yes	yes	yes	yes	yes	yes
Rackspace CloudFiles	yes	yes	yes	yes	yes	yes
Microsoft Azure	yes	yes	yes	yes	yes	yes
Google Storage	yes	yes	yes	yes	yes	yes

Cloud provider credentials

Cloud	Driver	Username	Password	Notes
mock	mock	mockuser	mockpassword	The mock driver doesn't talk to any cloud; it just pretends to be a cloud.
Amazon EC2/S3	ec2	Access Key ID	Secret Access Key	This information can be found on the Security Credentials page in your AWS account.
Eucalyptus	eucalyptus	Access Key ID	Secret Access Key
GoGrid	gogrid	API Key	Shared Secret	Go to My Account > API Keys for your account and click on the key you want to use to find the shared secret.
IBM SmartCloud	sbc	Username	Password
Microsoft Azure (Storage Account only)	azure	Public Storage Account Name	Primary Access Key	The Storage Account Name is chosen when you create the service (e.g. name in http://name.blob.core.windows.net/). This and the access key are available from the service control panel.
OpenNebula	opennebula	OpenNebula user	OpenNebula password	Set the environment variable OCCI_URL to the address on which OpenNebula's OCCI server is listening.
Rackspace Cloud Servers/Cloud Files	rackspace	Rackspace user name	API Key	Obtain the key from the API Access page in your control panel.
RHEV-M	rhevm	RHEV-M user name plus Windows domain, e.g., admin@rhevm.example.com	RHEV-M password	Set environment variable API_PROVIDER to the URL of the RHEV-M REST API endpoint.
Rimuhosting	rimuhosting	not used (?)	API Key
Terremark	terremark	Username	Password
VMware vSphere	vsphere	vSphere user	vSphere user password	Set environment variable API_PROVIDER to the hostname of the vSphere server.
OpenStack	openstack	OpenStack user	OpenStack user password	Set environment variable API_PROVIDER to the URL of OpenStack API entrypoint.
Aruba cloud.it	aruba	Username	Password

;T;@tI"/compute-resources/;T{;{ ;I"�( Compute resources

Compute Resources

The compute resources are: instances, instance states, images, realms, hardware profiles, firewalls, load balancers, addresses and keys.

Realms

A realm represents a boundary containing resources, such as a data center. The exact definition of a realm is given by the cloud provider. In some cases, a realm may represent different datacenters, different continents or different pools of resources within a single datacenter. A cloud provider may insist that all the resources exist within a single realm in order to cooperate. For instance, storage volumes may only be allowed to be mounted to instances within the same realm. Generally speaking, going from one realm to another within the same cloud may change many aspects of the cloud, such as SLA’s, pricing terms, etc.

Get a list of all realms

To list all realms use call GET /api/realms. You can filter the list by adding a request parameter architecture to the realms that support a specific architecture, such as i386. The example below shows the retrieval of all realms for the AWS EC2 driver, which correspond to EC2 "availability zones":

Storage resources

Example request:

GET /api/realms?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 639
<?xml version='1.0' encoding='utf-8' ?>
<realms>
  <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'>
    <name>us-east-1a</name>
    <state>available</state>
  </realm>
  <realm href='http://localhost:3001/api/realms/us-east-1b' id='us-east-1b'>
    <name>us-east-1b</name>
    <state>available</state>
  </realm>
  <realm href='http://localhost:3001/api/realms/us-east-1c' id='us-east-1c'>
    <name>us-east-1c</name>
    <state>available</state>
  </realm>
  <realm href='http://localhost:3001/api/realms/us-east-1d' id='us-east-1d'>
    <name>us-east-1d</name>
    <state>available</state>
  </realm>
</realms>

Get the details of a realm

To provide the details of a realm use call GET /api/realms/:id. The server responds with a name, a state and a limit applicable to the current requester. The name is an arbitrary label with no specific meaning in the API. The state can be either AVAILABLE or UNAVAILABLE.

The example below shows the realm for the Rackspace driver. Since Rackspace does not currently have a notion of realms, the Deltacloud Rackspace driver provides a single realm called 'US', signifying that all compute resources for that cloud provider are hosted in the United States:

Example request:

GET /api/realms/us?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 182

<?xml version='1.0' encoding='utf-8' ?>
<realm href='http://localhost:3001/api/realms/us' id='us'>
    <name>United States</name>
    <state>AVAILABLE</state>
    <limit></limit>
</realm>

Hardware profiles

;T; I"

Compute Resources

The compute resources are: instances, instance states, images, realms, hardware profiles, firewalls, load balancers, addresses and keys.

Realms

Get a list of all realms

Storage resources

Example request:

GET /api/realms?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 639
<?xml version='1.0' encoding='utf-8' ?>
<realms>
  <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'>
    <name>us-east-1a</name>
    <state>available</state>
  </realm>
  <realm href='http://localhost:3001/api/realms/us-east-1b' id='us-east-1b'>
    <name>us-east-1b</name>
    <state>available</state>
  </realm>
  <realm href='http://localhost:3001/api/realms/us-east-1c' id='us-east-1c'>
    <name>us-east-1c</name>
    <state>available</state>
  </realm>
  <realm href='http://localhost:3001/api/realms/us-east-1d' id='us-east-1d'>
    <name>us-east-1d</name>
    <state>available</state>
  </realm>
</realms>

Get the details of a realm

Example request:

GET /api/realms/us?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 182

<?xml version='1.0' encoding='utf-8' ?>
<realm href='http://localhost:3001/api/realms/us' id='us'>
    <name>United States</name>
    <state>AVAILABLE</state>
    <limit></limit>
</realm>

Hardware profiles
;T; I"

Compute Resources

The compute resources are: instances, instance states, images, realms, hardware profiles, firewalls, load balancers, addresses and keys.

Realms

Get a list of all realms

Storage resources

Example request:

GET /api/realms?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 639
<?xml version='1.0' encoding='utf-8' ?>
<realms>
  <realm href='http://localhost:3001/api/realms/us-east-1a' id='us-east-1a'>
    <name>us-east-1a</name>
    <state>available</state>
  </realm>
  <realm href='http://localhost:3001/api/realms/us-east-1b' id='us-east-1b'>
    <name>us-east-1b</name>
    <state>available</state>
  </realm>
  <realm href='http://localhost:3001/api/realms/us-east-1c' id='us-east-1c'>
    <name>us-east-1c</name>
    <state>available</state>
  </realm>
  <realm href='http://localhost:3001/api/realms/us-east-1d' id='us-east-1d'>
    <name>us-east-1d</name>
    <state>available</state>
  </realm>
</realms>

Get the details of a realm

Example request:

GET /api/realms/us?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 182

<?xml version='1.0' encoding='utf-8' ?>
<realm href='http://localhost:3001/api/realms/us' id='us'>
    <name>United States</name>
    <state>AVAILABLE</state>
    <limit></limit>
</realm>

Hardware profiles

;T;@zI"/api-docs/;T{;{ ;I"� API Documentation

;T; I";F; I";F;@{I"/write-new-driver/;T{;{ ;I"�8 Write New Provider Driver

Write a provider driver

The deltacloud drivers are stored in deltacloud/server/lib/deltacloud/drivers.

To add a driver for a hypotetical Foo cloud, add a directory into /drivers/ and then add a file for a driver itself:
```
deltacloud/server/lib/deltacloud/drivers/foo/foo_driver.rb
```
You need to define a class Deltacloud::Drivers::Foo::FooDriver to this file. The class has to be a subclass of the Deltacloud::BaseDriver.
Set up which collections the provider for you are writing the driver supports - e.g. images, instances, keys, buckets/blobs (storage), etc.:
```
def supported_collections
  DEFAULT_COLLECTIONS + [ :buckets ] - [ :storage_snapshots, :storage_volumes ]
end
```
This declares that the driver supports the DEFAULT_COLLECTIONS (defined in deltacloud/server/lib/drivers.rb) except storage_snapshots and storage_volumes and also supports the buckets collection. A storage only cloud provider driver would support only the buckets collection.
Define the methods for each collection that your driver supports. The methods, as well as the routes to them, are defined in deltacloud/server/lib/deltacloud/server.rb. You can look at the existing drivers to get the idea of how to implement a specific method.
Consider how the driver will be communicating with the cloud provider. Many of the existing drivers use external ruby gems for this purpose. For example, the ec2 driver uses the aws gem, the rackspace driver uses the cloudfiles and cloudservers gems. However, other drivers implement their own clients to communicate with the cloud provider, such as the IBM SmartCloud driver and the Gogrid driver. This also explains why some drivers in the /drivers directory contain only the provider _driver.rb file, while the others also define a provider_client.rb file. It is entirely up to you, whether you write your own client or use an existing one.

Thus, your driver for the cloud provider Foo may look like:

require 'deltacloud/base_driver'
require 'foo_lib' # a library for talking to the foo cloud

module Deltacloud
  module Drivers
    module Foo

class FooDriver < Deltacloud::BaseDriver

    def supported_collections
      DEFAULT_COLLECTIONS + [ :buckets ]
    end

    def images(credentials, opts={})
      client = new_foo_client(credentials)
      # Use client to get a list of images from the back-end cloud and then create a Deltacloud Image object for each of these.
      # Filter the result (eg specific image requested) and return to user.
    end

    def realms(credentials, opts={})
      (...)
    end

    def instances(credentials, opts={})
      (...)
    end

    ... ETC

    private

    def new_foo_client(credentials)
      client = FooLib::Service.new({:user => credentials.user,
:pass => credentials.password })
    end

end
        end
      end
    end

An important method for drivers that implement the instances collection is instance_states. This method represents the finite-state-machine for instances which varies across cloud providers. In some clouds an instance may be in the 'running' state after creation, whereas in other clouds an instance may need to be started explicitly. For example:

define_instance_states do
  start.to( :pending )          .on( :create )
  pending.to( :running )        .automatically
  running.to( :running )        .on( :reboot )
  running.to( :shutting_down )  .on( :stop )
  shutting_down.to( :stopped )  .automatically
  stopped.to( :finish )         .automatically
end

The voodoo used here (i.e. definition of .to and .on etc) is defined in /deltacloud/server/lib/deltacloud/state_machine.rb.

Valid states are:

:begin
:pending
:running
:shutting_down
:stopped
:end

The instance is located in the:begin state before being created. Immediately after being destroyed the instance is removed to the :end state.

Valid transition actions are:

:stop
:start
:reboot

The action :automatically may be used to indicate a tranisition that may occur without an action being triggered (see the example above).

You can implement some other methods according to the collections you will be supporting:

hardware_profiles(credentials, opts=nil)
images(credentials, opts=nil)
realms(credentials, opts=nil)
instances(credentials, opts=nil)
create_instance(credentials, image_id, opts)
reboot_instance(credentials, id)
stop_instance(credentials, id)
destroy_instance(credentials, id)

The hardware_profiles(...) method should return an array of HardwareProfile objects. The opts hash, if present, must be inspected for :id and :architecture keys. If these keys are available, the results should be filtered by the value associated with each key. The filter_on(...) helper method is used for the filtering and as you can see from existing driver method definitions, is invoked in many of the driver collection methods:

def hardware_profiles(credentials, opts=nil)
  hardware_profiles = # get all hardware profiles from provider
  hardware_profiles = filter_on( hardware_profiles, :id, opts )
  hardware_profiles = filter_on( hardware_profiles, :architecture, opts )
  return hardware_profiles
end

Once you've implemented some of the methods for your driver you should test if the driver is working correctly. Before you'll do this, you need to create a yaml file for your driver so that the Deltacloud server recognizes the driver. Assuming you've written the driver for cloud Foo and you've created the file foo_driver.rb (containing the class Deltacloud::Drivers::Foo::FooDriver), you need to drop a file into /deltacloud/server/config/drivers called foo.yaml, which contains:

---
:foo:
  :name Foo

Then, you can start the Deltacloud server:

deltacloudd -i foo

Back Test the driver

;T; I"p#

Write a provider driver

The deltacloud drivers are stored in deltacloud/server/lib/deltacloud/drivers.

To add a driver for a hypotetical Foo cloud, add a directory into /drivers/ and then add a file for a driver itself:
```
deltacloud/server/lib/deltacloud/drivers/foo/foo_driver.rb
```
You need to define a class Deltacloud::Drivers::Foo::FooDriver to this file. The class has to be a subclass of the Deltacloud::BaseDriver.
Set up which collections the provider for you are writing the driver supports - e.g. images, instances, keys, buckets/blobs (storage), etc.:
```
def supported_collections
  DEFAULT_COLLECTIONS + [ :buckets ] - [ :storage_snapshots, :storage_volumes ]
end
```
This declares that the driver supports the DEFAULT_COLLECTIONS (defined in deltacloud/server/lib/drivers.rb) except storage_snapshots and storage_volumes and also supports the buckets collection. A storage only cloud provider driver would support only the buckets collection.
Define the methods for each collection that your driver supports. The methods, as well as the routes to them, are defined in deltacloud/server/lib/deltacloud/server.rb. You can look at the existing drivers to get the idea of how to implement a specific method.
Consider how the driver will be communicating with the cloud provider. Many of the existing drivers use external ruby gems for this purpose. For example, the ec2 driver uses the aws gem, the rackspace driver uses the cloudfiles and cloudservers gems. However, other drivers implement their own clients to communicate with the cloud provider, such as the IBM SmartCloud driver and the Gogrid driver. This also explains why some drivers in the /drivers directory contain only the provider _driver.rb file, while the others also define a provider_client.rb file. It is entirely up to you, whether you write your own client or use an existing one.

Thus, your driver for the cloud provider Foo may look like:

require 'deltacloud/base_driver'
require 'foo_lib' # a library for talking to the foo cloud

module Deltacloud
  module Drivers
    module Foo

class FooDriver < Deltacloud::BaseDriver

    def supported_collections
      DEFAULT_COLLECTIONS + [ :buckets ]
    end

    def images(credentials, opts={})
      client = new_foo_client(credentials)
      # Use client to get a list of images from the back-end cloud and then create a Deltacloud Image object for each of these.
      # Filter the result (eg specific image requested) and return to user.
    end

    def realms(credentials, opts={})
      (...)
    end

    def instances(credentials, opts={})
      (...)
    end

    ... ETC

    private

    def new_foo_client(credentials)
      client = FooLib::Service.new({:user => credentials.user,
:pass => credentials.password })
    end

end
        end
      end
    end

define_instance_states do
  start.to( :pending )          .on( :create )
  pending.to( :running )        .automatically
  running.to( :running )        .on( :reboot )
  running.to( :shutting_down )  .on( :stop )
  shutting_down.to( :stopped )  .automatically
  stopped.to( :finish )         .automatically
end

The voodoo used here (i.e. definition of .to and .on etc) is defined in /deltacloud/server/lib/deltacloud/state_machine.rb.

Valid states are:

:begin
:pending
:running
:shutting_down
:stopped
:end

The instance is located in the:begin state before being created. Immediately after being destroyed the instance is removed to the :end state.

Valid transition actions are:

:stop
:start
:reboot

The action :automatically may be used to indicate a tranisition that may occur without an action being triggered (see the example above).

You can implement some other methods according to the collections you will be supporting:

hardware_profiles(credentials, opts=nil)
images(credentials, opts=nil)
realms(credentials, opts=nil)
instances(credentials, opts=nil)
create_instance(credentials, image_id, opts)
reboot_instance(credentials, id)
stop_instance(credentials, id)
destroy_instance(credentials, id)

def hardware_profiles(credentials, opts=nil)
  hardware_profiles = # get all hardware profiles from provider
  hardware_profiles = filter_on( hardware_profiles, :id, opts )
  hardware_profiles = filter_on( hardware_profiles, :architecture, opts )
  return hardware_profiles
end

---
:foo:
  :name Foo

Then, you can start the Deltacloud server:

deltacloudd -i foo

Back Test the driver

;T; I"c#

Write a provider driver

The deltacloud drivers are stored in deltacloud/server/lib/deltacloud/drivers.

To add a driver for a hypotetical Foo cloud, add a directory into /drivers/ and then add a file for a driver itself:
```
deltacloud/server/lib/deltacloud/drivers/foo/foo_driver.rb
```
You need to define a class Deltacloud::Drivers::Foo::FooDriver to this file. The class has to be a subclass of the Deltacloud::BaseDriver.
Set up which collections the provider for you are writing the driver supports - e.g. images, instances, keys, buckets/blobs (storage), etc.:
```
def supported_collections
  DEFAULT_COLLECTIONS + [ :buckets ] - [ :storage_snapshots, :storage_volumes ]
end
```
This declares that the driver supports the DEFAULT_COLLECTIONS (defined in deltacloud/server/lib/drivers.rb) except storage_snapshots and storage_volumes and also supports the buckets collection. A storage only cloud provider driver would support only the buckets collection.
Define the methods for each collection that your driver supports. The methods, as well as the routes to them, are defined in deltacloud/server/lib/deltacloud/server.rb. You can look at the existing drivers to get the idea of how to implement a specific method.
Consider how the driver will be communicating with the cloud provider. Many of the existing drivers use external ruby gems for this purpose. For example, the ec2 driver uses the aws gem, the rackspace driver uses the cloudfiles and cloudservers gems. However, other drivers implement their own clients to communicate with the cloud provider, such as the IBM SmartCloud driver and the Gogrid driver. This also explains why some drivers in the /drivers directory contain only the provider _driver.rb file, while the others also define a provider_client.rb file. It is entirely up to you, whether you write your own client or use an existing one.

Thus, your driver for the cloud provider Foo may look like:

require 'deltacloud/base_driver'
require 'foo_lib' # a library for talking to the foo cloud

module Deltacloud
  module Drivers
    module Foo

class FooDriver < Deltacloud::BaseDriver

    def supported_collections
      DEFAULT_COLLECTIONS + [ :buckets ]
    end

    def images(credentials, opts={})
      client = new_foo_client(credentials)
      # Use client to get a list of images from the back-end cloud and then create a Deltacloud Image object for each of these.
      # Filter the result (eg specific image requested) and return to user.
    end

    def realms(credentials, opts={})
      (...)
    end

    def instances(credentials, opts={})
      (...)
    end

    ... ETC

    private

    def new_foo_client(credentials)
      client = FooLib::Service.new({:user => credentials.user,
:pass => credentials.password })
    end

end
        end
      end
    end

define_instance_states do
  start.to( :pending )          .on( :create )
  pending.to( :running )        .automatically
  running.to( :running )        .on( :reboot )
  running.to( :shutting_down )  .on( :stop )
  shutting_down.to( :stopped )  .automatically
  stopped.to( :finish )         .automatically
end

The voodoo used here (i.e. definition of .to and .on etc) is defined in /deltacloud/server/lib/deltacloud/state_machine.rb.

Valid states are:

:begin
:pending
:running
:shutting_down
:stopped
:end

The instance is located in the:begin state before being created. Immediately after being destroyed the instance is removed to the :end state.

Valid transition actions are:

:stop
:start
:reboot

The action :automatically may be used to indicate a tranisition that may occur without an action being triggered (see the example above).

You can implement some other methods according to the collections you will be supporting:

hardware_profiles(credentials, opts=nil)
images(credentials, opts=nil)
realms(credentials, opts=nil)
instances(credentials, opts=nil)
create_instance(credentials, image_id, opts)
reboot_instance(credentials, id)
stop_instance(credentials, id)
destroy_instance(credentials, id)

def hardware_profiles(credentials, opts=nil)
  hardware_profiles = # get all hardware profiles from provider
  hardware_profiles = filter_on( hardware_profiles, :id, opts )
  hardware_profiles = filter_on( hardware_profiles, :architecture, opts )
  return hardware_profiles
end

---
:foo:
  :name Foo

Then, you can start the Deltacloud server:

deltacloudd -i foo

Back Test the driver

;T;@�I"/how-to-contribute/;T{;{ ;I"�) How Can I Contribute?

Contribute to Deltacloud

Deltacloud project is a free open source software licensed under the Apache Software Foundation license. The developers community is open to anyone who wants to contribute. Contributors are required to sign an individual contributor license agreement. Do not hesitate to contact us if you have any questions about contributing to the Deltacloud project.

How can I contribute?

Overview of the Deltacloud directory structure

The following list contains paths to essential files and directories for developers. It is intended as a help with orientation in the project directory - for example to quickly identify where the Deltacloud cloud provider drivers are stored:

deltacloud
|-----------------------------------------------------------------------------------
|-d-->tests                           Contains Cucumber tests
|-----------------------------------------------------------------------------------
|-d-->site                            Files for this website
|-----------------------------------------------------------------------------------
|-d-->client                          Contains the Deltacloud ruby client
|-----------------------------------------------------------------------------------
|-d-->clients                         Contains other Deltacloud clients (e.g. java)
|-----------------------------------------------------------------------------------
|-d--> server
       |----------------------------------------------------------------------------
       |-d-->bin                      Contains the Deltacloud executable deltacloudd
       |----------------------------------------------------------------------------
       |-d-->views                    Contains haml views for each collection
       |----------------------------------------------------------------------------
       |-d-->tests                    Contains unit tests for drivers
       |----------------------------------------------------------------------------
       |-d-->lib
             |----------------------------------------------------------------------
             |-d-->sinatra            Contains rabbit DSL and various helpers
             |----------------------------------------------------------------------
             |-d-->deltacloud
                   |----------------------------------------------------------------
                   |-d-->models       Definition of each collection model
                   |----------------------------------------------------------------
                   |-d-->drivers      Contains the drivers for each cloud provider
                   |----------------------------------------------------------------
                   |-d-->helpers      Various helper methods used by the drivers
                   |----------------------------------------------------------------
                   |-d-->base_driver  Contains the Deltacloud base driver
                   |----------------------------------------------------------------
                   |-f-->server.rb                Contains the sinatra routes
                   |----------------------------------------------------------------

Reporting a bug

We track bugs in Apache JIRA. When you discover a problem with Deltacloud functionality, check JIRA if someone has already reported the issue to the Deltacloud developers. Otherwise, report it.

Proposing an idea

Have you found a way how to improve Deltacloud project? Do you miss a feature or a tool, which we could include into Deltacloud? Our Teambox page is a place where we keep the latest task lists and where you can add comments or suggest new features for the project.

Writing documentation

You can also contribute with a piece of documentation. There are still things which needs to be described. If you found one like that and you are interested in writing a couple of sentences about the particular issue, please, don’t hesitate to do it and send us your contribution. We really appreciate your help.

;T; I"�

Contribute to Deltacloud

How can I contribute?

Overview of the Deltacloud directory structure

deltacloud
|-----------------------------------------------------------------------------------
|-d-->tests                           Contains Cucumber tests
|-----------------------------------------------------------------------------------
|-d-->site                            Files for this website
|-----------------------------------------------------------------------------------
|-d-->client                          Contains the Deltacloud ruby client
|-----------------------------------------------------------------------------------
|-d-->clients                         Contains other Deltacloud clients (e.g. java)
|-----------------------------------------------------------------------------------
|-d--> server
       |----------------------------------------------------------------------------
       |-d-->bin                      Contains the Deltacloud executable deltacloudd
       |----------------------------------------------------------------------------
       |-d-->views                    Contains haml views for each collection
       |----------------------------------------------------------------------------
       |-d-->tests                    Contains unit tests for drivers
       |----------------------------------------------------------------------------
       |-d-->lib
             |----------------------------------------------------------------------
             |-d-->sinatra            Contains rabbit DSL and various helpers
             |----------------------------------------------------------------------
             |-d-->deltacloud
                   |----------------------------------------------------------------
                   |-d-->models       Definition of each collection model
                   |----------------------------------------------------------------
                   |-d-->drivers      Contains the drivers for each cloud provider
                   |----------------------------------------------------------------
                   |-d-->helpers      Various helper methods used by the drivers
                   |----------------------------------------------------------------
                   |-d-->base_driver  Contains the Deltacloud base driver
                   |----------------------------------------------------------------
                   |-f-->server.rb                Contains the sinatra routes
                   |----------------------------------------------------------------

Reporting a bug

We track bugs in Apache JIRA. When you discover a problem with Deltacloud functionality, check JIRA if someone has already reported the issue to the Deltacloud developers. Otherwise, report it.

Proposing an idea

Writing documentation

You can also contribute with a piece of documentation. There are still things which needs to be described. If you found one like that and you are interested in writing a couple of sentences about the particular issue, please, don't hesitate to do it and send us your contribution. We really appreciate your help.;T; I"

Contribute to Deltacloud

How can I contribute?

Overview of the Deltacloud directory structure

deltacloud
|-----------------------------------------------------------------------------------
|-d-->tests                           Contains Cucumber tests
|-----------------------------------------------------------------------------------
|-d-->site                            Files for this website
|-----------------------------------------------------------------------------------
|-d-->client                          Contains the Deltacloud ruby client
|-----------------------------------------------------------------------------------
|-d-->clients                         Contains other Deltacloud clients (e.g. java)
|-----------------------------------------------------------------------------------
|-d--> server
       |----------------------------------------------------------------------------
       |-d-->bin                      Contains the Deltacloud executable deltacloudd
       |----------------------------------------------------------------------------
       |-d-->views                    Contains haml views for each collection
       |----------------------------------------------------------------------------
       |-d-->tests                    Contains unit tests for drivers
       |----------------------------------------------------------------------------
       |-d-->lib
             |----------------------------------------------------------------------
             |-d-->sinatra            Contains rabbit DSL and various helpers
             |----------------------------------------------------------------------
             |-d-->deltacloud
                   |----------------------------------------------------------------
                   |-d-->models       Definition of each collection model
                   |----------------------------------------------------------------
                   |-d-->drivers      Contains the drivers for each cloud provider
                   |----------------------------------------------------------------
                   |-d-->helpers      Various helper methods used by the drivers
                   |----------------------------------------------------------------
                   |-d-->base_driver  Contains the Deltacloud base driver
                   |----------------------------------------------------------------
                   |-f-->server.rb                Contains the sinatra routes
                   |----------------------------------------------------------------

Reporting a bug

We track bugs in Apache JIRA. When you discover a problem with Deltacloud functionality, check JIRA if someone has already reported the issue to the Deltacloud developers. Otherwise, report it.

Proposing an idea

Writing documentation

;T;@�I"/hardware-profiles/;T{;{ ;I"�= Hardware profiles

Hardware profiles

A hardware profile describes the size of a virtual machine in a cloud and specifies details such as how many virtual CPUs, how much memory or how much local storage an instance might have. The attributes of a hardware profile consist of a human-readable name and a list of elements. Each element defines possible values along with a sizing dimension.

Since clouds differ sharply in how virtual machine sizing is represented and influenced, hardware profiles provide a generic mechanism to express sizing constraints. For each dimension (such as amount of memory), the hardware profile can express that

size is fixed in the dimension, for example instances all have 2GB of memory;
size can vary within some range, for example instances can have from 1GB to 4GB of memory;
size can be chosen from a predefined set of values - an enumeration, for example instances can have 512 MB, 1 GB or 4GB of memory.

When creating a new instance, a client must specify the hardware profile on which the instance is based.

In addition to the sizing constraints, a hardware profile may also indicate the parameters that can be specified by a client in instance operations. A <param> XML tag signifies the user-defined variable dimensions within the given property. For instance, the following extract shows the memory dimension for a hardware profile that can be specified in the HTTP POST create

Storage resources

operation of the instances collection (i.e. creating a new instance). The given parameter must be specified using the name hwp_memory. The default value is 10240 but the client may specify a value in the range 7680 up to 15360:

...
<property kind='range' name='memory' unit='MB' value='10240'>
    <param href='http://localhost:3003/api/instances' method='post' name='hwp_memory' operation='create' />
    <range first='7680.0' last='15360' />
</property>
...

Get a list of all hardware profiles

To produce a list of all hardware profiles availaible with this cloud use call GET /api/hardware_profiles. The example below shows how to list the hardware profiles available in the Amazon EC2 cloud. As EC2 provides a set of pre-defined hardware profiles, the properties of each dimension (memory,cpu etc) are the type fixed.

Example request:

GET /api/hardware_profiles?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 3896
<?xml version='1.0' encoding='utf-8' ?>
<hardware_profiles>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/t1.micro' id='t1.micro'>
    <name>t1.micro</name>
    <property kind='fixed' name='cpu' unit='count' value='1' />
    <property kind='fixed' name='memory' unit='MB' value='645.12' />
    <property kind='fixed' name='architecture' unit='label' value='i386' />
    <property kind='fixed' name='storage' unit='GB' value='160' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m1.small' id='m1.small'>
    <name>m1.small</name>
    <property kind='fixed' name='cpu' unit='count' value='1' />
    <property kind='fixed' name='memory' unit='MB' value='1740.8' />
    <property kind='fixed' name='architecture' unit='label' value='i386' />
    <property kind='fixed' name='storage' unit='GB' value='160' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m1.large' id='m1.large'>
    <name>m1.large</name>
    <property kind='fixed' name='cpu' unit='count' value='4' />
    <property kind='fixed' name='memory' unit='MB' value='7680.0' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='850' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m1.xlarge' id='m1.xlarge'>
    <name>m1.xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='8' />
    <property kind='fixed' name='memory' unit='MB' value='15360' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='1690' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.medium' id='c1.medium'>
    <name>c1.medium</name>
    <property kind='fixed' name='cpu' unit='count' value='5' />
    <property kind='fixed' name='memory' unit='MB' value='1740.8' />
    <property kind='fixed' name='architecture' unit='label' value='i386' />
    <property kind='fixed' name='storage' unit='GB' value='350' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.xlarge' id='c1.xlarge'>
    <name>c1.xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='20' />
    <property kind='fixed' name='memory' unit='MB' value='7168' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='1690' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m2.xlarge' id='m2.xlarge'>
    <name>m2.xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='6.5' />
    <property kind='fixed' name='memory' unit='MB' value='17510.4' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='420' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m2.2xlarge' id='m2.2xlarge'>
    <name>m2.2xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='13' />
    <property kind='fixed' name='memory' unit='MB' value='35020.8' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='850' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m2.4xlarge' id='m2.4xlarge'>
    <name>m2.4xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='26' />
    <property kind='fixed' name='memory' unit='MB' value='70041.6' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='1690' />
  </hardware_profile>
</hardware_profiles>

Get the details of a hardware profile

To retrieve the details of a specific hardware profile use call GET /api/hardware profiles/:id. The example below shows a request for the m1-large profile of the Deltacloud mock driver. This hardware profile demonstrates the three different types of parameters (fixed, range, enum). Instances launched within this hardware profile will have exactly 2 virtual CPUs, memory in the range 7.5 to 15GB and local storage that can either be 850MB or 1GB. The default value for each dimension is indicated by the value attribute on the property element.

Example request:

GET /api/hardware_profiles/m1-large?format=xml HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3003
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 808

<?xml version='1.0' encoding='utf-8' ?>
<hardware_profile href='http://localhost:3003/api/hardware_profiles/m1-large' id='m1-large'>
  <name>m1-large</name>
  <property kind='fixed' name='cpu' unit='count' value='2' />
  <property kind='range' name='memory' unit='MB' value='10240'>
    <param href='http://localhost:3003/api/instances' method='post' name='hwp_memory' operation='create' />
    <range first='7680.0' last='15360' />
  </property>
  <property kind='enum' name='storage' unit='GB' value='850'>
    <param href='http://localhost:3003/api/instances' method='post' name='hwp_storage' operation='create' />
    <enum>
      <entry value='850' />
      <entry value='1024' />
    </enum>
  </property>
  <property kind='fixed' name='architecture' unit='label' value='x86_64' />
</hardware_profile>

Images

;T; I"M(

Hardware profiles

size is fixed in the dimension, for example instances all have 2GB of memory;
size can vary within some range, for example instances can have from 1GB to 4GB of memory;
size can be chosen from a predefined set of values - an enumeration, for example instances can have 512 MB, 1 GB or 4GB of memory.

When creating a new instance, a client must specify the hardware profile on which the instance is based.

Storage resources

...
<property kind='range' name='memory' unit='MB' value='10240'>
    <param href='http://localhost:3003/api/instances' method='post' name='hwp_memory' operation='create' />
    <range first='7680.0' last='15360' />
</property>
...

Get a list of all hardware profiles

Example request:

GET /api/hardware_profiles?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 3896
<?xml version='1.0' encoding='utf-8' ?>
<hardware_profiles>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/t1.micro' id='t1.micro'>
    <name>t1.micro</name>
    <property kind='fixed' name='cpu' unit='count' value='1' />
    <property kind='fixed' name='memory' unit='MB' value='645.12' />
    <property kind='fixed' name='architecture' unit='label' value='i386' />
    <property kind='fixed' name='storage' unit='GB' value='160' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m1.small' id='m1.small'>
    <name>m1.small</name>
    <property kind='fixed' name='cpu' unit='count' value='1' />
    <property kind='fixed' name='memory' unit='MB' value='1740.8' />
    <property kind='fixed' name='architecture' unit='label' value='i386' />
    <property kind='fixed' name='storage' unit='GB' value='160' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m1.large' id='m1.large'>
    <name>m1.large</name>
    <property kind='fixed' name='cpu' unit='count' value='4' />
    <property kind='fixed' name='memory' unit='MB' value='7680.0' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='850' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m1.xlarge' id='m1.xlarge'>
    <name>m1.xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='8' />
    <property kind='fixed' name='memory' unit='MB' value='15360' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='1690' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.medium' id='c1.medium'>
    <name>c1.medium</name>
    <property kind='fixed' name='cpu' unit='count' value='5' />
    <property kind='fixed' name='memory' unit='MB' value='1740.8' />
    <property kind='fixed' name='architecture' unit='label' value='i386' />
    <property kind='fixed' name='storage' unit='GB' value='350' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.xlarge' id='c1.xlarge'>
    <name>c1.xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='20' />
    <property kind='fixed' name='memory' unit='MB' value='7168' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='1690' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m2.xlarge' id='m2.xlarge'>
    <name>m2.xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='6.5' />
    <property kind='fixed' name='memory' unit='MB' value='17510.4' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='420' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m2.2xlarge' id='m2.2xlarge'>
    <name>m2.2xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='13' />
    <property kind='fixed' name='memory' unit='MB' value='35020.8' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='850' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m2.4xlarge' id='m2.4xlarge'>
    <name>m2.4xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='26' />
    <property kind='fixed' name='memory' unit='MB' value='70041.6' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='1690' />
  </hardware_profile>
</hardware_profiles>

Get the details of a hardware profile

Example request:

GET /api/hardware_profiles/m1-large?format=xml HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3003
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 808

<?xml version='1.0' encoding='utf-8' ?>
<hardware_profile href='http://localhost:3003/api/hardware_profiles/m1-large' id='m1-large'>
  <name>m1-large</name>
  <property kind='fixed' name='cpu' unit='count' value='2' />
  <property kind='range' name='memory' unit='MB' value='10240'>
    <param href='http://localhost:3003/api/instances' method='post' name='hwp_memory' operation='create' />
    <range first='7680.0' last='15360' />
  </property>
  <property kind='enum' name='storage' unit='GB' value='850'>
    <param href='http://localhost:3003/api/instances' method='post' name='hwp_storage' operation='create' />
    <enum>
      <entry value='850' />
      <entry value='1024' />
    </enum>
  </property>
  <property kind='fixed' name='architecture' unit='label' value='x86_64' />
</hardware_profile>

Images
;T; I"E(

Hardware profiles

size is fixed in the dimension, for example instances all have 2GB of memory;
size can vary within some range, for example instances can have from 1GB to 4GB of memory;
size can be chosen from a predefined set of values - an enumeration, for example instances can have 512 MB, 1 GB or 4GB of memory.

When creating a new instance, a client must specify the hardware profile on which the instance is based.

Storage resources

...
<property kind='range' name='memory' unit='MB' value='10240'>
    <param href='http://localhost:3003/api/instances' method='post' name='hwp_memory' operation='create' />
    <range first='7680.0' last='15360' />
</property>
...

Get a list of all hardware profiles

Example request:

GET /api/hardware_profiles?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 3896
<?xml version='1.0' encoding='utf-8' ?>
<hardware_profiles>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/t1.micro' id='t1.micro'>
    <name>t1.micro</name>
    <property kind='fixed' name='cpu' unit='count' value='1' />
    <property kind='fixed' name='memory' unit='MB' value='645.12' />
    <property kind='fixed' name='architecture' unit='label' value='i386' />
    <property kind='fixed' name='storage' unit='GB' value='160' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m1.small' id='m1.small'>
    <name>m1.small</name>
    <property kind='fixed' name='cpu' unit='count' value='1' />
    <property kind='fixed' name='memory' unit='MB' value='1740.8' />
    <property kind='fixed' name='architecture' unit='label' value='i386' />
    <property kind='fixed' name='storage' unit='GB' value='160' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m1.large' id='m1.large'>
    <name>m1.large</name>
    <property kind='fixed' name='cpu' unit='count' value='4' />
    <property kind='fixed' name='memory' unit='MB' value='7680.0' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='850' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m1.xlarge' id='m1.xlarge'>
    <name>m1.xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='8' />
    <property kind='fixed' name='memory' unit='MB' value='15360' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='1690' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.medium' id='c1.medium'>
    <name>c1.medium</name>
    <property kind='fixed' name='cpu' unit='count' value='5' />
    <property kind='fixed' name='memory' unit='MB' value='1740.8' />
    <property kind='fixed' name='architecture' unit='label' value='i386' />
    <property kind='fixed' name='storage' unit='GB' value='350' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.xlarge' id='c1.xlarge'>
    <name>c1.xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='20' />
    <property kind='fixed' name='memory' unit='MB' value='7168' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='1690' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m2.xlarge' id='m2.xlarge'>
    <name>m2.xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='6.5' />
    <property kind='fixed' name='memory' unit='MB' value='17510.4' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='420' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m2.2xlarge' id='m2.2xlarge'>
    <name>m2.2xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='13' />
    <property kind='fixed' name='memory' unit='MB' value='35020.8' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='850' />
  </hardware_profile>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/m2.4xlarge' id='m2.4xlarge'>
    <name>m2.4xlarge</name>
    <property kind='fixed' name='cpu' unit='count' value='26' />
    <property kind='fixed' name='memory' unit='MB' value='70041.6' />
    <property kind='fixed' name='architecture' unit='label' value='x86_64' />
    <property kind='fixed' name='storage' unit='GB' value='1690' />
  </hardware_profile>
</hardware_profiles>

Get the details of a hardware profile

Example request:

GET /api/hardware_profiles/m1-large?format=xml HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3003
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 808

<?xml version='1.0' encoding='utf-8' ?>
<hardware_profile href='http://localhost:3003/api/hardware_profiles/m1-large' id='m1-large'>
  <name>m1-large</name>
  <property kind='fixed' name='cpu' unit='count' value='2' />
  <property kind='range' name='memory' unit='MB' value='10240'>
    <param href='http://localhost:3003/api/instances' method='post' name='hwp_memory' operation='create' />
    <range first='7680.0' last='15360' />
  </property>
  <property kind='enum' name='storage' unit='GB' value='850'>
    <param href='http://localhost:3003/api/instances' method='post' name='hwp_storage' operation='create' />
    <enum>
      <entry value='850' />
      <entry value='1024' />
    </enum>
  </property>
  <property kind='fixed' name='architecture' unit='label' value='x86_64' />
</hardware_profile>

Images

;T;@�I"/drivers/;T{;{ ;I"`~ Drivers

Deltacloud drivers

Deltacloud provides drivers for a growing number of popular IaaS cloud providers. This page contains notes relevant to specific cloud provider drivers, such as the credentials that should be used for a given cloud provider. Furthermore the information here outlines the mechanism through which any API call sent by a given client to a Deltacloud server instance may be routed to a specific driver, regardless of the 'default' driver that the Deltacloud server was invoked for.

Dynamic driver switching

When the Deltacloud server is started it is passed a parameter that specifies the default driver to be used for API operations:

Notes on specific drivers

$ deltacloudd -i ec2

The above example shows how to start the Detlacloud server with the Amazon EC2 driver. It is possible to start a number of Deltacloud server instances for each cloud provider that you wish to connect to (e.g. on different ports). There is also a mechanism is with which you can instruct the server to use a specific driver, regardless of the current default. The Deltacloud API drivers collection (e.g. GET /api/drivers) provides a list of all currently supported cloud provider drivers.

Some drivers also support the notion of a provider. Changing the provider makes it possible to use the same driver against different instances of a cloud, for example different regions in EC2 or different installations of RHEV-M. The possible range of values for the provider is driver-specific, and it is listed in the notes for each driver below.

The driver and provider can be selected through the request headers X-Deltacloud-Driver and X-Deltacloud-Provider. For example, including the headers X-Deltacloud-Driver: ec2 and X-Deltacloud-Provider: eu-west-1 ensures that a request will be serviced by the EC2 driver, and that the driver will use the eu-west-1 region in EC2.

Driver functionality and Credentials

Compute Driver Functionality

	Create new instances	Start stopped instances	Stop running instances	Reboot running instances	Destroy instances	List all/get details about hardware profiles	List all/get details about realms	List all/get details about images	List all/get details about instances
Amazon EC2	yes	no	yes	yes	yes	yes	yes	yes	yes
Eucalyptus	yes	no	yes	yes	yes	yes	yes	yes	yes
Fujitsu FGCP	yes	yes	yes	no	yes	yes	yes	yes	yes
IBM SmartCloud	yes	yes	yes	yes	yes	yes	yes	yes	yes
GoGrid	yes	no	yes	yes	yes	yes	yes	yes	yes
OpenNebula	yes	yes	yes	yes	yes	yes	yes	yes	yes
Rackspace	yes	no	yes	yes	yes	yes	yes	yes	yes
RHEV-M	yes	yes	yes	no	yes	yes	yes	yes	yes
RimuHosting	yes	yes	yes	yes	yes	yes	yes	yes	yes
Terremark	yes	yes	yes	yes	yes	yes	yes	yes	yes
vSphere	yes	yes	yes	yes	yes	yes	yes	yes	yes
OpenStack	yes	yes	yes	yes	yes	yes	yes	yes	yes
Aruba cloud.it	yes	yes	yes	yes	yes	yes	yes	yes	yes

Storage Driver Functionality

	Create new buckets	Update/delete buckets	Create new blobs	Update/delete blobs	Read/write blob attributes	Read/write individual blob attributes
Amazon S3	yes	yes	yes	yes	yes	yes
Eucalyptus Walrus	yes	yes	yes	yes	yes	yes
Rackspace CloudFiles	yes	yes	yes	yes	yes	yes
Microsoft Azure	yes	yes	yes	yes	yes	yes
Google Storage	yes	yes	yes	yes	yes	yes

Deltacloud uses basic HTTP authentication to receive credentials from the client and passes them through to the particular back-end cloud. The credentials always consist of a username and password and they are never stored on the server. The exact credentials for logging into the server, and a place where you can find them, depends on the backend cloud that the server is talking to.

The following table gives details about the credentials that must be provided for each of the supported clouds. The entry from the Driver column needs to be passed as the -i option to the deltacloudd server daemon. Note that some of the drivers require additional information, e.g. API endpoint URL's. For more details see the Notes on specific drivers section.

Cloud provider credentials

Cloud	Driver	Username	Password	Notes
mock	mock	mockuser	mockpassword	The mock driver does not communicate with any cloud; it just pretends to be a cloud.
Amazon EC2/S3	ec2	Access Key ID	Secret Access Key	Retrieve neccessary information from the Security Credentials page in your AWS account.
Eucalyptus	eucalyptus	Access Key ID	Secret Access Key
Fujitsu FGCP	fgcp	User certificate's folder name	User certificate's passphrase	Set the environment variable FGCP_CERT_DIR to a folder where the folder with UserCert.p12 is stored or place UserCert.p12 in ~/.deltacloud/drivers/fgcp/<Username>/ in a linux environment, or %USERPROFILE%\.deltacloud\drivers\fgcp\<Username>\ in Windows. Then use Username to authenticate.
GoGrid	gogrid	API Key	Shared Secret	Go to My Account > API Keys for your account and click on the key you want to use to find the Shared Secret.
IBM SmartCloud	sbc	Username	Password
Microsoft Azure (Storage Account only)	azure	Public Storage Account Name	Primary Access Key	The Storage Account Name is chosen when you create the service (e.g. name in name.blob.core.windows.net). The name and the access key are available from the service control panel.
OpenNebula	opennebula	OpenNebula user	OpenNebula password	Set the environment variable OCCI_URL to the address on which OpenNebula's OCCI server is listening.
OpenStack	openstack	OpenStack user	The username is OpenStack user name and tenant_name concatenated with a '+' and password is your openstack service password.	Set the environment variable API_PROVIDER to the URL of Keystone Identity service. Alternatively use the '-P' option when starting the Deltacloud server. See notes for more info.
Rackspace Cloud Servers/Cloud Files	rackspace	Rackspace user name	API Key	Obtain the key from the API Access page in your control panel.
RHEV-M	rhevm	RHEV-M user name plus Windows domain, e.g., admin@rhevm.example.com	RHEV-M password	Set the environment variable API_PROVIDER to the URL of the RHEV-M REST API endpoint.
Rimuhosting	rimuhosting	not used (?)	API Key
Terremark	terremark	Username	Password
VMware vSphere	vsphere	vSphere user	vSphere user password	Set the environment variable API_PROVIDER to the hostname of the vSphere server and the Datastore.
Aruba cloud.it	aruba	Username	Password

Notes on specific drivers

EC2 driver

The providers for the EC2 driver correspond to AWS's regions, and currently support all EC2 regions.

Eucalyptus driver

The Eucalyptus driver is based on the EC2 driver.

The driver allows selecting the Eucalyptus installation by setting a provider in the format

For example, for the Eucalyptus installation at 192.168.1.1:8773 and a Walrus installation at 192.168.1.2:8773, the driver can be pointed at that installation by passing the request headers

X-Deltacloud-Driver: eucalyptus
X-Deltacloud-Provider: ec2=192.168.1.1:8773;s3=192.168.1.2:8773

IBM Smartcloud driver

When using the IBM SmartCloud driver, the credentials passed in response to the HTTP 401 authentication challenge should be your IBM SmartCloud username and password.

OpenNebula

When you use the OpenNebula driver, the credentials passed in response to the HTTP 401 authentication challenge should be your OpenNebula user and password.

The address, on which the OCCI server is listening, needs to be defined in an environment variable called OCCI_URL.

The OpenNebula driver has been updated to support v3.x of the OpenNebula API. The driver is contributed by Daniel Molina who has also put together a guide for using OpenNebula through Deltacloud.

Fujitsu FGCP driver

When you use the Fujitsu FGCP driver, do not authenticate with your FGCP Portal username. Use the name of the folder in which your UserCert.p12 is stored. UserCert.p12 is the certificate you issued on the FGCP Portal to access MyPortal.

Set the environment variable FGCP_CERT_DIR to override the default path ~/.deltacloud/drivers/fgcp/ to locate the Username folder with the UserCert.p12 file.

FGCP virtual systems and networks are both mapped to realms:

Creating a firewall is equivalent to creating a FGCP virtual system. Specify a system descriptor ID as firewall description (e.g. "1-tier Skeleton").
Destroying a firewall destroys the virtual system. All instances in it need to be in the STOPPED state. This operation first stops the firewall and therefore it can take five minutes until the firewall actually disappears.
When creating an instance, specify a network segment realm as target location.

OpenStack driver

To use the Openstack driver you need to set the API_PROVIDER environment variable, or the 'X-Deltacloud-Provider' HTTP header to the URI of the Keystone Identity service (you should get this from your Openstack service administrator). You can also pass this with the '-P' option when starting the Deltacloud server.

Furthermore, you need to provide username, tenant_name and password for authentication. The username and tenant_name are specified as one string, concatenated with '+'. For example, with a username of "you@domain.com" and tenantname of "you@domain.com-default-tenant", you would pass "you@domain.com+you@domain.com-default-tenant" as the username in HTTP basic authentication to Deltacloud. This is explained further in this blog post.

Rackspace driver

When you use the Rackspace-cloud driver (Rackspace cloud used to be called "Mosso") - the password in a HTTP 401 challenge should be your API key, NOT your Rackspace account password. You can get the API-key, or generate a new one, from the Rackspace console.

RHEV-M driver

The RHEV-M driver supports latest release of Red Hat Enterprise Virtualization Manager (3.0 currently). In order to make the driver work with this provider, you need to set the API_PROVIDER environment variable or use the 'X-Deltacloud-Provider' request header to the URL of the RHEV-M REST API entry point. The usual URL looks like:

API_PROVIDER="https://rhevm.hostname.com:8443/api;645e425e-66fe-4ac9-8874-537bd10ef08d"

To make sure that you have right credentials, try to access https://rhevm.hostname.com:8443/rhevm-api in your browser. If you're able to authenticate within the browser, then the crendentials you used are valid Deltacloud credentials.

In order to make RHEV-M driver work properly, you need to set the RHEV-M Data Center UUID you want to speak with in API_PROVIDER url (see the example above). To obtain a list of all Data Centers you can choose from, start Deltacloud API without specifying a datacenter in the API_PROVIDER URL and do this request:

GET /api/drivers/rhevm?format=xml

The list of possible datacenters will appear in the 'providers' section.

RimuHosting

Further details coming soon.

VMware vSphere driver

You can find the details on how to make the VMware vSphere driver work with Deltacloud API in vSphere Setup in Aeolus project wiki.

In order to connect to vSphere, you need to set the API_PROVIDER environment variable or use the 'X-Deltacloud-Provider' HTTP header in the request to the vSphere host you want to use and the Datastore you want to speak to. For example:

API_PROVIDER="vsphere.hostname.com;DATASTORE-ID"

The username and password in 401 challenge should be the same as you use in the vSphere Control Center.

;T; I"�j

Deltacloud drivers

Dynamic driver switching

When the Deltacloud server is started it is passed a parameter that specifies the default driver to be used for API operations:

Notes on specific drivers

$ deltacloudd -i ec2

Driver functionality and Credentials

Compute Driver Functionality

	Create new instances	Start stopped instances	Stop running instances	Reboot running instances	Destroy instances	List all/get details about hardware profiles	List all/get details about realms	List all/get details about images	List all/get details about instances
Amazon EC2	yes	no	yes	yes	yes	yes	yes	yes	yes
Eucalyptus	yes	no	yes	yes	yes	yes	yes	yes	yes
Fujitsu FGCP	yes	yes	yes	no	yes	yes	yes	yes	yes
IBM SmartCloud	yes	yes	yes	yes	yes	yes	yes	yes	yes
GoGrid	yes	no	yes	yes	yes	yes	yes	yes	yes
OpenNebula	yes	yes	yes	yes	yes	yes	yes	yes	yes
Rackspace	yes	no	yes	yes	yes	yes	yes	yes	yes
RHEV-M	yes	yes	yes	no	yes	yes	yes	yes	yes
RimuHosting	yes	yes	yes	yes	yes	yes	yes	yes	yes
Terremark	yes	yes	yes	yes	yes	yes	yes	yes	yes
vSphere	yes	yes	yes	yes	yes	yes	yes	yes	yes
OpenStack	yes	yes	yes	yes	yes	yes	yes	yes	yes
Aruba cloud.it	yes	yes	yes	yes	yes	yes	yes	yes	yes

Storage Driver Functionality

	Create new buckets	Update/delete buckets	Create new blobs	Update/delete blobs	Read/write blob attributes	Read/write individual blob attributes
Amazon S3	yes	yes	yes	yes	yes	yes
Eucalyptus Walrus	yes	yes	yes	yes	yes	yes
Rackspace CloudFiles	yes	yes	yes	yes	yes	yes
Microsoft Azure	yes	yes	yes	yes	yes	yes
Google Storage	yes	yes	yes	yes	yes	yes

Cloud provider credentials

Cloud	Driver	Username	Password	Notes
mock	mock	mockuser	mockpassword	The mock driver does not communicate with any cloud; it just pretends to be a cloud.
Amazon EC2/S3	ec2	Access Key ID	Secret Access Key	Retrieve neccessary information from the Security Credentials page in your AWS account.
Eucalyptus	eucalyptus	Access Key ID	Secret Access Key
Fujitsu FGCP	fgcp	User certificate's folder name	User certificate's passphrase	Set the environment variable FGCP_CERT_DIR to a folder where the folder with UserCert.p12 is stored or place UserCert.p12 in ~/.deltacloud/drivers/fgcp/<Username>/ in a linux environment, or %USERPROFILE%\.deltacloud\drivers\fgcp\<Username>\ in Windows. Then use Username to authenticate.
GoGrid	gogrid	API Key	Shared Secret	Go to My Account > API Keys for your account and click on the key you want to use to find the Shared Secret.
IBM SmartCloud	sbc	Username	Password
Microsoft Azure (Storage Account only)	azure	Public Storage Account Name	Primary Access Key	The Storage Account Name is chosen when you create the service (e.g. name in name.blob.core.windows.net). The name and the access key are available from the service control panel.
OpenNebula	opennebula	OpenNebula user	OpenNebula password	Set the environment variable OCCI_URL to the address on which OpenNebula's OCCI server is listening.
OpenStack	openstack	OpenStack user	The username is OpenStack user name and tenant_name concatenated with a '+' and password is your openstack service password.	Set the environment variable API_PROVIDER to the URL of Keystone Identity service. Alternatively use the '-P' option when starting the Deltacloud server. See notes for more info.
Rackspace Cloud Servers/Cloud Files	rackspace	Rackspace user name	API Key	Obtain the key from the API Access page in your control panel.
RHEV-M	rhevm	RHEV-M user name plus Windows domain, e.g., admin@rhevm.example.com	RHEV-M password	Set the environment variable API_PROVIDER to the URL of the RHEV-M REST API endpoint.
Rimuhosting	rimuhosting	not used (?)	API Key
Terremark	terremark	Username	Password
VMware vSphere	vsphere	vSphere user	vSphere user password	Set the environment variable API_PROVIDER to the hostname of the vSphere server and the Datastore.
Aruba cloud.it	aruba	Username	Password

Notes on specific drivers

EC2 driver

The providers for the EC2 driver correspond to AWS's regions, and currently support all EC2 regions.

Eucalyptus driver

The Eucalyptus driver is based on the EC2 driver.

The driver allows selecting the Eucalyptus installation by setting a provider in the format

For example, for the Eucalyptus installation at 192.168.1.1:8773 and a Walrus installation at 192.168.1.2:8773, the driver can be pointed at that installation by passing the request headers

X-Deltacloud-Driver: eucalyptus
X-Deltacloud-Provider: ec2=192.168.1.1:8773;s3=192.168.1.2:8773

IBM Smartcloud driver

When using the IBM SmartCloud driver, the credentials passed in response to the HTTP 401 authentication challenge should be your IBM SmartCloud username and password.

OpenNebula

When you use the OpenNebula driver, the credentials passed in response to the HTTP 401 authentication challenge should be your OpenNebula user and password.

The address, on which the OCCI server is listening, needs to be defined in an environment variable called OCCI_URL.

The OpenNebula driver has been updated to support v3.x of the OpenNebula API. The driver is contributed by Daniel Molina who has also put together a guide for using OpenNebula through Deltacloud.

Fujitsu FGCP driver

Set the environment variable FGCP_CERT_DIR to override the default path ~/.deltacloud/drivers/fgcp/ to locate the Username folder with the UserCert.p12 file.

FGCP virtual systems and networks are both mapped to realms:

Creating a firewall is equivalent to creating a FGCP virtual system. Specify a system descriptor ID as firewall description (e.g. "1-tier Skeleton").
Destroying a firewall destroys the virtual system. All instances in it need to be in the STOPPED state. This operation first stops the firewall and therefore it can take five minutes until the firewall actually disappears.
When creating an instance, specify a network segment realm as target location.

OpenStack driver

Rackspace driver

RHEV-M driver

API_PROVIDER="https://rhevm.hostname.com:8443/api;645e425e-66fe-4ac9-8874-537bd10ef08d"

GET /api/drivers/rhevm?format=xml

The list of possible datacenters will appear in the 'providers' section.

RimuHosting

Further details coming soon.

VMware vSphere driver

You can find the details on how to make the VMware vSphere driver work with Deltacloud API in vSphere Setup in Aeolus project wiki.

API_PROVIDER="vsphere.hostname.com;DATASTORE-ID"

The username and password in 401 challenge should be the same as you use in the vSphere Control Center.

;T; I"�h

Deltacloud drivers

Dynamic driver switching

When the Deltacloud server is started it is passed a parameter that specifies the default driver to be used for API operations:

Notes on specific drivers

$ deltacloudd -i ec2

Driver functionality and Credentials

Compute Driver Functionality

	Create new instances	Start stopped instances	Stop running instances	Reboot running instances	Destroy instances	List all/get details about hardware profiles	List all/get details about realms	List all/get details about images	List all/get details about instances
Amazon EC2	yes	no	yes	yes	yes	yes	yes	yes	yes
Eucalyptus	yes	no	yes	yes	yes	yes	yes	yes	yes
Fujitsu FGCP	yes	yes	yes	no	yes	yes	yes	yes	yes
IBM SmartCloud	yes	yes	yes	yes	yes	yes	yes	yes	yes
GoGrid	yes	no	yes	yes	yes	yes	yes	yes	yes
OpenNebula	yes	yes	yes	yes	yes	yes	yes	yes	yes
Rackspace	yes	no	yes	yes	yes	yes	yes	yes	yes
RHEV-M	yes	yes	yes	no	yes	yes	yes	yes	yes
RimuHosting	yes	yes	yes	yes	yes	yes	yes	yes	yes
Terremark	yes	yes	yes	yes	yes	yes	yes	yes	yes
vSphere	yes	yes	yes	yes	yes	yes	yes	yes	yes
OpenStack	yes	yes	yes	yes	yes	yes	yes	yes	yes
Aruba cloud.it	yes	yes	yes	yes	yes	yes	yes	yes	yes

Storage Driver Functionality

	Create new buckets	Update/delete buckets	Create new blobs	Update/delete blobs	Read/write blob attributes	Read/write individual blob attributes
Amazon S3	yes	yes	yes	yes	yes	yes
Eucalyptus Walrus	yes	yes	yes	yes	yes	yes
Rackspace CloudFiles	yes	yes	yes	yes	yes	yes
Microsoft Azure	yes	yes	yes	yes	yes	yes
Google Storage	yes	yes	yes	yes	yes	yes

Cloud provider credentials

Cloud	Driver	Username	Password	Notes
mock	mock	mockuser	mockpassword	The mock driver does not communicate with any cloud; it just pretends to be a cloud.
Amazon EC2/S3	ec2	Access Key ID	Secret Access Key	Retrieve neccessary information from the Security Credentials page in your AWS account.
Eucalyptus	eucalyptus	Access Key ID	Secret Access Key
Fujitsu FGCP	fgcp	User certificate's folder name	User certificate's passphrase	Set the environment variable FGCP_CERT_DIR to a folder where the folder with UserCert.p12 is stored or place UserCert.p12 in ~/.deltacloud/drivers/fgcp/<Username>/ in a linux environment, or %USERPROFILE%\.deltacloud\drivers\fgcp\<Username>\ in Windows. Then use Username to authenticate.
GoGrid	gogrid	API Key	Shared Secret	Go to My Account > API Keys for your account and click on the key you want to use to find the Shared Secret.
IBM SmartCloud	sbc	Username	Password
Microsoft Azure (Storage Account only)	azure	Public Storage Account Name	Primary Access Key	The Storage Account Name is chosen when you create the service (e.g. name in name.blob.core.windows.net). The name and the access key are available from the service control panel.
OpenNebula	opennebula	OpenNebula user	OpenNebula password	Set the environment variable OCCI_URL to the address on which OpenNebula's OCCI server is listening.
OpenStack	openstack	OpenStack user	The username is OpenStack user name and tenant_name concatenated with a '+' and password is your openstack service password.	Set the environment variable API_PROVIDER to the URL of Keystone Identity service. Alternatively use the '-P' option when starting the Deltacloud server. See notes for more info.
Rackspace Cloud Servers/Cloud Files	rackspace	Rackspace user name	API Key	Obtain the key from the API Access page in your control panel.
RHEV-M	rhevm	RHEV-M user name plus Windows domain, e.g., admin@rhevm.example.com	RHEV-M password	Set the environment variable API_PROVIDER to the URL of the RHEV-M REST API endpoint.
Rimuhosting	rimuhosting	not used (?)	API Key
Terremark	terremark	Username	Password
VMware vSphere	vsphere	vSphere user	vSphere user password	Set the environment variable API_PROVIDER to the hostname of the vSphere server and the Datastore.
Aruba cloud.it	aruba	Username	Password

Notes on specific drivers

EC2 driver

The providers for the EC2 driver correspond to AWS's regions, and currently support all EC2 regions.

Eucalyptus driver

The Eucalyptus driver is based on the EC2 driver.

The driver allows selecting the Eucalyptus installation by setting a provider in the format

For example, for the Eucalyptus installation at 192.168.1.1:8773 and a Walrus installation at 192.168.1.2:8773, the driver can be pointed at that installation by passing the request headers

X-Deltacloud-Driver: eucalyptus
X-Deltacloud-Provider: ec2=192.168.1.1:8773;s3=192.168.1.2:8773

IBM Smartcloud driver

When using the IBM SmartCloud driver, the credentials passed in response to the HTTP 401 authentication challenge should be your IBM SmartCloud username and password.

OpenNebula

When you use the OpenNebula driver, the credentials passed in response to the HTTP 401 authentication challenge should be your OpenNebula user and password.

The address, on which the OCCI server is listening, needs to be defined in an environment variable called OCCI_URL.

The OpenNebula driver has been updated to support v3.x of the OpenNebula API. The driver is contributed by Daniel Molina who has also put together a guide for using OpenNebula through Deltacloud.

Fujitsu FGCP driver

Set the environment variable FGCP_CERT_DIR to override the default path ~/.deltacloud/drivers/fgcp/ to locate the Username folder with the UserCert.p12 file.

FGCP virtual systems and networks are both mapped to realms:

Creating a firewall is equivalent to creating a FGCP virtual system. Specify a system descriptor ID as firewall description (e.g. "1-tier Skeleton").
Destroying a firewall destroys the virtual system. All instances in it need to be in the STOPPED state. This operation first stops the firewall and therefore it can take five minutes until the firewall actually disappears.
When creating an instance, specify a network segment realm as target location.

OpenStack driver

Rackspace driver

RHEV-M driver

API_PROVIDER="https://rhevm.hostname.com:8443/api;645e425e-66fe-4ac9-8874-537bd10ef08d"

GET /api/drivers/rhevm?format=xml

The list of possible datacenters will appear in the 'providers' section.

RimuHosting

Further details coming soon.

VMware vSphere driver

You can find the details on how to make the VMware vSphere driver work with Deltacloud API in vSphere Setup in Aeolus project wiki.

API_PROVIDER="vsphere.hostname.com;DATASTORE-ID"

The username and password in 401 challenge should be the same as you use in the vSphere Control Center.

;T;@�I"/credentials/;T{;{ ;I"�, Credentials

Cloud provider credentials

Cloud	Driver	Username	Password	Notes
mock	mock	mockuser	mockpassword	The mock driver doesn't talk to any cloud; it just pretends to be a cloud.
Amazon EC2/S3	ec2	Access Key ID	Secret Access Key	This information can be found on the Security Credentials page in your AWS account.
Eucalyptus	eucalyptus	Access Key ID	Secret Access Key
GoGrid	gogrid	API Key	Shared Secret	Go to My Account > API Keys for your account and click on the key you want to use to find the shared secret.
IBM SmartCloud	sbc	Username	Password
Microsoft Azure (Storage Account only)	azure	Public Storage Account Name	Primary Access Key	The Storage Account Name is chosen when you create the service (e.g. name in http://name.blob.core.windows.net/). This and the access key are available from the service control panel.
OpenNebula	opennebula	OpenNebula user	OpenNebula password	Set the environment variable OCCI_URL to the address on which OpenNebula's OCCI server is listening.
Rackspace Cloud Servers/Cloud Files	rackspace	Rackspace user name	API Key	Obtain the key from the API Access page in your control panel.
RHEV-M	rhevm	RHEV-M user name plus Windows domain, e.g., admin@rhevm.example.com	RHEV-M password	Set environment variable API_PROVIDER to the URL of the RHEV-M REST API endpoint.
Rimuhosting	rimuhosting	not used (?)	API Key
Terremark	terremark	Username	Password
VMware vSphere	vsphere	vSphere user	vSphere user password	Set environment variable API_PROVIDER to the hostname of the vSphere server.
OpenStack	openstack	OpenStack user	OpenStack user password	Set environment variable API_PROVIDER to the URL of OpenStack API entrypoint.

;T; I"�

Cloud provider credentials

Cloud	Driver	Username	Password	Notes
mock	mock	mockuser	mockpassword	The mock driver doesn't talk to any cloud; it just pretends to be a cloud.
Amazon EC2/S3	ec2	Access Key ID	Secret Access Key	This information can be found on the Security Credentials page in your AWS account.
Eucalyptus	eucalyptus	Access Key ID	Secret Access Key
GoGrid	gogrid	API Key	Shared Secret	Go to My Account > API Keys for your account and click on the key you want to use to find the shared secret.
IBM SmartCloud	sbc	Username	Password
Microsoft Azure (Storage Account only)	azure	Public Storage Account Name	Primary Access Key	The Storage Account Name is chosen when you create the service (e.g. name in http://name.blob.core.windows.net/). This and the access key are available from the service control panel.
OpenNebula	opennebula	OpenNebula user	OpenNebula password	Set the environment variable OCCI_URL to the address on which OpenNebula's OCCI server is listening.
Rackspace Cloud Servers/Cloud Files	rackspace	Rackspace user name	API Key	Obtain the key from the API Access page in your control panel.
RHEV-M	rhevm	RHEV-M user name plus Windows domain, e.g., admin@rhevm.example.com	RHEV-M password	Set environment variable API_PROVIDER to the URL of the RHEV-M REST API endpoint.
Rimuhosting	rimuhosting	not used (?)	API Key
Terremark	terremark	Username	Password
VMware vSphere	vsphere	vSphere user	vSphere user password	Set environment variable API_PROVIDER to the hostname of the vSphere server.
OpenStack	openstack	OpenStack user	OpenStack user password	Set environment variable API_PROVIDER to the URL of OpenStack API entrypoint.

;T; I"B

Cloud provider credentials

Cloud	Driver	Username	Password	Notes
mock	mock	mockuser	mockpassword	The mock driver doesn't talk to any cloud; it just pretends to be a cloud.
Amazon EC2/S3	ec2	Access Key ID	Secret Access Key	This information can be found on the Security Credentials page in your AWS account.
Eucalyptus	eucalyptus	Access Key ID	Secret Access Key
GoGrid	gogrid	API Key	Shared Secret	Go to My Account > API Keys for your account and click on the key you want to use to find the shared secret.
IBM SmartCloud	sbc	Username	Password
Microsoft Azure (Storage Account only)	azure	Public Storage Account Name	Primary Access Key	The Storage Account Name is chosen when you create the service (e.g. name in http://name.blob.core.windows.net/). This and the access key are available from the service control panel.
OpenNebula	opennebula	OpenNebula user	OpenNebula password	Set the environment variable OCCI_URL to the address on which OpenNebula's OCCI server is listening.
Rackspace Cloud Servers/Cloud Files	rackspace	Rackspace user name	API Key	Obtain the key from the API Access page in your control panel.
RHEV-M	rhevm	RHEV-M user name plus Windows domain, e.g., admin@rhevm.example.com	RHEV-M password	Set environment variable API_PROVIDER to the URL of the RHEV-M REST API endpoint.
Rimuhosting	rimuhosting	not used (?)	API Key
Terremark	terremark	Username	Password
VMware vSphere	vsphere	vSphere user	vSphere user password	Set environment variable API_PROVIDER to the hostname of the vSphere server.
OpenStack	openstack	OpenStack user	OpenStack user password	Set environment variable API_PROVIDER to the URL of OpenStack API entrypoint.

;T;@�I"/instances/;T{;{ ;I"� Instances

Instances

An instance represents the core of all cloud compute activity: a running virtual machine. An instance is created from an image, with a specified hardware profile and in a given realm. Each instance can have a number of other attributes, not all of which are exposed for all back-end cloud providers. The full list of possible instance attributes is:

Attribute	Meaning
owner_id	the id of the cloud provider account that launched the instance
image_id	the id of the image from which the instance was launched
name	a human readable name for the instance given at launch time
realm_id	realm into which the instance was launched
state	current state of the instance (e.g. 'running')
actions	actions that a client may effect on the instance, based on current state
public_addresses	the globally routable IP address of the instance
private_addresses	the private IP address of the instance, routable within its private network
instance_profile	the specific values of memory, cpu, storage
launch_time	timestamp at which the instance was launched
keyname	name of authentication key, if this method is used for authentication (e.g. EC2)
username	the username for authentication when connecting to the instance
password	the password used together with username above
firewalls	the firewalls that this instance was launched into (EC2 specific)

Storage resources

Get a list of all current instances

To produce a list of all current instances in the given cloud (belonging to the specified account) use call GET /api/instances. The example below displays instances in the Amazon EC2 cloud.

Example request:

GET /api/instances?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Client response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 2790
<?xml version='1.0' encoding='utf-8' ?>
<instances>
  <instance href='http://localhost:3001/api/instances/i-1fbc627e' id='i-1fbc627e'>
    <name>ami-f51aff9c</name>
    <owner_id>393485797142</owner_id>
    <image href='http://localhost:3001/api/images/ami-f51aff9c' id='ami-f51aff9c'></image>
    <realm href='http://localhost:3001/api/realms/us-east-1c' id='us-east-1c'></realm>
    <state>RUNNING</state>
    <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.medium' id='c1.medium'>
    </hardware_profile>
    <actions>
      <link href='http://localhost:3001/api/instances/i-1fbc627e/reboot' method='post' rel='reboot' />
      <link href='http://localhost:3001/api/instances/i-1fbc627e/stop' method='post' rel='stop' />
      <link href='http://localhost:3001/api/instances/i-1fbc627e/run;id=i-1fbc627e' method='post' rel='run' />
    </actions>
    <launch_time>2011-07-22T11:29:48.000Z</launch_time>
    <public_addresses><address>ec2-50-16-183-107.compute-1.amazonaws.com</address></public_addresses>
    <private_addresses><address>domU-12-31-39-0F-79-D4.compute-1.internal</address></private_addresses>
    <firewalls>
      <firewall href='http://localhost:3001/api/firewalls/default' id='default'></firewall>
    </firewalls>
    <authentication type='key'>
      <login>
        <keyname>eftah</keyname>
      </login>
    </authentication>
  </instance>
  <instance href='http://localhost:3001/api/instances/i-f3ba6492' id='i-f3ba6492'>
    <name>ami-2b5fba42</name>
    <owner_id>393485797142</owner_id>
    <image href='http://localhost:3001/api/images/ami-2b5fba42' id='ami-2b5fba42'></image>
    <realm href='http://localhost:3001/api/realms/us-east-1d' id='us-east-1d'></realm>
    <state>RUNNING</state>
    <hardware_profile href='http://localhost:3001/api/hardware_profiles/m1.small' id='m1.small'>
    </hardware_profile>
    <actions>
      <link href='http://localhost:3001/api/instances/i-f3ba6492/reboot' method='post' rel='reboot' />
      <link href='http://localhost:3001/api/instances/i-f3ba6492/stop' method='post' rel='stop' />
      <link href='http://localhost:3001/api/instances/i-f3ba6492/run;id=i-f3ba6492' method='post' rel='run' />
    </actions>
    <launch_time>2011-07-22T11:32:25.000Z</launch_time>
    <public_addresses><address>ec2-184-73-78-87.compute-1.amazonaws.com</address></public_addresses>
    <private_addresses><address>ip-10-196-89-221.ec2.internal</address></private_addresses>
    <firewalls>
      <firewall href='http://localhost:3001/api/firewalls/default' id='default'></firewall>
      <firewall href='http://localhost:3001/api/firewalls/test' id='test'></firewall>
    </firewalls>
    <authentication type='key'>
      <login>
        <keyname>eftah</keyname>
      </login>
    </authentication>
  </instance>
</instances>

Get the details of an instance

To get the details of a specific instance use call GET /api/instances/:id. The example below shows an instance launched in the Rackspace Cloudservers cloud. As you can see, the type of authentication is password but the username and password attributes are blank. The reason why these attributes are blank is that Rackspace only reports these values once, during instance creation and not for subsequent requests. To find an example of the response from an instance go to the Create an instance section.

Example request:

GET /api/instances/20112212?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1167
<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3002/api/instances/20112212' id='20112212'>
  <name>myserver</name>
  <owner_id>mandreou</owner_id>
  <image href='http://localhost:3002/api/images/53' id='53'></image>
  <realm href='http://localhost:3002/api/realms/us' id='us'></realm>
  <state>RUNNING</state>
  <hardware_profile href='http://localhost:3002/api/hardware_profiles/1' id='1'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3002/api/instances/20112212/reboot' method='post' rel='reboot' />
    <link href='http://localhost:3002/api/instances/20112212/stop' method='post' rel='stop' />
    <link href='http://localhost:3002/api/instances/20112212/run;id=20112212' method='post' rel='run' />
    <link href='http://localhost:3002/api/images;instance_id=20112212' method='post' rel='create_image' />
  </actions>
  <public_addresses><address>50.57.116.72</address></public_addresses>
  <private_addresses><address>10.182.143.64</address></private_addresses>
  <authentication type='password'>
    <login>
      <username>root</username>
      <password></password>
    </login>
  </authentication>
</instance>

Launch an action on an instance

To launch an action on an instance use call POST /api/instances/:id/:action. The valid actions for an instance are specified by the instance states entity. The set of permissible actions that a client may perform on an instance at a given time depends on the current instance state. These are reported by the <actions> attribute in the Deltacloud server response to the GET /api/instances/:id call (Get the details of an instance section). The first example below shows a reboot action on a currently running instance, followed by a stop action.

After invoking the stop operation, the instance state may still be reported as RUNNING in the Deltacloud server response. It is because it may take some time for the instance state to change in the back-end cloud provider (and this will vary between providers). You can assure yourself that the action was performed correctly by requesting a list of instances or a by requesting a specific instance.

The Deltacloud server also allows a special 'run-on-instance' action for some cloud provider instances.This enables a client to perform a command on a running instance over SSH. The Deltacloud server will return the output of that command to the client. This is reported as the run action in the list of instance actions, if it is available. The cmd parameter specifies the command, which is executed on a running instance.The private_key parameter specifies the authentication for cloud providers that expect key based authentication for connecting to instances . For those cloud providers that use username/password for authentication, the password parameter specifies the authentication. Examples below illustrate the run-on-instance feature for an Amazon EC2 instance and a Rackspace Cloudservers instance. The examples differ in how authentication is performed (private RSA Key for EC2 and username/password for Rackspace).

Example request (reboot):

POST /api/instances/i-f3ba6492/reboot?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1322

<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3001/api/instances/i-f3ba6492' id='i-f3ba6492'>
  <name>ami-f51aff9c</name>
  <owner_id>393485797142</owner_id>
  <image href='http://localhost:3001/api/images/ami-f51aff9c' id='ami-f51aff9c'></image>
  <realm href='http://localhost:3001/api/realms/us-east-1c' id='us-east-1c'></realm>
  <state>RUNNING</state>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.medium' id='c1.medium'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3001/api/instances/i-f3ba6492/reboot' method='post' rel='reboot' />
    <link href='http://localhost:3001/api/instances/i-f3ba6492/stop' method='post' rel='stop' />
    <link href='http://localhost:3001/api/instances/i-f3ba6492/run;id=i-f3ba6492' method='post' rel='run' />
  </actions>
  <launch_time>2011-07-22T11:29:48.000Z</launch_time>
  <public_addresses><address>ec2-50-16-183-107.compute-1.amazonaws.com</address></public_addresses>
  <private_addresses><address>domU-12-31-39-0F-79-D4.compute-1.internal</address></private_addresses>
  <firewalls>  <firewall href='http://localhost:3001/api/firewalls/default' id='default'></firewall></firewalls>
  <authentication type='key'>
    <login>
      <keyname>eftah</keyname>
    </login>
  </authentication>
</instance>

Example request (stop):

POST /api/instances/20112212/stop?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1167

<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3002/api/instances/20112212' id='20112212'>
  <name>myserver</name>
  <owner_id>mandreou</owner_id>
  <image href='http://localhost:3002/api/images/53' id='53'></image>
  <realm href='http://localhost:3002/api/realms/us' id='us'></realm>
  <state>STOPPED</state>
  <hardware_profile href='http://localhost:3002/api/hardware_profiles/1' id='1'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3002/api/instances/20112212/reboot' method='post' rel='reboot' />
    <link href='http://localhost:3002/api/instances/20112212/stop' method='post' rel='stop' />
    <link href='http://localhost:3002/api/instances/20112212/run;id=20112212' method='post' rel='run' />
    <link href='http://localhost:3002/api/images;instance_id=20112212' method='post' rel='create_image' />
  </actions>
  <public_addresses><address>50.57.116.72</address></public_addresses>
  <private_addresses><address>10.182.143.64</address></private_addresses>
  <authentication type='password'>
    <login>
      <username>root</username>
      <password></password>
    </login>
  </authentication>
</instance>

Example request (run-on-instance Amazon EC2):

× Note:

Run-on-instance requests to EC2 instances will fail with 502 Bad Gateway - Execution Expired if the firewall in which the instance was launched does not grant SSH access (tcp, port 22) to the requesting client's IP address. This access may be given using the firewalls collection.

POST /api/instances/i-afde73ce/run?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Content-Length: 1927
Content-Type: multipart/form-data; boundary=----------------------------332ed6691ab8

------------------------------332ed6691ab8
Content-Disposition: form-data; name="cmd"

uname -a; ls -l
------------------------------332ed6691ab8
Content-Disposition: form-data; name="private_key"

-----BEGIN RSA PRIVATE KEY-----.BTTEpATBAAKDAQEA4t3R/PgUo3KDDuX4
vZZpZuXFkAA/5X2lFRY2/xsQqbPz9utPOsUoPf9Aajy+.vGRJrO2KAJ9U/JTNDzr
3NPbG3aHYPSnwsSxkFSG4Q6ukqYlxT9TPF/+wvdxfAtp3nYw3ZGuSX/DOtToWtQ8
F/+GvHTHKDQSB+TeEs1Sa/PFwxpspB+RqHbqOTWPsFOHL+9sZGTqd6D4B.R6DBNh
9Dabu9BVZrl5BTOKlbAgrKnzsGKvaBST/D2.AB/HB9/GOT36OoBmEr1y9gFwu4Xf
aKw+AXVf9y9TKxVD3TE5uB.oDZG8s4gr2e691xHG9YGzBBBbNzfFh94b3Td5JBGS
zRDTKYBfOgv+Zu5N+WyeaZ0ab50DwK9BXYB5hsRu5zbAqObbTZkwN9qwBOZHzATX
wVTZU+eTz.39OZPqu4fQwrBN13lDbUoZxlqT9g2+haQBB9sTDzQEZ08QKBgQDJyw
lBBZqQKBgQDz5E2rL59lNS5pBxDO9r6B9rXtBBTZ5tZUWNFRvyNsxY5nJT03.KDw
qo2VP5WDZeOhRWEUY96./pWN3hNFDkT44vDpeXQUh3rBHyD5DWvWxAze9Ds+UTO/
esuLwP5vXhfoYp6gV9XG.BEBzSVq8kZ2kZtlbWHTR/SGepTkDgYEA9zwHTDhtKR2
KS8/BSFZQ884ZqFkbwT9fTW6s0rgUSBDTUDgYEA9W5HXTOEPGFDnqBhKPLN.xD9D
vZZpZuXFkAA/5X2lFRY2/xsQqbPz9utPOsUoPf9Aajy+.vGRJrO2KAJ9U/JTNDzr
lBBZqQKBgQDz5E2rL59lNS5pBxDO9r6B9rXtBBTZ5tZUWNFRvyNsxY5nJT03.KDw
F/+GvHTHKDQSB+TeEs1Sa/PFwxpspB+RqHbqOTWPsFOHL+9sZGTqd6D4B.R6DBNh
wVTZU+eTz.39OZPqu4fQwrBN13lDbUoZxlqT9g2+haQBB9sTDzQEZ08QKBgQDJyw
lBBZqQKBgQDz5E2rL59lNS5pBxDO9r6B9rXtBBTZ5tZUWNFRvyNsxY5nJT03.KDw
DAAeVWKU1OyDXfN4v6Zn1nNrhSkdrd+XV0nTLExsfg==.-----END RSA PRIVAT
E KEY-----
------------------------------332ed6691ab8--

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Mon, 25 Jul 2011 12:56:02 GMT
Content-Length: 497

<instance href='http://localhost:3001/api/instances/i-afde73ce' id='i-afde73ce'>
  <public_address>
    ec2-50-19-59-126.compute-1.amazonaws.com
  </public_address>
  <command>
    uname -a; ls -l
  </command>
  <output>Linux domU-12-31-39-0F-E1-78 2.6.21.7-2.fc8xen #1 SMP Fri Feb 15 12:39:36 EST 2008 i686 i686 i386 GNU/Linux
  total 140
  -rw-r--r-- 1 root root 137263 Mar 26  2008 ec2-ami-tools-1.3-19974.noarch.rpm
  -rw-r--r-- 1 root root      0 Mar 26  2008 firstlogin
  </output>
</instance>

Example request (run-on-instance Rackspace Cloudservers):

POST /api/instances/20117112/run?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*
Content-Length: 275
Expect: 100-continue
Content-Type: multipart/form-data; boundary=----------------------------9b05ece66f4d
------------------------------9b05ece66f4d
Content-Disposition: form-data; name="cmd"

uname -a; ifconfig; pwd
------------------------------9b05ece66f4d
Content-Disposition: form-data; name="password"

myserverqB2Uwk21I
------------------------------9b05ece66f4d--

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Mon, 25 Jul 2011 13:02:15 GMT
Content-Length: 1781

<instance href='http://localhost:3002/api/instances/20117112' id='20117112'>
  <public_address>
    50.57.117.249
  </public_address>
  <command>
    uname -a; ifconfig; pwd
  </command>
  <output>Linux myserver 2.6.35.4-rscloud #8 SMP Mon Sep 20 15:54:33 UTC 2010 x86_64 x86_64 x86_64 GNU/Linux
  eth0      Link encap:Ethernet  HWaddr 40:40:B1:7A:52:7E
            inet addr:50.57.117.249  Bcast:50.57.117.255  Mask:255.255.255.0
            inet6 addr: fe80::4240:b1ff:fe7a:527e/64 Scope:Link
            UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
            RX packets:54 errors:0 dropped:0 overruns:0 frame:0
            TX packets:62 errors:0 dropped:0 overruns:0 carrier:0
            collisions:0 txqueuelen:1000
            RX bytes:5880 (5.7 KiB)  TX bytes:6331 (6.1 KiB)
            Interrupt:24

  eth1      Link encap:Ethernet  HWaddr 40:40:8E:4B:52:23
            inet addr:10.182.131.159  Bcast:10.182.159.255  Mask:255.255.224.0
            inet6 addr: fe80::4240:8eff:fe4b:5223/64 Scope:Link
            UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
            RX packets:3 errors:0 dropped:0 overruns:0 frame:0
            TX packets:12 errors:0 dropped:0 overruns:0 carrier:0
            collisions:0 txqueuelen:1000
            RX bytes:188 (188.0 b)  TX bytes:720 (720.0 b)
            Interrupt:25

  lo        Link encap:Local Loopback
            inet addr:127.0.0.1  Mask:255.0.0.0
            inet6 addr: ::1/128 Scope:Host
            UP LOOPBACK RUNNING  MTU:16436  Metric:1
            RX packets:0 errors:0 dropped:0 overruns:0 frame:0
            TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
            collisions:0 txqueuelen:0
            RX bytes:0 (0.0 b)  TX bytes:0 (0.0 b)

  /root</output>
</instance>

Create a new instance

To create a new instance use call POST /api/instances. At least, clients must specify the image from which the virtual machine instance is created. Optionally, a client may also specify a hardware profile and a realm (with default values used otherwise). Clients can also provide a name for the new instance though this is not supported by all back-end cloud providers. You can check whether a given feature is available in the response to the Deltacloud server API entry point. The details of the new instance are returned in response to this operation.

To create an instance in the Amazon EC2 cloud a client can also specify the name of the used EC2 keypair as well as the firewalls (EC2 security groups) that the instance should be launched into. The EC2 keypair is specified with the parameter keyname while firewalls are specified sequentially as firewalls1 ... firewalls2 ... etc.

See the example below. The values for public and private addresses are blank in the server response, because they have not yet been assigned by the cloud provider. Subsequent requests for the instance details will provide these values.

As with other POST operations in the Deltacloud API, clients may specify parameters as multipart/form-data or as x-www-url-form-urlencoded content type, as you can see in examples below.

Client request (AWS EC2):

POST /api/instances?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 107
Content-Type: application/x-www-form-urlencoded

keyname=eftah&image_id=ami-f51aff9c&realm_id=us-east-1c&hwp_id=c1.medium&
firewalls1=default&firewalls2=test

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Content-Length: 1183

<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3001/api/instances/i-cbb861aa' id='i-cbb861aa'>
  <name>ami-f51aff9c</name>
  <owner_id>393485797142</owner_id>
  <image href='http://localhost:3001/api/images/ami-f51aff9c' id='ami-f51aff9c'></image>
  <realm href='http://localhost:3001/api/realms/us-east-1c' id='us-east-1c'></realm>
  <state>PENDING</state>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.medium' id='c1.medium'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3001/api/instances/i-cbb861aa/stop' method='post' rel='stop' />
    <link href='http://localhost:3001/api/instances/i-cbb861aa/run;id=i-cbb861aa' method='post' rel='run' />
  </actions>
  <launch_time>2011-07-22T16:09:45.000Z</launch_time>
  <public_addresses></public_addresses>
  <private_addresses></private_addresses>
  <firewalls>
    <firewall href='http://localhost:3001/api/firewalls/test' id='test'></firewall>
    <firewall href='http://localhost:3001/api/firewalls/default' id='default'></firewall>
  </firewalls>
  <authentication type='key'>
    <login>
      <keyname>eftah</keyname>
    </login>
  </authentication>
</instance>

In the following example you can see that the client provides the optional name parameter and that the created instance uses password type of authentication. Furthermore, the client uses a content-type of application/x-www-form-urlencoded. The username and password are returned with the details of the new instance:

Example request: (Rackspace Cloudservers)

POST /api/instances?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*
Content-Length: 34
Content-Type: application/x-www-form-urlencoded

image_id=53&hwp_id=1&name=myserver

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Content-Length: 883

<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3002/api/instances/20112212' id='20112212'>
  <name>myserver</name>
  <owner_id>mandreou</owner_id>
  <image href='http://localhost:3002/api/images/53' id='53'></image>
  <realm href='http://localhost:3002/api/realms/us' id='us'></realm>
  <state>PENDING</state>
  <hardware_profile href='http://localhost:3002/api/hardware_profiles/1' id='1'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3002/api/instances/20112212/run;id=20112212' method='post' rel='run' />
  </actions>
  <public_addresses><address>50.57.116.72</address></public_addresses>
  <private_addresses><address>10.182.143.64</address></private_addresses>
  <authentication type='password'>
    <login>
      <username>root</username>
      <password>myserver4OvKh7Ak3</password>
    </login>
  </authentication>
</instance>

Note:

The Deltacloud does not report potential errors, if you are creating an instance in vSphere. When you launch an instance, Deltacloud does not wait until the task is finished. Instead of that, Deltacloud creates a YAML representation of the instance in vSphere datastore. The YAML instance is in a 'PENDING' state until the 'real' instance is created. If the real instance fails to create, the YAML representation is removed. However, Deltacloud does not send you any error message.

Keys

;T; I".m

Instances

Attribute	Meaning
owner_id	the id of the cloud provider account that launched the instance
image_id	the id of the image from which the instance was launched
name	a human readable name for the instance given at launch time
realm_id	realm into which the instance was launched
state	current state of the instance (e.g. 'running')
actions	actions that a client may effect on the instance, based on current state
public_addresses	the globally routable IP address of the instance
private_addresses	the private IP address of the instance, routable within its private network
instance_profile	the specific values of memory, cpu, storage
launch_time	timestamp at which the instance was launched
keyname	name of authentication key, if this method is used for authentication (e.g. EC2)
username	the username for authentication when connecting to the instance
password	the password used together with username above
firewalls	the firewalls that this instance was launched into (EC2 specific)

Storage resources

Get a list of all current instances

To produce a list of all current instances in the given cloud (belonging to the specified account) use call GET /api/instances. The example below displays instances in the Amazon EC2 cloud.

Example request:

GET /api/instances?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Client response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 2790
<?xml version='1.0' encoding='utf-8' ?>
<instances>
  <instance href='http://localhost:3001/api/instances/i-1fbc627e' id='i-1fbc627e'>
    <name>ami-f51aff9c</name>
    <owner_id>393485797142</owner_id>
    <image href='http://localhost:3001/api/images/ami-f51aff9c' id='ami-f51aff9c'></image>
    <realm href='http://localhost:3001/api/realms/us-east-1c' id='us-east-1c'></realm>
    <state>RUNNING</state>
    <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.medium' id='c1.medium'>
    </hardware_profile>
    <actions>
      <link href='http://localhost:3001/api/instances/i-1fbc627e/reboot' method='post' rel='reboot' />
      <link href='http://localhost:3001/api/instances/i-1fbc627e/stop' method='post' rel='stop' />
      <link href='http://localhost:3001/api/instances/i-1fbc627e/run;id=i-1fbc627e' method='post' rel='run' />
    </actions>
    <launch_time>2011-07-22T11:29:48.000Z</launch_time>
    <public_addresses><address>ec2-50-16-183-107.compute-1.amazonaws.com</address></public_addresses>
    <private_addresses><address>domU-12-31-39-0F-79-D4.compute-1.internal</address></private_addresses>
    <firewalls>
      <firewall href='http://localhost:3001/api/firewalls/default' id='default'></firewall>
    </firewalls>
    <authentication type='key'>
      <login>
        <keyname>eftah</keyname>
      </login>
    </authentication>
  </instance>
  <instance href='http://localhost:3001/api/instances/i-f3ba6492' id='i-f3ba6492'>
    <name>ami-2b5fba42</name>
    <owner_id>393485797142</owner_id>
    <image href='http://localhost:3001/api/images/ami-2b5fba42' id='ami-2b5fba42'></image>
    <realm href='http://localhost:3001/api/realms/us-east-1d' id='us-east-1d'></realm>
    <state>RUNNING</state>
    <hardware_profile href='http://localhost:3001/api/hardware_profiles/m1.small' id='m1.small'>
    </hardware_profile>
    <actions>
      <link href='http://localhost:3001/api/instances/i-f3ba6492/reboot' method='post' rel='reboot' />
      <link href='http://localhost:3001/api/instances/i-f3ba6492/stop' method='post' rel='stop' />
      <link href='http://localhost:3001/api/instances/i-f3ba6492/run;id=i-f3ba6492' method='post' rel='run' />
    </actions>
    <launch_time>2011-07-22T11:32:25.000Z</launch_time>
    <public_addresses><address>ec2-184-73-78-87.compute-1.amazonaws.com</address></public_addresses>
    <private_addresses><address>ip-10-196-89-221.ec2.internal</address></private_addresses>
    <firewalls>
      <firewall href='http://localhost:3001/api/firewalls/default' id='default'></firewall>
      <firewall href='http://localhost:3001/api/firewalls/test' id='test'></firewall>
    </firewalls>
    <authentication type='key'>
      <login>
        <keyname>eftah</keyname>
      </login>
    </authentication>
  </instance>
</instances>

Get the details of an instance

Example request:

GET /api/instances/20112212?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1167
<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3002/api/instances/20112212' id='20112212'>
  <name>myserver</name>
  <owner_id>mandreou</owner_id>
  <image href='http://localhost:3002/api/images/53' id='53'></image>
  <realm href='http://localhost:3002/api/realms/us' id='us'></realm>
  <state>RUNNING</state>
  <hardware_profile href='http://localhost:3002/api/hardware_profiles/1' id='1'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3002/api/instances/20112212/reboot' method='post' rel='reboot' />
    <link href='http://localhost:3002/api/instances/20112212/stop' method='post' rel='stop' />
    <link href='http://localhost:3002/api/instances/20112212/run;id=20112212' method='post' rel='run' />
    <link href='http://localhost:3002/api/images;instance_id=20112212' method='post' rel='create_image' />
  </actions>
  <public_addresses><address>50.57.116.72</address></public_addresses>
  <private_addresses><address>10.182.143.64</address></private_addresses>
  <authentication type='password'>
    <login>
      <username>root</username>
      <password></password>
    </login>
  </authentication>
</instance>

Launch an action on an instance

Example request (reboot):

POST /api/instances/i-f3ba6492/reboot?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1322

<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3001/api/instances/i-f3ba6492' id='i-f3ba6492'>
  <name>ami-f51aff9c</name>
  <owner_id>393485797142</owner_id>
  <image href='http://localhost:3001/api/images/ami-f51aff9c' id='ami-f51aff9c'></image>
  <realm href='http://localhost:3001/api/realms/us-east-1c' id='us-east-1c'></realm>
  <state>RUNNING</state>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.medium' id='c1.medium'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3001/api/instances/i-f3ba6492/reboot' method='post' rel='reboot' />
    <link href='http://localhost:3001/api/instances/i-f3ba6492/stop' method='post' rel='stop' />
    <link href='http://localhost:3001/api/instances/i-f3ba6492/run;id=i-f3ba6492' method='post' rel='run' />
  </actions>
  <launch_time>2011-07-22T11:29:48.000Z</launch_time>
  <public_addresses><address>ec2-50-16-183-107.compute-1.amazonaws.com</address></public_addresses>
  <private_addresses><address>domU-12-31-39-0F-79-D4.compute-1.internal</address></private_addresses>
  <firewalls>  <firewall href='http://localhost:3001/api/firewalls/default' id='default'></firewall></firewalls>
  <authentication type='key'>
    <login>
      <keyname>eftah</keyname>
    </login>
  </authentication>
</instance>

Example request (stop):

POST /api/instances/20112212/stop?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1167

<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3002/api/instances/20112212' id='20112212'>
  <name>myserver</name>
  <owner_id>mandreou</owner_id>
  <image href='http://localhost:3002/api/images/53' id='53'></image>
  <realm href='http://localhost:3002/api/realms/us' id='us'></realm>
  <state>STOPPED</state>
  <hardware_profile href='http://localhost:3002/api/hardware_profiles/1' id='1'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3002/api/instances/20112212/reboot' method='post' rel='reboot' />
    <link href='http://localhost:3002/api/instances/20112212/stop' method='post' rel='stop' />
    <link href='http://localhost:3002/api/instances/20112212/run;id=20112212' method='post' rel='run' />
    <link href='http://localhost:3002/api/images;instance_id=20112212' method='post' rel='create_image' />
  </actions>
  <public_addresses><address>50.57.116.72</address></public_addresses>
  <private_addresses><address>10.182.143.64</address></private_addresses>
  <authentication type='password'>
    <login>
      <username>root</username>
      <password></password>
    </login>
  </authentication>
</instance>

Example request (run-on-instance Amazon EC2):

× Note:

POST /api/instances/i-afde73ce/run?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Content-Length: 1927
Content-Type: multipart/form-data; boundary=----------------------------332ed6691ab8

------------------------------332ed6691ab8
Content-Disposition: form-data; name="cmd"

uname -a; ls -l
------------------------------332ed6691ab8
Content-Disposition: form-data; name="private_key"

-----BEGIN RSA PRIVATE KEY-----.BTTEpATBAAKDAQEA4t3R/PgUo3KDDuX4
vZZpZuXFkAA/5X2lFRY2/xsQqbPz9utPOsUoPf9Aajy+.vGRJrO2KAJ9U/JTNDzr
3NPbG3aHYPSnwsSxkFSG4Q6ukqYlxT9TPF/+wvdxfAtp3nYw3ZGuSX/DOtToWtQ8
F/+GvHTHKDQSB+TeEs1Sa/PFwxpspB+RqHbqOTWPsFOHL+9sZGTqd6D4B.R6DBNh
9Dabu9BVZrl5BTOKlbAgrKnzsGKvaBST/D2.AB/HB9/GOT36OoBmEr1y9gFwu4Xf
aKw+AXVf9y9TKxVD3TE5uB.oDZG8s4gr2e691xHG9YGzBBBbNzfFh94b3Td5JBGS
zRDTKYBfOgv+Zu5N+WyeaZ0ab50DwK9BXYB5hsRu5zbAqObbTZkwN9qwBOZHzATX
wVTZU+eTz.39OZPqu4fQwrBN13lDbUoZxlqT9g2+haQBB9sTDzQEZ08QKBgQDJyw
lBBZqQKBgQDz5E2rL59lNS5pBxDO9r6B9rXtBBTZ5tZUWNFRvyNsxY5nJT03.KDw
qo2VP5WDZeOhRWEUY96./pWN3hNFDkT44vDpeXQUh3rBHyD5DWvWxAze9Ds+UTO/
esuLwP5vXhfoYp6gV9XG.BEBzSVq8kZ2kZtlbWHTR/SGepTkDgYEA9zwHTDhtKR2
KS8/BSFZQ884ZqFkbwT9fTW6s0rgUSBDTUDgYEA9W5HXTOEPGFDnqBhKPLN.xD9D
vZZpZuXFkAA/5X2lFRY2/xsQqbPz9utPOsUoPf9Aajy+.vGRJrO2KAJ9U/JTNDzr
lBBZqQKBgQDz5E2rL59lNS5pBxDO9r6B9rXtBBTZ5tZUWNFRvyNsxY5nJT03.KDw
F/+GvHTHKDQSB+TeEs1Sa/PFwxpspB+RqHbqOTWPsFOHL+9sZGTqd6D4B.R6DBNh
wVTZU+eTz.39OZPqu4fQwrBN13lDbUoZxlqT9g2+haQBB9sTDzQEZ08QKBgQDJyw
lBBZqQKBgQDz5E2rL59lNS5pBxDO9r6B9rXtBBTZ5tZUWNFRvyNsxY5nJT03.KDw
DAAeVWKU1OyDXfN4v6Zn1nNrhSkdrd+XV0nTLExsfg==.-----END RSA PRIVAT
E KEY-----
------------------------------332ed6691ab8--

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Mon, 25 Jul 2011 12:56:02 GMT
Content-Length: 497

<instance href='http://localhost:3001/api/instances/i-afde73ce' id='i-afde73ce'>
  <public_address>
    ec2-50-19-59-126.compute-1.amazonaws.com
  </public_address>
  <command>
    uname -a; ls -l
  </command>
  <output>Linux domU-12-31-39-0F-E1-78 2.6.21.7-2.fc8xen #1 SMP Fri Feb 15 12:39:36 EST 2008 i686 i686 i386 GNU/Linux
  total 140
  -rw-r--r-- 1 root root 137263 Mar 26  2008 ec2-ami-tools-1.3-19974.noarch.rpm
  -rw-r--r-- 1 root root      0 Mar 26  2008 firstlogin
  </output>
</instance>

Example request (run-on-instance Rackspace Cloudservers):

POST /api/instances/20117112/run?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*
Content-Length: 275
Expect: 100-continue
Content-Type: multipart/form-data; boundary=----------------------------9b05ece66f4d
------------------------------9b05ece66f4d
Content-Disposition: form-data; name="cmd"

uname -a; ifconfig; pwd
------------------------------9b05ece66f4d
Content-Disposition: form-data; name="password"

myserverqB2Uwk21I
------------------------------9b05ece66f4d--

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Mon, 25 Jul 2011 13:02:15 GMT
Content-Length: 1781

<instance href='http://localhost:3002/api/instances/20117112' id='20117112'>
  <public_address>
    50.57.117.249
  </public_address>
  <command>
    uname -a; ifconfig; pwd
  </command>
  <output>Linux myserver 2.6.35.4-rscloud #8 SMP Mon Sep 20 15:54:33 UTC 2010 x86_64 x86_64 x86_64 GNU/Linux
  eth0      Link encap:Ethernet  HWaddr 40:40:B1:7A:52:7E
            inet addr:50.57.117.249  Bcast:50.57.117.255  Mask:255.255.255.0
            inet6 addr: fe80::4240:b1ff:fe7a:527e/64 Scope:Link
            UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
            RX packets:54 errors:0 dropped:0 overruns:0 frame:0
            TX packets:62 errors:0 dropped:0 overruns:0 carrier:0
            collisions:0 txqueuelen:1000
            RX bytes:5880 (5.7 KiB)  TX bytes:6331 (6.1 KiB)
            Interrupt:24

  eth1      Link encap:Ethernet  HWaddr 40:40:8E:4B:52:23
            inet addr:10.182.131.159  Bcast:10.182.159.255  Mask:255.255.224.0
            inet6 addr: fe80::4240:8eff:fe4b:5223/64 Scope:Link
            UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
            RX packets:3 errors:0 dropped:0 overruns:0 frame:0
            TX packets:12 errors:0 dropped:0 overruns:0 carrier:0
            collisions:0 txqueuelen:1000
            RX bytes:188 (188.0 b)  TX bytes:720 (720.0 b)
            Interrupt:25

  lo        Link encap:Local Loopback
            inet addr:127.0.0.1  Mask:255.0.0.0
            inet6 addr: ::1/128 Scope:Host
            UP LOOPBACK RUNNING  MTU:16436  Metric:1
            RX packets:0 errors:0 dropped:0 overruns:0 frame:0
            TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
            collisions:0 txqueuelen:0
            RX bytes:0 (0.0 b)  TX bytes:0 (0.0 b)

  /root</output>
</instance>

Create a new instance

As with other POST operations in the Deltacloud API, clients may specify parameters as multipart/form-data or as x-www-url-form-urlencoded content type, as you can see in examples below.

Client request (AWS EC2):

POST /api/instances?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 107
Content-Type: application/x-www-form-urlencoded

keyname=eftah&image_id=ami-f51aff9c&realm_id=us-east-1c&hwp_id=c1.medium&
firewalls1=default&firewalls2=test

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Content-Length: 1183

<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3001/api/instances/i-cbb861aa' id='i-cbb861aa'>
  <name>ami-f51aff9c</name>
  <owner_id>393485797142</owner_id>
  <image href='http://localhost:3001/api/images/ami-f51aff9c' id='ami-f51aff9c'></image>
  <realm href='http://localhost:3001/api/realms/us-east-1c' id='us-east-1c'></realm>
  <state>PENDING</state>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.medium' id='c1.medium'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3001/api/instances/i-cbb861aa/stop' method='post' rel='stop' />
    <link href='http://localhost:3001/api/instances/i-cbb861aa/run;id=i-cbb861aa' method='post' rel='run' />
  </actions>
  <launch_time>2011-07-22T16:09:45.000Z</launch_time>
  <public_addresses></public_addresses>
  <private_addresses></private_addresses>
  <firewalls>
    <firewall href='http://localhost:3001/api/firewalls/test' id='test'></firewall>
    <firewall href='http://localhost:3001/api/firewalls/default' id='default'></firewall>
  </firewalls>
  <authentication type='key'>
    <login>
      <keyname>eftah</keyname>
    </login>
  </authentication>
</instance>

Example request: (Rackspace Cloudservers)

POST /api/instances?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*
Content-Length: 34
Content-Type: application/x-www-form-urlencoded

image_id=53&hwp_id=1&name=myserver

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Content-Length: 883

<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3002/api/instances/20112212' id='20112212'>
  <name>myserver</name>
  <owner_id>mandreou</owner_id>
  <image href='http://localhost:3002/api/images/53' id='53'></image>
  <realm href='http://localhost:3002/api/realms/us' id='us'></realm>
  <state>PENDING</state>
  <hardware_profile href='http://localhost:3002/api/hardware_profiles/1' id='1'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3002/api/instances/20112212/run;id=20112212' method='post' rel='run' />
  </actions>
  <public_addresses><address>50.57.116.72</address></public_addresses>
  <private_addresses><address>10.182.143.64</address></private_addresses>
  <authentication type='password'>
    <login>
      <username>root</username>
      <password>myserver4OvKh7Ak3</password>
    </login>
  </authentication>
</instance>

Note:

Keys
;T; I"�l

Instances

Attribute	Meaning
owner_id	the id of the cloud provider account that launched the instance
image_id	the id of the image from which the instance was launched
name	a human readable name for the instance given at launch time
realm_id	realm into which the instance was launched
state	current state of the instance (e.g. 'running')
actions	actions that a client may effect on the instance, based on current state
public_addresses	the globally routable IP address of the instance
private_addresses	the private IP address of the instance, routable within its private network
instance_profile	the specific values of memory, cpu, storage
launch_time	timestamp at which the instance was launched
keyname	name of authentication key, if this method is used for authentication (e.g. EC2)
username	the username for authentication when connecting to the instance
password	the password used together with username above
firewalls	the firewalls that this instance was launched into (EC2 specific)

Storage resources

Get a list of all current instances

To produce a list of all current instances in the given cloud (belonging to the specified account) use call GET /api/instances. The example below displays instances in the Amazon EC2 cloud.

Example request:

GET /api/instances?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Client response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 2790
<?xml version='1.0' encoding='utf-8' ?>
<instances>
  <instance href='http://localhost:3001/api/instances/i-1fbc627e' id='i-1fbc627e'>
    <name>ami-f51aff9c</name>
    <owner_id>393485797142</owner_id>
    <image href='http://localhost:3001/api/images/ami-f51aff9c' id='ami-f51aff9c'></image>
    <realm href='http://localhost:3001/api/realms/us-east-1c' id='us-east-1c'></realm>
    <state>RUNNING</state>
    <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.medium' id='c1.medium'>
    </hardware_profile>
    <actions>
      <link href='http://localhost:3001/api/instances/i-1fbc627e/reboot' method='post' rel='reboot' />
      <link href='http://localhost:3001/api/instances/i-1fbc627e/stop' method='post' rel='stop' />
      <link href='http://localhost:3001/api/instances/i-1fbc627e/run;id=i-1fbc627e' method='post' rel='run' />
    </actions>
    <launch_time>2011-07-22T11:29:48.000Z</launch_time>
    <public_addresses><address>ec2-50-16-183-107.compute-1.amazonaws.com</address></public_addresses>
    <private_addresses><address>domU-12-31-39-0F-79-D4.compute-1.internal</address></private_addresses>
    <firewalls>
      <firewall href='http://localhost:3001/api/firewalls/default' id='default'></firewall>
    </firewalls>
    <authentication type='key'>
      <login>
        <keyname>eftah</keyname>
      </login>
    </authentication>
  </instance>
  <instance href='http://localhost:3001/api/instances/i-f3ba6492' id='i-f3ba6492'>
    <name>ami-2b5fba42</name>
    <owner_id>393485797142</owner_id>
    <image href='http://localhost:3001/api/images/ami-2b5fba42' id='ami-2b5fba42'></image>
    <realm href='http://localhost:3001/api/realms/us-east-1d' id='us-east-1d'></realm>
    <state>RUNNING</state>
    <hardware_profile href='http://localhost:3001/api/hardware_profiles/m1.small' id='m1.small'>
    </hardware_profile>
    <actions>
      <link href='http://localhost:3001/api/instances/i-f3ba6492/reboot' method='post' rel='reboot' />
      <link href='http://localhost:3001/api/instances/i-f3ba6492/stop' method='post' rel='stop' />
      <link href='http://localhost:3001/api/instances/i-f3ba6492/run;id=i-f3ba6492' method='post' rel='run' />
    </actions>
    <launch_time>2011-07-22T11:32:25.000Z</launch_time>
    <public_addresses><address>ec2-184-73-78-87.compute-1.amazonaws.com</address></public_addresses>
    <private_addresses><address>ip-10-196-89-221.ec2.internal</address></private_addresses>
    <firewalls>
      <firewall href='http://localhost:3001/api/firewalls/default' id='default'></firewall>
      <firewall href='http://localhost:3001/api/firewalls/test' id='test'></firewall>
    </firewalls>
    <authentication type='key'>
      <login>
        <keyname>eftah</keyname>
      </login>
    </authentication>
  </instance>
</instances>

Get the details of an instance

Example request:

GET /api/instances/20112212?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1167
<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3002/api/instances/20112212' id='20112212'>
  <name>myserver</name>
  <owner_id>mandreou</owner_id>
  <image href='http://localhost:3002/api/images/53' id='53'></image>
  <realm href='http://localhost:3002/api/realms/us' id='us'></realm>
  <state>RUNNING</state>
  <hardware_profile href='http://localhost:3002/api/hardware_profiles/1' id='1'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3002/api/instances/20112212/reboot' method='post' rel='reboot' />
    <link href='http://localhost:3002/api/instances/20112212/stop' method='post' rel='stop' />
    <link href='http://localhost:3002/api/instances/20112212/run;id=20112212' method='post' rel='run' />
    <link href='http://localhost:3002/api/images;instance_id=20112212' method='post' rel='create_image' />
  </actions>
  <public_addresses><address>50.57.116.72</address></public_addresses>
  <private_addresses><address>10.182.143.64</address></private_addresses>
  <authentication type='password'>
    <login>
      <username>root</username>
      <password></password>
    </login>
  </authentication>
</instance>

Launch an action on an instance

Example request (reboot):

POST /api/instances/i-f3ba6492/reboot?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1322

<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3001/api/instances/i-f3ba6492' id='i-f3ba6492'>
  <name>ami-f51aff9c</name>
  <owner_id>393485797142</owner_id>
  <image href='http://localhost:3001/api/images/ami-f51aff9c' id='ami-f51aff9c'></image>
  <realm href='http://localhost:3001/api/realms/us-east-1c' id='us-east-1c'></realm>
  <state>RUNNING</state>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.medium' id='c1.medium'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3001/api/instances/i-f3ba6492/reboot' method='post' rel='reboot' />
    <link href='http://localhost:3001/api/instances/i-f3ba6492/stop' method='post' rel='stop' />
    <link href='http://localhost:3001/api/instances/i-f3ba6492/run;id=i-f3ba6492' method='post' rel='run' />
  </actions>
  <launch_time>2011-07-22T11:29:48.000Z</launch_time>
  <public_addresses><address>ec2-50-16-183-107.compute-1.amazonaws.com</address></public_addresses>
  <private_addresses><address>domU-12-31-39-0F-79-D4.compute-1.internal</address></private_addresses>
  <firewalls>  <firewall href='http://localhost:3001/api/firewalls/default' id='default'></firewall></firewalls>
  <authentication type='key'>
    <login>
      <keyname>eftah</keyname>
    </login>
  </authentication>
</instance>

Example request (stop):

POST /api/instances/20112212/stop?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1167

<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3002/api/instances/20112212' id='20112212'>
  <name>myserver</name>
  <owner_id>mandreou</owner_id>
  <image href='http://localhost:3002/api/images/53' id='53'></image>
  <realm href='http://localhost:3002/api/realms/us' id='us'></realm>
  <state>STOPPED</state>
  <hardware_profile href='http://localhost:3002/api/hardware_profiles/1' id='1'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3002/api/instances/20112212/reboot' method='post' rel='reboot' />
    <link href='http://localhost:3002/api/instances/20112212/stop' method='post' rel='stop' />
    <link href='http://localhost:3002/api/instances/20112212/run;id=20112212' method='post' rel='run' />
    <link href='http://localhost:3002/api/images;instance_id=20112212' method='post' rel='create_image' />
  </actions>
  <public_addresses><address>50.57.116.72</address></public_addresses>
  <private_addresses><address>10.182.143.64</address></private_addresses>
  <authentication type='password'>
    <login>
      <username>root</username>
      <password></password>
    </login>
  </authentication>
</instance>

Example request (run-on-instance Amazon EC2):

× Note:

POST /api/instances/i-afde73ce/run?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Content-Length: 1927
Content-Type: multipart/form-data; boundary=----------------------------332ed6691ab8

------------------------------332ed6691ab8
Content-Disposition: form-data; name="cmd"

uname -a; ls -l
------------------------------332ed6691ab8
Content-Disposition: form-data; name="private_key"

-----BEGIN RSA PRIVATE KEY-----.BTTEpATBAAKDAQEA4t3R/PgUo3KDDuX4
vZZpZuXFkAA/5X2lFRY2/xsQqbPz9utPOsUoPf9Aajy+.vGRJrO2KAJ9U/JTNDzr
3NPbG3aHYPSnwsSxkFSG4Q6ukqYlxT9TPF/+wvdxfAtp3nYw3ZGuSX/DOtToWtQ8
F/+GvHTHKDQSB+TeEs1Sa/PFwxpspB+RqHbqOTWPsFOHL+9sZGTqd6D4B.R6DBNh
9Dabu9BVZrl5BTOKlbAgrKnzsGKvaBST/D2.AB/HB9/GOT36OoBmEr1y9gFwu4Xf
aKw+AXVf9y9TKxVD3TE5uB.oDZG8s4gr2e691xHG9YGzBBBbNzfFh94b3Td5JBGS
zRDTKYBfOgv+Zu5N+WyeaZ0ab50DwK9BXYB5hsRu5zbAqObbTZkwN9qwBOZHzATX
wVTZU+eTz.39OZPqu4fQwrBN13lDbUoZxlqT9g2+haQBB9sTDzQEZ08QKBgQDJyw
lBBZqQKBgQDz5E2rL59lNS5pBxDO9r6B9rXtBBTZ5tZUWNFRvyNsxY5nJT03.KDw
qo2VP5WDZeOhRWEUY96./pWN3hNFDkT44vDpeXQUh3rBHyD5DWvWxAze9Ds+UTO/
esuLwP5vXhfoYp6gV9XG.BEBzSVq8kZ2kZtlbWHTR/SGepTkDgYEA9zwHTDhtKR2
KS8/BSFZQ884ZqFkbwT9fTW6s0rgUSBDTUDgYEA9W5HXTOEPGFDnqBhKPLN.xD9D
vZZpZuXFkAA/5X2lFRY2/xsQqbPz9utPOsUoPf9Aajy+.vGRJrO2KAJ9U/JTNDzr
lBBZqQKBgQDz5E2rL59lNS5pBxDO9r6B9rXtBBTZ5tZUWNFRvyNsxY5nJT03.KDw
F/+GvHTHKDQSB+TeEs1Sa/PFwxpspB+RqHbqOTWPsFOHL+9sZGTqd6D4B.R6DBNh
wVTZU+eTz.39OZPqu4fQwrBN13lDbUoZxlqT9g2+haQBB9sTDzQEZ08QKBgQDJyw
lBBZqQKBgQDz5E2rL59lNS5pBxDO9r6B9rXtBBTZ5tZUWNFRvyNsxY5nJT03.KDw
DAAeVWKU1OyDXfN4v6Zn1nNrhSkdrd+XV0nTLExsfg==.-----END RSA PRIVAT
E KEY-----
------------------------------332ed6691ab8--

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Mon, 25 Jul 2011 12:56:02 GMT
Content-Length: 497

<instance href='http://localhost:3001/api/instances/i-afde73ce' id='i-afde73ce'>
  <public_address>
    ec2-50-19-59-126.compute-1.amazonaws.com
  </public_address>
  <command>
    uname -a; ls -l
  </command>
  <output>Linux domU-12-31-39-0F-E1-78 2.6.21.7-2.fc8xen #1 SMP Fri Feb 15 12:39:36 EST 2008 i686 i686 i386 GNU/Linux
  total 140
  -rw-r--r-- 1 root root 137263 Mar 26  2008 ec2-ami-tools-1.3-19974.noarch.rpm
  -rw-r--r-- 1 root root      0 Mar 26  2008 firstlogin
  </output>
</instance>

Example request (run-on-instance Rackspace Cloudservers):

POST /api/instances/20117112/run?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*
Content-Length: 275
Expect: 100-continue
Content-Type: multipart/form-data; boundary=----------------------------9b05ece66f4d
------------------------------9b05ece66f4d
Content-Disposition: form-data; name="cmd"

uname -a; ifconfig; pwd
------------------------------9b05ece66f4d
Content-Disposition: form-data; name="password"

myserverqB2Uwk21I
------------------------------9b05ece66f4d--

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Mon, 25 Jul 2011 13:02:15 GMT
Content-Length: 1781

<instance href='http://localhost:3002/api/instances/20117112' id='20117112'>
  <public_address>
    50.57.117.249
  </public_address>
  <command>
    uname -a; ifconfig; pwd
  </command>
  <output>Linux myserver 2.6.35.4-rscloud #8 SMP Mon Sep 20 15:54:33 UTC 2010 x86_64 x86_64 x86_64 GNU/Linux
  eth0      Link encap:Ethernet  HWaddr 40:40:B1:7A:52:7E
            inet addr:50.57.117.249  Bcast:50.57.117.255  Mask:255.255.255.0
            inet6 addr: fe80::4240:b1ff:fe7a:527e/64 Scope:Link
            UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
            RX packets:54 errors:0 dropped:0 overruns:0 frame:0
            TX packets:62 errors:0 dropped:0 overruns:0 carrier:0
            collisions:0 txqueuelen:1000
            RX bytes:5880 (5.7 KiB)  TX bytes:6331 (6.1 KiB)
            Interrupt:24

  eth1      Link encap:Ethernet  HWaddr 40:40:8E:4B:52:23
            inet addr:10.182.131.159  Bcast:10.182.159.255  Mask:255.255.224.0
            inet6 addr: fe80::4240:8eff:fe4b:5223/64 Scope:Link
            UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
            RX packets:3 errors:0 dropped:0 overruns:0 frame:0
            TX packets:12 errors:0 dropped:0 overruns:0 carrier:0
            collisions:0 txqueuelen:1000
            RX bytes:188 (188.0 b)  TX bytes:720 (720.0 b)
            Interrupt:25

  lo        Link encap:Local Loopback
            inet addr:127.0.0.1  Mask:255.0.0.0
            inet6 addr: ::1/128 Scope:Host
            UP LOOPBACK RUNNING  MTU:16436  Metric:1
            RX packets:0 errors:0 dropped:0 overruns:0 frame:0
            TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
            collisions:0 txqueuelen:0
            RX bytes:0 (0.0 b)  TX bytes:0 (0.0 b)

  /root</output>
</instance>

Create a new instance

As with other POST operations in the Deltacloud API, clients may specify parameters as multipart/form-data or as x-www-url-form-urlencoded content type, as you can see in examples below.

Client request (AWS EC2):

POST /api/instances?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 107
Content-Type: application/x-www-form-urlencoded

keyname=eftah&image_id=ami-f51aff9c&realm_id=us-east-1c&hwp_id=c1.medium&
firewalls1=default&firewalls2=test

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Content-Length: 1183

<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3001/api/instances/i-cbb861aa' id='i-cbb861aa'>
  <name>ami-f51aff9c</name>
  <owner_id>393485797142</owner_id>
  <image href='http://localhost:3001/api/images/ami-f51aff9c' id='ami-f51aff9c'></image>
  <realm href='http://localhost:3001/api/realms/us-east-1c' id='us-east-1c'></realm>
  <state>PENDING</state>
  <hardware_profile href='http://localhost:3001/api/hardware_profiles/c1.medium' id='c1.medium'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3001/api/instances/i-cbb861aa/stop' method='post' rel='stop' />
    <link href='http://localhost:3001/api/instances/i-cbb861aa/run;id=i-cbb861aa' method='post' rel='run' />
  </actions>
  <launch_time>2011-07-22T16:09:45.000Z</launch_time>
  <public_addresses></public_addresses>
  <private_addresses></private_addresses>
  <firewalls>
    <firewall href='http://localhost:3001/api/firewalls/test' id='test'></firewall>
    <firewall href='http://localhost:3001/api/firewalls/default' id='default'></firewall>
  </firewalls>
  <authentication type='key'>
    <login>
      <keyname>eftah</keyname>
    </login>
  </authentication>
</instance>

Example request: (Rackspace Cloudservers)

POST /api/instances?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3002
Accept: */*
Content-Length: 34
Content-Type: application/x-www-form-urlencoded

image_id=53&hwp_id=1&name=myserver

Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Content-Length: 883

<?xml version='1.0' encoding='utf-8' ?>
<instance href='http://localhost:3002/api/instances/20112212' id='20112212'>
  <name>myserver</name>
  <owner_id>mandreou</owner_id>
  <image href='http://localhost:3002/api/images/53' id='53'></image>
  <realm href='http://localhost:3002/api/realms/us' id='us'></realm>
  <state>PENDING</state>
  <hardware_profile href='http://localhost:3002/api/hardware_profiles/1' id='1'>
  </hardware_profile>
  <actions>
    <link href='http://localhost:3002/api/instances/20112212/run;id=20112212' method='post' rel='run' />
  </actions>
  <public_addresses><address>50.57.116.72</address></public_addresses>
  <private_addresses><address>10.182.143.64</address></private_addresses>
  <authentication type='password'>
    <login>
      <username>root</username>
      <password>myserver4OvKh7Ak3</password>
    </login>
  </authentication>
</instance>

Note:

Keys

;T;@�I"/libdeltacloud/;T{;{ ;I" Libdeltacloud

;T; I";F; I";F;@�I"/blob-storage/;T{;{ ;I"L] Blob storage

Blob Storage

Blob storage represents a generic key ==> value data store, as implemented for example by Amazon S3 or Openstack swift. In Deltacloud, the organisational unit of blob storage is a bucket. Individual data items - blobs are exposed as a subcollection under each bucket.

A bucket has

a name;
a size (denotes the number of blobs it contains); and
a list of links to each blob.

A blob has:

a content_length;
a content_type;
a last_modified timestamp;
a structure containing user_metadata;
a link to the blob content; and
a name of the bucket in which this blob exists.

Get a list of all buckets

To return a list of all buckets belonging to the given cloud provider account use call GET /api/buckets. The response from the Deltacloud server includes the name and URI of each bucket but not the size or the list of blobs which the bucket contains. These details are available when a client requests (GETs) a specific bucket.

Example request:

GET /api/buckets?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 597
<?xml version='1.0' encoding='utf-8' ?>
<buckets>
  <bucket href='http://localhost:3001/api/buckets/mybucket1' id='mybucket1'>
    <name>mybucket1</name>
    <size></size>
  </bucket>
  <bucket href='http://localhost:3001/api/buckets/mybucket2' id='mybucket2'>
    <name>mybucket2</name>
    <size></size>
  </bucket>
  <bucket href='http://localhost:3001/api/buckets/mybucket3' id='mybucket3'>
    <name>mybucket3</name>
    <size></size>
  </bucket>
  <bucket href='http://localhost:3001/api/buckets/mybucket4' id='mybucket4'>
    <name>mybucket4</name>
    <size></size>
  </bucket>
</buckets>

Get the details of a specific bucket

To return details of a specific bucket use call GET /api/buckets/:id. The Deltacloud server response includes the size of the bucket and the URI for each blob object that it contains.

Example request:

GET /api/buckets/mybucket1?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 534
<?xml version='1.0' encoding='utf-8' ?>
<bucket href='http://localhost:3001/api/buckets/mybucket1' id='mybucket1'>
  <name>mybucket1</name>
  <size>4</size>
  <blob href='http://localhost:3001/api/buckets/mybucket1/myfile' id='myfile'></blob>
  <blob href='http://localhost:3001/api/buckets/mybucket1/an_object' id='an_object'></blob>
  <blob href='http://localhost:3001/api/buckets/mybucket1/picture_blob' id='picture_blob'></blob>
  <blob href='http://localhost:3001/api/buckets/mybucket1/some_blob id='some_blob'></blob>
</bucket>

Create a new bucket

To create a new bucket use call POST /api/buckets. You need to specify the name as a parameter. Optionally for Amazon S3 buckets, you can specify a bucket location with the location parameter, as per Regions and Endpoints for Amazon Simple Storage Service. Valid values for S3 bucket location parameter are: "us-west-1", "EU", "ap-southeast-1", "ap-northeast-1" (while not specifying a location default to the "US Standard" region). Note that clients may specify parameters as multipart/form-data or using a content-type of application/x-www-form-urlencoded.

On succesful creation this call will return a 201 HTTP status, specifying the URI of the newly created bucket in the Location header and the newly created bucket object in the response message body. The example request below shows how to create a new bucket in the EU (Ireland) region. If the given back-end cloud does not support locations then the location parameter is ignored.

Example request:

POST /api/buckets?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*
Content-Length: 31
Content-Type: application/x-www-form-urlencoded

name=mybucketeurope&location=EU

Server response:

HTTP/1.1 201 Created
Location: http://localhost:3001/api/buckets/mybucketeurope
Content-Type: application/xml
Content-Length: 182

<?xml version='1.0' encoding='utf-8' ?>
<bucket href='http://localhost:3001/api/buckets/mybucketeurope' id='mybucketeurope'>
  <name>mybucketeurope</name>
  <size>0</size>
</bucket>

Delete a bucket

To delete the specified bucket use call DELETE /api/buckets/:id. The bucket must be empty (otherwise the call will fail with an error response). A succesful operation will return 204 No Content.

Example request:

DELETE /api/buckets/mybucketeurope?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content

Get the details of a blob

To retrieve the details of a specific blob use call GET /api/buckets/:bucket_id/:blob_id. The blob content is not returned as part of the response but rather a URI is given from which the content may be retrieved as shown below.

Example request:

GET /api/buckets/mariosbucket1/some_more_blob_woo?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 586
<?xml version='1.0' encoding='utf-8' ?>
<blob href='http://localhost:3001/api/buckets/mariosbucket1/some_more_blob_woo' id='some_more_blob_woo'>
  <bucket>mariosbucket1</bucket>
  <content_length>86</content_length>
  <content_type>text/plain</content_type>
  <last_modified>Fri Jan 28 12:23:08 UTC 2011</last_modified>
  <user_metadata>
    <entry key='v'>
      <![CDATA[0.2.0]]>
    </entry>
    <entry key='test'>
      <![CDATA[value]]>
    </entry>
  </user_metadata>
  <content href='http://localhost:3001/api/buckets/mariosbucket1/some_more_blob_woo/content'></content>
</blob>

Get the actual blob content

To retrieve the actual blob content use call GET /api/buckets/:bucket_id/:blob_id/content. The location of blob content is specified in the content URI returned from the GET /api/buckets/:bucket_id/:blob_id call. The content is streamed through the Deltacloud server as soon as it is received from the back-end cloud provider. The aim is to avoid the creation of a temporary file (especially significant in case of large blobs). The Deltacloud server sets Content-Disposition: attachment; filename=blob_name in the HTTP response headers.

Example request:

GET /api/buckets/mariosanotherbucketohyeah/Im_a_blob_beholdme/content?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Disposition: attachment; filename=Im_a_blob_beholdme
Content-Type: text/plain
Content-Length: 50

<BLOB DATA HERE>

Create a blob object

To create a blob object and set its content use call PUT /api/buckets/:bucket_id/:blob_id. If the blob already exists then its data and metadata are overwritten with those specified in this call. The request must specify the name of the blob and the name of the bucket in which the blob is to be placed in the call URI. The client must also specify the content_length of the blob data and the blob data itself in the HTTP headers. Optionally the call may also specify a content_type and any number of key:value pairs of user defined metadata. User metadata is defined using 'X-Deltacloud-Blobmeta-' header, e.g. X-Deltacloud-Blobmeta-Version:2.1.

To eliminate the necessity of creating a local file at the Deltacloud server for each blob created, the Deltacloud server starts to stream the blob data to the back-end cloud provider as soon as the request headers are processed. A succesful operation will return the newly created blob object, as shown below.

Example request:

PUT /api/buckets/mybucket/12Jul2011blob?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
Content-Type: text/plain
Content-Length: 128988
X-Deltacloud-Blobmeta-Version:2.1
X-Deltacloud-Blobmeta-Author:msa

... BLOB DATA ...

Server response:

<?xml version='1.0' encoding='utf-8' ?>
<blob href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob' id='12Jul2011blob'>
  <bucket>mybucket</bucket>
  <content_length>128988</content_length>
  <content_type>text/plain</content_type>
  <last_modified>Wed Jul 13 13:27:22 UTC 2011</last_modified>
  <user_metadata>
    <entry key='author'>
      <![CDATA[msa]]>
    </entry>
    <entry key='version'>
      <![CDATA[2.1]]>
    </entry>
  </user_metadata>
  <content href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob/content'>
  </content>
</blob>

The Deltacloud server also responds to an alternative POST /api/buckets/:bucket_id route for creating or updating a blob object. As with the PUT method for creating/updating a blob, the client must specify the bucket in which the blob is to be created through the call URI (i.e. you POST to the specified bucket). The rest of the required fields, that is, the name of the blob, the blob_data and the content-length are specified by the client as multipart/form-data (i.e. in HTTP POST form fields).

In order to specify the optional user metadata for a given blob the client must set the form field meta_params to specify the number of metadata key/value pairs. The metadata itself is then specified by the client with fields of the form meta_nameN and meta_valueN where N is an integer from 1 up to the number specified by the meta_params field (e.g. meta_name1=author, meta_value1=jrd).

It should be noted that the POST method for creating a blob is non streaming - the Deltacloud server will create a temporary file with the blob data, before the file is transferred to the backend cloud. Thus, it should only be used for blobs with a relatively small content-length and in general the PUT method should be preferred for larger blobs. This POST method is mainly provided for clients that cannot easily invoke a HTTP PUT operation (e.g. web browsers) and can be used for creating/updating a blob through the deltacloud HTML interface (provided for testing purposes).

Example request:

POST /api/buckets/mybucket?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu) libcurl/7.20.1 N
Accept: */*
Content-Length: 113582
Expect: 100-continue
Content-Type: multipart/form-data; boundary=----------------------------517f5f2df858

------------------------------517f5f2df858
Content-Disposition: form-data; name="blob"

12Jul2011blob
------------------------------517f5f2df858
Content-Disposition: form-data; name="blob_data"; filename="small.txt"
Content-Type: text/plain

<THE_BLOB_DATA_HERE>

------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_params"

2
------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_name1"

author
------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_value1"
jjs
------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_name2"

version
------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_value2"

2.2
------------------------------517f5f2df858--

Server response:

<?xml version='1.0' encoding='utf-8' ?>
<blob href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob' id='12Jul2011blob'>
  <bucket>mybucket</bucket>
  <content_length>112766</content_length>
  <content_type>text/plain</content_type>
  <last_modified></last_modified>
  <user_metadata>
    <entry key='x-amz-meta-author'>
      <![CDATA[jjs]]>
    </entry>
    <entry key='x-amz-meta-version'>
      <![CDATA[2.2]]>
    </entry>
  </user_metadata>
  <content href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob/content'>
  </content>
</blob>

Delete a blob object

To delete the specified blob object from the back-end cloud use call DELETE /api/buckets/:bucket_id/:blob_id. The names of the blob and the bucket in which this exists are specified the in call URI. After a succesful operation the Deltacloud server responds with a HTTP 204 (No Content) with no message body.

Example request:

DELETE /api/buckets/mybucket/12Jul2011blob?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Connection: close
Server: thin 1.2.11

Get all metadata fields

To return all user defined metadata fields on a specified blob URI use the HTTP HEAD operation HEAD /api/buckets/:bucket_id/:blob_id. As per RFC 2616 this HEAD operation does not return a message body. Rather, the blob user metadata values are returned in the response X-Deltacloud-Blobmeta- headers (e.g., X-Deltacloud-Blobmeta-version:1.2).

Example request:

HEAD /api/buckets/mybucket/myblob?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
X-Deltacloud-Blobmeta-version: 1.21
X-Deltacloud-Blobmeta-author: jrd

Update the user-defined blob metadata

To update the user-defined blob metadata use call POST /api/buckets/:bucket_id/:blob_id on the URI of a blob. This operation will overwrite all previously set user-metadata values (if any) and replace them with those specified in this call. The client must set the user-defined metadata in the X-Deltacloud-Blobmeta- headers (e.g., X-Deltacloud-Blobmeta-Model:2012).

Example request:

POST /api/buckets/mybucket/myblob?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*
X-Deltacloud-Blobmeta-model: 2012
X-Deltacloud-Blobmeta-paint: Stannite_Grey

Server response:

HTTP/1.1 204 No Content
X-Deltacloud-Blobmeta-model: 2012
X-Deltacloud-Blobmeta-paint: Stannite_Grey

;T; I"�G

Blob Storage

A bucket has

a name;
a size (denotes the number of blobs it contains); and
a list of links to each blob.

A blob has:

a content_length;
a content_type;
a last_modified timestamp;
a structure containing user_metadata;
a link to the blob content; and
a name of the bucket in which this blob exists.

Get a list of all buckets

Example request:

GET /api/buckets?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 597
<?xml version='1.0' encoding='utf-8' ?>
<buckets>
  <bucket href='http://localhost:3001/api/buckets/mybucket1' id='mybucket1'>
    <name>mybucket1</name>
    <size></size>
  </bucket>
  <bucket href='http://localhost:3001/api/buckets/mybucket2' id='mybucket2'>
    <name>mybucket2</name>
    <size></size>
  </bucket>
  <bucket href='http://localhost:3001/api/buckets/mybucket3' id='mybucket3'>
    <name>mybucket3</name>
    <size></size>
  </bucket>
  <bucket href='http://localhost:3001/api/buckets/mybucket4' id='mybucket4'>
    <name>mybucket4</name>
    <size></size>
  </bucket>
</buckets>

Get the details of a specific bucket

To return details of a specific bucket use call GET /api/buckets/:id. The Deltacloud server response includes the size of the bucket and the URI for each blob object that it contains.

Example request:

GET /api/buckets/mybucket1?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 534
<?xml version='1.0' encoding='utf-8' ?>
<bucket href='http://localhost:3001/api/buckets/mybucket1' id='mybucket1'>
  <name>mybucket1</name>
  <size>4</size>
  <blob href='http://localhost:3001/api/buckets/mybucket1/myfile' id='myfile'></blob>
  <blob href='http://localhost:3001/api/buckets/mybucket1/an_object' id='an_object'></blob>
  <blob href='http://localhost:3001/api/buckets/mybucket1/picture_blob' id='picture_blob'></blob>
  <blob href='http://localhost:3001/api/buckets/mybucket1/some_blob id='some_blob'></blob>
</bucket>

Create a new bucket

Example request:

POST /api/buckets?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*
Content-Length: 31
Content-Type: application/x-www-form-urlencoded

name=mybucketeurope&location=EU

Server response:

HTTP/1.1 201 Created
Location: http://localhost:3001/api/buckets/mybucketeurope
Content-Type: application/xml
Content-Length: 182

<?xml version='1.0' encoding='utf-8' ?>
<bucket href='http://localhost:3001/api/buckets/mybucketeurope' id='mybucketeurope'>
  <name>mybucketeurope</name>
  <size>0</size>
</bucket>

Delete a bucket

Example request:

DELETE /api/buckets/mybucketeurope?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content

Get the details of a blob

Example request:

GET /api/buckets/mariosbucket1/some_more_blob_woo?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 586
<?xml version='1.0' encoding='utf-8' ?>
<blob href='http://localhost:3001/api/buckets/mariosbucket1/some_more_blob_woo' id='some_more_blob_woo'>
  <bucket>mariosbucket1</bucket>
  <content_length>86</content_length>
  <content_type>text/plain</content_type>
  <last_modified>Fri Jan 28 12:23:08 UTC 2011</last_modified>
  <user_metadata>
    <entry key='v'>
      <![CDATA[0.2.0]]>
    </entry>
    <entry key='test'>
      <![CDATA[value]]>
    </entry>
  </user_metadata>
  <content href='http://localhost:3001/api/buckets/mariosbucket1/some_more_blob_woo/content'></content>
</blob>

Get the actual blob content

Example request:

GET /api/buckets/mariosanotherbucketohyeah/Im_a_blob_beholdme/content?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Disposition: attachment; filename=Im_a_blob_beholdme
Content-Type: text/plain
Content-Length: 50

<BLOB DATA HERE>

Create a blob object

Example request:

PUT /api/buckets/mybucket/12Jul2011blob?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
Content-Type: text/plain
Content-Length: 128988
X-Deltacloud-Blobmeta-Version:2.1
X-Deltacloud-Blobmeta-Author:msa

... BLOB DATA ...

Server response:

<?xml version='1.0' encoding='utf-8' ?>
<blob href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob' id='12Jul2011blob'>
  <bucket>mybucket</bucket>
  <content_length>128988</content_length>
  <content_type>text/plain</content_type>
  <last_modified>Wed Jul 13 13:27:22 UTC 2011</last_modified>
  <user_metadata>
    <entry key='author'>
      <![CDATA[msa]]>
    </entry>
    <entry key='version'>
      <![CDATA[2.1]]>
    </entry>
  </user_metadata>
  <content href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob/content'>
  </content>
</blob>

Example request:

POST /api/buckets/mybucket?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu) libcurl/7.20.1 N
Accept: */*
Content-Length: 113582
Expect: 100-continue
Content-Type: multipart/form-data; boundary=----------------------------517f5f2df858

------------------------------517f5f2df858
Content-Disposition: form-data; name="blob"

12Jul2011blob
------------------------------517f5f2df858
Content-Disposition: form-data; name="blob_data"; filename="small.txt"
Content-Type: text/plain

<THE_BLOB_DATA_HERE>

------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_params"

2
------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_name1"

author
------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_value1"
jjs
------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_name2"

version
------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_value2"

2.2
------------------------------517f5f2df858--

Server response:

<?xml version='1.0' encoding='utf-8' ?>
<blob href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob' id='12Jul2011blob'>
  <bucket>mybucket</bucket>
  <content_length>112766</content_length>
  <content_type>text/plain</content_type>
  <last_modified></last_modified>
  <user_metadata>
    <entry key='x-amz-meta-author'>
      <![CDATA[jjs]]>
    </entry>
    <entry key='x-amz-meta-version'>
      <![CDATA[2.2]]>
    </entry>
  </user_metadata>
  <content href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob/content'>
  </content>
</blob>

Delete a blob object

Example request:

DELETE /api/buckets/mybucket/12Jul2011blob?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Connection: close
Server: thin 1.2.11

Get all metadata fields

Example request:

HEAD /api/buckets/mybucket/myblob?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
X-Deltacloud-Blobmeta-version: 1.21
X-Deltacloud-Blobmeta-author: jrd

Update the user-defined blob metadata

Example request:

POST /api/buckets/mybucket/myblob?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*
X-Deltacloud-Blobmeta-model: 2012
X-Deltacloud-Blobmeta-paint: Stannite_Grey

Server response:

HTTP/1.1 204 No Content
X-Deltacloud-Blobmeta-model: 2012
X-Deltacloud-Blobmeta-paint: Stannite_Grey

;T; I"�G

Blob Storage

A bucket has

a name;
a size (denotes the number of blobs it contains); and
a list of links to each blob.

A blob has:

a content_length;
a content_type;
a last_modified timestamp;
a structure containing user_metadata;
a link to the blob content; and
a name of the bucket in which this blob exists.

Get a list of all buckets

Example request:

GET /api/buckets?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 597
<?xml version='1.0' encoding='utf-8' ?>
<buckets>
  <bucket href='http://localhost:3001/api/buckets/mybucket1' id='mybucket1'>
    <name>mybucket1</name>
    <size></size>
  </bucket>
  <bucket href='http://localhost:3001/api/buckets/mybucket2' id='mybucket2'>
    <name>mybucket2</name>
    <size></size>
  </bucket>
  <bucket href='http://localhost:3001/api/buckets/mybucket3' id='mybucket3'>
    <name>mybucket3</name>
    <size></size>
  </bucket>
  <bucket href='http://localhost:3001/api/buckets/mybucket4' id='mybucket4'>
    <name>mybucket4</name>
    <size></size>
  </bucket>
</buckets>

Get the details of a specific bucket

To return details of a specific bucket use call GET /api/buckets/:id. The Deltacloud server response includes the size of the bucket and the URI for each blob object that it contains.

Example request:

GET /api/buckets/mybucket1?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 534
<?xml version='1.0' encoding='utf-8' ?>
<bucket href='http://localhost:3001/api/buckets/mybucket1' id='mybucket1'>
  <name>mybucket1</name>
  <size>4</size>
  <blob href='http://localhost:3001/api/buckets/mybucket1/myfile' id='myfile'></blob>
  <blob href='http://localhost:3001/api/buckets/mybucket1/an_object' id='an_object'></blob>
  <blob href='http://localhost:3001/api/buckets/mybucket1/picture_blob' id='picture_blob'></blob>
  <blob href='http://localhost:3001/api/buckets/mybucket1/some_blob id='some_blob'></blob>
</bucket>

Create a new bucket

Example request:

POST /api/buckets?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*
Content-Length: 31
Content-Type: application/x-www-form-urlencoded

name=mybucketeurope&location=EU

Server response:

HTTP/1.1 201 Created
Location: http://localhost:3001/api/buckets/mybucketeurope
Content-Type: application/xml
Content-Length: 182

<?xml version='1.0' encoding='utf-8' ?>
<bucket href='http://localhost:3001/api/buckets/mybucketeurope' id='mybucketeurope'>
  <name>mybucketeurope</name>
  <size>0</size>
</bucket>

Delete a bucket

Example request:

DELETE /api/buckets/mybucketeurope?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content

Get the details of a blob

Example request:

GET /api/buckets/mariosbucket1/some_more_blob_woo?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 586
<?xml version='1.0' encoding='utf-8' ?>
<blob href='http://localhost:3001/api/buckets/mariosbucket1/some_more_blob_woo' id='some_more_blob_woo'>
  <bucket>mariosbucket1</bucket>
  <content_length>86</content_length>
  <content_type>text/plain</content_type>
  <last_modified>Fri Jan 28 12:23:08 UTC 2011</last_modified>
  <user_metadata>
    <entry key='v'>
      <![CDATA[0.2.0]]>
    </entry>
    <entry key='test'>
      <![CDATA[value]]>
    </entry>
  </user_metadata>
  <content href='http://localhost:3001/api/buckets/mariosbucket1/some_more_blob_woo/content'></content>
</blob>

Get the actual blob content

Example request:

GET /api/buckets/mariosanotherbucketohyeah/Im_a_blob_beholdme/content?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Disposition: attachment; filename=Im_a_blob_beholdme
Content-Type: text/plain
Content-Length: 50

<BLOB DATA HERE>

Create a blob object

Example request:

PUT /api/buckets/mybucket/12Jul2011blob?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
Content-Type: text/plain
Content-Length: 128988
X-Deltacloud-Blobmeta-Version:2.1
X-Deltacloud-Blobmeta-Author:msa

... BLOB DATA ...

Server response:

<?xml version='1.0' encoding='utf-8' ?>
<blob href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob' id='12Jul2011blob'>
  <bucket>mybucket</bucket>
  <content_length>128988</content_length>
  <content_type>text/plain</content_type>
  <last_modified>Wed Jul 13 13:27:22 UTC 2011</last_modified>
  <user_metadata>
    <entry key='author'>
      <![CDATA[msa]]>
    </entry>
    <entry key='version'>
      <![CDATA[2.1]]>
    </entry>
  </user_metadata>
  <content href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob/content'>
  </content>
</blob>

Example request:

POST /api/buckets/mybucket?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu) libcurl/7.20.1 N
Accept: */*
Content-Length: 113582
Expect: 100-continue
Content-Type: multipart/form-data; boundary=----------------------------517f5f2df858

------------------------------517f5f2df858
Content-Disposition: form-data; name="blob"

12Jul2011blob
------------------------------517f5f2df858
Content-Disposition: form-data; name="blob_data"; filename="small.txt"
Content-Type: text/plain

<THE_BLOB_DATA_HERE>

------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_params"

2
------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_name1"

author
------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_value1"
jjs
------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_name2"

version
------------------------------517f5f2df858
Content-Disposition: form-data; name="meta_value2"

2.2
------------------------------517f5f2df858--

Server response:

<?xml version='1.0' encoding='utf-8' ?>
<blob href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob' id='12Jul2011blob'>
  <bucket>mybucket</bucket>
  <content_length>112766</content_length>
  <content_type>text/plain</content_type>
  <last_modified></last_modified>
  <user_metadata>
    <entry key='x-amz-meta-author'>
      <![CDATA[jjs]]>
    </entry>
    <entry key='x-amz-meta-version'>
      <![CDATA[2.2]]>
    </entry>
  </user_metadata>
  <content href='http://localhost:3001/api/buckets/mybucket/12Jul2011blob/content'>
  </content>
</blob>

Delete a blob object

Example request:

DELETE /api/buckets/mybucket/12Jul2011blob?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Connection: close
Server: thin 1.2.11

Get all metadata fields

Example request:

HEAD /api/buckets/mybucket/myblob?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
X-Deltacloud-Blobmeta-version: 1.21
X-Deltacloud-Blobmeta-author: jrd

Update the user-defined blob metadata

Example request:

POST /api/buckets/mybucket/myblob?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1
Host: localhost:3001
Accept: */*
X-Deltacloud-Blobmeta-model: 2012
X-Deltacloud-Blobmeta-paint: Stannite_Grey

Server response:

HTTP/1.1 204 No Content
X-Deltacloud-Blobmeta-model: 2012
X-Deltacloud-Blobmeta-paint: Stannite_Grey

;T;@�I"/ruby-client/;T{;{ ;I"�# The Deltacloud Ruby Client

Working with Deltacloud Ruby Client

Each type of a resource has an associated model. Where resource refers to other resources, natural navigation across the object model is possible. For example:

puts instance.image.name
puts instance.hardware_profile.architecture

Listing realms

Retrieve a complete list of realms available to you:

realm = client.realms

You can access a specific realm by adding its identifier:

realm = client.realm( 'us' )

Listing hardware profiles

Display a complete list of hardware profiles available for launching machines:

hwp = client.hardware_profiles

You can filter hardware profiles by architecture.

hardware_profiles = client.hardware_profiles( :architecture=>'x86_64' )

Retrieve a specific hardware profile by its identifier:

hardware_profile = client.hardware_profile( 'm1-small' )

Listing images

Return a complete list of images:

images = client.images

Retrieve a list of images owned by the currently authenticated user:

images = client.images( :owner_id=>:self )

You can also retrieve a list of images visible to you but owned by a specific user:

images = client.images( :owner_id=>'daryll' )

Access a specific image by its identifier:

image = client.image( 'ami-8675309' )

Listing instances

Get a list of all instances visible to you:

instances = client.instances

Retrieve a list of all running instances:

instances = client.instances( :state =>:running )

Look up the first instance in the list:

instance = client.instances.first

Find a specific instance by its identifier:

instance = client.instance( 'i-90125' )

Launching instances

Launch an instance using an image identifier:

instance = client.create_instance(image_id)

You may specify a hardware profile:

instance = client.create_instance(image_id, :hwp_id => 'm1-small')

To create new instance, you can also use the 'user_name' feature:

instance = client.create_instance(image_id, :name => 'myinst1')

Manipulating instances

Start an instance:

instance.start!

Execute the 'reboot' operation:

instance.reboot!

Destroy an instance:

instance.destroy!

For more details on Deltacloud Ruby client see the full documentation.

Back

;T; I"�

Working with Deltacloud Ruby Client

Each type of a resource has an associated model. Where resource refers to other resources, natural navigation across the object model is possible. For example:

puts instance.image.name
puts instance.hardware_profile.architecture

Listing realms

Retrieve a complete list of realms available to you:

realm = client.realms

You can access a specific realm by adding its identifier:

realm = client.realm( 'us' )

Listing hardware profiles

Display a complete list of hardware profiles available for launching machines:

hwp = client.hardware_profiles

You can filter hardware profiles by architecture.

hardware_profiles = client.hardware_profiles( :architecture=>'x86_64' )

Retrieve a specific hardware profile by its identifier:

hardware_profile = client.hardware_profile( 'm1-small' )

Listing images

Return a complete list of images:

images = client.images

Retrieve a list of images owned by the currently authenticated user:

images = client.images( :owner_id=>:self )

You can also retrieve a list of images visible to you but owned by a specific user:

images = client.images( :owner_id=>'daryll' )

Access a specific image by its identifier:

image = client.image( 'ami-8675309' )

Listing instances

Get a list of all instances visible to you:

instances = client.instances

Retrieve a list of all running instances:

instances = client.instances( :state =>:running )

Look up the first instance in the list:

instance = client.instances.first

Find a specific instance by its identifier:

instance = client.instance( 'i-90125' )

Launching instances

Launch an instance using an image identifier:

instance = client.create_instance(image_id)

You may specify a hardware profile:

instance = client.create_instance(image_id, :hwp_id => 'm1-small')

To create new instance, you can also use the 'user_name' feature:

instance = client.create_instance(image_id, :name => 'myinst1')

Manipulating instances

Start an instance:

instance.start!

Execute the 'reboot' operation:

instance.reboot!

Destroy an instance:

instance.destroy!

For more details on Deltacloud Ruby client see the full documentation.

Back
;T; I"

Working with Deltacloud Ruby Client

Each type of a resource has an associated model. Where resource refers to other resources, natural navigation across the object model is possible. For example:

puts instance.image.name
puts instance.hardware_profile.architecture

Listing realms

Retrieve a complete list of realms available to you:

realm = client.realms

You can access a specific realm by adding its identifier:

realm = client.realm( 'us' )

Listing hardware profiles

Display a complete list of hardware profiles available for launching machines:

hwp = client.hardware_profiles

You can filter hardware profiles by architecture.

hardware_profiles = client.hardware_profiles( :architecture=>'x86_64' )

Retrieve a specific hardware profile by its identifier:

hardware_profile = client.hardware_profile( 'm1-small' )

Listing images

Return a complete list of images:

images = client.images

Retrieve a list of images owned by the currently authenticated user:

images = client.images( :owner_id=>:self )

You can also retrieve a list of images visible to you but owned by a specific user:

images = client.images( :owner_id=>'daryll' )

Access a specific image by its identifier:

image = client.image( 'ami-8675309' )

Listing instances

Get a list of all instances visible to you:

instances = client.instances

Retrieve a list of all running instances:

instances = client.instances( :state =>:running )

Look up the first instance in the list:

instance = client.instances.first

Find a specific instance by its identifier:

instance = client.instance( 'i-90125' )

Launching instances

Launch an instance using an image identifier:

instance = client.create_instance(image_id)

You may specify a hardware profile:

instance = client.create_instance(image_id, :hwp_id => 'm1-small')

To create new instance, you can also use the 'user_name' feature:

instance = client.create_instance(image_id, :name => 'myinst1')

Manipulating instances

Start an instance:

instance.start!

Execute the 'reboot' operation:

instance.reboot!

Destroy an instance:

instance.destroy!

For more details on Deltacloud Ruby client see the full documentation.

Back

;T;@�I"/storage-resources/;T{;{ ;I"4O Storage resources

Storage resources

Storage resources are divided into two groups:

storage volumes, which can be attached to a running instance (accessible by the instance OS)
blob storage, which represents a generic 'key <−−> value' based data store, as implemented by Rackspace CloudFiles or Amazon S3

Storage snapshots represent a storage volume, a backup which is created at a particular point of time (a snapshot).

Storage Volumes

A storage volume has

a capacity expressed in Gigabytes;
a created timestamp;
a realm_id specifying the realm in which the volume exists;
a state (for Amazon EC2 this is one of creating, available, in-use, deleting, deleted, error); and
a set of actions.

When attached to an instance, a storage volume will also expose a mount element which contains the attributes instance and device, specifying the instance, to which the volume is attached, and the mount point (e.g. /dev/sdh), respectively.

Get a list of all storage volumes

To list all storage volumes use call GET /api/storage_volumes.

Example request:

GET /api/storage_volumes?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 21:04:09 GMT
Content-Length: 1341

<?xml version='1.0' encoding='utf-8' ?>
<storage_volumes>
  <storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'>
    <created>Thu Jul 28 20:44:18 UTC 2011</created>
    <capacity unit='GB'>10</capacity>
        <realm_id>us-east-1c</realm_id>
    <state>AVAILABLE</state>
    <actions>
      <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach' method='post' rel='attach' />
      <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach' method='post' rel='detach' />
      <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' method='delete' rel='destroy' />
    </actions>
  </storage_volume>
  <storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'>
    <created>Thu Jul 28 20:56:07 UTC 2011</created>
    <capacity unit='GB'>15</capacity>
    <realm_id>us-east-1c</realm_id>
    <state>AVAILABLE</state>
    <actions>
      <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2/attach' method='post' rel='attach' />
      <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2/detach' method='post' rel='detach' />
      <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' method='delete' rel='destroy' />
    </actions>
  </storage_volume>
</storage_volumes>

Get the details of a storage volume

To retrieve the details for the specified storage volume use call GET /api/storage_volumes/:id.

Example request:

GET /api/storage_volumes/vol-99fbe5f2?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 21:06:39 GMT
Content-Length: 794
<?xml version='1.0' encoding='utf-8' ?>
<storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'>
  <created>Thu Jul 28 20:56:07 UTC 2011</created>
  <capacity unit='GB'>15</capacity>
  <realm_id>us-east-1c</realm_id>
  <state>IN-USE</state>
  <mount>
    <instance href='i-b100b3d0' id='i-b100b3d0'></instance>
    <device name='/dev/sdh'></device>
  </mount>
  <actions>
    <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2/attach' method='post' rel='attach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2/detach' method='post' rel='detach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' method='delete' rel='destroy' />
  </actions>
</storage_volume>

Create a new storage volume

To create a new storage volume use call POST /api/storage_volumes. A client may specify a snapshot_id from which the storage volume is instantiated though this is optional. The capacity parameter, expressed in Gigabytes, is also optional and its default size is 1 GB. Finally clients may also specify the realm_id, as a storage volume can typically only be attached to instances running within the specified realm. If the realm is not specified it will set it at the first realm returned by the cloud provider. A successful operation will return HTTP 201 Created with the details of the new storage volume.

× Note:

Fujitsu GCP requires the size to be a multiple of 10, so the specified capacity is rounded up to the nearest multiple of ten, making the default size 10 GB.

As with the other POST operations in the Deltacloud API, clients may choose to specify operation parameters as multipart/form-data or as application/x-www-form-urlencoded data.

Example request:

POST /api/storage_volumes?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 31
Content-Type: application/x-www-form-urlencoded

capacity=10&realm_id=us-east-1c

Server response:

HTTP/1.1 201 Created
Date: Thu, 28 Jul 2011 20:44:27 GMT
Content-Length: 649

<?xml version='1.0' encoding='utf-8' ?>
<storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'>
  <created>Thu Jul 28 20:44:18 UTC 2011</created>
  <capacity unit='GB'>10</capacity>
  <realm_id>us-east-1c</realm_id>
  <state>CREATING</state>
  <actions>
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach' method='post' rel='attach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach' method='post' rel='detach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' method='delete' rel='destroy' />
  </actions>
</storage_volume>

Delete a storage volume

To delete the specified storage volume use call DELETE /api/storage_volumes/:id. The operation will return a HTTP 204 No Content after a succesful operation.

× Note:

The operation will fail if the given storage_volume is currently attached to an instance.

Example request:

DELETE /api/storage_volumes/vol-0bc0de60?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 22:34:29 GMT

Example request: (error deleting a volume currently attached to an instance)

DELETE /api/storage_volumes/vol-0bc0de60?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 502 Bad Gateway
Content-Type: application/xml
Date: Thu, 28 Jul 2011 22:30:07 GMT
Content-Length: 617

<error status='502' url='/api/storage_volumes/vol-0bc0de60?format=xml'>
  <kind>backend_error</kind>
  <backend driver='ec2'>
    <code>502</code>
  </backend>
  <message><![CDATA[Client.VolumeInUse: Volume vol-0bc0de60 is currently attached to i-b100b3d0
  REQUEST=ec2.us-east-1.amazonaws.com:443/?AWSAccessKeyId=AKIAJATNOR5HKG3FK27Q&Action=DeleteVolume&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2011-07-28T22%3A30%3A00.000Z&Version=2010-08-31&VolumeId=vol-0bc0de60&Signature=WnZTd9vFaUZEwfuifyo3%2FWa2HBEG1S7R8Iv%2FHqc%2BmqE%3D
  REQUEST ID=5dff67bb-d63a-4055-b550-f323fa16e185]]></message>
</error>

Attach a storage volume to a running instance

To attach the specified storage volume to a running instance use call POST /api/storage_volumes/:id/attach. Clients must specify the instance_id and the device as parameters. The device parameter is used as the mount point, that is the location at which the storage volume will be exposed to the given instance (e.g. /dev/sdh). The Deltacloud server will respond with a HTTP 202 Accepted after a succesful attach operation with details of the storage volume. In the example below, the state is reported as 'unknown' although the mount element is present. It is because the processing has not yet been completed (hence the 202 status code). Clients may specify the required parameters as multipart/form-data or as application/x-www-form-urlencoded data.

Example request:

POST /api/storage_volumes/vol-0bc0de60/attach?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 38
Content-Type: application/x-www-form-urlencoded

instance_id=i-b100b3d0&device=/dev/sdi

Server response:

HTTP/1.1 202 Accepted
Date: Thu, 28 Jul 2011 21:36:17 GMT
Content-Length: 709

<?xml version='1.0' encoding='utf-8' ?>
<storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'>
  <capacity unit='GB'></capacity>
  <device>/dev/sdi</device>
  <state>unknown</state>
  <mount>
    <instance href='i-b100b3d0' id='i-b100b3d0'></instance>
    <device name='/dev/sdi'></device>
  </mount>
  <actions>
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach' method='post' rel='attach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach' method='post' rel='detach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' method='delete' rel='destroy' />
  </actions>
</storage_volume>

Detach a storage volume from an instance

To detach the given storage volume from the instance to which it is currently attached use call POST /api/storage_volumes/:id/detach. A succesful operation will return HTTP 201 Accepted with details of the storage volume. Similarly to attach operation, in the example below, the state is reported as 'unknown' and the mount element is still present as the processing has not been completed yet (hence the 202 status code).

Example request:

POST /api/storage_volumes/vol-0bc0de60/detach?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 202 Accepted
Content-Type: application/xml
Date: Thu, 28 Jul 2011 21:29:18 GMT
Content-Length: 709

<?xml version='1.0' encoding='utf-8' ?>
<storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'>
  <capacity unit='GB'></capacity>
  <device>/dev/sdi</device>
  <state>unknown</state>
  <mount>
    <instance href='i-b100b3d0' id='i-b100b3d0'></instance>
    <device name='/dev/sdi'></device>
  </mount>
  <actions>
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach' method='post' rel='attach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach' method='post' rel='detach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' method='delete' rel='destroy' />
  </actions>
</storage_volume>

Storage snapshots

;T; I"�9

Storage resources

Storage resources are divided into two groups:

storage volumes, which can be attached to a running instance (accessible by the instance OS)
blob storage, which represents a generic 'key <−−> value' based data store, as implemented by Rackspace CloudFiles or Amazon S3

Storage snapshots represent a storage volume, a backup which is created at a particular point of time (a snapshot).

Storage Volumes

A storage volume has

a capacity expressed in Gigabytes;
a created timestamp;
a realm_id specifying the realm in which the volume exists;
a state (for Amazon EC2 this is one of creating, available, in-use, deleting, deleted, error); and
a set of actions.

Get a list of all storage volumes

To list all storage volumes use call GET /api/storage_volumes.

Example request:

GET /api/storage_volumes?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 21:04:09 GMT
Content-Length: 1341

<?xml version='1.0' encoding='utf-8' ?>
<storage_volumes>
  <storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'>
    <created>Thu Jul 28 20:44:18 UTC 2011</created>
    <capacity unit='GB'>10</capacity>
        <realm_id>us-east-1c</realm_id>
    <state>AVAILABLE</state>
    <actions>
      <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach' method='post' rel='attach' />
      <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach' method='post' rel='detach' />
      <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' method='delete' rel='destroy' />
    </actions>
  </storage_volume>
  <storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'>
    <created>Thu Jul 28 20:56:07 UTC 2011</created>
    <capacity unit='GB'>15</capacity>
    <realm_id>us-east-1c</realm_id>
    <state>AVAILABLE</state>
    <actions>
      <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2/attach' method='post' rel='attach' />
      <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2/detach' method='post' rel='detach' />
      <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' method='delete' rel='destroy' />
    </actions>
  </storage_volume>
</storage_volumes>

Get the details of a storage volume

To retrieve the details for the specified storage volume use call GET /api/storage_volumes/:id.

Example request:

GET /api/storage_volumes/vol-99fbe5f2?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 21:06:39 GMT
Content-Length: 794
<?xml version='1.0' encoding='utf-8' ?>
<storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'>
  <created>Thu Jul 28 20:56:07 UTC 2011</created>
  <capacity unit='GB'>15</capacity>
  <realm_id>us-east-1c</realm_id>
  <state>IN-USE</state>
  <mount>
    <instance href='i-b100b3d0' id='i-b100b3d0'></instance>
    <device name='/dev/sdh'></device>
  </mount>
  <actions>
    <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2/attach' method='post' rel='attach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2/detach' method='post' rel='detach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' method='delete' rel='destroy' />
  </actions>
</storage_volume>

Create a new storage volume

× Note:

Fujitsu GCP requires the size to be a multiple of 10, so the specified capacity is rounded up to the nearest multiple of ten, making the default size 10 GB.

As with the other POST operations in the Deltacloud API, clients may choose to specify operation parameters as multipart/form-data or as application/x-www-form-urlencoded data.

Example request:

POST /api/storage_volumes?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 31
Content-Type: application/x-www-form-urlencoded

capacity=10&realm_id=us-east-1c

Server response:

HTTP/1.1 201 Created
Date: Thu, 28 Jul 2011 20:44:27 GMT
Content-Length: 649

<?xml version='1.0' encoding='utf-8' ?>
<storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'>
  <created>Thu Jul 28 20:44:18 UTC 2011</created>
  <capacity unit='GB'>10</capacity>
  <realm_id>us-east-1c</realm_id>
  <state>CREATING</state>
  <actions>
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach' method='post' rel='attach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach' method='post' rel='detach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' method='delete' rel='destroy' />
  </actions>
</storage_volume>

Delete a storage volume

To delete the specified storage volume use call DELETE /api/storage_volumes/:id. The operation will return a HTTP 204 No Content after a succesful operation.

× Note:

The operation will fail if the given storage_volume is currently attached to an instance.

Example request:

DELETE /api/storage_volumes/vol-0bc0de60?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 22:34:29 GMT

Example request: (error deleting a volume currently attached to an instance)

DELETE /api/storage_volumes/vol-0bc0de60?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 502 Bad Gateway
Content-Type: application/xml
Date: Thu, 28 Jul 2011 22:30:07 GMT
Content-Length: 617

<error status='502' url='/api/storage_volumes/vol-0bc0de60?format=xml'>
  <kind>backend_error</kind>
  <backend driver='ec2'>
    <code>502</code>
  </backend>
  <message><![CDATA[Client.VolumeInUse: Volume vol-0bc0de60 is currently attached to i-b100b3d0
  REQUEST=ec2.us-east-1.amazonaws.com:443/?AWSAccessKeyId=AKIAJATNOR5HKG3FK27Q&Action=DeleteVolume&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2011-07-28T22%3A30%3A00.000Z&Version=2010-08-31&VolumeId=vol-0bc0de60&Signature=WnZTd9vFaUZEwfuifyo3%2FWa2HBEG1S7R8Iv%2FHqc%2BmqE%3D
  REQUEST ID=5dff67bb-d63a-4055-b550-f323fa16e185]]></message>
</error>

Attach a storage volume to a running instance

Example request:

POST /api/storage_volumes/vol-0bc0de60/attach?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 38
Content-Type: application/x-www-form-urlencoded

instance_id=i-b100b3d0&device=/dev/sdi

Server response:

HTTP/1.1 202 Accepted
Date: Thu, 28 Jul 2011 21:36:17 GMT
Content-Length: 709

<?xml version='1.0' encoding='utf-8' ?>
<storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'>
  <capacity unit='GB'></capacity>
  <device>/dev/sdi</device>
  <state>unknown</state>
  <mount>
    <instance href='i-b100b3d0' id='i-b100b3d0'></instance>
    <device name='/dev/sdi'></device>
  </mount>
  <actions>
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach' method='post' rel='attach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach' method='post' rel='detach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' method='delete' rel='destroy' />
  </actions>
</storage_volume>

Detach a storage volume from an instance

Example request:

POST /api/storage_volumes/vol-0bc0de60/detach?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 202 Accepted
Content-Type: application/xml
Date: Thu, 28 Jul 2011 21:29:18 GMT
Content-Length: 709

<?xml version='1.0' encoding='utf-8' ?>
<storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'>
  <capacity unit='GB'></capacity>
  <device>/dev/sdi</device>
  <state>unknown</state>
  <mount>
    <instance href='i-b100b3d0' id='i-b100b3d0'></instance>
    <device name='/dev/sdi'></device>
  </mount>
  <actions>
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach' method='post' rel='attach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach' method='post' rel='detach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' method='delete' rel='destroy' />
  </actions>
</storage_volume>

Storage snapshots
;T; I"�9

Storage resources

Storage resources are divided into two groups:

storage volumes, which can be attached to a running instance (accessible by the instance OS)
blob storage, which represents a generic 'key <−−> value' based data store, as implemented by Rackspace CloudFiles or Amazon S3

Storage snapshots represent a storage volume, a backup which is created at a particular point of time (a snapshot).

Storage Volumes

A storage volume has

a capacity expressed in Gigabytes;
a created timestamp;
a realm_id specifying the realm in which the volume exists;
a state (for Amazon EC2 this is one of creating, available, in-use, deleting, deleted, error); and
a set of actions.

Get a list of all storage volumes

To list all storage volumes use call GET /api/storage_volumes.

Example request:

GET /api/storage_volumes?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 21:04:09 GMT
Content-Length: 1341

<?xml version='1.0' encoding='utf-8' ?>
<storage_volumes>
  <storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'>
    <created>Thu Jul 28 20:44:18 UTC 2011</created>
    <capacity unit='GB'>10</capacity>
        <realm_id>us-east-1c</realm_id>
    <state>AVAILABLE</state>
    <actions>
      <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach' method='post' rel='attach' />
      <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach' method='post' rel='detach' />
      <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' method='delete' rel='destroy' />
    </actions>
  </storage_volume>
  <storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'>
    <created>Thu Jul 28 20:56:07 UTC 2011</created>
    <capacity unit='GB'>15</capacity>
    <realm_id>us-east-1c</realm_id>
    <state>AVAILABLE</state>
    <actions>
      <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2/attach' method='post' rel='attach' />
      <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2/detach' method='post' rel='detach' />
      <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' method='delete' rel='destroy' />
    </actions>
  </storage_volume>
</storage_volumes>

Get the details of a storage volume

To retrieve the details for the specified storage volume use call GET /api/storage_volumes/:id.

Example request:

GET /api/storage_volumes/vol-99fbe5f2?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 21:06:39 GMT
Content-Length: 794
<?xml version='1.0' encoding='utf-8' ?>
<storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'>
  <created>Thu Jul 28 20:56:07 UTC 2011</created>
  <capacity unit='GB'>15</capacity>
  <realm_id>us-east-1c</realm_id>
  <state>IN-USE</state>
  <mount>
    <instance href='i-b100b3d0' id='i-b100b3d0'></instance>
    <device name='/dev/sdh'></device>
  </mount>
  <actions>
    <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2/attach' method='post' rel='attach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2/detach' method='post' rel='detach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' method='delete' rel='destroy' />
  </actions>
</storage_volume>

Create a new storage volume

× Note:

Fujitsu GCP requires the size to be a multiple of 10, so the specified capacity is rounded up to the nearest multiple of ten, making the default size 10 GB.

As with the other POST operations in the Deltacloud API, clients may choose to specify operation parameters as multipart/form-data or as application/x-www-form-urlencoded data.

Example request:

POST /api/storage_volumes?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 31
Content-Type: application/x-www-form-urlencoded

capacity=10&realm_id=us-east-1c

Server response:

HTTP/1.1 201 Created
Date: Thu, 28 Jul 2011 20:44:27 GMT
Content-Length: 649

<?xml version='1.0' encoding='utf-8' ?>
<storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'>
  <created>Thu Jul 28 20:44:18 UTC 2011</created>
  <capacity unit='GB'>10</capacity>
  <realm_id>us-east-1c</realm_id>
  <state>CREATING</state>
  <actions>
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach' method='post' rel='attach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach' method='post' rel='detach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' method='delete' rel='destroy' />
  </actions>
</storage_volume>

Delete a storage volume

To delete the specified storage volume use call DELETE /api/storage_volumes/:id. The operation will return a HTTP 204 No Content after a succesful operation.

× Note:

The operation will fail if the given storage_volume is currently attached to an instance.

Example request:

DELETE /api/storage_volumes/vol-0bc0de60?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 22:34:29 GMT

Example request: (error deleting a volume currently attached to an instance)

DELETE /api/storage_volumes/vol-0bc0de60?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 502 Bad Gateway
Content-Type: application/xml
Date: Thu, 28 Jul 2011 22:30:07 GMT
Content-Length: 617

<error status='502' url='/api/storage_volumes/vol-0bc0de60?format=xml'>
  <kind>backend_error</kind>
  <backend driver='ec2'>
    <code>502</code>
  </backend>
  <message><![CDATA[Client.VolumeInUse: Volume vol-0bc0de60 is currently attached to i-b100b3d0
  REQUEST=ec2.us-east-1.amazonaws.com:443/?AWSAccessKeyId=AKIAJATNOR5HKG3FK27Q&Action=DeleteVolume&SignatureMethod=HmacSHA256&SignatureVersion=2&Timestamp=2011-07-28T22%3A30%3A00.000Z&Version=2010-08-31&VolumeId=vol-0bc0de60&Signature=WnZTd9vFaUZEwfuifyo3%2FWa2HBEG1S7R8Iv%2FHqc%2BmqE%3D
  REQUEST ID=5dff67bb-d63a-4055-b550-f323fa16e185]]></message>
</error>

Attach a storage volume to a running instance

Example request:

POST /api/storage_volumes/vol-0bc0de60/attach?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 38
Content-Type: application/x-www-form-urlencoded

instance_id=i-b100b3d0&device=/dev/sdi

Server response:

HTTP/1.1 202 Accepted
Date: Thu, 28 Jul 2011 21:36:17 GMT
Content-Length: 709

<?xml version='1.0' encoding='utf-8' ?>
<storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'>
  <capacity unit='GB'></capacity>
  <device>/dev/sdi</device>
  <state>unknown</state>
  <mount>
    <instance href='i-b100b3d0' id='i-b100b3d0'></instance>
    <device name='/dev/sdi'></device>
  </mount>
  <actions>
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach' method='post' rel='attach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach' method='post' rel='detach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' method='delete' rel='destroy' />
  </actions>
</storage_volume>

Detach a storage volume from an instance

Example request:

POST /api/storage_volumes/vol-0bc0de60/detach?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 202 Accepted
Content-Type: application/xml
Date: Thu, 28 Jul 2011 21:29:18 GMT
Content-Length: 709

<?xml version='1.0' encoding='utf-8' ?>
<storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'>
  <capacity unit='GB'></capacity>
  <device>/dev/sdi</device>
  <state>unknown</state>
  <mount>
    <instance href='i-b100b3d0' id='i-b100b3d0'></instance>
    <device name='/dev/sdi'></device>
  </mount>
  <actions>
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/attach' method='post' rel='attach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60/detach' method='post' rel='detach' />
    <link href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' method='delete' rel='destroy' />
  </actions>
</storage_volume>

Storage snapshots

;T;@�I"/storage-snapshots/;T{;{ ;I"s1 Storage snapshots

Storage snapshots

A storage snapshot captures the state of a storage volume at the exact moment in time. Each snapshot has

a created timestamp; and
a storage volume attribute referring to the volume from which the snapshot was made.

Get a list of all storage snapshots

To list all available storage snapshots use call GET /api/storage_snapshots. As concerns Amazon EC2, this list includes any snapshots that are available to the requesting client account, including those that may not have been created by that account. As this list is very long the example below shows only part of the response:

Example request:

GET /api/storage_snapshots?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 22:08:36 GMT
Content-Length: 156897

<?xml version='1.0' encoding='utf-8' ?>
<storage_snapshots>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-45b8d024' id='snap-45b8d024'>
    <created>Thu Jul 28 21:54:19 UTC 2011</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'></storage_volume>
  </storage_snapshot>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-d5a1c9b4' id='snap-d5a1c9b4'>
    <created>Thu Jul 28 21:46:12 UTC 2011</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'></storage_volume>
  </storage_snapshot>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-dda6cebc' id='snap-dda6cebc'>
    <created>Thu Jul 28 21:51:55 UTC 2011</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'></storage_volume>
  </storage_snapshot>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-d010f6b9' id='snap-d010f6b9'>
    <created>Mon Oct 20 18:23:59 UTC 2008</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-351efb5c' id='vol-351efb5c'></storage_volume>
  </storage_snapshot>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-a310f6ca' id='snap-a310f6ca'>
    <created>Mon Oct 20 18:25:53 UTC 2008</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-001efb69' id='vol-001efb69'></storage_volume>
  </storage_snapshot>
  (...)
</storage_snapshots>

Get the details of a storage snaphsot

To get all details for a specified storage snapshot, as shown below, use call GET /api/storage_snapshots/:id.

Example request:

GET /api/storage_snapshots/snap-45b8d024?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 22:08:36 GMT
Content-Length: 329

<?xml version='1.0' encoding='utf-8' ?>
<storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-45b8d024' id='snap-45b8d024'>
  <created>Thu Jul 28 21:54:19 UTC 2011</created>
  <storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'></storage_volume>
</storage_snapshot>

Create a new storage snapshot

To create a new storage snapshot use call POST /api/storage_snapshots. Clients must specify the storage volume, which the snapshot is created from, by supplying the volume_id parameter. The Deltacloud server responds with HTTP 201 Created after a succesful operation and provides details of the new storage snapshot. Clients may specify operation parameters as multipart/form-data, or as application/x-www-form-urlencoded data:

Example request:

POST /api/storage_snapshots?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 22
Content-Type: application/x-www-form-urlencoded

volume_id=vol-99fbe5f2

Server response:

HTTP/1.1 201 Created
Date: Thu, 28 Jul 2011 21:46:48 GMT
Content-Length: 329

<?xml version='1.0' encoding='utf-8' ?>
<storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-d5a1c9b4' id='snap-d5a1c9b4'>
  <created>Thu Jul 28 21:46:12 UTC 2011</created>
  <storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'></storage_volume>
</storage_snapshot>

Delete a storage snapshot

To delete the specified storagesnapshot use call DELETE /api/storage_snapshots/:id. The operation returns a HTTP 204 No Content after a succesful operation:

Example request:

DELETE /api/storage_snapshots/snap-dda6cebc?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 22:26:07 GMT

Blob storage

;T; I"�

Storage snapshots

A storage snapshot captures the state of a storage volume at the exact moment in time. Each snapshot has

a created timestamp; and
a storage volume attribute referring to the volume from which the snapshot was made.

Get a list of all storage snapshots

Example request:

GET /api/storage_snapshots?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 22:08:36 GMT
Content-Length: 156897

<?xml version='1.0' encoding='utf-8' ?>
<storage_snapshots>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-45b8d024' id='snap-45b8d024'>
    <created>Thu Jul 28 21:54:19 UTC 2011</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'></storage_volume>
  </storage_snapshot>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-d5a1c9b4' id='snap-d5a1c9b4'>
    <created>Thu Jul 28 21:46:12 UTC 2011</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'></storage_volume>
  </storage_snapshot>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-dda6cebc' id='snap-dda6cebc'>
    <created>Thu Jul 28 21:51:55 UTC 2011</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'></storage_volume>
  </storage_snapshot>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-d010f6b9' id='snap-d010f6b9'>
    <created>Mon Oct 20 18:23:59 UTC 2008</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-351efb5c' id='vol-351efb5c'></storage_volume>
  </storage_snapshot>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-a310f6ca' id='snap-a310f6ca'>
    <created>Mon Oct 20 18:25:53 UTC 2008</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-001efb69' id='vol-001efb69'></storage_volume>
  </storage_snapshot>
  (...)
</storage_snapshots>

Get the details of a storage snaphsot

To get all details for a specified storage snapshot, as shown below, use call GET /api/storage_snapshots/:id.

Example request:

GET /api/storage_snapshots/snap-45b8d024?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 22:08:36 GMT
Content-Length: 329

<?xml version='1.0' encoding='utf-8' ?>
<storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-45b8d024' id='snap-45b8d024'>
  <created>Thu Jul 28 21:54:19 UTC 2011</created>
  <storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'></storage_volume>
</storage_snapshot>

Create a new storage snapshot

Example request:

POST /api/storage_snapshots?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 22
Content-Type: application/x-www-form-urlencoded

volume_id=vol-99fbe5f2

Server response:

HTTP/1.1 201 Created
Date: Thu, 28 Jul 2011 21:46:48 GMT
Content-Length: 329

<?xml version='1.0' encoding='utf-8' ?>
<storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-d5a1c9b4' id='snap-d5a1c9b4'>
  <created>Thu Jul 28 21:46:12 UTC 2011</created>
  <storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'></storage_volume>
</storage_snapshot>

Delete a storage snapshot

To delete the specified storagesnapshot use call DELETE /api/storage_snapshots/:id. The operation returns a HTTP 204 No Content after a succesful operation:

Example request:

DELETE /api/storage_snapshots/snap-dda6cebc?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 22:26:07 GMT

Blob storage
;T; I"�

Storage snapshots

A storage snapshot captures the state of a storage volume at the exact moment in time. Each snapshot has

a created timestamp; and
a storage volume attribute referring to the volume from which the snapshot was made.

Get a list of all storage snapshots

Example request:

GET /api/storage_snapshots?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 22:08:36 GMT
Content-Length: 156897

<?xml version='1.0' encoding='utf-8' ?>
<storage_snapshots>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-45b8d024' id='snap-45b8d024'>
    <created>Thu Jul 28 21:54:19 UTC 2011</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'></storage_volume>
  </storage_snapshot>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-d5a1c9b4' id='snap-d5a1c9b4'>
    <created>Thu Jul 28 21:46:12 UTC 2011</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'></storage_volume>
  </storage_snapshot>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-dda6cebc' id='snap-dda6cebc'>
    <created>Thu Jul 28 21:51:55 UTC 2011</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'></storage_volume>
  </storage_snapshot>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-d010f6b9' id='snap-d010f6b9'>
    <created>Mon Oct 20 18:23:59 UTC 2008</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-351efb5c' id='vol-351efb5c'></storage_volume>
  </storage_snapshot>
  <storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-a310f6ca' id='snap-a310f6ca'>
    <created>Mon Oct 20 18:25:53 UTC 2008</created>
    <storage_volume href='http://localhost:3001/api/storage_volumes/vol-001efb69' id='vol-001efb69'></storage_volume>
  </storage_snapshot>
  (...)
</storage_snapshots>

Get the details of a storage snaphsot

To get all details for a specified storage snapshot, as shown below, use call GET /api/storage_snapshots/:id.

Example request:

GET /api/storage_snapshots/snap-45b8d024?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Thu, 28 Jul 2011 22:08:36 GMT
Content-Length: 329

<?xml version='1.0' encoding='utf-8' ?>
<storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-45b8d024' id='snap-45b8d024'>
  <created>Thu Jul 28 21:54:19 UTC 2011</created>
  <storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'></storage_volume>
</storage_snapshot>

Create a new storage snapshot

Example request:

POST /api/storage_snapshots?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 22
Content-Type: application/x-www-form-urlencoded

volume_id=vol-99fbe5f2

Server response:

HTTP/1.1 201 Created
Date: Thu, 28 Jul 2011 21:46:48 GMT
Content-Length: 329

<?xml version='1.0' encoding='utf-8' ?>
<storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-d5a1c9b4' id='snap-d5a1c9b4'>
  <created>Thu Jul 28 21:46:12 UTC 2011</created>
  <storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'></storage_volume>
</storage_snapshot>

Delete a storage snapshot

To delete the specified storagesnapshot use call DELETE /api/storage_snapshots/:id. The operation returns a HTTP 204 No Content after a succesful operation:

Example request:

DELETE /api/storage_snapshots/snap-dda6cebc?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*

Server response:

HTTP/1.1 204 No Content
Date: Thu, 28 Jul 2011 22:26:07 GMT

Blob storage

;T;@�I"/about/;T{;{ ;I"8 About

About Deltacloud

Deltacloud provides the API server and drivers necessary for connecting to cloud providers.

Deltacloud maintains long-term stability for scripts, tools and applications and backward compatibility across different versions.

Deltacloud enables management of resources in different clouds by the use of one of three supported APIs. The supported APIs are the Deltacloud classic API, the DMTF CIMI API or even the EC2 API.

All of this means you can start an instance on an internal cloud and with the same code start another on EC2 or RHEV-M.

How does Deltacloud work?

Deltacloud contains a cloud abstraction API - whether the Deltacloud classic API, the DMTF CIMI API or even the EC2 API. The API works as a wrapper around a large number of clouds, abstracting their differences. For every cloud provider there is a driver "speaking" that cloud provider's native API, freeing you from dealing with the particulars of each cloud's API.

Install Deltacloud and start the deltacloudd daemon server. You can use your favourite HTTP client to talk to the server using the Deltacloud REST API, the DMTF CIMI API or even the EC2 API. Deltacloud even comes with an HTML interface so you can simply use your web browser to control your cloud infrastructure straight out of the box. The HTML interface is written with the jQuery mobile framework, so it is compatible with your mobile or tablet devices.

Get Deltacloud

;T; I"�

About Deltacloud

Deltacloud provides the API server and drivers necessary for connecting to cloud providers.

Deltacloud maintains long-term stability for scripts, tools and applications and backward compatibility across different versions.

Deltacloud enables management of resources in different clouds by the use of one of three supported APIs. The supported APIs are the Deltacloud classic API, the DMTF CIMI API or even the EC2 API.

All of this means you can start an instance on an internal cloud and with the same code start another on EC2 or RHEV-M.

How does Deltacloud work?

Get Deltacloud

;T; I"�

About Deltacloud

Deltacloud provides the API server and drivers necessary for connecting to cloud providers.

Deltacloud maintains long-term stability for scripts, tools and applications and backward compatibility across different versions.

Deltacloud enables management of resources in different clouds by the use of one of three supported APIs. The supported APIs are the Deltacloud classic API, the DMTF CIMI API or even the EC2 API.

All of this means you can start an instance on an internal cloud and with the same code start another on EC2 or RHEV-M.

How does Deltacloud work?

Get Deltacloud

;T;@�I"/assets/img/diagram-soa/;T{;{I"/assets/img/logo/;T{;{I"/assets/img/introbg/;T{;{I"/assets/img/asf_logo_wide/;T{;{I"&/assets/img/glyphicons-halflings/;T{;{I"3/assets/img/documentation_files/default-debug/;T{;{;I"7@import url(generic.css); @import url(debug.css); ;T; @�; @�I"-/assets/img/documentation_files/default/;T{;{;I"8@import url(generic.css); @import url(dcloud.css); ;T; @�; @�I"3/assets/img/documentation_files/asf_logo_wide/;T{;{I"+/assets/img/documentation_files/piwik/;T{;{;I"lM/* * Piwik - Web Analytics * * JavaScript tracking client * * @link http://piwik.org * @source http://dev.piwik.org/trac/browser/trunk/js/piwik.js * @license http://www.opensource.org/licenses/bsd-license.php Simplified BSD */ if(!this.JSON2){this.JSON2={}}(function(){function d(f){return f<10?"0"+f:f}function l(n,m){var f=Object.prototype.toString.apply(n);if(f==="[object Date]"){return isFinite(n.valueOf())?n.getUTCFullYear()+"-"+d(n.getUTCMonth()+1)+"-"+d(n.getUTCDate())+"T"+d(n.getUTCHours())+":"+d(n.getUTCMinutes())+":"+d(n.getUTCSeconds())+"Z":null}if(f==="[object String]"||f==="[object Number]"||f==="[object Boolean]"){return n.valueOf()}if(f!=="[object Array]"&&typeof n.toJSON==="function"){return n.toJSON(m)}return n}var c=new RegExp("[\u0000\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]","g"),e='\\\\\\"\x00-\x1f\x7f-\x9f\u00ad\u0600-\u0604\u070f\u17b4\u17b5\u200c-\u200f\u2028-\u202f\u2060-\u206f\ufeff\ufff0-\uffff]',i=new RegExp("["+e,"g"),j,b,k={"\b":"\\b","\t":"\\t","\n":"\\n","\f":"\\f","\r":"\\r",'"':'\\"',"\\":"\\\\"},h; function a(f){i.lastIndex=0;return i.test(f)?'"'+f.replace(i,function(m){var n=k[m];return typeof n==="string"?n:"\\u"+("0000"+m.charCodeAt(0).toString(16)).slice(-4)})+'"':'"'+f+'"'}function g(s,p){var n,m,t,f,q=j,o,r=p[s];if(r&&typeof r==="object"){r=l(r,s)}if(typeof h==="function"){r=h.call(p,s,r)}switch(typeof r){case"string":return a(r);case"number":return isFinite(r)?String(r):"null";case"boolean":case"null":return String(r);case"object":if(!r){return"null"}j+=b;o=[];if(Object.prototype.toString.apply(r)==="[object Array]"){f=r.length;for(n=0;n>>(32-i))},ac=function(ai){var ah="",ag,W;for(ag=7;ag>=0;ag--){W=(ai>>>(ag*4))&15;ah+=W.toString(16)}return ah},Q,ae,ad,M=[],U=1732584193,S=4023233417,R=2562383102,P=271733878,O=3285377520,aa,Z,Y,X,V,af,L,T=[];ab=o(ab);L=ab.length;for(ae=0;ae>>29);T.push((L<<3)&4294967295);for(Q=0;Q=0){bc=bc.slice(0,bb)}if((bb=bc.lastIndexOf("/"))!==bc.length-1){bc=bc.slice(0,bb+1)}return bc+ba}function aE(bd){var bb,ba,bc;for(bb=0;bb0)&&(bd.slice(bc)===ba)){return true}}}return false}function a9(ba){var bb=new Image(1,1);bb.onload=function(){};bb.src=N+(N.indexOf("?")<0?"?":"&")+ba}function aP(ba){try{var bc=x.XDomainRequest?new x.XDomainRequest():x.XMLHttpRequest?new x.XMLHttpRequest():x.ActiveXObject?new ActiveXObject("Microsoft.XMLHTTP"):null;bc.open("POST",N,true);bc.onreadystatechange=function(){if(this.readyState===4&&this.status!==200){a9(ba)}};bc.setRequestHeader("Content-Type","application/x-www-form-urlencoded; charset=UTF-8");bc.send(ba)}catch(bb){a9(ba)}}function an(bc,bb){var ba=new Date();if(!a0){if(aF==="POST"){aP(bc)}else{a9(bc) }f=ba.getTime()+bb}}function aO(ba){return a5+ba+"."+aX+"."+aJ}function P(){var ba=aO("testcookie");if(!r(c.cookieEnabled)){l(ba,"1");return e(ba)==="1"?"1":"0"}return c.cookieEnabled?"1":"0"}function az(){aJ=al((W||aT)+(a6||"/")).slice(0,4)}function Y(){var bb=aO("cvar"),ba=e(bb);if(ba.length){ba=JSON2.parse(ba);if(z(ba)){return ba}}return{}}function M(){if(Q===false){Q=Y()}}function aW(){var ba=new Date();aG=ba.getTime()}function V(be,bb,ba,bd,bc,bf){l(aO("id"),be+"."+bb+"."+ba+"."+bd+"."+bc+"."+bf,aa,a6,W,Z)}function L(){var bb=new Date(),ba=Math.round(bb.getTime()/1000),bd=e(aO("id")),bc;if(bd){bc=bd.split(".");bc.unshift("0")}else{if(!ap){ap=al((c.userAgent||"")+(c.platform||"")+JSON2.stringify(aY)+ba).slice(0,16)}bc=["1",ap,ba,0,ba,"",""]}return bc}function i(){var ba=e(aO("ref"));if(ba.length){try{ba=JSON2.parse(ba);if(z(ba)){return ba}}catch(bb){}}return["","",0,""]}function aj(bc,bA,bB,be){var by,bb=new Date(),bk=Math.round(bb.getTime()/1000),bD,bz,bg,br,bv,bj,bt,bh,bx,bf=1024,bE,bn,bu=Q,bp=aO("id"),bl=aO("ses"),bm=aO("ref"),bF=aO("cvar"),bs=L(),bo=e(bl),bw=i(),bC=ar||a7,bi,ba; if(a0){l(bp,"",-1,a6,W);l(bl,"",-1,a6,W);l(bF,"",-1,a6,W);l(bm,"",-1,a6,W);return""}bD=bs[0];bz=bs[1];br=bs[2];bg=bs[3];bv=bs[4];bj=bs[5];if(!r(bs[6])){bs[6]=""}bt=bs[6];if(!r(be)){be=""}bi=bw[0];ba=bw[1];bh=bw[2];bx=bw[3];if(!bo){bg++;bj=bv;if(!aq||!bi.length){for(by in am){if(Object.prototype.hasOwnProperty.call(am,by)){bi=y(bC,am[by]);if(bi.length){break}}}for(by in ah){if(Object.prototype.hasOwnProperty.call(ah,by)){ba=y(bC,ah[by]);if(ba.length){break}}}}bE=b(aH);bn=bx.length?b(bx):"";if(bE.length&&!aE(bE)&&(!aq||!bn.length||aE(bn))){bx=aH}if(bx.length||bi.length){bh=bk;bw=[bi,ba,bh,a2(bx.slice(0,bf))];l(bm,JSON2.stringify(bw),at,a6,W,Z)}}bc+="&idsite="+aX+"&rec=1&r="+String(Math.random()).slice(2,8)+"&h="+bb.getHours()+"&m="+bb.getMinutes()+"&s="+bb.getSeconds()+"&url="+h(a2(bC))+(aH.length?"&urlref="+h(a2(aH)):"")+"&_id="+bz+"&_idts="+br+"&_idvc="+bg+"&_idn="+bD+(bi.length?"&_rcn="+h(bi):"")+(ba.length?"&_rck="+h(ba):"")+"&_refts="+bh+"&_viewts="+bj+(String(bt).length?"&_ects="+bt:"")+(String(bx).length?"&_ref="+h(a2(bx.slice(0,bf))):""); var bd=JSON2.stringify(ax);if(bd.length>2){bc+="&cvar="+h(bd)}for(by in aY){if(Object.prototype.hasOwnProperty.call(aY,by)){bc+="&"+by+"="+aY[by]}}if(bA){bc+="&data="+h(JSON2.stringify(bA))}else{if(U){bc+="&data="+h(JSON2.stringify(U))}}if(Q){var bq=JSON2.stringify(Q);if(bq.length>2){bc+="&_cvar="+h(bq)}for(by in bu){if(Object.prototype.hasOwnProperty.call(bu,by)){if(Q[by][0]===""||Q[by][1]===""){delete Q[by]}}}l(bF,JSON2.stringify(Q),ab,a6,W,Z)}V(bz,br,bg,bk,bj,r(be)&&String(be).length?be:bt);l(bl,"*",ab,a6,W,Z);bc+=E(bB);return bc}function aR(bd,bc,bh,be,ba,bk){var bf="idgoal=0",bg,bb=new Date(),bi=[],bj;if(String(bd).length){bf+="&ec_id="+h(bd);bg=Math.round(bb.getTime()/1000)}bf+="&revenue="+bc;if(String(bh).length){bf+="&ec_st="+bh}if(String(be).length){bf+="&ec_tx="+be}if(String(ba).length){bf+="&ec_sh="+ba}if(String(bk).length){bf+="&ec_dt="+bk}if(aN){for(bj in aN){if(Object.prototype.hasOwnProperty.call(aN,bj)){if(!r(aN[bj][1])){aN[bj][1]=""}if(!r(aN[bj][2])){aN[bj][2]=""}if(!r(aN[bj][3])||String(aN[bj][3]).length===0){aN[bj][3]=0 }if(!r(aN[bj][4])||String(aN[bj][4]).length===0){aN[bj][4]=1}bi.push(aN[bj])}}bf+="&ec_items="+h(JSON2.stringify(bi))}bf=aj(bf,U,"ecommerce",bg);an(bf,aC)}function aQ(ba,be,bd,bc,bb,bf){if(String(ba).length&&r(be)){aR(ba,be,bd,bc,bb,bf)}}function a4(ba){if(r(ba)){aR("",ba,"","","","")}}function av(bd,be){var ba=new Date(),bc=aj("action_name="+h(K(bd||ai)),be,"log");an(bc,aC);if(S&&ae&&!aI){aI=true;J(p,"click",aW);J(p,"mouseup",aW);J(p,"mousedown",aW);J(p,"mousemove",aW);J(p,"mousewheel",aW);J(x,"DOMMouseScroll",aW);J(x,"scroll",aW);J(p,"keypress",aW);J(p,"keydown",aW);J(p,"keyup",aW);J(x,"resize",aW);J(x,"focus",aW);J(x,"blur",aW);aG=ba.getTime();setTimeout(function bb(){var bf=new Date(),bg;if((aG+ae)>bf.getTime()){if(S0){ba=r(ba)&&!j(ba)?String(ba):ba;be=r(be)&&!j(be)?String(be):be;bd=[ba.slice(0,a1),be.slice(0,a1)];if(bc==="visit"||bc===2){M();Q[bb]=bd}else{if(bc==="page"||bc===3){ax[bb]=bd}}}},getCustomVariable:function(bb,bc){var ba;if(!r(bc)){bc="visit" }if(bc==="page"||bc===3){ba=ax[bb]}else{if(bc==="visit"||bc===2){M();ba=Q[bb]}}if(!r(ba)||(ba&&ba[0]==="")){return false}return ba},deleteCustomVariable:function(ba,bb){if(this.getCustomVariable(ba,bb)){this.setCustomVariable(ba,"","",bb)}},setLinkTrackingTimer:function(ba){aC=ba},setDownloadExtensions:function(ba){ak=ba},addDownloadExtensions:function(ba){ak+="|"+ba},setDomains:function(ba){aD=j(ba)?[ba]:ba;aD.push(aT)},setIgnoreClasses:function(ba){R=j(ba)?[ba]:ba},setRequestMethod:function(ba){aF=ba||"GET"},setReferrerUrl:function(ba){aH=ba},setCustomUrl:function(ba){ar=aS(a7,ba)},setDocumentTitle:function(ba){ai=ba},setDownloadClasses:function(ba){aw=j(ba)?[ba]:ba},setLinkClasses:function(ba){ac=j(ba)?[ba]:ba},setCampaignNameKey:function(ba){am=j(ba)?[ba]:ba},setCampaignKeywordKey:function(ba){ah=j(ba)?[ba]:ba},discardHashTag:function(ba){T=ba},setCookieNamePrefix:function(ba){a5=ba;Q=Y()},setCookieDomain:function(ba){W=t(ba);az()},setCookiePath:function(ba){a6=ba;az()},setVisitorCookieTimeout:function(ba){aa=ba*1000 },setSessionCookieTimeout:function(ba){ab=ba*1000},setReferralCookieTimeout:function(ba){at=ba*1000},setConversionAttributionFirstReferrer:function(ba){aq=ba},setDoNotTrack:function(bb){var ba=c.doNotTrack||c.msDoNotTrack;a0=bb&&(ba==="yes"||ba==="1")},addListener:function(bb,ba){aL(bb,ba)},enableLinkTracking:function(ba){if(m){au(ba)}else{v.push(function(){au(ba)})}},setHeartBeatTimer:function(bc,bb){var ba=new Date();S=ba.getTime()+bc*1000;ae=bb*1000},killFrame:function(){if(x.location!==x.top.location){x.top.location=x.location}},redirectFile:function(ba){if(x.location.protocol==="file:"){x.location=ba}},setCountPreRendered:function(ba){ao=ba},trackGoal:function(ba,bc,bb){ag(function(){aA(ba,bc,bb)})},trackLink:function(bb,ba,bc){ag(function(){aV(bb,ba,bc)})},trackPageView:function(ba,bb){ag(function(){av(ba,bb)})},setEcommerceView:function(bd,ba,bc,bb){if(!r(bc)||!bc.length){bc=""}else{if(bc instanceof Array){bc=JSON2.stringify(bc)}}ax[5]=["_pkc",bc];if(r(bb)&&String(bb).length){ax[2]=["_pkp",bb] }if((!r(bd)||!bd.length)&&(!r(ba)||!ba.length)){return}if(r(bd)&&bd.length){ax[3]=["_pks",bd]}if(!r(ba)||!ba.length){ba=""}ax[4]=["_pkn",ba]},addEcommerceItem:function(be,ba,bc,bb,bd){if(be.length){aN[be]=[be,ba,bc,bb,bd]}},trackEcommerceOrder:function(ba,be,bd,bc,bb,bf){aQ(ba,be,bd,bc,bb,bf)},trackEcommerceCartUpdate:function(ba){a4(ba)}}}function q(){return{push:G}}J(x,"beforeunload",H,false);k();Date.prototype.getTimeAlias=Date.prototype.getTime;B=new u();for(D=0;D<_paq.length;D++){G(_paq[D])}_paq=new q();return{addPlugin:function(i,L){a[i]=L},getTracker:function(i,L){return new u(i,L)},getAsyncTracker:function(){return B}}}()),piwik_track,piwik_log=function(b,f,d,g){function a(h){try{return eval("piwik_"+h)}catch(i){}return}var c,e=Piwik.getTracker(d,f);e.setDocumentTitle(b);e.setCustomData(g);c=a("tracker_pause");if(c){e.setLinkTrackingTimer(c)}c=a("download_extensions");if(c){e.setDownloadExtensions(c)}c=a("hosts_alias");if(c){e.setDomains(c)}c=a("ignore_classes");if(c){e.setIgnoreClasses(c) }e.trackPageView();if(a("install_tracker")){piwik_track=function(i,k,j,h){e.setSiteId(k);e.setTrackerUrl(j);e.trackLink(i,h)};e.enableLinkTracking()}};;T; @�; @�I"/assets/img/documentation/;T{;{;I"/[ Deltacloud - Documentation

Documentation

The Deltacloud documentation is divided into the following parts:

Install Deltacloud

This page lists the libraries and packages that you will need in order to install the Deltacloud server, a "Hello Deltacloud" quick-start guide as well as some information on interacting with the Deltacloud server after a succesful installation.

Installation of Deltacloud itself

Once you've setup all the dependencies listed below, installing Deltacloud is as easy as typing:

$ sudo gem install deltacloud-core

And thats it! The gem install command will automatically fetch and install all other gems that the Deltacloud server needs if you don't already have these. As an alternative you can get the latest releases of Deltacloud from the Apache website.

Installation dependencies

The Deltacloud server relies on a number of external rubygems and other libraries. You must have the following packages installed before trying to install and run the Deltacloud server. Please note that the names of the packages below may differ for your distribution (e.g. 'ruby-devel' vs 'ruby-dev'). In short, you need:

ruby and ruby-devel,
gem (RubyGems),
gcc-c++,
libxml2 and libxml2-devel,
libxslt and libxslt-devel,
rake

More info on getting these follows:

ruby and ruby-devel

You need to install ruby. You can check to see if you already have a ruby installation by typing:

$ ruby -v

If you see something that looks like the following:

ruby 1.8.7 (2010-08-16 patchlevel 302) [i686-linux]

then you can skip the ruby installation. Deltacloud requires ruby to be at least version 1.8.7. You also need the development headers (ruby-devel) as Deltacloud relies on some rubygems with C extensions. If you use a package manager such as yum or apt-get:

sudo yum install ruby
sudo yum install ruby-devel

sudo apt-get install ruby
sudo apt-get install ruby-devel

gem (RubyGems)

Deltacloud relies on a number of ruby gems so you also need to install RubyGems. As with ruby, you can check if you already have the gem executable installed by typing gem -v . Again, your package manager can help with the installation:

$ sudo yum install rubygems

gcc-c++, libxml2, libxml2-devel, libxslt, libxslt-devel

These are required to build RubyGems that have C extensions. Again, typically the easiest way to get these is with you package manager:

$ sudo yum install gcc-c++
$ sudo yum install libxml libxml2-devel
$ sudo yum install libxslt libxslt-devel

rake

Rake is Ruby's Make and is itself a ruby gem. Once you have RubyGems installed you can get rake with:

$ sudo gem install rake

"Hello Deltacloud!", quick-start guide

This guide assumes a linux environment. Some of the Deltacloud developers are running recent versions of Fedora. However, as Deltacloud is written in Ruby you should be able to install it on any OS that supports Ruby. If you have succesfully installed Deltacloud or are having any problems doing so, please let us know, we'd love to hear from you!

Running the Deltacloud server

After you succesfully install Deltacloud, you can start the server by typing deltacloudd -i provider_id. The provider_id is the name of the cloud provider that you have an account with, for example 'ec2'. If you don't yet have an account with a cloud provider, you can still try the Deltacloud mock driver:

deltacloudd -i mock

This will start the Deltacloud server on your local machine with the mock driver, accepting connections on port 3001 (the default). From version 0.4.0 of Deltacloud, you can use the '-l' flag to see all available provider_ids that can be used with the deltacloudd executable.

$ deltacloudd -l


Available drivers:
* condor
* vsphere
* opennebula
* eucalyptus
* rhevm
* sbc
* azure
* gogrid
* mock
* rackspace
* rimuhosting
* terremark
* ec2

After you start the server, the Deltacloud HTML interface is available at http://localhost:3001/api - open this address in your web browser. If you want to see XML output from the server in the browser, append format=xml to each URL. On Webkit based browsers like Safari, you might need to instruct the server explicitly to return HTML Do this by appending format=html to each URL. Your browser will prompt you for credentials when you invoke an operation that requires authentication.

The '-h' flag will list all available options for deltacloudd. For example, to start the Deltacloud server with the Rackspace driver on port 10000 you can use:

$ deltacloudd -i rackspace -P 10000

You may want to install the server on another machine and make Deltacloud available on your local network. To do this you need to bind the Deltacloud server to an address other than 'localhost' (default). For instance, if you install and start Deltacloud on a machine with the IP address 192.168.10.200 you should start the server with:

$ deltacloudd -i ec2 -P 5000 -r 192.168.10.200

This will make the Deltacloud server available at the address http://192.168.10.200:5000/api.

The Deltacloud ruby client

The Deltacloud project also maintains a ruby client, which you need to install seperately to the Deltacloud API server. The Deltacloud client consists of a ruby library (packaged as a ruby gem) which you can use to programmatically interact with the Deltacloud server and control your cloud infrastructure across cloud providers. For example, assuming the Deltacloud server is running at 192.168.10.244:5000

require 'deltacloud'


api_url      = 'http://192.168.10.244:5000/api'
api_name     = 'TK2PJCAN9R1HKG2FK24Z'
api_password = 'aLe27rZlRhlBcVoQbL4JsVtaNga12vEL9d9kS5CA'


client = DeltaCloud.new( api_name, api_password, api_url )


# get a list of currently running instances (virtual machines)
client.instances.each do |instance|
 puts instance.name
end


other work with client here

More comprehensive information on using the Deltacloud ruby client in this way can be found in the client documentation. Assuming you already have Ruby and RubyGems setup, you can install the Deltacloud client by simply typing:

$ sudo gem install deltacloud-client

Installing the Deltacloud client also gives you the deltacloudc command line tool. This executable makes use of the Deltacloud client library to speak to the Deltacloud server using the REST API. This allows you to to control your IAAS cloud infrastructure form the command line; even better if you are familiar with linux scripting, you can knock up a bash script in no time to automate your cloud infrastructure tasks. The general usage pattern for deltacloudc is:

$ deltacloudc collection operation [options]

collection refers to the Deltacloud object collections, such as Instances, Images, Buckets, Realms etc, as described in greater detail in the REST API
operation is collection dependant. All collections respond to 'index' and 'show' operations (retrieve details on all objects in a given collection or on a specific object, respectively); some collections respond to 'create' and 'destroy' operations. The instances collection (realised virtual servers) responds to operations for managing the instance lifecycle, such as 'stop', 'reboot' etc.
options are listed by invoking deltacloudc -h One important option is -u, with which you specify the API_URL where the Deltacloud server is running. The API_URL takes the form http://[user]:[password]@[api_url]:[port]/[api] (examples follow). Alternatively, rather than having to supply the API_URL for every invocation of deltacloudc you have the choice of setting the API_URL environment variable (e.g., export API_URL=http://mockuser:mockpassword@localhost:3001/api). A listing of the credentials you need to provide for each back-end cloud provider is available here.

The following examples assume that the Deltacloud server is running on your local machine port 3001 (the deltacloudd server daemon defaults to 'localhost:3001') and was started with the 'mock' provider (i.e. deltacloudd -i mock ). To list all collections available in the current driver:

$ deltacloudc -l -u http://mockuser:mockpassword@localhost:3001/api

To get a list of all images:

$ deltacloudc images index -u http://mockuser:mockpassword@localhost:3001/api

To list all operations for the buckets collection:

$ deltacloudc buckets -l -u http://mockuser:mockpassword@localhost:3001/api

To create a new blob in the bucket called 'bucket1':

$ deltacloudc blob create -i 'my_new_blob' -b 'bucket1' -f /home/marios/file.txt

Other HTTP clients - cURL

As interaction with the Deltacloud server is via HTTP calls, you can use any HTTP client to talk to it using the Deltacloud REST API. One popular command line tool available on most modern linux distributions is cURL. We give some examples here of how you can use cURL to interact with Deltacloud, demonstrating the flexibility and power of the Deltacloud REST API. The following examples assume the Deltacloud server is running on locahost:3001, and was started with the 'ec2' driver (i.e., deltacloudd -i ec2 ). To get a listing of all images available in the back-end cloud:

curl  --user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
"http://localhost:3001/api/images?format=xml"

The cURL --user option is used to specify the username:password credentials for access to the back-end cloud provider (Amazon EC2 in this case). To create a new instance from the image with id 'ami-f51aff9c', in realm 'us-east-1c', with the hardware profile 'c1.medium', in firewall 'default':

curl -X POST -F "keyname=eftah" -F "image_id=ami-f51aff9c"
-F "realm_id=us-east-1c" -F "hwp_id=c1.medium" -F "firewalls1=default"
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
"http://localhost:3001/api/instances?format=xml"

To delete a firewall called 'develgroup':

curl -X DELETE
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/firewalls/develgroup?format=xml

To create a blob called 'my_new_blob' within the bucket 'mybucket' from a local file with HTTP PUT specifying its content type and setting some some metadata key:value pairs:

curl -H 'content-type: text/html' -H 'X-Deltacloud-Blobmeta-Name:mariosblob'
-H 'X-Deltacloud-Blobmeta-Version:2.1' --upload-file
"/home/marios/Desktop/somefile.html"
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/buckets/mybucket/my_new_blob?format=xml

To retrieve blob metadata for the blob called 'my_new_blob':

curl -iv -X HEAD
--user "pGbAJ1TsVg5PKs3BK27O:dPs47ralgBlldqYNbLg3scthsg4g8v0L9d6Mb5DK"
http://localhost:3001/api/buckets/mybucket/my_new_blob?format=xml

Note the use of the '-iv' flags here which will ensure that cURL displays the request and response headers (blob metadata is reported in the response headers, with an empty response body).

;T; @�; @�I"/assets/img/pattern/;T{;{I"$/assets/img/deltacloud_concept/;T{;{I"/assets/img/asf/;T{;{I",/assets/img/glyphicons-halflings-white/;T{;{I" /assets/js/bootstrap-alert/;T{;{;I"� /* ========================================================== * bootstrap-alert.js v2.0.1 * http://twitter.github.com/bootstrap/javascript.html#alerts * ========================================================== * Copyright 2012 Twitter, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * ========================================================== */ !function( $ ){ "use strict" /* ALERT CLASS DEFINITION * ====================== */ var dismiss = '[data-dismiss="alert"]' , Alert = function ( el ) { $(el).on('click', dismiss, this.close) } Alert.prototype = { constructor: Alert , close: function ( e ) { var $this = $(this) , selector = $this.attr('data-target') , $parent if (!selector) { selector = $this.attr('href') selector = selector && selector.replace(/.*(?=#[^\s]*$)/, '') //strip for ie7 } $parent = $(selector) $parent.trigger('close') e && e.preventDefault() $parent.length || ($parent = $this.hasClass('alert') ? $this : $this.parent()) $parent .trigger('close') .removeClass('in') function removeElement() { $parent .trigger('closed') .remove() } $.support.transition && $parent.hasClass('fade') ? $parent.on($.support.transition.end, removeElement) : removeElement() } } /* ALERT PLUGIN DEFINITION * ======================= */ $.fn.alert = function ( option ) { return this.each(function () { var $this = $(this) , data = $this.data('alert') if (!data) $this.data('alert', (data = new Alert(this))) if (typeof option == 'string') data[option].call($this) }) } $.fn.alert.Constructor = Alert /* ALERT DATA-API * ============== */ $(function () { $('body').on('click.alert.data-api', dismiss, Alert.prototype.close) }) }( window.jQuery );;T; @�; @�I" /assets/js/bootstrap-modal/;T{;{;I"�/* ========================================================= * bootstrap-modal.js v2.0.1 * http://twitter.github.com/bootstrap/javascript.html#modals * ========================================================= * Copyright 2012 Twitter, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * ========================================================= */ !function( $ ){ "use strict" /* MODAL CLASS DEFINITION * ====================== */ var Modal = function ( content, options ) { this.options = options this.$element = $(content) .delegate('[data-dismiss="modal"]', 'click.dismiss.modal', $.proxy(this.hide, this)) } Modal.prototype = { constructor: Modal , toggle: function () { return this[!this.isShown ? 'show' : 'hide']() } , show: function () { var that = this if (this.isShown) return $('body').addClass('modal-open') this.isShown = true this.$element.trigger('show') escape.call(this) backdrop.call(this, function () { var transition = $.support.transition && that.$element.hasClass('fade') !that.$element.parent().length && that.$element.appendTo(document.body) //don't move modals dom position that.$element .show() if (transition) { that.$element[0].offsetWidth // force reflow } that.$element.addClass('in') transition ? that.$element.one($.support.transition.end, function () { that.$element.trigger('shown') }) : that.$element.trigger('shown') }) } , hide: function ( e ) { e && e.preventDefault() if (!this.isShown) return var that = this this.isShown = false $('body').removeClass('modal-open') escape.call(this) this.$element .trigger('hide') .removeClass('in') $.support.transition && this.$element.hasClass('fade') ? hideWithTransition.call(this) : hideModal.call(this) } } /* MODAL PRIVATE METHODS * ===================== */ function hideWithTransition() { var that = this , timeout = setTimeout(function () { that.$element.off($.support.transition.end) hideModal.call(that) }, 500) this.$element.one($.support.transition.end, function () { clearTimeout(timeout) hideModal.call(that) }) } function hideModal( that ) { this.$element .hide() .trigger('hidden') backdrop.call(this) } function backdrop( callback ) { var that = this , animate = this.$element.hasClass('fade') ? 'fade' : '' if (this.isShown && this.options.backdrop) { var doAnimate = $.support.transition && animate this.$backdrop = $('

') .appendTo(document.body) if (this.options.backdrop != 'static') { this.$backdrop.click($.proxy(this.hide, this)) } if (doAnimate) this.$backdrop[0].offsetWidth // force reflow this.$backdrop.addClass('in') doAnimate ? this.$backdrop.one($.support.transition.end, callback) : callback() } else if (!this.isShown && this.$backdrop) { this.$backdrop.removeClass('in') $.support.transition && this.$element.hasClass('fade')? this.$backdrop.one($.support.transition.end, $.proxy(removeBackdrop, this)) : removeBackdrop.call(this) } else if (callback) { callback() } } function removeBackdrop() { this.$backdrop.remove() this.$backdrop = null } function escape() { var that = this if (this.isShown && this.options.keyboard) { $(document).on('keyup.dismiss.modal', function ( e ) { e.which == 27 && that.hide() }) } else if (!this.isShown) { $(document).off('keyup.dismiss.modal') } } /* MODAL PLUGIN DEFINITION * ======================= */ $.fn.modal = function ( option ) { return this.each(function () { var $this = $(this) , data = $this.data('modal') , options = $.extend({}, $.fn.modal.defaults, $this.data(), typeof option == 'object' && option) if (!data) $this.data('modal', (data = new Modal(this, options))) if (typeof option == 'string') data[option]() else if (options.show) data.show() }) } $.fn.modal.defaults = { backdrop: true , keyboard: true , show: true } $.fn.modal.Constructor = Modal /* MODAL DATA-API * ============== */ $(function () { $('body').on('click.modal.data-api', '[data-toggle="modal"]', function ( e ) { var $this = $(this), href , $target = $($this.attr('data-target') || (href = $this.attr('href')) && href.replace(/.*(?=#[^\s]+$)/, '')) //strip for ie7 , option = $target.data('modal') ? 'toggle' : $.extend({}, $target.data(), $this.data()) e.preventDefault() $target.modal(option) }) }) }( window.jQuery );;T; @�; @�I"/assets/js/jquery/;T{;{;I"g5// jquery.tweet.js - See http://tweet.seaofclouds.com/ or https://github.com/seaofclouds/tweet for more info // Copyright (c) 2008-2011 Todd Matthews & Steve Purcell (function (factory) { if (typeof define === 'function' && define.amd) define(['jquery'], factory); // AMD support for RequireJS etc. else factory(jQuery); }(function ($) { $.fn.tweet = function(o){ var s = $.extend({ username: null, // [string or array] required unless using the 'query' option; one or more twitter screen names (use 'list' option for multiple names, where possible) list: null, // [string] optional name of list belonging to username favorites: false, // [boolean] display the user's favorites instead of his tweets query: null, // [string] optional search query (see also: http://search.twitter.com/operators) avatar_size: null, // [integer] height and width of avatar if displayed (48px max) count: 3, // [integer] how many tweets to display? fetch: null, // [integer] how many tweets to fetch via the API (set this higher than 'count' if using the 'filter' option) page: 1, // [integer] which page of results to fetch (if count != fetch, you'll get unexpected results) retweets: true, // [boolean] whether to fetch (official) retweets (not supported in all display modes) intro_text: null, // [string] do you want text BEFORE your your tweets? outro_text: null, // [string] do you want text AFTER your tweets? join_text: null, // [string] optional text in between date and tweet, try setting to "auto" auto_join_text_default: "I said,", // [string] auto text for non verb: "I said" bullocks auto_join_text_ed: "I", // [string] auto text for past tense: "I" surfed auto_join_text_ing: "I am", // [string] auto tense for present tense: "I was" surfing auto_join_text_reply: "I replied to", // [string] auto tense for replies: "I replied to" @someone "with" auto_join_text_url: "I was looking at", // [string] auto tense for urls: "I was looking at" http:... loading_text: null, // [string] optional loading text, displayed while tweets load refresh_interval: null, // [integer] optional number of seconds after which to reload tweets twitter_url: "twitter.com", // [string] custom twitter url, if any (apigee, etc.) twitter_api_url: "api.twitter.com", // [string] custom twitter api url, if any (apigee, etc.) twitter_search_url: "search.twitter.com", // [string] custom twitter search url, if any (apigee, etc.) template: "{avatar}{time}{join}{text}", // [string or function] template used to construct each tweet

- see code for available vars comparator: function(tweet1, tweet2) { // [function] comparator used to sort tweets (see Array.sort) return tweet2["tweet_time"] - tweet1["tweet_time"]; }, filter: function(tweet) { // [function] whether or not to include a particular tweet (be sure to also set 'fetch') return true; } // You can attach callbacks to the following events using jQuery's standard .bind() mechanism: // "loaded" -- triggered when tweets have been fetched and rendered }, o); // See http://daringfireball.net/2010/07/improved_regex_for_matching_urls var url_regexp = /\b((?:https?:\/\/|www\d{0,3}[.]|[a-z0-9.\-]+[.][a-z]{2,4}\/)(?:[^\s()<>]+|$([^\s()<>]+|(\([^\s()<>]+$))*\))+(?:$([^\s()<>]+|(\([^\s()<>]+$))*\)|[^\s`!()\[\]{};:'".,<>?«»“”‘’]))/gi; // Expand values inside simple string templates with {placeholders} function t(template, info) { if (typeof template === "string") { var result = template; for(var key in info) { var val = info[key]; result = result.replace(new RegExp('{'+key+'}','g'), val === null ? '' : val); } return result; } else return template(info); } // Export the t function for use when passing a function as the 'template' option $.extend({tweet: {t: t}}); function replacer (regex, replacement) { return function() { var returning = []; this.each(function() { returning.push(this.replace(regex, replacement)); }); return $(returning); }; } function escapeHTML(s) { return s.replace(//g,"^>"); } $.fn.extend({ linkUser: replacer(/(^|[\W])@(\w+)/gi, "$1@$2"), // Support various latin1 (\u00**) and arabic (\u06**) alphanumeric chars linkHash: replacer(/(?:^| )[\#]+([\w\u00c0-\u00d6\u00d8-\u00f6\u00f8-\u00ff\u0600-\u06ff]+)/gi, ' #$1'), makeHeart: replacer(/(<)+[3]/gi, "♥") }); function linkURLs(text, entities) { return text.replace(url_regexp, function(match) { var url = (/^[a-z]+:/i).test(match) ? match : "http://"+match; var text = match; for(var i = 0; i < entities.length; ++i) { var entity = entities[i]; if (entity.url == url && entity.expanded_url) { url = entity.expanded_url; text = entity.display_url; break; } } return ""+escapeHTML(text)+""; }); } function parse_date(date_str) { // The non-search twitter APIs return inconsistently-formatted dates, which Date.parse // cannot handle in IE. We therefore perform the following transformation: // "Wed Apr 29 08:53:31 +0000 2009" => "Wed, Apr 29 2009 08:53:31 +0000" return Date.parse(date_str.replace(/^([a-z]{3})( [a-z]{3} \d\d?)(.*)( \d{4})$/i, '$1,$2$4$3')); } function extract_relative_time(date) { var toInt = function(val) { return parseInt(val, 10); }; var relative_to = new Date(); var delta = toInt((relative_to.getTime() - date) / 1000); if (delta < 1) delta = 0; return { days: toInt(delta / 86400), hours: toInt(delta / 3600), minutes: toInt(delta / 60), seconds: toInt(delta) }; } function format_relative_time(time_ago) { if ( time_ago.days > 2 ) return 'about ' + time_ago.days + ' days ago'; if ( time_ago.hours > 24 ) return 'about a day ago'; if ( time_ago.hours > 2 ) return 'about ' + time_ago.hours + ' hours ago'; if ( time_ago.minutes > 45 ) return 'about an hour ago'; if ( time_ago.minutes > 2 ) return 'about ' + time_ago.minutes + ' minutes ago'; if ( time_ago.seconds > 1 ) return 'about ' + time_ago.seconds + ' seconds ago'; return 'just now'; } function build_auto_join_text(text) { if (text.match(/^(@([A-Za-z0-9-_]+)) .*/i)) { return s.auto_join_text_reply; } else if (text.match(url_regexp)) { return s.auto_join_text_url; } else if (text.match(/^((\w+ed)|just) .*/im)) { return s.auto_join_text_ed; } else if (text.match(/^(\w*ing) .*/i)) { return s.auto_join_text_ing; } else { return s.auto_join_text_default; } } function build_api_url() { var proto = ('https:' == document.location.protocol ? 'https:' : 'http:'); var count = (s.fetch === null) ? s.count : s.fetch; var common_params = '&include_entities=1&callback=?'; if (s.list) { return proto+"//"+s.twitter_api_url+"/1/"+s.username[0]+"/lists/"+s.list+"/statuses.json?page="+s.page+"&per_page="+count+common_params; } else if (s.favorites) { return proto+"//"+s.twitter_api_url+"/favorites/"+s.username[0]+".json?page="+s.page+"&count="+count+common_params; } else if (s.query === null && s.username.length == 1) { return proto+'//'+s.twitter_api_url+'/1/statuses/user_timeline.json?screen_name='+s.username[0]+'&count='+count+(s.retweets ? '&include_rts=1' : '')+'&page='+s.page+common_params; } else { var query = (s.query || 'from:'+s.username.join(' OR from:')); return proto+'//'+s.twitter_search_url+'/search.json?&q='+encodeURIComponent(query)+'&rpp='+count+'&page='+s.page+common_params; } } function extract_avatar_url(item, secure) { if (secure) { return ('user' in item) ? item.user.profile_image_url_https : extract_avatar_url(item, false). replace(/^http:\/\/[a-z0-9]{1,3}\.twimg\.com\//, "https://s3.amazonaws.com/twitter_production/"); } else { return item.profile_image_url || item.user.profile_image_url; } } // Convert twitter API objects into data available for // constructing each tweet

using a template function extract_template_data(item){ var o = {}; o.item = item; o.source = item.source; o.screen_name = item.from_user || item.user.screen_name; // The actual user name is not returned by all Twitter APIs, so please do not // file an issue if it is empty: o.name = item.from_user_name || item.user.name; o.avatar_size = s.avatar_size; o.avatar_url = extract_avatar_url(item, (document.location.protocol === 'https:')); o.retweet = typeof(item.retweeted_status) != 'undefined'; o.tweet_time = parse_date(item.created_at); o.join_text = s.join_text == "auto" ? build_auto_join_text(item.text) : s.join_text; o.tweet_id = item.id_str; o.twitter_base = "http://"+s.twitter_url+"/"; o.user_url = o.twitter_base+o.screen_name; o.tweet_url = o.user_url+"/status/"+o.tweet_id; o.reply_url = o.twitter_base+"intent/tweet?in_reply_to="+o.tweet_id; o.retweet_url = o.twitter_base+"intent/retweet?tweet_id="+o.tweet_id; o.favorite_url = o.twitter_base+"intent/favorite?tweet_id="+o.tweet_id; o.retweeted_screen_name = o.retweet && item.retweeted_status.user.screen_name; o.tweet_relative_time = format_relative_time(extract_relative_time(o.tweet_time)); o.entities = item.entities ? (item.entities.urls || []).concat(item.entities.media || []) : []; o.tweet_raw_text = o.retweet ? ('RT @'+o.retweeted_screen_name+' '+item.retweeted_status.text) : item.text; // avoid '...' in long retweets o.tweet_text = $([linkURLs(o.tweet_raw_text, o.entities)]).linkUser().linkHash()[0]; o.tweet_text_fancy = $([o.tweet_text]).makeHeart()[0]; // Default spans, and pre-formatted blocks for common layouts o.user = t('{screen_name}', o); o.join = s.join_text ? t(' {join_text} ', o) : ' '; o.avatar = o.avatar_size ? t(' ${screen_name}\'s avatar$ ', o) : ''; o.time = t('{tweet_relative_time}', o); o.text = t('{tweet_text_fancy}', o); o.reply_action = t('reply', o); o.retweet_action = t('retweet', o); o.favorite_action = t('favorite', o); return o; } function load(widget) { var intro = '

'+s.intro_text+'

'; var outro = '

'+s.outro_text+'

'; var loading = $('

'+s.loading_text+'

'); if (s.loading_text) $(widget).not(":has(.tweet_list)").empty().append(loading); $.getJSON(build_api_url(), function(data){ var list = $('

" + t(s.template, o) + "

' + match + '

0){if(c!=="border")for(;g=0===c})}function S(a){return!a||!a.parentNode||a.parentNode.nodeType===11}function K(){return!0}function J(){return!1}function n(a,b,c){var d=b+"defer",e=b+"queue",g=b+"mark",h=f._data(a,d);h&&(c==="queue"||!f._data(a,e))&&(c==="mark"||!f._data(a,g))&&setTimeout(function(){!f._data(a,e)&&!f._data(a,g)&&(f.removeData(a,d,!0),h.fire())},0)}function m(a){for(var b in a){if(b==="data"&&f.isEmptyObject(a[b]))continue;if(b!=="toJSON")return!1}return!0}function l(a,c,d){if(d===b&&a.nodeType===1){var e="data-"+c.replace(k,"-$1").toLowerCase();d=a.getAttribute(e);if(typeof d=="string"){try{d=d==="true"?!0:d==="false"?!1:d==="null"?null:f.isNumeric(d)?parseFloat(d):j.test(d)?f.parseJSON(d):d}catch(g){}f.data(a,c,d)}else d=b}return d}function h(a){var b=g[a]={},c,d;a=a.split(/\s+/);for(c=0,d=a.length;c)[^>]*$|#([\w\-]*)$)/,j=/\S/,k=/^\s+/,l=/\s+$/,m=/^<(\w+)\s*\/?>(?:<\/\1>)?$/,n=/^[\],:{}\s]*$/,o=/\\(?:["\\\/bfnrt]|u[0-9a-fA-F]{4})/g,p=/"[^"\\\n\r]*"|true|false|null|-?\d+(?:\.\d*)?(?:[eE][+\-]?\d+)?/g,q=/(?:^|:|,)(?:\s*\[)+/g,r=/(webkit)[ \/]([\w.]+)/,s=/(opera)(?:.*version)?[ \/]([\w.]+)/,t=/(msie) ([\w.]+)/,u=/(mozilla)(?:.*? rv:([\w.]+))?/,v=/-([a-z]|[0-9])/ig,w=/^-ms-/,x=function(a,b){return(b+"").toUpperCase()},y=d.userAgent,z,A,B,C=Object.prototype.toString,D=Object.prototype.hasOwnProperty,E=Array.prototype.push,F=Array.prototype.slice,G=String.prototype.trim,H=Array.prototype.indexOf,I={};e.fn=e.prototype={constructor:e,init:function(a,d,f){var g,h,j,k;if(!a)return this;if(a.nodeType){this.context=this[0]=a,this.length=1;return this}if(a==="body"&&!d&&c.body){this.context=c,this[0]=c.body,this.selector=a,this.length=1;return this}if(typeof a=="string"){a.charAt(0)!=="<"||a.charAt(a.length-1)!==">"||a.length<3?g=i.exec(a):g=[null,a,null];if(g&&(g[1]||!d)){if(g[1]){d=d instanceof e?d[0]:d,k=d?d.ownerDocument||d:c,j=m.exec(a),j?e.isPlainObject(d)?(a=[c.createElement(j[1])],e.fn.attr.call(a,d,!0)):a=[k.createElement(j[1])]:(j=e.buildFragment([g[1]],[k]),a=(j.cacheable?e.clone(j.fragment):j.fragment).childNodes);return e.merge(this,a)}h=c.getElementById(g[2]);if(h&&h.parentNode){if(h.id!==g[2])return f.find(a);this.length=1,this[0]=h}this.context=c,this.selector=a;return this}return!d||d.jquery?(d||f).find(a):this.constructor(d).find(a)}if(e.isFunction(a))return f.ready(a);a.selector!==b&&(this.selector=a.selector,this.context=a.context);return e.makeArray(a,this)},selector:"",jquery:"1.7.1",length:0,size:function(){return this.length},toArray:function(){return F.call(this,0)},get:function(a){return a==null?this.toArray():a<0?this[this.length+a]:this[a]},pushStack:function(a,b,c){var d=this.constructor();e.isArray(a)?E.apply(d,a):e.merge(d,a),d.prevObject=this,d.context=this.context,b==="find"?d.selector=this.selector+(this.selector?" ":"")+c:b&&(d.selector=this.selector+"."+b+"("+c+")");return d},each:function(a,b){return e.each(this,a,b)},ready:function(a){e.bindReady(),A.add(a);return this},eq:function(a){a=+a;return a===-1?this.slice(a):this.slice(a,a+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return this.pushStack(F.apply(this,arguments),"slice",F.call(arguments).join(","))},map:function(a){return this.pushStack(e.map(this,function(b,c){return a.call(b,c,b)}))},end:function(){return this.prevObject||this.constructor(null)},push:E,sort:[].sort,splice:[].splice},e.fn.init.prototype=e.fn,e.extend=e.fn.extend=function(){var a,c,d,f,g,h,i=arguments[0]||{},j=1,k=arguments.length,l=!1;typeof i=="boolean"&&(l=i,i=arguments[1]||{},j=2),typeof i!="object"&&!e.isFunction(i)&&(i={}),k===j&&(i=this,--j);for(;j0)return;A.fireWith(c,[e]),e.fn.trigger&&e(c).trigger("ready").off("ready")}},bindReady:function(){if(!A){A=e.Callbacks("once memory");if(c.readyState==="complete")return setTimeout(e.ready,1);if(c.addEventListener)c.addEventListener("DOMContentLoaded",B,!1),a.addEventListener("load",e.ready,!1);else if(c.attachEvent){c.attachEvent("onreadystatechange",B),a.attachEvent("onload",e.ready);var b=!1;try{b=a.frameElement==null}catch(d){}c.documentElement.doScroll&&b&&J()}}},isFunction:function(a){return e.type(a)==="function"},isArray:Array.isArray||function(a){return e.type(a)==="array"},isWindow:function(a){return a&&typeof a=="object"&&"setInterval"in a},isNumeric:function(a){return!isNaN(parseFloat(a))&&isFinite(a)},type:function(a){return a==null?String(a):I[C.call(a)]||"object"},isPlainObject:function(a){if(!a||e.type(a)!=="object"||a.nodeType||e.isWindow(a))return!1;try{if(a.constructor&&!D.call(a,"constructor")&&!D.call(a.constructor.prototype,"isPrototypeOf"))return!1}catch(c){return!1}var d;for(d in a);return d===b||D.call(a,d)},isEmptyObject:function(a){for(var b in a)return!1;return!0},error:function(a){throw new Error(a)},parseJSON:function(b){if(typeof b!="string"||!b)return null;b=e.trim(b);if(a.JSON&&a.JSON.parse)return a.JSON.parse(b);if(n.test(b.replace(o,"@").replace(p,"]").replace(q,"")))return(new Function("return "+b))();e.error("Invalid JSON: "+b)},parseXML:function(c){var d,f;try{a.DOMParser?(f=new DOMParser,d=f.parseFromString(c,"text/xml")):(d=new ActiveXObject("Microsoft.XMLDOM"),d.async="false",d.loadXML(c))}catch(g){d=b}(!d||!d.documentElement||d.getElementsByTagName("parsererror").length)&&e.error("Invalid XML: "+c);return d},noop:function(){},globalEval:function(b){b&&j.test(b)&&(a.execScript||function(b){a.eval.call(a,b)})(b)},camelCase:function(a){return a.replace(w,"ms-").replace(v,x)},nodeName:function(a,b){return a.nodeName&&a.nodeName.toUpperCase()===b.toUpperCase()},each:function(a,c,d){var f,g=0,h=a.length,i=h===b||e.isFunction(a);if(d){if(i){for(f in a)if(c.apply(a[f],d)===!1)break}else for(;g0&&a[0]&&a[j-1]||j===0||e.isArray(a));if(k)for(;i1?i.call(arguments,0):b,j.notifyWith(k,e)}}function l(a){return function(c){b[a]=arguments.length>1?i.call(arguments,0):c,--g||j.resolveWith(j,b)}}var b=i.call(arguments,0),c=0,d=b.length,e=Array(d),g=d,h=d,j=d<=1&&a&&f.isFunction(a.promise)?a:f.Deferred(),k=j.promise();if(d>1){for(;c

a",d=q.getElementsByTagName("*"),e=q.getElementsByTagName("a")[0];if(!d||!d.length||!e)return{};g=c.createElement("select"),h=g.appendChild(c.createElement("option")),i=q.getElementsByTagName("input")[0],b={leadingWhitespace:q.firstChild.nodeType===3,tbody:!q.getElementsByTagName("tbody").length,htmlSerialize:!!q.getElementsByTagName("link").length,style:/top/.test(e.getAttribute("style")),hrefNormalized:e.getAttribute("href")==="/a",opacity:/^0.55/.test(e.style.opacity),cssFloat:!!e.style.cssFloat,checkOn:i.value==="on",optSelected:h.selected,getSetAttribute:q.className!=="t",enctype:!!c.createElement("form").enctype,html5Clone:c.createElement("nav").cloneNode(!0).outerHTML!=="<:nav>",submitBubbles:!0,changeBubbles:!0,focusinBubbles:!1,deleteExpando:!0,noCloneEvent:!0,inlineBlockNeedsLayout:!1,shrinkWrapBlocks:!1,reliableMarginRight:!0},i.checked=!0,b.noCloneChecked=i.cloneNode(!0).checked,g.disabled=!0,b.optDisabled=!h.disabled;try{delete q.test}catch(s){b.deleteExpando=!1}!q.addEventListener&&q.attachEvent&&q.fireEvent&&(q.attachEvent("onclick",function(){b.noCloneEvent=!1}),q.cloneNode(!0).fireEvent("onclick")),i=c.createElement("input"),i.value="t",i.setAttribute("type","radio"),b.radioValue=i.value==="t",i.setAttribute("checked","checked"),q.appendChild(i),k=c.createDocumentFragment(),k.appendChild(q.lastChild),b.checkClone=k.cloneNode(!0).cloneNode(!0).lastChild.checked,b.appendChecked=i.checked,k.removeChild(i),k.appendChild(q),q.innerHTML="",a.getComputedStyle&&(j=c.createElement("div"),j.style.width="0",j.style.marginRight="0",q.style.width="2px",q.appendChild(j),b.reliableMarginRight=(parseInt((a.getComputedStyle(j,null)||{marginRight:0}).marginRight,10)||0)===0);if(q.attachEvent)for(o in{submit:1,change:1,focusin:1})n="on"+o,p=n in q,p||(q.setAttribute(n,"return;"),p=typeof q[n]=="function"),b[o+"Bubbles"]=p;k.removeChild(q),k=g=h=j=q=i=null,f(function(){var a,d,e,g,h,i,j,k,m,n,o,r=c.getElementsByTagName("body")[0];!r||(j=1,k="position:absolute;top:0;left:0;width:1px;height:1px;margin:0;",m="visibility:hidden;border:0;",n="style='"+k+"border:5px solid #000;padding:0;'",o="

"+""+"

",a=c.createElement("div"),a.style.cssText=m+"width:0;height:0;position:static;top:0;margin-top:"+j+"px",r.insertBefore(a,r.firstChild),q=c.createElement("div"),a.appendChild(q),q.innerHTML="

",l=q.getElementsByTagName("td"),p=l[0].offsetHeight===0,l[0].style.display="",l[1].style.display="none",b.reliableHiddenOffsets=p&&l[0].offsetHeight===0,q.innerHTML="",q.style.width=q.style.paddingLeft="1px",f.boxModel=b.boxModel=q.offsetWidth===2,typeof q.style.zoom!="undefined"&&(q.style.display="inline",q.style.zoom=1,b.inlineBlockNeedsLayout=q.offsetWidth===2,q.style.display="",q.innerHTML="

",b.shrinkWrapBlocks=q.offsetWidth!==2),q.style.cssText=k+m,q.innerHTML=o,d=q.firstChild,e=d.firstChild,h=d.nextSibling.firstChild.firstChild,i={doesNotAddBorder:e.offsetTop!==5,doesAddBorderForTableAndCells:h.offsetTop===5},e.style.position="fixed",e.style.top="20px",i.fixedPosition=e.offsetTop===20||e.offsetTop===15,e.style.position=e.style.top="",d.style.overflow="hidden",d.style.position="relative",i.subtractsBorderForOverflowNotVisible=e.offsetTop===-5,i.doesNotIncludeMarginInBodyOffset=r.offsetTop!==j,r.removeChild(a),q=a=null,f.extend(b,i))});return b}();var j=/^(?:\{.*\}|\[.*\])$/,k=/([A-Z])/g;f.extend({cache:{},uuid:0,expando:"jQuery"+(f.fn.jquery+Math.random()).replace(/\D/g,""),noData:{embed:!0,object:"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000",applet:!0},hasData:function(a){a=a.nodeType?f.cache[a[f.expando]]:a[f.expando];return!!a&&!m(a)},data:function(a,c,d,e){if(!!f.acceptData(a)){var g,h,i,j=f.expando,k=typeof c=="string",l=a.nodeType,m=l?f.cache:a,n=l?a[j]:a[j]&&j,o=c==="events";if((!n||!m[n]||!o&&!e&&!m[n].data)&&k&&d===b)return;n||(l?a[j]=n=++f.uuid:n=j),m[n]||(m[n]={},l||(m[n].toJSON=f.noop));if(typeof c=="object"||typeof c=="function")e?m[n]=f.extend(m[n],c):m[n].data=f.extend(m[n].data,c);g=h=m[n],e||(h.data||(h.data={}),h=h.data),d!==b&&(h[f.camelCase(c)]=d);if(o&&!h[c])return g.events;k?(i=h[c],i==null&&(i=h[f.camelCase(c)])):i=h;return i}},removeData:function(a,b,c){if(!!f.acceptData(a)){var d,e,g,h=f.expando,i=a.nodeType,j=i?f.cache:a,k=i?a[h]:h;if(!j[k])return;if(b){d=c?j[k]:j[k].data;if(d){f.isArray(b)||(b in d?b=[b]:(b=f.camelCase(b),b in d?b=[b]:b=b.split(" ")));for(e=0,g=b.length;e-1)return!0;return!1},val:function(a){var c,d,e,g=this[0];{if(!!arguments.length){e=f.isFunction(a);return this.each(function(d){var g=f(this),h;if(this.nodeType===1){e?h=a.call(this,d,g.val()):h=a,h==null?h="":typeof h=="number"?h+="":f.isArray(h)&&(h=f.map(h,function(a){return a==null?"":a+""})),c=f.valHooks[this.nodeName.toLowerCase()]||f.valHooks[this.type];if(!c||!("set"in c)||c.set(this,h,"value")===b)this.value=h}})}if(g){c=f.valHooks[g.nodeName.toLowerCase()]||f.valHooks[g.type];if(c&&"get"in c&&(d=c.get(g,"value"))!==b)return d;d=g.value;return typeof d=="string"?d.replace(q,""):d==null?"":d}}}}),f.extend({valHooks:{option:{get:function(a){var b=a.attributes.value;return!b||b.specified?a.value:a.text}},select:{get:function(a){var b,c,d,e,g=a.selectedIndex,h=[],i=a.options,j=a.type==="select-one";if(g<0)return null;c=j?g:0,d=j?g+1:i.length;for(;c=0}),c.length||(a.selectedIndex=-1);return c}}},attrFn:{val:!0,css:!0,html:!0,text:!0,data:!0,width:!0,height:!0,offset:!0},attr:function(a,c,d,e){var g,h,i,j=a.nodeType;if(!!a&&j!==3&&j!==8&&j!==2){if(e&&c in f.attrFn)return f(a)[c](d);if(typeof a.getAttribute=="undefined")return f.prop(a,c,d);i=j!==1||!f.isXMLDoc(a),i&&(c=c.toLowerCase(),h=f.attrHooks[c]||(u.test(c)?x:w));if(d!==b){if(d===null){f.removeAttr(a,c);return}if(h&&"set"in h&&i&&(g=h.set(a,d,c))!==b)return g;a.setAttribute(c,""+d);return d}if(h&&"get"in h&&i&&(g=h.get(a,c))!==null)return g;g=a.getAttribute(c);return g===null?b:g}},removeAttr:function(a,b){var c,d,e,g,h=0;if(b&&a.nodeType===1){d=b.toLowerCase().split(p),g=d.length;for(;h=0}})});var z=/^(?:textarea|input|select)$/i,A=/^([^\.]*)?(?:\.(.+))?$/,B=/\bhover(\.\S+)?\b/,C=/^key/,D=/^(?:mouse|contextmenu)|click/,E=/^(?:focusinfocus|focusoutblur)$/,F=/^(\w*)(?:#([\w\-]+))?(?:\.([\w\-]+))?$/,G=function(a){var b=F.exec(a);b&&(b[1]=(b[1]||"").toLowerCase(),b[3]=b[3]&&new RegExp("(?:^|\\s)"+b[3]+"(?:\\s|$)"));return b},H=function(a,b){var c=a.attributes||{};return(!b[1]||a.nodeName.toLowerCase()===b[1])&&(!b[2]||(c.id||{}).value===b[2])&&(!b[3]||b[3].test((c["class"]||{}).value))},I=function(a){return f.event.special.hover?a:a.replace(B,"mouseenter$1 mouseleave$1")}; f.event={add:function(a,c,d,e,g){var h,i,j,k,l,m,n,o,p,q,r,s;if(!(a.nodeType===3||a.nodeType===8||!c||!d||!(h=f._data(a)))){d.handler&&(p=d,d=p.handler),d.guid||(d.guid=f.guid++),j=h.events,j||(h.events=j={}),i=h.handle,i||(h.handle=i=function(a){return typeof f!="undefined"&&(!a||f.event.triggered!==a.type)?f.event.dispatch.apply(i.elem,arguments):b},i.elem=a),c=f.trim(I(c)).split(" ");for(k=0;k=0&&(h=h.slice(0,-1),k=!0),h.indexOf(".")>=0&&(i=h.split("."),h=i.shift(),i.sort());if((!e||f.event.customEvent[h])&&!f.event.global[h])return;c=typeof c=="object"?c[f.expando]?c:new f.Event(h,c):new f.Event(h),c.type=h,c.isTrigger=!0,c.exclusive=k,c.namespace=i.join("."),c.namespace_re=c.namespace?new RegExp("(^|\\.)"+i.join("\\.(?:.*\\.)?")+"(\\.|$)"):null,o=h.indexOf(":")<0?"on"+h:"";if(!e){j=f.cache;for(l in j)j[l].events&&j[l].events[h]&&f.event.trigger(c,d,j[l].handle.elem,!0);return}c.result=b,c.target||(c.target=e),d=d!=null?f.makeArray(d):[],d.unshift(c),p=f.event.special[h]||{};if(p.trigger&&p.trigger.apply(e,d)===!1)return;r=[[e,p.bindType||h]];if(!g&&!p.noBubble&&!f.isWindow(e)){s=p.delegateType||h,m=E.test(s+h)?e:e.parentNode,n=null;for(;m;m=m.parentNode)r.push([m,s]),n=m;n&&n===e.ownerDocument&&r.push([n.defaultView||n.parentWindow||a,s])}for(l=0;le&&i.push({elem:this,matches:d.slice(e)});for(j=0;j0?this.on(b,null,a,c):this.trigger(b)},f.attrFn&&(f.attrFn[b]=!0),C.test(b)&&(f.event.fixHooks[b]=f.event.keyHooks),D.test(b)&&(f.event.fixHooks[b]=f.event.mouseHooks)}),function(){function x(a,b,c,e,f,g){for(var h=0,i=e.length;h0){k=j;break}}j=j[a]}e[h]=k}}}function w(a,b,c,e,f,g){for(var h=0,i=e.length;h+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g,d="sizcache"+(Math.random()+"").replace(".",""),e=0,g=Object.prototype.toString,h=!1,i=!0,j=/\\/g,k=/\r\n/g,l=/\W/;[0,0].sort(function(){i=!1;return 0});var m=function(b,d,e,f){e=e||[],d=d||c;var h=d;if(d.nodeType!==1&&d.nodeType!==9)return[];if(!b||typeof b!="string")return e;var i,j,k,l,n,q,r,t,u=!0,v=m.isXML(d),w=[],x=b;do{a.exec(""),i=a.exec(x);if(i){x=i[3],w.push(i[1]);if(i[2]){l=i[3];break}}}while(i);if(w.length>1&&p.exec(b))if(w.length===2&&o.relative[w[0]])j=y(w[0]+w[1],d,f);else{j=o.relative[w[0]]?[d]:m(w.shift(),d);while(w.length)b=w.shift(),o.relative[b]&&(b+=w.shift()),j=y(b,j,f)}else{!f&&w.length>1&&d.nodeType===9&&!v&&o.match.ID.test(w[0])&&!o.match.ID.test(w[w.length-1])&&(n=m.find(w.shift(),d,v),d=n.expr?m.filter(n.expr,n.set)[0]:n.set[0]);if(d){n=f?{expr:w.pop(),set:s(f)}:m.find(w.pop(),w.length===1&&(w[0]==="~"||w[0]==="+")&&d.parentNode?d.parentNode:d,v),j=n.expr?m.filter(n.expr,n.set):n.set,w.length>0?k=s(j):u=!1;while(w.length)q=w.pop(),r=q,o.relative[q]?r=w.pop():q="",r==null&&(r=d),o.relative[q](k,r,v)}else k=w=[]}k||(k=j),k||m.error(q||b);if(g.call(k)==="[object Array]")if(!u)e.push.apply(e,k);else if(d&&d.nodeType===1)for(t=0;k[t]!=null;t++)k[t]&&(k[t]===!0||k[t].nodeType===1&&m.contains(d,k[t]))&&e.push(j[t]);else for(t=0;k[t]!=null;t++)k[t]&&k[t].nodeType===1&&e.push(j[t]);else s(k,e);l&&(m(l,h,e,f),m.uniqueSort(e));return e};m.uniqueSort=function(a){if(u){h=i,a.sort(u);if(h)for(var b=1;b0},m.find=function(a,b,c){var d,e,f,g,h,i;if(!a)return[];for(e=0,f=o.order.length;e":function(a,b){var c,d=typeof b=="string",e=0,f=a.length;if(d&&!l.test(b)){b=b.toLowerCase();for(;e=0)?c||d.push(h):c&&(b[g]=!1));return!1},ID:function(a){return a[1].replace(j,"")},TAG:function(a,b){return a[1].replace(j,"").toLowerCase()},CHILD:function(a){if(a[1]==="nth"){a[2]||m.error(a[0]),a[2]=a[2].replace(/^\+|\s*/g,"");var b=/(-?)(\d*)(?:n([+\-]?\d*))?/.exec(a[2]==="even"&&"2n"||a[2]==="odd"&&"2n+1"||!/\D/.test(a[2])&&"0n+"+a[2]||a[2]);a[2]=b[1]+(b[2]||1)-0,a[3]=b[3]-0}else a[2]&&m.error(a[0]);a[0]=e++;return a},ATTR:function(a,b,c,d,e,f){var g=a[1]=a[1].replace(j,"");!f&&o.attrMap[g]&&(a[1]=o.attrMap[g]),a[4]=(a[4]||a[5]||"").replace(j,""),a[2]==="~="&&(a[4]=" "+a[4]+" ");return a},PSEUDO:function(b,c,d,e,f){if(b[1]==="not")if((a.exec(b[3])||"").length>1||/^\w/.test(b[3]))b[3]=m(b[3],null,null,c);else{var g=m.filter(b[3],c,d,!0^f);d||e.push.apply(e,g);return!1}else if(o.match.POS.test(b[0])||o.match.CHILD.test(b[0]))return!0;return b},POS:function(a){a.unshift(!0);return a}},filters:{enabled:function(a){return a.disabled===!1&&a.type!=="hidden"},disabled:function(a){return a.disabled===!0},checked:function(a){return a.checked===!0},selected:function(a){a.parentNode&&a.parentNode.selectedIndex;return a.selected===!0},parent:function(a){return!!a.firstChild},empty:function(a){return!a.firstChild},has:function(a,b,c){return!!m(c[3],a).length},header:function(a){return/h\d/i.test(a.nodeName)},text:function(a){var b=a.getAttribute("type"),c=a.type;return a.nodeName.toLowerCase()==="input"&&"text"===c&&(b===c||b===null)},radio:function(a){return a.nodeName.toLowerCase()==="input"&&"radio"===a.type},checkbox:function(a){return a.nodeName.toLowerCase()==="input"&&"checkbox"===a.type},file:function(a){return a.nodeName.toLowerCase()==="input"&&"file"===a.type},password:function(a){return a.nodeName.toLowerCase()==="input"&&"password"===a.type},submit:function(a){var b=a.nodeName.toLowerCase();return(b==="input"||b==="button")&&"submit"===a.type},image:function(a){return a.nodeName.toLowerCase()==="input"&&"image"===a.type},reset:function(a){var b=a.nodeName.toLowerCase();return(b==="input"||b==="button")&&"reset"===a.type},button:function(a){var b=a.nodeName.toLowerCase();return b==="input"&&"button"===a.type||b==="button"},input:function(a){return/input|select|textarea|button/i.test(a.nodeName)},focus:function(a){return a===a.ownerDocument.activeElement}},setFilters:{first:function(a,b){return b===0},last:function(a,b,c,d){return b===d.length-1},even:function(a,b){return b%2===0},odd:function(a,b){return b%2===1},lt:function(a,b,c){return bc[3]-0},nth:function(a,b,c){return c[3]-0===b},eq:function(a,b,c){return c[3]-0===b}},filter:{PSEUDO:function(a,b,c,d){var e=b[1],f=o.filters[e];if(f)return f(a,c,b,d);if(e==="contains")return(a.textContent||a.innerText||n([a])||"").indexOf(b[3])>=0;if(e==="not"){var g=b[3];for(var h=0,i=g.length;h=0}},ID:function(a,b){return a.nodeType===1&&a.getAttribute("id")===b},TAG:function(a,b){return b==="*"&&a.nodeType===1||!!a.nodeName&&a.nodeName.toLowerCase()===b},CLASS:function(a,b){return(" "+(a.className||a.getAttribute("class"))+" ").indexOf(b)>-1},ATTR:function(a,b){var c=b[1],d=m.attr?m.attr(a,c):o.attrHandle[c]?o.attrHandle[c](a):a[c]!=null?a[c]:a.getAttribute(c),e=d+"",f=b[2],g=b[4];return d==null?f==="!=":!f&&m.attr?d!=null:f==="="?e===g:f==="*="?e.indexOf(g)>=0:f==="~="?(" "+e+" ").indexOf(g)>=0:g?f==="!="?e!==g:f==="^="?e.indexOf(g)===0:f==="$="?e.substr(e.length-g.length)===g:f==="|="?e===g||e.substr(0,g.length+1)===g+"-":!1:e&&d!==!1},POS:function(a,b,c,d){var e=b[2],f=o.setFilters[e];if(f)return f(a,c,b,d)}}},p=o.match.POS,q=function(a,b){return"\\"+(b-0+1)};for(var r in o.match)o.match[r]=new RegExp(o.match[r].source+/(?![^\[]*\])(?![^$]*$)/.source),o.leftMatch[r]=new RegExp(/(^(?:.|\r|\n)*?)/.source+o.match[r].source.replace(/\\(\d+)/g,q));var s=function(a,b){a=Array.prototype.slice.call(a,0);if(b){b.push.apply(b,a);return b}return a};try{Array.prototype.slice.call(c.documentElement.childNodes,0)[0].nodeType}catch(t){s=function(a,b){var c=0,d=b||[];if(g.call(a)==="[object Array]")Array.prototype.push.apply(d,a);else if(typeof a.length=="number")for(var e=a.length;c",e.insertBefore(a,e.firstChild),c.getElementById(d)&&(o.find.ID=function(a,c,d){if(typeof c.getElementById!="undefined"&&!d){var e=c.getElementById(a[1]);return e?e.id===a[1]||typeof e.getAttributeNode!="undefined"&&e.getAttributeNode("id").nodeValue===a[1]?[e]:b:[]}},o.filter.ID=function(a,b){var c=typeof a.getAttributeNode!="undefined"&&a.getAttributeNode("id");return a.nodeType===1&&c&&c.nodeValue===b}),e.removeChild(a),e=a=null}(),function(){var a=c.createElement("div");a.appendChild(c.createComment("")),a.getElementsByTagName("*").length>0&&(o.find.TAG=function(a,b){var c=b.getElementsByTagName(a[1]);if(a[1]==="*"){var d=[];for(var e=0;c[e];e++)c[e].nodeType===1&&d.push(c[e]);c=d}return c}),a.innerHTML="",a.firstChild&&typeof a.firstChild.getAttribute!="undefined"&&a.firstChild.getAttribute("href")!=="#"&&(o.attrHandle.href=function(a){return a.getAttribute("href",2)}),a=null}(),c.querySelectorAll&&function(){var a=m,b=c.createElement("div"),d="__sizzle__";b.innerHTML="

";if(!b.querySelectorAll||b.querySelectorAll(".TEST").length!==0){m=function(b,e,f,g){e=e||c;if(!g&&!m.isXML(e)){var h=/^(\w+$)|^\.([\w\-]+$)|^#([\w\-]+$)/.exec(b);if(h&&(e.nodeType===1||e.nodeType===9)){if(h[1])return s(e.getElementsByTagName(b),f);if(h[2]&&o.find.CLASS&&e.getElementsByClassName)return s(e.getElementsByClassName(h[2]),f)}if(e.nodeType===9){if(b==="body"&&e.body)return s([e.body],f);if(h&&h[3]){var i=e.getElementById(h[3]);if(!i||!i.parentNode)return s([],f);if(i.id===h[3])return s([i],f)}try{return s(e.querySelectorAll(b),f)}catch(j){}}else if(e.nodeType===1&&e.nodeName.toLowerCase()!=="object"){var k=e,l=e.getAttribute("id"),n=l||d,p=e.parentNode,q=/^\s*[+~]/.test(b);l?n=n.replace(/'/g,"\\$&"):e.setAttribute("id",n),q&&p&&(e=e.parentNode);try{if(!q||p)return s(e.querySelectorAll("[id='"+n+"'] "+b),f)}catch(r){}finally{l||k.removeAttribute("id")}}}return a(b,e,f,g)};for(var e in a)m[e]=a[e];b=null}}(),function(){var a=c.documentElement,b=a.matchesSelector||a.mozMatchesSelector||a.webkitMatchesSelector||a.msMatchesSelector;if(b){var d=!b.call(c.createElement("div"),"div"),e=!1;try{b.call(c.documentElement,"[test!='']:sizzle")}catch(f){e=!0}m.matchesSelector=function(a,c){c=c.replace(/\=\s*([^'"\]]*)\s*\]/g,"='$1']");if(!m.isXML(a))try{if(e||!o.match.PSEUDO.test(c)&&!/!=/.test(c)){var f=b.call(a,c);if(f||!d||a.document&&a.document.nodeType!==11)return f}}catch(g){}return m(c,null,null,[a]).length>0}}}(),function(){var a=c.createElement("div");a.innerHTML="

";if(!!a.getElementsByClassName&&a.getElementsByClassName("e").length!==0){a.lastChild.className="e";if(a.getElementsByClassName("e").length===1)return;o.order.splice(1,0,"CLASS"),o.find.CLASS=function(a,b,c){if(typeof b.getElementsByClassName!="undefined"&&!c)return b.getElementsByClassName(a[1])},a=null}}(),c.documentElement.contains?m.contains=function(a,b){return a!==b&&(a.contains?a.contains(b):!0)}:c.documentElement.compareDocumentPosition?m.contains=function(a,b){return!!(a.compareDocumentPosition(b)&16)}:m.contains=function(){return!1},m.isXML=function(a){var b=(a?a.ownerDocument||a:0).documentElement;return b?b.nodeName!=="HTML":!1};var y=function(a,b,c){var d,e=[],f="",g=b.nodeType?[b]:b;while(d=o.match.PSEUDO.exec(a))f+=d[0],a=a.replace(o.match.PSEUDO,"");a=o.relative[a]?a+"*":a;for(var h=0,i=g.length;h0)for(h=g;h=0:f.filter(a,this).length>0:this.filter(a).length>0)},closest:function(a,b){var c=[],d,e,g=this[0];if(f.isArray(a)){var h=1;while(g&&g.ownerDocument&&g!==b){for(d=0;d-1:f.find.matchesSelector(g,a)){c.push(g);break}g=g.parentNode;if(!g||!g.ownerDocument||g===b||g.nodeType===11)break}}c=c.length>1?f.unique(c):c;return this.pushStack(c,"closest",a)},index:function(a){if(!a)return this[0]&&this[0].parentNode?this.prevAll().length:-1;if(typeof a=="string")return f.inArray(this[0],f(a));return f.inArray(a.jquery?a[0]:a,this)},add:function(a,b){var c=typeof a=="string"?f(a,b):f.makeArray(a&&a.nodeType?[a]:a),d=f.merge(this.get(),c);return this.pushStack(S(c[0])||S(d[0])?d:f.unique(d))},andSelf:function(){return this.add(this.prevObject)}}),f.each({parent:function(a){var b=a.parentNode;return b&&b.nodeType!==11?b:null},parents:function(a){return f.dir(a,"parentNode")},parentsUntil:function(a,b,c){return f.dir(a,"parentNode",c)},next:function(a){return f.nth(a,2,"nextSibling")},prev:function(a){return f.nth(a,2,"previousSibling")},nextAll:function(a){return f.dir(a,"nextSibling")},prevAll:function(a){return f.dir(a,"previousSibling")},nextUntil:function(a,b,c){return f.dir(a,"nextSibling",c)},prevUntil:function(a,b,c){return f.dir(a,"previousSibling",c)},siblings:function(a){return f.sibling(a.parentNode.firstChild,a)},children:function(a){return f.sibling(a.firstChild)},contents:function(a){return f.nodeName(a,"iframe")?a.contentDocument||a.contentWindow.document:f.makeArray(a.childNodes)}},function(a,b){f.fn[a]=function(c,d){var e=f.map(this,b,c);L.test(a)||(d=c),d&&typeof d=="string"&&(e=f.filter(d,e)),e=this.length>1&&!R[a]?f.unique(e):e,(this.length>1||N.test(d))&&M.test(a)&&(e=e.reverse());return this.pushStack(e,a,P.call(arguments).join(","))}}),f.extend({filter:function(a,b,c){c&&(a=":not("+a+")");return b.length===1?f.find.matchesSelector(b[0],a)?[b[0]]:[]:f.find.matches(a,b)},dir:function(a,c,d){var e=[],g=a[c];while(g&&g.nodeType!==9&&(d===b||g.nodeType!==1||!f(g).is(d)))g.nodeType===1&&e.push(g),g=g[c];return e},nth:function(a,b,c,d){b=b||1;var e=0;for(;a;a=a[c])if(a.nodeType===1&&++e===b)break;return a},sibling:function(a,b){var c=[];for(;a;a=a.nextSibling)a.nodeType===1&&a!==b&&c.push(a);return c}});var V="abbr|article|aside|audio|canvas|datalist|details|figcaption|figure|footer|header|hgroup|mark|meter|nav|output|progress|section|summary|time|video",W=/ jQuery\d+="(?:\d+|null)"/g,X=/^\s+/,Y=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/ig,Z=/<([\w:]+)/,$=/",""],legend:[1,"

","

"],thead:[1,"","

"],tr:[2,"","

"],td:[3,"","

"],col:[2,"","

"],area:[1,"",""],_default:[0,"",""]},bh=U(c);bg.optgroup=bg.option,bg.tbody=bg.tfoot=bg.colgroup=bg.caption=bg.thead,bg.th=bg.td,f.support.htmlSerialize||(bg._default=[1,"div

","

"]),f.fn.extend({text:function(a){if(f.isFunction(a))return this.each(function(b){var c=f(this);c.text(a.call(this,b,c.text()))});if(typeof a!="object"&&a!==b)return this.empty().append((this[0]&&this[0].ownerDocument||c).createTextNode(a));return f.text(this)},wrapAll:function(a){if(f.isFunction(a))return this.each(function(b){f(this).wrapAll(a.call(this,b))});if(this[0]){var b=f(a,this[0].ownerDocument).eq(0).clone(!0);this[0].parentNode&&b.insertBefore(this[0]),b.map(function(){var a=this;while(a.firstChild&&a.firstChild.nodeType===1)a=a.firstChild;return a}).append(this)}return this},wrapInner:function(a){if(f.isFunction(a))return this.each(function(b){f(this).wrapInner(a.call(this,b))});return this.each(function(){var b=f(this),c=b.contents();c.length?c.wrapAll(a):b.append(a)})},wrap:function(a){var b=f.isFunction(a);return this.each(function(c){f(this).wrapAll(b?a.call(this,c):a)})},unwrap:function(){return this.parent().each(function(){f.nodeName(this,"body")||f(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,!0,function(a){this.nodeType===1&&this.appendChild(a)})},prepend:function(){return this.domManip(arguments,!0,function(a){this.nodeType===1&&this.insertBefore(a,this.firstChild)})},before:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,!1,function(a){this.parentNode.insertBefore(a,this)});if(arguments.length){var a=f.clean(arguments);a.push.apply(a,this.toArray());return this.pushStack(a,"before",arguments)}},after:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,!1,function(a){this.parentNode.insertBefore(a,this.nextSibling)});if(arguments.length){var a=this.pushStack(this,"after",arguments);a.push.apply(a,f.clean(arguments));return a}},remove:function(a,b){for(var c=0,d;(d=this[c])!=null;c++)if(!a||f.filter(a,[d]).length)!b&&d.nodeType===1&&(f.cleanData(d.getElementsByTagName("*")),f.cleanData([d])),d.parentNode&&d.parentNode.removeChild(d);return this},empty:function() {for(var a=0,b;(b=this[a])!=null;a++){b.nodeType===1&&f.cleanData(b.getElementsByTagName("*"));while(b.firstChild)b.removeChild(b.firstChild)}return this},clone:function(a,b){a=a==null?!1:a,b=b==null?a:b;return this.map(function(){return f.clone(this,a,b)})},html:function(a){if(a===b)return this[0]&&this[0].nodeType===1?this[0].innerHTML.replace(W,""):null;if(typeof a=="string"&&!ba.test(a)&&(f.support.leadingWhitespace||!X.test(a))&&!bg[(Z.exec(a)||["",""])[1].toLowerCase()]){a=a.replace(Y,"<$1>");try{for(var c=0,d=this.length;c1&&l0?this.clone(!0):this).get();f(e[h])[b](j),d=d.concat(j)}return this.pushStack(d,a,e.selector)}}),f.extend({clone:function(a,b,c){var d,e,g,h=f.support.html5Clone||!bc.test("<"+a.nodeName)?a.cloneNode(!0):bo(a);if((!f.support.noCloneEvent||!f.support.noCloneChecked)&&(a.nodeType===1||a.nodeType===11)&&!f.isXMLDoc(a)){bk(a,h),d=bl(a),e=bl(h);for(g=0;d[g];++g)e[g]&&bk(d[g],e[g])}if(b){bj(a,h);if(c){d=bl(a),e=bl(h);for(g=0;d[g];++g)bj(d[g],e[g])}}d=e=null;return h},clean:function(a,b,d,e){var g;b=b||c,typeof b.createElement=="undefined"&&(b=b.ownerDocument||b[0]&&b[0].ownerDocument||c);var h=[],i;for(var j=0,k;(k=a[j])!=null;j++){typeof k=="number"&&(k+="");if(!k)continue;if(typeof k=="string")if(!_.test(k))k=b.createTextNode(k);else{k=k.replace(Y,"<$1>");var l=(Z.exec(k)||["",""])[1].toLowerCase(),m=bg[l]||bg._default,n=m[0],o=b.createElement("div");b===c?bh.appendChild(o):U(b).appendChild(o),o.innerHTML=m[1]+k+m[2];while(n--)o=o.lastChild;if(!f.support.tbody){var p=$.test(k),q=l==="table"&&!p?o.firstChild&&o.firstChild.childNodes:m[1]===""&&!p?o.childNodes:[];for(i=q.length-1;i>=0;--i)f.nodeName(q[i],"tbody")&&!q[i].childNodes.length&&q[i].parentNode.removeChild(q[i])}!f.support.leadingWhitespace&&X.test(k)&&o.insertBefore(b.createTextNode(X.exec(k)[0]),o.firstChild),k=o.childNodes}var r;if(!f.support.appendChecked)if(k[0]&&typeof (r=k.length)=="number")for(i=0;i=0)return b+"px"}}}),f.support.opacity||(f.cssHooks.opacity={get:function(a,b){return br.test((b&&a.currentStyle?a.currentStyle.filter:a.style.filter)||"")?parseFloat(RegExp.$1)/100+"":b?"1":""},set:function(a,b){var c=a.style,d=a.currentStyle,e=f.isNumeric(b)?"alpha(opacity="+b*100+")":"",g=d&&d.filter||c.filter||"";c.zoom=1;if(b>=1&&f.trim(g.replace(bq,""))===""){c.removeAttribute("filter");if(d&&!d.filter)return}c.filter=bq.test(g)?g.replace(bq,e):g+" "+e}}),f(function(){f.support.reliableMarginRight||(f.cssHooks.marginRight={get:function(a,b){var c;f.swap(a,{display:"inline-block"},function(){b?c=bz(a,"margin-right","marginRight"):c=a.style.marginRight});return c}})}),c.defaultView&&c.defaultView.getComputedStyle&&(bA=function(a,b){var c,d,e;b=b.replace(bs,"-$1").toLowerCase(),(d=a.ownerDocument.defaultView)&&(e=d.getComputedStyle(a,null))&&(c=e.getPropertyValue(b),c===""&&!f.contains(a.ownerDocument.documentElement,a)&&(c=f.style(a,b)));return c}),c.documentElement.currentStyle&&(bB=function(a,b){var c,d,e,f=a.currentStyle&&a.currentStyle[b],g=a.style;f===null&&g&&(e=g[b])&&(f=e),!bt.test(f)&&bu.test(f)&&(c=g.left,d=a.runtimeStyle&&a.runtimeStyle.left,d&&(a.runtimeStyle.left=a.currentStyle.left),g.left=b==="fontSize"?"1em":f||0,f=g.pixelLeft+"px",g.left=c,d&&(a.runtimeStyle.left=d));return f===""?"auto":f}),bz=bA||bB,f.expr&&f.expr.filters&&(f.expr.filters.hidden=function(a){var b=a.offsetWidth,c=a.offsetHeight;return b===0&&c===0||!f.support.reliableHiddenOffsets&&(a.style&&a.style.display||f.css(a,"display"))==="none"},f.expr.filters.visible=function(a){return!f.expr.filters.hidden(a)});var bD=/%20/g,bE=/\[\]$/,bF=/\r?\n/g,bG=/#.*$/,bH=/^(.*?):[ \t]*([^\r\n]*)\r?$/mg,bI=/^(?:color|date|datetime|datetime-local|email|hidden|month|number|password|range|search|tel|text|time|url|week)$/i,bJ=/^(?:about|app|app\-storage|.+\-extension|file|res|widget):$/,bK=/^(?:GET|HEAD)$/,bL=/^\/\//,bM=/\?/,bN=/)<[^<]*)*<\/script>/gi,bO=/^(?:select|textarea)/i,bP=/\s+/,bQ=/([?&])_=[^&]*/,bR=/^([\w\+\.\-]+:)(?:\/\/([^\/?#:]*)(?::(\d+))?)?/,bS=f.fn.load,bT={},bU={},bV,bW,bX=["*/"]+["*"];try{bV=e.href}catch(bY){bV=c.createElement("a"),bV.href="",bV=bV.href}bW=bR.exec(bV.toLowerCase())||[],f.fn.extend({load:function(a,c,d){if(typeof a!="string"&&bS)return bS.apply(this,arguments);if(!this.length)return this;var e=a.indexOf(" ");if(e>=0){var g=a.slice(e,a.length);a=a.slice(0,e)}var h="GET";c&&(f.isFunction(c)?(d=c,c=b):typeof c=="object"&&(c=f.param(c,f.ajaxSettings.traditional),h="POST"));var i=this;f.ajax({url:a,type:h,dataType:"html",data:c,complete:function(a,b,c){c=a.responseText,a.isResolved()&&(a.done(function(a){c=a}),i.html(g?f("

").append(c.replace(bN,"")).find(g):c)),d&&i.each(d,[c,b,a])}});return this},serialize:function(){return f.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?f.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||bO.test(this.nodeName)||bI.test(this.type))}).map(function(a,b){var c=f(this).val();return c==null?null:f.isArray(c)?f.map(c,function(a,c){return{name:b.name,value:a.replace(bF,"\r\n")}}):{name:b.name,value:c.replace(bF,"\r\n")}}).get()}}),f.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "),function(a,b){f.fn[b]=function(a){return this.on(b,a)}}),f.each(["get","post"],function(a,c){f[c]=function(a,d,e,g){f.isFunction(d)&&(g=g||e,e=d,d=b);return f.ajax({type:c,url:a,data:d,success:e,dataType:g})}}),f.extend({getScript:function(a,c){return f.get(a,b,c,"script")},getJSON:function(a,b,c){return f.get(a,b,c,"json")},ajaxSetup:function(a,b){b?b_(a,f.ajaxSettings):(b=a,a=f.ajaxSettings),b_(a,b);return a},ajaxSettings:{url:bV,isLocal:bJ.test(bW[1]),global:!0,type:"GET",contentType:"application/x-www-form-urlencoded",processData:!0,async:!0,accepts:{xml:"application/xml, text/xml",html:"text/html",text:"text/plain",json:"application/json, text/javascript","*":bX},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText"},converters:{"* text":a.String,"text html":!0,"text json":f.parseJSON,"text xml":f.parseXML},flatOptions:{context:!0,url:!0}},ajaxPrefilter:bZ(bT),ajaxTransport:bZ(bU),ajax:function(a,c){function w(a,c,l,m){if(s!==2){s=2,q&&clearTimeout(q),p=b,n=m||"",v.readyState=a>0?4:0;var o,r,u,w=c,x=l?cb(d,v,l):b,y,z;if(a>=200&&a<300||a===304){if(d.ifModified){if(y=v.getResponseHeader("Last-Modified"))f.lastModified[k]=y;if(z=v.getResponseHeader("Etag"))f.etag[k]=z}if(a===304)w="notmodified",o=!0;else try{r=cc(d,x),w="success",o=!0}catch(A){w="parsererror",u=A}}else{u=w;if(!w||a)w="error",a<0&&(a=0)}v.status=a,v.statusText=""+(c||w),o?h.resolveWith(e,[r,w,v]):h.rejectWith(e,[v,w,u]),v.statusCode(j),j=b,t&&g.trigger("ajax"+(o?"Success":"Error"),[v,d,o?r:u]),i.fireWith(e,[v,w]),t&&(g.trigger("ajaxComplete",[v,d]),--f.active||f.event.trigger("ajaxStop"))}}typeof a=="object"&&(c=a,a=b),c=c||{};var d=f.ajaxSetup({},c),e=d.context||d,g=e!==d&&(e.nodeType||e instanceof f)?f(e):f.event,h=f.Deferred(),i=f.Callbacks("once memory"),j=d.statusCode||{},k,l={},m={},n,o,p,q,r,s=0,t,u,v={readyState:0,setRequestHeader:function(a,b){if(!s){var c=a.toLowerCase();a=m[c]=m[c]||a,l[a]=b}return this},getAllResponseHeaders:function(){return s===2?n:null},getResponseHeader:function(a){var c;if(s===2){if(!o){o={};while(c=bH.exec(n))o[c[1].toLowerCase()]=c[2]}c=o[a.toLowerCase()]}return c===b?null:c},overrideMimeType:function(a){s||(d.mimeType=a);return this},abort:function(a){a=a||"abort",p&&p.abort(a),w(0,a);return this}};h.promise(v),v.success=v.done,v.error=v.fail,v.complete=i.add,v.statusCode=function(a){if(a){var b;if(s<2)for(b in a)j[b]=[j[b],a[b]];else b=a[v.status],v.then(b,b)}return this},d.url=((a||d.url)+"").replace(bG,"").replace(bL,bW[1]+"//"),d.dataTypes=f.trim(d.dataType||"*").toLowerCase().split(bP),d.crossDomain==null&&(r=bR.exec(d.url.toLowerCase()),d.crossDomain=!(!r||r[1]==bW[1]&&r[2]==bW[2]&&(r[3]||(r[1]==="http:"?80:443))==(bW[3]||(bW[1]==="http:"?80:443)))),d.data&&d.processData&&typeof d.data!="string"&&(d.data=f.param(d.data,d.traditional)),b$(bT,d,c,v);if(s===2)return!1;t=d.global,d.type=d.type.toUpperCase(),d.hasContent=!bK.test(d.type),t&&f.active++===0&&f.event.trigger("ajaxStart");if(!d.hasContent){d.data&&(d.url+=(bM.test(d.url)?"&":"?")+d.data,delete d.data),k=d.url;if(d.cache===!1){var x=f.now(),y=d.url.replace(bQ,"$1_="+x);d.url=y+(y===d.url?(bM.test(d.url)?"&":"?")+"_="+x:"")}}(d.data&&d.hasContent&&d.contentType!==!1||c.contentType)&&v.setRequestHeader("Content-Type",d.contentType),d.ifModified&&(k=k||d.url,f.lastModified[k]&&v.setRequestHeader("If-Modified-Since",f.lastModified[k]),f.etag[k]&&v.setRequestHeader("If-None-Match",f.etag[k])),v.setRequestHeader("Accept",d.dataTypes[0]&&d.accepts[d.dataTypes[0]]?d.accepts[d.dataTypes[0]]+(d.dataTypes[0]!=="*"?", "+bX+"; q=0.01":""):d.accepts["*"]);for(u in d.headers)v.setRequestHeader(u,d.headers[u]);if(d.beforeSend&&(d.beforeSend.call(e,v,d)===!1||s===2)){v.abort();return!1}for(u in{success:1,error:1,complete:1})v[u](d[u]);p=b$(bU,d,c,v);if(!p)w(-1,"No Transport");else{v.readyState=1,t&&g.trigger("ajaxSend",[v,d]),d.async&&d.timeout>0&&(q=setTimeout(function(){v.abort("timeout")},d.timeout));try{s=1,p.send(l,w)}catch(z){if(s<2)w(-1,z);else throw z}}return v},param:function(a,c){var d=[],e=function(a,b){b=f.isFunction(b)?b():b,d[d.length]=encodeURIComponent(a)+"="+encodeURIComponent(b)};c===b&&(c=f.ajaxSettings.traditional);if(f.isArray(a)||a.jquery&&!f.isPlainObject(a))f.each(a,function(){e(this.name,this.value)});else for(var g in a)ca(g,a[g],c,e);return d.join("&").replace(bD,"+")}}),f.extend({active:0,lastModified:{},etag:{}});var cd=f.now(),ce=/(\=)\?(&|$)|\?\?/i;f.ajaxSetup({jsonp:"callback",jsonpCallback:function(){return f.expando+"_"+cd++}}),f.ajaxPrefilter("json jsonp",function(b,c,d){var e=b.contentType==="application/x-www-form-urlencoded"&&typeof b.data=="string";if(b.dataTypes[0]==="jsonp"||b.jsonp!==!1&&(ce.test(b.url)||e&&ce.test(b.data))){var g,h=b.jsonpCallback=f.isFunction(b.jsonpCallback)?b.jsonpCallback():b.jsonpCallback,i=a[h],j=b.url,k=b.data,l="$1"+h+"$2";b.jsonp!==!1&&(j=j.replace(ce,l),b.url===j&&(e&&(k=k.replace(ce,l)),b.data===k&&(j+=(/\?/.test(j)?"&":"?")+b.jsonp+"="+h))),b.url=j,b.data=k,a[h]=function(a){g=[a]},d.always(function(){a[h]=i,g&&f.isFunction(i)&&a[h](g[0])}),b.converters["script json"]=function(){g||f.error(h+" was not called");return g[0]},b.dataTypes[0]="json";return"script"}}),f.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/javascript|ecmascript/},converters:{"text script":function(a){f.globalEval(a);return a}}}),f.ajaxPrefilter("script",function(a){a.cache===b&&(a.cache=!1),a.crossDomain&&(a.type="GET",a.global=!1)}),f.ajaxTransport("script",function(a){if(a.crossDomain){var d,e=c.head||c.getElementsByTagName("head")[0]||c.documentElement;return{send:function(f,g){d=c.createElement("script"),d.async="async",a.scriptCharset&&(d.charset=a.scriptCharset),d.src=a.url,d.onload=d.onreadystatechange=function(a,c){if(c||!d.readyState||/loaded|complete/.test(d.readyState))d.onload=d.onreadystatechange=null,e&&d.parentNode&&e.removeChild(d),d=b,c||g(200,"success")},e.insertBefore(d,e.firstChild)},abort:function(){d&&d.onload(0,1)}}}});var cf=a.ActiveXObject?function(){for(var a in ch)ch[a](0,1)}:!1,cg=0,ch;f.ajaxSettings.xhr=a.ActiveXObject?function(){return!this.isLocal&&ci()||cj()}:ci,function(a){f.extend(f.support,{ajax:!!a,cors:!!a&&"withCredentials"in a})}(f.ajaxSettings.xhr()),f.support.ajax&&f.ajaxTransport(function(c){if(!c.crossDomain||f.support.cors){var d;return{send:function(e,g){var h=c.xhr(),i,j;c.username?h.open(c.type,c.url,c.async,c.username,c.password):h.open(c.type,c.url,c.async);if(c.xhrFields)for(j in c.xhrFields)h[j]=c.xhrFields[j];c.mimeType&&h.overrideMimeType&&h.overrideMimeType(c.mimeType),!c.crossDomain&&!e["X-Requested-With"]&&(e["X-Requested-With"]="XMLHttpRequest");try{for(j in e)h.setRequestHeader(j,e[j])}catch(k){}h.send(c.hasContent&&c.data||null),d=function(a,e){var j,k,l,m,n;try{if(d&&(e||h.readyState===4)){d=b,i&&(h.onreadystatechange=f.noop,cf&&delete ch[i]);if(e)h.readyState!==4&&h.abort();else{j=h.status,l=h.getAllResponseHeaders(),m={},n=h.responseXML,n&&n.documentElement&&(m.xml=n),m.text=h.responseText;try{k=h.statusText}catch(o){k=""}!j&&c.isLocal&&!c.crossDomain?j=m.text?200:404:j===1223&&(j=204)}}}catch(p){e||g(-1,p)}m&&g(j,k,m,l)},!c.async||h.readyState===4?d():(i=++cg,cf&&(ch||(ch={},f(a).unload(cf)),ch[i]=d),h.onreadystatechange=d)},abort:function(){d&&d(0,1)}}}});var ck={},cl,cm,cn=/^(?:toggle|show|hide)$/,co=/^([+\-]=)?([\d+.\-]+)([a-z%]*)$/i,cp,cq=[["height","marginTop","marginBottom","paddingTop","paddingBottom"],["width","marginLeft","marginRight","paddingLeft","paddingRight"],["opacity"]],cr;f.fn.extend({show:function(a,b,c){var d,e;if(a||a===0)return this.animate(cu("show",3),a,b,c);for(var g=0,h=this.length;g=i.duration+this.startTime){this.now=this.end,this.pos=this.state=1,this.update(),i.animatedProperties[this.prop]=!0;for(b in i.animatedProperties)i.animatedProperties[b]!==!0&&(g=!1);if(g){i.overflow!=null&&!f.support.shrinkWrapBlocks&&f.each(["","X","Y"],function(a,b){h.style["overflow"+b]=i.overflow[a]}),i.hide&&f(h).hide();if(i.hide||i.show)for(b in i.animatedProperties)f.style(h,b,i.orig[b]),f.removeData(h,"fxshow"+b,!0),f.removeData(h,"toggle"+b,!0);d=i.complete,d&&(i.complete=!1,d.call(h))}return!1}i.duration==Infinity?this.now=e:(c=e-this.startTime,this.state=c/i.duration,this.pos=f.easing[i.animatedProperties[this.prop]](this.state,c,0,1,i.duration),this.now=this.start+(this.end-this.start)*this.pos),this.update();return!0}},f.extend(f.fx,{tick:function(){var a,b=f.timers,c=0;for(;c-1,k={},l={},m,n;j?(l=e.position(),m=l.top,n=l.left):(m=parseFloat(h)||0,n=parseFloat(i)||0),f.isFunction(b)&&(b=b.call(a,c,g)),b.top!=null&&(k.top=b.top-g.top+m),b.left!=null&&(k.left=b.left-g.left+n),"using"in b?b.using.call(a,k):e.css(k)}},f.fn.extend({position:function(){if(!this[0])return null;var a=this[0],b=this.offsetParent(),c=this.offset(),d=cx.test(b[0].nodeName)?{top:0,left:0}:b.offset();c.top-=parseFloat(f.css(a,"marginTop"))||0,c.left-=parseFloat(f.css(a,"marginLeft"))||0,d.top+=parseFloat(f.css(b[0],"borderTopWidth"))||0,d.left+=parseFloat(f.css(b[0],"borderLeftWidth"))||0;return{top:c.top-d.top,left:c.left-d.left}},offsetParent:function(){return this.map(function(){var a=this.offsetParent||c.body;while(a&&!cx.test(a.nodeName)&&f.css(a,"position")==="static")a=a.offsetParent;return a})}}),f.each(["Left","Top"],function(a,c){var d="scroll"+c;f.fn[d]=function(c){var e,g;if(c===b){e=this[0];if(!e)return null;g=cy(e);return g?"pageXOffset"in g?g[a?"pageYOffset":"pageXOffset"]:f.support.boxModel&&g.document.documentElement[d]||g.document.body[d]:e[d]}return this.each(function(){g=cy(this),g?g.scrollTo(a?f(g).scrollLeft():c,a?c:f(g).scrollTop()):this[d]=c})}}),f.each(["Height","Width"],function(a,c){var d=c.toLowerCase();f.fn["inner"+c]=function(){var a=this[0];return a?a.style?parseFloat(f.css(a,d,"padding")):this[d]():null},f.fn["outer"+c]=function(a){var b=this[0];return b?b.style?parseFloat(f.css(b,d,a?"margin":"border")):this[d]():null},f.fn[d]=function(a){var e=this[0];if(!e)return a==null?null:this;if(f.isFunction(a))return this.each(function(b){var c=f(this);c[d](a.call(this,b,c[d]()))});if(f.isWindow(e)){var g=e.document.documentElement["client"+c],h=e.document.body;return e.document.compatMode==="CSS1Compat"&&g||h&&h["client"+c]||g}if(e.nodeType===9)return Math.max(e.documentElement["client"+c],e.body["scroll"+c],e.documentElement["scroll"+c],e.body["offset"+c],e.documentElement["offset"+c]);if(a===b){var i=f.css(e,d),j=parseFloat(i);return f.isNumeric(j)?j:i}return this.css(d,typeof a=="string"?a:a+"px")}}),a.jQuery=a.$=f,typeof define=="function"&&define.amd&&define.amd.jQuery&&define("jquery",[],function(){return f})})(window);;T; @'; @'I"#/assets/js/bootstrap-collapse/;T{;{;I"H/* ============================================================= * bootstrap-collapse.js v2.0.1 * http://twitter.github.com/bootstrap/javascript.html#collapse * ============================================================= * Copyright 2012 Twitter, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * ============================================================ */ !function( $ ){ "use strict" var Collapse = function ( element, options ) { this.$element = $(element) this.options = $.extend({}, $.fn.collapse.defaults, options) if (this.options["parent"]) { this.$parent = $(this.options["parent"]) } this.options.toggle && this.toggle() } Collapse.prototype = { constructor: Collapse , dimension: function () { var hasWidth = this.$element.hasClass('width') return hasWidth ? 'width' : 'height' } , show: function () { var dimension = this.dimension() , scroll = $.camelCase(['scroll', dimension].join('-')) , actives = this.$parent && this.$parent.find('.in') , hasData if (actives && actives.length) { hasData = actives.data('collapse') actives.collapse('hide') hasData || actives.data('collapse', null) } this.$element[dimension](0) this.transition('addClass', 'show', 'shown') this.$element[dimension](this.$element[0][scroll]) } , hide: function () { var dimension = this.dimension() this.reset(this.$element[dimension]()) this.transition('removeClass', 'hide', 'hidden') this.$element[dimension](0) } , reset: function ( size ) { var dimension = this.dimension() this.$element .removeClass('collapse') [dimension](size || 'auto') [0].offsetWidth this.$element.addClass('collapse') } , transition: function ( method, startEvent, completeEvent ) { var that = this , complete = function () { if (startEvent == 'show') that.reset() that.$element.trigger(completeEvent) } this.$element .trigger(startEvent) [method]('in') $.support.transition && this.$element.hasClass('collapse') ? this.$element.one($.support.transition.end, complete) : complete() } , toggle: function () { this[this.$element.hasClass('in') ? 'hide' : 'show']() } } /* COLLAPSIBLE PLUGIN DEFINITION * ============================== */ $.fn.collapse = function ( option ) { return this.each(function () { var $this = $(this) , data = $this.data('collapse') , options = typeof option == 'object' && option if (!data) $this.data('collapse', (data = new Collapse(this, options))) if (typeof option == 'string') data[option]() }) } $.fn.collapse.defaults = { toggle: true } $.fn.collapse.Constructor = Collapse /* COLLAPSIBLE DATA-API * ==================== */ $(function () { $('body').on('click.collapse.data-api', '[data-toggle=collapse]', function ( e ) { var $this = $(this), href , target = $this.attr('data-target') || e.preventDefault() || (href = $this.attr('href')) && href.replace(/.*(?=#[^\s]+$)/, '') //strip for ie7 , option = $(target).data('collapse') ? 'toggle' : $this.data() $(target).collapse(option) }) }) }( window.jQuery );;T; @+; @+I"#/assets/js/bootstrap-carousel/;T{;{;I"�/* ========================================================== * bootstrap-carousel.js v2.0.1 * http://twitter.github.com/bootstrap/javascript.html#carousel * ========================================================== * Copyright 2012 Twitter, Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. * ========================================================== */ !function( $ ){ "use strict" /* CAROUSEL CLASS DEFINITION * ========================= */ var Carousel = function (element, options) { this.$element = $(element) this.options = $.extend({}, $.fn.carousel.defaults, options) this.options.slide && this.slide(this.options.slide) } Carousel.prototype = { cycle: function () { this.interval = setInterval($.proxy(this.next, this), this.options.interval) return this } , to: function (pos) { var $active = this.$element.find('.active') , children = $active.parent().children() , activePos = children.index($active) , that = this if (pos > (children.length - 1) || pos < 0) return if (this.sliding) { return this.$element.one('slid', function () { that.to(pos) }) } if (activePos == pos) { return this.pause().cycle() } return this.slide(pos > activePos ? 'next' : 'prev', $(children[pos])) } , pause: function () { clearInterval(this.interval) this.interval = null return this } , next: function () { if (this.sliding) return return this.slide('next') } , prev: function () { if (this.sliding) return return this.slide('prev') } , slide: function (type, next) { var $active = this.$element.find('.active') , $next = next || $active[type]() , isCycling = this.interval , direction = type == 'next' ? 'left' : 'right' , fallback = type == 'next' ? 'first' : 'last' , that = this if (!$next.length) return this.sliding = true isCycling && this.pause() $next = $next.length ? $next : this.$element.find('.item')[fallback]() if (!$.support.transition && this.$element.hasClass('slide')) { this.$element.trigger('slide') $active.removeClass('active') $next.addClass('active') this.sliding = false this.$element.trigger('slid') } else { $next.addClass(type) $next[0].offsetWidth // force reflow $active.addClass(direction) $next.addClass(direction) this.$element.trigger('slide') this.$element.one($.support.transition.end, function () { $next.removeClass([type, direction].join(' ')).addClass('active') $active.removeClass(['active', direction].join(' ')) that.sliding = false setTimeout(function () { that.$element.trigger('slid') }, 0) }) } isCycling && this.cycle() return this } } /* CAROUSEL PLUGIN DEFINITION * ========================== */ $.fn.carousel = function ( option ) { return this.each(function () { var $this = $(this) , data = $this.data('carousel') , options = typeof option == 'object' && option if (!data) $this.data('carousel', (data = new Carousel(this, options))) if (typeof option == 'number') data.to(option) else if (typeof option == 'string' || (option = options.slide)) data[option]() else data.cycle() }) } $.fn.carousel.defaults = { interval: 5000 } $.fn.carousel.Constructor = Carousel /* CAROUSEL DATA-API * ================= */ $(function () { $('body').on('click.carousel.data-api', '[data-slide]', function ( e ) { var $this = $(this), href , $target = $($this.attr('data-target') || (href = $this.attr('href')) && href.replace(/.*(?=#[^\s]+$)/, '')) //strip for ie7 , options = !$target.data('modal') && $.extend({}, $target.data(), $this.data()) $target.carousel(options) e.preventDefault() }) }) }( window.jQuery );;T; @/; @/I"/assets/css/bootstrap/;T{;{;I"�article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block}audio,canvas,video{display:inline-block;*display:inline;*zoom:1}audio:not([controls]){display:none}html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}a:focus{outline:thin dotted #333;outline:5px auto -webkit-focus-ring-color;outline-offset:-2px}a:hover,a:active{outline:0}sub,sup{position:relative;font-size:75%;line-height:0;vertical-align:baseline}sup{top:-0.5em}sub{bottom:-0.25em}img{max-width:100%;height:auto;border:0;-ms-interpolation-mode:bicubic}button,input,select,textarea{margin:0;font-size:100%;vertical-align:middle}button,input{*overflow:visible;line-height:normal}button::-moz-focus-inner,input::-moz-focus-inner{padding:0;border:0}button,input[type="button"],input[type="reset"],input[type="submit"]{cursor:pointer;-webkit-appearance:button}input[type="search"]{-webkit-appearance:textfield;-webkit-box-sizing:content-box;-moz-box-sizing:content-box;box-sizing:content-box}input[type="search"]::-webkit-search-decoration,input[type="search"]::-webkit-search-cancel-button{-webkit-appearance:none}textarea{overflow:auto;vertical-align:top}.clearfix{*zoom:1}.clearfix:before,.clearfix:after{display:table;content:""}.clearfix:after{clear:both}body{margin:0;font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:16px;line-height:18px;color:#606060;background-color:#fff}a{color:#08c;text-decoration:none}a:hover{color:#005580;text-decoration:underline}.row{margin-left:-20px;*zoom:1}.row:before,.row:after{display:table;content:""}.row:after{clear:both}[class*="span"]{float:left;margin-left:20px}.span1{width:60px}.span2{width:140px}.span3{width:220px}.span4{width:300px}.span5{width:380px}.span6{width:460px}.span7{width:540px}.span8{width:620px}.span9{width:700px}.span10{width:780px}.span11{width:860px}.span12,.container{width:940px}.offset1{margin-left:100px}.offset2{margin-left:180px}.offset3{margin-left:260px}.offset4{margin-left:340px}.offset5{margin-left:420px}.offset6{margin-left:500px}.offset7{margin-left:580px}.offset8{margin-left:660px}.offset9{margin-left:740px}.offset10{margin-left:820px}.offset11{margin-left:900px}.row-fluid{width:100%;*zoom:1}.row-fluid:before,.row-fluid:after{display:table;content:""}.row-fluid:after{clear:both}.row-fluid>[class*="span"]{float:left;margin-left:2.127659574%}.row-fluid>[class*="span"]:first-child{margin-left:0}.row-fluid>.span1{width:6.382978723%}.row-fluid>.span2{width:14.89361702%}.row-fluid>.span3{width:23.404255317%}.row-fluid>.span4{width:31.914893614%}.row-fluid>.span5{width:40.425531911%}.row-fluid>.span6{width:48.93617020799999%}.row-fluid>.span7{width:57.446808505%}.row-fluid>.span8{width:65.95744680199999%}.row-fluid>.span9{width:74.468085099%}.row-fluid>.span10{width:82.97872339599999%}.row-fluid>.span11{width:91.489361693%}.row-fluid>.span12{width:99.99999998999999%}.container{width:940px;margin-left:auto;margin-right:auto;*zoom:1}.container:before,.container:after{display:table;content:""}.container:after{clear:both}.container-fluid{padding-left:20px;padding-right:20px;*zoom:1}.container-fluid:before,.container-fluid:after{display:table;content:""}.container-fluid:after{clear:both}p{margin:0 0 9px;font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:16px;line-height:18px}p small{font-size:14px;color:#999}.lead{margin-bottom:18px;font-size:20px;font-weight:200;line-height:27px}h1,h2,h3,h4,h5,h6{margin:0;font-weight:700;color:#606060;text-rendering:optimizelegibility}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{font-weight:400;color:#999}h1{font-size:30px;line-height:36px}h1 small{font-size:18px}h2{font-size:24px;line-height:36px}h2 small{font-size:18px}h3{line-height:27px;font-size:18px}h3 small{font-size:14px}h4,h5,h6{line-height:18px}h4{font-size:14px}h4 small{font-size:12px}h5{font-size:12px}h6{font-size:11px;color:#999;text-transform:uppercase}.page-header{padding-bottom:17px;margin:18px 0;border-bottom:1px solid#eee}.page-header h1{line-height:1}ul,ol{padding:0;margin:0 0 9px 25px}ul ul,ul ol,ol ol,ol ul{margin-bottom:0}ul{list-style:disc}ol{list-style:decimal}li{line-height:18px}ul.unstyled,ol.unstyled{margin-left:0;list-style:none}dl{margin-bottom:18px}dt,dd{line-height:18px}dt{font-weight:700}dd{margin-left:9px}hr{margin:18px 0;border:0;border-top:1px solid#eee;border-bottom:1px solid#fff}strong{font-weight:700}em{font-style:italic}.muted{color:#999}abbr{font-size:90%;text-transform:uppercase;border-bottom:1px dotted #ddd;cursor:help}blockquote{padding:0 0 0 15px;margin:0 0 18px;border-left:5px solid#eee}blockquote p{margin-bottom:0;font-size:16px;font-weight:300;line-height:22.5px}blockquote small{display:block;line-height:18px;color:#999}blockquote small:before{content:'\2014 \00A0'}blockquote.pull-right{float:right;padding-left:0;padding-right:15px;border-left:0;border-right:5px solid#eee}blockquote.pull-right p,blockquote.pull-right small{text-align:right}q:before,q:after,blockquote:before,blockquote:after{content:""}address{display:block;margin-bottom:18px;line-height:18px;font-style:normal}small{font-size:100%}cite{font-style:normal}code,pre{padding:0 3px 2px;font-family:Menlo,Monaco,"Courier New",monospace;font-size:15px;color:#606060;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}code{padding:3px 4px;color:#d14;background-color:#f7f7f9;border:1px solid #e1e1e8}pre{display:block;padding:8.5px;margin:0 0 9px;font-size:12px;line-height:18px;background-color:#f5f5f5;border:1px solid #ccc;border:1px solid rgba(0,0,0,0.15);-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;white-space:pre;white-space:pre-wrap;word-break:break-all;word-wrap:break-word}pre.prettyprint{margin-bottom:18px}pre code{padding:0;color:inherit;background-color:transparent;border:0}.pre-scrollable{max-height:340px;overflow-y:scroll}form{margin:0 0 18px}fieldset{padding:0;margin:0;border:0}legend{display:block;width:100%;padding:0;margin-bottom:27px;font-size:24px;line-height:36px;color:#606060;border:0;border-bottom:1px solid #eee}legend small{font-size:13.5px;color:#999}label,input,button,select,textarea{font-size:16px;font-weight:400;line-height:18px}input,button,select,textarea{font-family:"Helvetica Neue",Helvetica,Arial,sans-serif}label{display:block;margin-bottom:5px;color:#606060}input,textarea,select,.uneditable-input{display:inline-block;width:210px;height:18px;padding:4px;margin-bottom:9px;font-size:16px;line-height:18px;color:#555;border:1px solid #ccc;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}.uneditable-textarea{width:auto;height:auto}label input,label textarea,label select{display:block}input[type="image"],input[type="checkbox"],input[type="radio"]{width:auto;height:auto;padding:0;margin:3px 0;*margin-top:0;line-height:normal;cursor:pointer;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0;border:0 \9}input[type="image"]{border:0}input[type="file"]{width:auto;padding:initial;line-height:initial;border:initial;background-color:#fff;background-color:initial;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none}input[type="button"],input[type="reset"],input[type="submit"]{width:auto;height:auto}select,input[type="file"]{height:28px;*margin-top:4px;line-height:28px}input[type="file"]{line-height:18px \9}select{width:220px;background-color:#fff}select[multiple],select[size]{height:auto}input[type="image"]{-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none}textarea{height:auto}input[type="hidden"]{display:none}.radio,.checkbox{padding-left:18px}.radio input[type="radio"],.checkbox input[type="checkbox"]{float:left;margin-left:-18px}.controls>.radio:first-child,.controls>.checkbox:first-child{padding-top:5px}.radio.inline,.checkbox.inline{display:inline-block;padding-top:5px;margin-bottom:0;vertical-align:middle}.radio.inline+.radio.inline,.checkbox.inline+.checkbox.inline{margin-left:10px}input,textarea{-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);-moz-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);box-shadow:inset 0 1px 1px rgba(0,0,0,0.075);-webkit-transition:border linear .2s,box-shadow linear .2s;-moz-transition:border linear .2s,box-shadow linear .2s;-ms-transition:border linear .2s,box-shadow linear .2s;-o-transition:border linear .2s,box-shadow linear .2s;transition:border linear .2s,box-shadow linear .2s}input:focus,textarea:focus{border-color:rgba(82,168,236,0.8);-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 8px rgba(82,168,236,0.6);-moz-box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 8px rgba(82,168,236,0.6);box-shadow:inset 0 1px 1px rgba(0,0,0,0.075),0 0 8px rgba(82,168,236,0.6);outline:0;outline:thin dotted \9}input[type="file"]:focus,input[type="radio"]:focus,input[type="checkbox"]:focus,select:focus{-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none;outline:thin dotted #333;outline:5px auto -webkit-focus-ring-color;outline-offset:-2px}.input-mini{width:60px}.input-small{width:90px}.input-medium{width:150px}.input-large{width:210px}.input-xlarge{width:270px}.input-xxlarge{width:530px}input[class*="span"],select[class*="span"],textarea[class*="span"],.uneditable-input{float:none;margin-left:0}input.span1,textarea.span1,.uneditable-input.span1{width:50px}input.span2,textarea.span2,.uneditable-input.span2{width:130px}input.span3,textarea.span3,.uneditable-input.span3{width:210px}input.span4,textarea.span4,.uneditable-input.span4{width:290px}input.span5,textarea.span5,.uneditable-input.span5{width:370px}input.span6,textarea.span6,.uneditable-input.span6{width:450px}input.span7,textarea.span7,.uneditable-input.span7{width:530px}input.span8,textarea.span8,.uneditable-input.span8{width:610px}input.span9,textarea.span9,.uneditable-input.span9{width:690px}input.span10,textarea.span10,.uneditable-input.span10{width:770px}input.span11,textarea.span11,.uneditable-input.span11{width:850px}input.span12,textarea.span12,.uneditable-input.span12{width:930px}input[disabled],select[disabled],textarea[disabled],input[readonly],select[readonly],textarea[readonly]{background-color:#f5f5f5;border-color:#ddd;cursor:not-allowed}.control-group.warning>label,.control-group.warning .help-block,.control-group.warning .help-inline{color:#c09853}.control-group.warning input,.control-group.warning select,.control-group.warning textarea{color:#c09853;border-color:#c09853}.control-group.warning input:focus,.control-group.warning select:focus,.control-group.warning textarea:focus{border-color:#a47e3c;-webkit-box-shadow:0 0 6px #dbc59e;-moz-box-shadow:0 0 6px #dbc59e;box-shadow:0 0 6px #dbc59e}.control-group.warning .input-prepend .add-on,.control-group.warning .input-append .add-on{color:#c09853;background-color:#fcf8e3;border-color:#c09853}.control-group.error>label,.control-group.error .help-block,.control-group.error .help-inline{color:#b94a48}.control-group.error input,.control-group.error select,.control-group.error textarea{color:#b94a48;border-color:#b94a48}.control-group.error input:focus,.control-group.error select:focus,.control-group.error textarea:focus{border-color:#953b39;-webkit-box-shadow:0 0 6px #d59392;-moz-box-shadow:0 0 6px #d59392;box-shadow:0 0 6px #d59392}.control-group.error .input-prepend .add-on,.control-group.error .input-append .add-on{color:#b94a48;background-color:#f2dede;border-color:#b94a48}.control-group.success>label,.control-group.success .help-block,.control-group.success .help-inline{color:#468847}.control-group.success input,.control-group.success select,.control-group.success textarea{color:#468847;border-color:#468847}.control-group.success input:focus,.control-group.success select:focus,.control-group.success textarea:focus{border-color:#356635;-webkit-box-shadow:0 0 6px #7aba7b;-moz-box-shadow:0 0 6px #7aba7b;box-shadow:0 0 6px #7aba7b}.control-group.success .input-prepend .add-on,.control-group.success .input-append .add-on{color:#468847;background-color:#dff0d8;border-color:#468847}input:focus:required:invalid,textarea:focus:required:invalid,select:focus:required:invalid{color:#b94a48;border-color:#ee5f5b}input:focus:required:invalid:focus,textarea:focus:required:invalid:focus,select:focus:required:invalid:focus{border-color:#e9322d;-webkit-box-shadow:0 0 6px #f8b9b7;-moz-box-shadow:0 0 6px #f8b9b7;box-shadow:0 0 6px #f8b9b7}.form-actions{padding:17px 20px 18px;margin-top:18px;margin-bottom:18px;background-color:#f5f5f5;border-top:1px solid #ddd}.uneditable-input{display:block;background-color:#fff;border-color:#eee;-webkit-box-shadow:inset 0 1px 2px rgba(0,0,0,0.025);-moz-box-shadow:inset 0 1px 2px rgba(0,0,0,0.025);box-shadow:inset 0 1px 2px rgba(0,0,0,0.025);cursor:not-allowed}:-moz-placeholder{color:#999}::-webkit-input-placeholder{color:#999}.help-block{display:block;margin-top:5px;margin-bottom:0;color:#999}.help-inline{display:inline-block;*display:inline;*zoom:1;margin-bottom:9px;vertical-align:middle;padding-left:5px}.input-prepend,.input-append{margin-bottom:5px;*zoom:1}.input-prepend:before,.input-append:before,.input-prepend:after,.input-append:after{display:table;content:""}.input-prepend:after,.input-append:after{clear:both}.input-prepend input,.input-append input,.input-prepend .uneditable-input,.input-append .uneditable-input{-webkit-border-radius:0 3px 3px 0;-moz-border-radius:0 3px 3px 0;border-radius:0 3px 3px 0}.input-prepend input:focus,.input-append input:focus,.input-prepend .uneditable-input:focus,.input-append .uneditable-input:focus{position:relative;z-index:2}.input-prepend .uneditable-input,.input-append .uneditable-input{border-left-color:#ccc}.input-prepend .add-on,.input-append .add-on{float:left;display:block;width:auto;min-width:16px;height:18px;margin-right:-1px;padding:4px 5px;font-weight:400;line-height:18px;color:#999;text-align:center;text-shadow:0 1px 0#fff;background-color:#f5f5f5;border:1px solid #ccc;-webkit-border-radius:3px 0 0 3px;-moz-border-radius:3px 0 0 3px;border-radius:3px 0 0 3px}.input-prepend .active,.input-append .active{background-color:#a9dba9;border-color:#46a546}.input-prepend .add-on{*margin-top:1px}.input-append input,.input-append .uneditable-input{float:left;-webkit-border-radius:3px 0 0 3px;-moz-border-radius:3px 0 0 3px;border-radius:3px 0 0 3px}.input-append .uneditable-input{border-left-color:#eee;border-right-color:#ccc}.input-append .add-on{margin-right:0;margin-left:-1px;-webkit-border-radius:0 3px 3px 0;-moz-border-radius:0 3px 3px 0;border-radius:0 3px 3px 0}.input-append input:first-child{*margin-left:-160px}.input-append input:first-child+.add-on{*margin-left:-21px}.search-query{padding-left:14px;padding-right:14px;margin-bottom:0;-webkit-border-radius:14px;-moz-border-radius:14px;border-radius:14px}.form-search input,.form-inline input,.form-horizontal input,.form-search textarea,.form-inline textarea,.form-horizontal textarea,.form-search select,.form-inline select,.form-horizontal select,.form-search .help-inline,.form-inline .help-inline,.form-horizontal .help-inline,.form-search .uneditable-input,.form-inline .uneditable-input,.form-horizontal .uneditable-input{display:inline-block;margin-bottom:0}.form-search .hide,.form-inline .hide,.form-horizontal .hide{display:none}.form-search label,.form-inline label,.form-search .input-append,.form-inline .input-append,.form-search .input-prepend,.form-inline .input-prepend{display:inline-block}.form-search .input-append .add-on,.form-inline .input-prepend .add-on,.form-search .input-append .add-on,.form-inline .input-prepend .add-on{vertical-align:middle}.form-search .radio,.form-inline .radio,.form-search .checkbox,.form-inline .checkbox{margin-bottom:0;vertical-align:middle}.control-group{margin-bottom:9px}legend+.control-group{margin-top:18px;-webkit-margin-top-collapse:separate}.form-horizontal .control-group{margin-bottom:18px;*zoom:1}.form-horizontal .control-group:before,.form-horizontal .control-group:after{display:table;content:""}.form-horizontal .control-group:after{clear:both}.form-horizontal .control-label{float:left;width:140px;padding-top:5px;text-align:right}.form-horizontal .controls{margin-left:160px}.form-horizontal .form-actions{padding-left:160px}table{max-width:100%;border-collapse:collapse;border-spacing:0}.table{width:100%;margin-bottom:18px}.table th,.table td{padding:8px;line-height:18px;text-align:left;vertical-align:top;border-top:1px solid #ddd}.table th{font-weight:700}.table thead th{vertical-align:bottom}.table thead:first-child tr th,.table thead:first-child tr td{border-top:0}.table tbody+tbody{border-top:2px solid #ddd}.table-condensed th,.table-condensed td{padding:4px 5px}.table-bordered{border:1px solid #ddd;border-collapse:separate;*border-collapse:collapsed;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}.table-bordered th+th,.table-bordered td+td,.table-bordered th+td,.table-bordered td+th{border-left:1px solid #ddd}.table-bordered thead:first-child tr:first-child th,.table-bordered tbody:first-child tr:first-child th,.table-bordered tbody:first-child tr:first-child td{border-top:0}.table-bordered thead:first-child tr:first-child th:first-child,.table-bordered tbody:first-child tr:first-child td:first-child{-webkit-border-radius:4px 0 0 0;-moz-border-radius:4px 0 0 0;border-radius:4px 0 0 0}.table-bordered thead:first-child tr:first-child th:last-child,.table-bordered tbody:first-child tr:first-child td:last-child{-webkit-border-radius:0 4px 0 0;-moz-border-radius:0 4px 0 0;border-radius:0 4px 0 0}.table-bordered thead:last-child tr:last-child th:first-child,.table-bordered tbody:last-child tr:last-child td:first-child{-webkit-border-radius:0 0 0 4px;-moz-border-radius:0 0 0 4px;border-radius:0 0 0 4px}.table-bordered thead:last-child tr:last-child th:last-child,.table-bordered tbody:last-child tr:last-child td:last-child{-webkit-border-radius:0 0 4px 0;-moz-border-radius:0 0 4px 0;border-radius:0 0 4px 0}.table-striped tbody tr:nth-child(odd) td,.table-striped tbody tr:nth-child(odd) th{background-color:#f9f9f9}.table tbody tr:hover td,.table tbody tr:hover th{background-color:#f5f5f5}table .span1{float:none;width:44px;margin-left:0}table .span2{float:none;width:124px;margin-left:0}table .span3{float:none;width:204px;margin-left:0}table .span4{float:none;width:284px;margin-left:0}table .span5{float:none;width:364px;margin-left:0}table .span6{float:none;width:444px;margin-left:0}table .span7{float:none;width:524px;margin-left:0}table .span8{float:none;width:604px;margin-left:0}table .span9{float:none;width:684px;margin-left:0}table .span10{float:none;width:764px;margin-left:0}table .span11{float:none;width:844px;margin-left:0}table .span12{float:none;width:924px;margin-left:0}[class^="icon-"],[class*=" icon-"]{display:inline-block;width:14px;height:14px;line-height:14px;vertical-align:text-top;background-image:url("../img/glyphicons-halflings.png");background-position:14px 14px;background-repeat:no-repeat;*margin-right:.3em}[class^="icon-"]:last-child,[class*=" icon-"]:last-child{*margin-left:0}.icon-white{background-image:url("../img/glyphicons-halflings-white.png")}.icon-glass{background-position:0 0}.icon-music{background-position:-24px 0}.icon-search{background-position:-48px 0}.icon-envelope{background-position:-72px 0}.icon-heart{background-position:-96px 0}.icon-star{background-position:-120px 0}.icon-star-empty{background-position:-144px 0}.icon-user{background-position:-168px 0}.icon-film{background-position:-192px 0}.icon-th-large{background-position:-216px 0}.icon-th{background-position:-240px 0}.icon-th-list{background-position:-264px 0}.icon-ok{background-position:-288px 0}.icon-remove{background-position:-312px 0}.icon-zoom-in{background-position:-336px 0}.icon-zoom-out{background-position:-360px 0}.icon-off{background-position:-384px 0}.icon-signal{background-position:-408px 0}.icon-cog{background-position:-432px 0}.icon-trash{background-position:-456px 0}.icon-home{background-position:0 -24px}.icon-file{background-position:-24px -24px}.icon-time{background-position:-48px -24px}.icon-road{background-position:-72px -24px}.icon-download-alt{background-position:-96px -24px}.icon-download{background-position:-120px -24px}.icon-upload{background-position:-144px -24px}.icon-inbox{background-position:-168px -24px}.icon-play-circle{background-position:-192px -24px}.icon-repeat{background-position:-216px -24px}.icon-refresh{background-position:-240px -24px}.icon-list-alt{background-position:-264px -24px}.icon-lock{background-position:-287px -24px}.icon-flag{background-position:-312px -24px}.icon-headphones{background-position:-336px -24px}.icon-volume-off{background-position:-360px -24px}.icon-volume-down{background-position:-384px -24px}.icon-volume-up{background-position:-408px -24px}.icon-qrcode{background-position:-432px -24px}.icon-barcode{background-position:-456px -24px}.icon-tag{background-position:0 -48px}.icon-tags{background-position:-25px -48px}.icon-book{background-position:-48px -48px}.icon-bookmark{background-position:-72px -48px}.icon-print{background-position:-96px -48px}.icon-camera{background-position:-120px -48px}.icon-font{background-position:-144px -48px}.icon-bold{background-position:-167px -48px}.icon-italic{background-position:-192px -48px}.icon-text-height{background-position:-216px -48px}.icon-text-width{background-position:-240px -48px}.icon-align-left{background-position:-264px -48px}.icon-align-center{background-position:-288px -48px}.icon-align-right{background-position:-312px -48px}.icon-align-justify{background-position:-336px -48px}.icon-list{background-position:-360px -48px}.icon-indent-left{background-position:-384px -48px}.icon-indent-right{background-position:-408px -48px}.icon-facetime-video{background-position:-432px -48px}.icon-picture{background-position:-456px -48px}.icon-pencil{background-position:0 -72px}.icon-map-marker{background-position:-24px -72px}.icon-adjust{background-position:-48px -72px}.icon-tint{background-position:-72px -72px}.icon-edit{background-position:-96px -72px}.icon-share{background-position:-120px -72px}.icon-check{background-position:-144px -72px}.icon-move{background-position:-168px -72px}.icon-step-backward{background-position:-192px -72px}.icon-fast-backward{background-position:-216px -72px}.icon-backward{background-position:-240px -72px}.icon-play{background-position:-264px -72px}.icon-pause{background-position:-288px -72px}.icon-stop{background-position:-312px -72px}.icon-forward{background-position:-336px -72px}.icon-fast-forward{background-position:-360px -72px}.icon-step-forward{background-position:-384px -72px}.icon-eject{background-position:-408px -72px}.icon-chevron-left{background-position:-432px -72px}.icon-chevron-right{background-position:-456px -72px}.icon-plus-sign{background-position:0 -96px}.icon-minus-sign{background-position:-24px -96px}.icon-remove-sign{background-position:-48px -96px}.icon-ok-sign{background-position:-72px -96px}.icon-question-sign{background-position:-96px -96px}.icon-info-sign{background-position:-120px -96px}.icon-screenshot{background-position:-144px -96px}.icon-remove-circle{background-position:-168px -96px}.icon-ok-circle{background-position:-192px -96px}.icon-ban-circle{background-position:-216px -96px}.icon-arrow-left{background-position:-240px -96px}.icon-arrow-right{background-position:-264px -96px}.icon-arrow-up{background-position:-289px -96px}.icon-arrow-down{background-position:-312px -96px}.icon-share-alt{background-position:-336px -96px}.icon-resize-full{background-position:-360px -96px}.icon-resize-small{background-position:-384px -96px}.icon-plus{background-position:-408px -96px}.icon-minus{background-position:-433px -96px}.icon-asterisk{background-position:-456px -96px}.icon-exclamation-sign{background-position:0 -120px}.icon-gift{background-position:-24px -120px}.icon-leaf{background-position:-48px -120px}.icon-fire{background-position:-72px -120px}.icon-eye-open{background-position:-96px -120px}.icon-eye-close{background-position:-120px -120px}.icon-warning-sign{background-position:-144px -120px}.icon-plane{background-position:-168px -120px}.icon-calendar{background-position:-192px -120px}.icon-random{background-position:-216px -120px}.icon-comment{background-position:-240px -120px}.icon-magnet{background-position:-264px -120px}.icon-chevron-up{background-position:-288px -120px}.icon-chevron-down{background-position:-313px -119px}.icon-retweet{background-position:-336px -120px}.icon-shopping-cart{background-position:-360px -120px}.icon-folder-close{background-position:-384px -120px}.icon-folder-open{background-position:-408px -120px}.icon-resize-vertical{background-position:-432px -119px}.icon-resize-horizontal{background-position:-456px -118px}.dropdown{position:relative}.dropdown-toggle{*margin-bottom:-3px}.dropdown-toggle:active,.open .dropdown-toggle{outline:0}.caret{display:inline-block;width:0;height:0;text-indent:-99999px;*text-indent:0;vertical-align:top;border-left:4px solid transparent;border-right:4px solid transparent;border-top:4px solid#000;opacity:.3;filter:alpha(opacity=30);content:"\2193"}.dropdown .caret{margin-top:8px;margin-left:2px}.dropdown:hover .caret,.open.dropdown .caret{opacity:1;filter:alpha(opacity=100)}.dropdown-menu{position:absolute;top:100%;left:0;z-index:1000;float:left;display:none;min-width:160px;_width:160px;padding:4px 0;margin:0;list-style:none;background-color:#fff;border-color:#ccc;border-color:rgba(0,0,0,0.2);border-style:solid;border-width:1px;-webkit-border-radius:0 0 5px 5px;-moz-border-radius:0 0 5px 5px;border-radius:0 0 5px 5px;-webkit-box-shadow:0 5px 10px rgba(0,0,0,0.2);-moz-box-shadow:0 5px 10px rgba(0,0,0,0.2);box-shadow:0 5px 10px rgba(0,0,0,0.2);-webkit-background-clip:padding-box;-moz-background-clip:padding;background-clip:padding-box;*border-right-width:2px;*border-bottom-width:2px}.dropdown-menu.bottom-up{top:auto;bottom:100%;margin-bottom:2px}.dropdown-menu .divider{height:1px;margin:5px 1px;overflow:hidden;background-color:#e5e5e5;border-bottom:1px solid#fff;*width:100%;*margin:-5px 0 5px}.dropdown-menu a{display:block;padding:3px 15px;clear:both;font-weight:400;line-height:18px;color:#555;white-space:nowrap}.dropdown-menu li>a:hover,.dropdown-menu .active>a,.dropdown-menu .active>a:hover{color:#fff;text-decoration:none;background-color:#08c}.dropdown.open{*z-index:1000}.dropdown.open .dropdown-toggle{color:#fff;background:#ccc;background:rgba(0,0,0,0.3)}.dropdown.open .dropdown-menu{display:block}.typeahead{margin-top:2px;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}.well{min-height:20px;padding:19px;margin-bottom:20px;background-color:#f5f5f5;border:1px solid #eee;border:1px solid rgba(0,0,0,0.05);-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;-webkit-box-shadow:inset 0 1px 1px rgba(0,0,0,0.05);-moz-box-shadow:inset 0 1px 1px rgba(0,0,0,0.05);box-shadow:inset 0 1px 1px rgba(0,0,0,0.05)}.well blockquote{border-color:#ddd;border-color:rgba(0,0,0,0.15)}.fade{-webkit-transition:opacity .15s linear;-moz-transition:opacity .15s linear;-ms-transition:opacity .15s linear;-o-transition:opacity .15s linear;transition:opacity .15s linear;opacity:0}.fade.in{opacity:1}.collapse{-webkit-transition:height .35s ease;-moz-transition:height .35s ease;-ms-transition:height .35s ease;-o-transition:height .35s ease;transition:height .35s ease;position:relative;overflow:hidden;height:0}.collapse.in{height:auto}.close{float:right;font-size:20px;font-weight:700;line-height:18px;color:#000;text-shadow:0 1px 0#fff;opacity:.2;filter:alpha(opacity=20)}.close:hover{color:#000;text-decoration:none;opacity:.4;filter:alpha(opacity=40);cursor:pointer}.btn{display:inline-block;padding:4px 10px 4px;margin-bottom:0;font-size:16px;line-height:18px;color:#606060;text-align:center;text-shadow:0 1px 1px rgba(255,255,255,0.75);vertical-align:middle;background-color:#f5f5f5;background-image:-moz-linear-gradient(top,#fff,#e6e6e6);background-image:-ms-linear-gradient(top,#fff,#e6e6e6);background-image:-webkit-gradient(linear,0 0,0 100%,from(#fff),to(#e6e6e6));background-image:-webkit-linear-gradient(top,#fff,#e6e6e6);background-image:-o-linear-gradient(top,#fff,#e6e6e6);background-image:linear-gradient(top,#fff,#e6e6e6);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffff',endColorstr='#e6e6e6',GradientType=0);border-color:#e6e6e6 #e6e6e6 #bfbfbf;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);border:1px solid #ccc;border-bottom-color:#bbb;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;-webkit-box-shadow:inset 0 1px 0 rgba(255,255,255,0.2),0 1px 2px rgba(0,0,0,0.05);-moz-box-shadow:inset 0 1px 0 rgba(255,255,255,0.2),0 1px 2px rgba(0,0,0,0.05);box-shadow:inset 0 1px 0 rgba(255,255,255,0.2),0 1px 2px rgba(0,0,0,0.05);cursor:pointer;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);*margin-left:.3em}.btn:hover,.btn:active,.btn.active,.btn.disabled,.btn[disabled]{background-color:#e6e6e6}.btn:active,.btn.active{background-color:#ccc \9}.btn:first-child{*margin-left:0}.btn:hover{color:#606060;text-decoration:none;background-color:#e6e6e6;background-position:0 -15px;-webkit-transition:background-position .1s linear;-moz-transition:background-position .1s linear;-ms-transition:background-position .1s linear;-o-transition:background-position .1s linear;transition:background-position .1s linear}.btn:focus{outline:thin dotted #333;outline:5px auto -webkit-focus-ring-color;outline-offset:-2px}.btn.active,.btn:active{background-image:none;-webkit-box-shadow:inset 0 2px 4px rgba(0,0,0,0.15),0 1px 2px rgba(0,0,0,0.05);-moz-box-shadow:inset 0 2px 4px rgba(0,0,0,0.15),0 1px 2px rgba(0,0,0,0.05);box-shadow:inset 0 2px 4px rgba(0,0,0,0.15),0 1px 2px rgba(0,0,0,0.05);background-color:#e6e6e6;background-color:#d9d9d9 \9;outline:0}.btn.disabled,.btn[disabled]{cursor:default;background-image:none;background-color:#e6e6e6;opacity:.65;filter:alpha(opacity=65);-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none}.btn-large{padding:9px 14px;font-size:18px;line-height:normal;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px}.btn-large [class^="icon-"]{margin-top:1px}.btn-small{padding:5px 9px;font-size:14px;line-height:16px}.btn-small [class^="icon-"]{margin-top:-1px}.btn-mini{padding:2px 6px;font-size:14px;line-height:14px}.btn-primary,.btn-primary:hover,.btn-warning,.btn-warning:hover,.btn-danger,.btn-danger:hover,.btn-success,.btn-success:hover,.btn-info,.btn-info:hover,.btn-inverse,.btn-inverse:hover{text-shadow:0 -1px 0 rgba(0,0,0,0.25);color:#fff}.btn-primary.active,.btn-warning.active,.btn-danger.active,.btn-success.active,.btn-info.active,.btn-dark.active{color:rgba(255,255,255,0.75)}.btn-primary{background-color:#006dcc;background-image:-moz-linear-gradient(top,#08c,#04c);background-image:-ms-linear-gradient(top,#08c,#04c);background-image:-webkit-gradient(linear,0 0,0 100%,from(#08c),to(#04c));background-image:-webkit-linear-gradient(top,#08c,#04c);background-image:-o-linear-gradient(top,#08c,#04c);background-image:linear-gradient(top,#08c,#04c);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#0088cc',endColorstr='#0044cc',GradientType=0);border-color:#04c #0044cc #002a80;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false)}.btn-primary:hover,.btn-primary:active,.btn-primary.active,.btn-primary.disabled,.btn-primary[disabled]{background-color:#04c}.btn-primary:active,.btn-primary.active{background-color:#039 \9}.btn-warning{background-color:#faa732;background-image:-moz-linear-gradient(top,#fbb450,#f89406);background-image:-ms-linear-gradient(top,#fbb450,#f89406);background-image:-webkit-gradient(linear,0 0,0 100%,from(#fbb450),to(#f89406));background-image:-webkit-linear-gradient(top,#fbb450,#f89406);background-image:-o-linear-gradient(top,#fbb450,#f89406);background-image:linear-gradient(top,#fbb450,#f89406);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#fbb450',endColorstr='#f89406',GradientType=0);border-color:#f89406 #f89406 #ad6704;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false)}.btn-warning:hover,.btn-warning:active,.btn-warning.active,.btn-warning.disabled,.btn-warning[disabled]{background-color:#f89406}.btn-warning:active,.btn-warning.active{background-color:#c67605 \9}.btn-danger{background-color:#da4f49;background-image:-moz-linear-gradient(top,#ee5f5b,#bd362f);background-image:-ms-linear-gradient(top,#ee5f5b,#bd362f);background-image:-webkit-gradient(linear,0 0,0 100%,from(#ee5f5b),to(#bd362f));background-image:-webkit-linear-gradient(top,#ee5f5b,#bd362f);background-image:-o-linear-gradient(top,#ee5f5b,#bd362f);background-image:linear-gradient(top,#ee5f5b,#bd362f);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ee5f5b',endColorstr='#bd362f',GradientType=0);border-color:#bd362f #bd362f #802420;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false)}.btn-danger:hover,.btn-danger:active,.btn-danger.active,.btn-danger.disabled,.btn-danger[disabled]{background-color:#bd362f}.btn-danger:active,.btn-danger.active{background-color:#942a25 \9}.btn-success{background-color:#5bb75b;background-image:-moz-linear-gradient(top,#62c462,#51a351);background-image:-ms-linear-gradient(top,#62c462,#51a351);background-image:-webkit-gradient(linear,0 0,0 100%,from(#62c462),to(#51a351));background-image:-webkit-linear-gradient(top,#62c462,#51a351);background-image:-o-linear-gradient(top,#62c462,#51a351);background-image:linear-gradient(top,#62c462,#51a351);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#62c462',endColorstr='#51a351',GradientType=0);border-color:#51a351 #51a351 #387038;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false)}.btn-success:hover,.btn-success:active,.btn-success.active,.btn-success.disabled,.btn-success[disabled]{background-color:#51a351}.btn-success:active,.btn-success.active{background-color:#408140 \9}.btn-info{background-color:#49afcd;background-image:-moz-linear-gradient(top,#5bc0de,#2f96b4);background-image:-ms-linear-gradient(top,#5bc0de,#2f96b4);background-image:-webkit-gradient(linear,0 0,0 100%,from(#5bc0de),to(#2f96b4));background-image:-webkit-linear-gradient(top,#5bc0de,#2f96b4);background-image:-o-linear-gradient(top,#5bc0de,#2f96b4);background-image:linear-gradient(top,#5bc0de,#2f96b4);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#5bc0de',endColorstr='#2f96b4',GradientType=0);border-color:#2f96b4 #2f96b4 #1f6377;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false)}.btn-info:hover,.btn-info:active,.btn-info.active,.btn-info.disabled,.btn-info[disabled]{background-color:#2f96b4}.btn-info:active,.btn-info.active{background-color:#24748c \9}.btn-inverse{background-color:#393939;background-image:-moz-linear-gradient(top,#454545,#262626);background-image:-ms-linear-gradient(top,#454545,#262626);background-image:-webkit-gradient(linear,0 0,0 100%,from(#454545),to(#262626));background-image:-webkit-linear-gradient(top,#454545,#262626);background-image:-o-linear-gradient(top,#454545,#262626);background-image:linear-gradient(top,#454545,#262626);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#454545',endColorstr='#262626',GradientType=0);border-color:#262626 #262626#000;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false)}.btn-inverse:hover,.btn-inverse:active,.btn-inverse.active,.btn-inverse.disabled,.btn-inverse[disabled]{background-color:#262626}.btn-inverse:active,.btn-inverse.active{background-color:#0c0c0c \9}button.btn,input[type="submit"].btn{*padding-top:2px;*padding-bottom:2px}button.btn::-moz-focus-inner,input[type="submit"].btn::-moz-focus-inner{padding:0;border:0}button.btn.large,input[type="submit"].btn.large{*padding-top:7px;*padding-bottom:7px}button.btn.small,input[type="submit"].btn.small{*padding-top:3px;*padding-bottom:3px}.btn-group{position:relative;*zoom:1;*margin-left:.3em}.btn-group:before,.btn-group:after{display:table;content:""}.btn-group:after{clear:both}.btn-group:first-child{*margin-left:0}.btn-group+.btn-group{margin-left:5px}.btn-toolbar{margin-top:9px;margin-bottom:9px}.btn-toolbar .btn-group{display:inline-block;*display:inline;*zoom:1}.btn-group .btn{position:relative;float:left;margin-left:-1px;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.btn-group .btn:first-child{margin-left:0;-webkit-border-top-left-radius:4px;-moz-border-radius-topleft:4px;border-top-left-radius:4px;-webkit-border-bottom-left-radius:4px;-moz-border-radius-bottomleft:4px;border-bottom-left-radius:4px}.btn-group .btn:last-child,.btn-group .dropdown-toggle{-webkit-border-top-right-radius:4px;-moz-border-radius-topright:4px;border-top-right-radius:4px;-webkit-border-bottom-right-radius:4px;-moz-border-radius-bottomright:4px;border-bottom-right-radius:4px}.btn-group .btn.large:first-child{margin-left:0;-webkit-border-top-left-radius:6px;-moz-border-radius-topleft:6px;border-top-left-radius:6px;-webkit-border-bottom-left-radius:6px;-moz-border-radius-bottomleft:6px;border-bottom-left-radius:6px}.btn-group .btn.large:last-child,.btn-group .large.dropdown-toggle{-webkit-border-top-right-radius:6px;-moz-border-radius-topright:6px;border-top-right-radius:6px;-webkit-border-bottom-right-radius:6px;-moz-border-radius-bottomright:6px;border-bottom-right-radius:6px}.btn-group .btn:hover,.btn-group .btn:focus,.btn-group .btn:active,.btn-group .btn.active{z-index:2}.btn-group .dropdown-toggle:active,.btn-group.open .dropdown-toggle{outline:0}.btn-group .dropdown-toggle{padding-left:8px;padding-right:8px;-webkit-box-shadow:inset 1px 0 0 rgba(255,255,255,0.125),inset 0 1px 0 rgba(255,255,255,0.2),0 1px 2px rgba(0,0,0,0.05);-moz-box-shadow:inset 1px 0 0 rgba(255,255,255,0.125),inset 0 1px 0 rgba(255,255,255,0.2),0 1px 2px rgba(0,0,0,0.05);box-shadow:inset 1px 0 0 rgba(255,255,255,0.125),inset 0 1px 0 rgba(255,255,255,0.2),0 1px 2px rgba(0,0,0,0.05);*padding-top:5px;*padding-bottom:5px}.btn-group.open{*z-index:1000}.btn-group.open .dropdown-menu{display:block;margin-top:1px;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px}.btn-group.open .dropdown-toggle{background-image:none;-webkit-box-shadow:inset 0 1px 6px rgba(0,0,0,0.15),0 1px 2px rgba(0,0,0,0.05);-moz-box-shadow:inset 0 1px 6px rgba(0,0,0,0.15),0 1px 2px rgba(0,0,0,0.05);box-shadow:inset 0 1px 6px rgba(0,0,0,0.15),0 1px 2px rgba(0,0,0,0.05)}.btn .caret{margin-top:7px;margin-left:0}.btn:hover .caret,.open.btn-group .caret{opacity:1;filter:alpha(opacity=100)}.btn-primary .caret,.btn-danger .caret,.btn-info .caret,.btn-success .caret,.btn-inverse .caret{border-top-color:#fff;opacity:.75;filter:alpha(opacity=75)}.btn-small .caret{margin-top:4px}.alert{padding:8px 35px 8px 14px;margin-bottom:18px;text-shadow:0 1px 0 rgba(255,255,255,0.5);background-color:#fcf8e3;border:1px solid #fbeed5;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}.alert,.alert-heading{color:#c09853}.alert .close{position:relative;top:-2px;right:-21px;line-height:18px}.alert-success{background-color:#dff0d8;border-color:#d6e9c6}.alert-success,.alert-success .alert-heading{color:#468847}.alert-danger,.alert-error{background-color:#f2dede;border-color:#eed3d7}.alert-danger,.alert-error,.alert-danger .alert-heading,.alert-error .alert-heading{color:#b94a48}.alert-info{background-color:#d9edf7;border-color:#bce8f1}.alert-info,.alert-info .alert-heading{color:#3a87ad}.alert-block{padding-top:14px;padding-bottom:14px}.alert-block>p,.alert-block>ul{margin-bottom:0}.alert-block p+p{margin-top:5px}.nav{margin-left:0;margin-bottom:18px;list-style:none}.nav>li>a{display:block}.nav>li>a:hover{text-decoration:none;background-color:#eee}.nav .nav-header{display:block;padding:3px 15px;font-size:11px;font-weight:700;line-height:18px;color:#999;text-shadow:0 1px 0 rgba(255,255,255,0.5);text-transform:uppercase}.nav li+.nav-header{margin-top:9px}.nav-list{padding-left:14px;padding-right:14px;margin-bottom:0}.nav-list>li>a,.nav-list .nav-header{margin-left:-15px;margin-right:-15px;text-shadow:0 1px 0 rgba(255,255,255,0.5)}.nav-list>li>a{padding:3px 15px}.nav-list .active>a,.nav-list .active>a:hover{color:#fff;text-shadow:0 -1px 0 rgba(0,0,0,0.2);background-color:#08c}.nav-list [class^="icon-"]{margin-right:2px}.nav-tabs,.nav-pills{*zoom:1}.nav-tabs:before,.nav-pills:before,.nav-tabs:after,.nav-pills:after{display:table;content:""}.nav-tabs:after,.nav-pills:after{clear:both}.nav-tabs>li,.nav-pills>li{float:left}.nav-tabs>li>a,.nav-pills>li>a{padding-right:12px;padding-left:12px;margin-right:2px;line-height:14px}.nav-tabs{border-bottom:1px solid #ddd}.nav-tabs>li{margin-bottom:-1px}.nav-tabs>li>a{padding-top:9px;padding-bottom:9px;border:1px solid transparent;-webkit-border-radius:4px 4px 0 0;-moz-border-radius:4px 4px 0 0;border-radius:4px 4px 0 0}.nav-tabs>li>a:hover{border-color:#eee #eeeeee#ddd}.nav-tabs>.active>a,.nav-tabs>.active>a:hover{color:#555;background-color:#fff;border:1px solid #ddd;border-bottom-color:transparent;cursor:default}.nav-pills>li>a{padding-top:8px;padding-bottom:8px;margin-top:2px;margin-bottom:2px;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px}.nav-pills .active>a,.nav-pills .active>a:hover{color:#fff;background-color:#08c}.nav-stacked>li{float:none}.nav-stacked>li>a{margin-right:0}.nav-tabs.nav-stacked{border-bottom:0}.nav-tabs.nav-stacked>li>a{border:1px solid #ddd;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.nav-tabs.nav-stacked>li:first-child>a{-webkit-border-radius:4px 4px 0 0;-moz-border-radius:4px 4px 0 0;border-radius:4px 4px 0 0}.nav-tabs.nav-stacked>li:last-child>a{-webkit-border-radius:0 0 4px 4px;-moz-border-radius:0 0 4px 4px;border-radius:0 0 4px 4px}.nav-tabs.nav-stacked>li>a:hover{border-color:#ddd;z-index:2}.nav-pills.nav-stacked>li>a{margin-bottom:3px}.nav-pills.nav-stacked>li:last-child>a{margin-bottom:1px}.nav-tabs .dropdown-menu,.nav-pills .dropdown-menu{margin-top:1px;border-width:1px}.nav-pills .dropdown-menu{-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}.nav-tabs .dropdown-toggle .caret,.nav-pills .dropdown-toggle .caret{border-top-color:#08c;margin-top:6px}.nav-tabs .dropdown-toggle:hover .caret,.nav-pills .dropdown-toggle:hover .caret{border-top-color:#005580}.nav-tabs .active .dropdown-toggle .caret,.nav-pills .active .dropdown-toggle .caret{border-top-color:#606060}.nav>.dropdown.active>a:hover{color:#000;cursor:pointer}.nav-tabs .open .dropdown-toggle,.nav-pills .open .dropdown-toggle,.nav>.open.active>a:hover{color:#fff;background-color:#999;border-color:#999}.nav .open .caret,.nav .open.active .caret,.nav .open a:hover .caret{border-top-color:#fff;opacity:1;filter:alpha(opacity=100)}.tabs-stacked .open>a:hover{border-color:#999}.tabbable{*zoom:1}.tabbable:before,.tabbable:after{display:table;content:""}.tabbable:after{clear:both}.tab-content{overflow:hidden}.tabs-below .nav-tabs,.tabs-right .nav-tabs,.tabs-left .nav-tabs{border-bottom:0}.tab-content>.tab-pane,.pill-content>.pill-pane{display:none}.tab-content>.active,.pill-content>.active{display:block}.tabs-below .nav-tabs{border-top:1px solid #ddd}.tabs-below .nav-tabs>li{margin-top:-1px;margin-bottom:0}.tabs-below .nav-tabs>li>a{-webkit-border-radius:0 0 4px 4px;-moz-border-radius:0 0 4px 4px;border-radius:0 0 4px 4px}.tabs-below .nav-tabs>li>a:hover{border-bottom-color:transparent;border-top-color:#ddd}.tabs-below .nav-tabs .active>a,.tabs-below .nav-tabs .active>a:hover{border-color:transparent #ddd #ddd #ddd}.tabs-left .nav-tabs>li,.tabs-right .nav-tabs>li{float:none}.tabs-left .nav-tabs>li>a,.tabs-right .nav-tabs>li>a{min-width:74px;margin-right:0;margin-bottom:3px}.tabs-left .nav-tabs{float:left;margin-right:19px;border-right:1px solid #ddd}.tabs-left .nav-tabs>li>a{margin-right:-1px;-webkit-border-radius:4px 0 0 4px;-moz-border-radius:4px 0 0 4px;border-radius:4px 0 0 4px}.tabs-left .nav-tabs>li>a:hover{border-color:#eee #dddddd#eee #eeeeee}.tabs-left .nav-tabs .active>a,.tabs-left .nav-tabs .active>a:hover{border-color:#ddd transparent #ddd #ddd;*border-right-color:#fff}.tabs-right .nav-tabs{float:right;margin-left:19px;border-left:1px solid #ddd}.tabs-right .nav-tabs>li>a{margin-left:-1px;-webkit-border-radius:0 4px 4px 0;-moz-border-radius:0 4px 4px 0;border-radius:0 4px 4px 0}.tabs-right .nav-tabs>li>a:hover{border-color:#eee #eeeeee#eee #dddddd}.tabs-right .nav-tabs .active>a,.tabs-right .nav-tabs .active>a:hover{border-color:#ddd #ddd #ddd transparent;*border-left-color:#fff}.navbar{overflow:visible;margin-bottom:18px}.navbar-inner{padding-left:20px;padding-right:20px;background-color:#474747;background-image:-moz-linear-gradient(top,#606060,#222);background-image:-ms-linear-gradient(top,#606060,#222);background-image:-webkit-gradient(linear,0 0,0 100%,from(#606060),to(#222));background-image:-webkit-linear-gradient(top,#606060,#222);background-image:-o-linear-gradient(top,#606060,#222);background-image:linear-gradient(top,#606060,#222);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#606060',endColorstr='#222222',GradientType=0);-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;-webkit-box-shadow:0 1px 3px rgba(0,0,0,0.25),inset 0 -1px 0 rgba(0,0,0,0.1);-moz-box-shadow:0 1px 3px rgba(0,0,0,0.25),inset 0 -1px 0 rgba(0,0,0,0.1);box-shadow:0 1px 3px rgba(0,0,0,0.25),inset 0 -1px 0 rgba(0,0,0,0.1)}.btn-navbar{display:none;float:right;padding:7px 10px;margin-left:5px;margin-right:5px;background-color:#474747;background-image:-moz-linear-gradient(top,#606060,#222);background-image:-ms-linear-gradient(top,#606060,#222);background-image:-webkit-gradient(linear,0 0,0 100%,from(#606060),to(#222));background-image:-webkit-linear-gradient(top,#606060,#222);background-image:-o-linear-gradient(top,#606060,#222);background-image:linear-gradient(top,#606060,#222);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#606060',endColorstr='#222222',GradientType=0);border-color:#222 #222222#000;border-color:rgba(0,0,0,0.1) rgba(0,0,0,0.1) rgba(0,0,0,0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);-webkit-box-shadow:inset 0 1px 0 rgba(255,255,255,0.1),0 1px 0 rgba(255,255,255,0.075);-moz-box-shadow:inset 0 1px 0 rgba(255,255,255,0.1),0 1px 0 rgba(255,255,255,0.075);box-shadow:inset 0 1px 0 rgba(255,255,255,0.1),0 1px 0 rgba(255,255,255,0.075)}.btn-navbar:hover,.btn-navbar:active,.btn-navbar.active,.btn-navbar.disabled,.btn-navbar[disabled]{background-color:#222}.btn-navbar:active,.btn-navbar.active{background-color:#080808 \9}.btn-navbar .icon-bar{display:block;width:18px;height:2px;background-color:#f5f5f5;-webkit-border-radius:1px;-moz-border-radius:1px;border-radius:1px;-webkit-box-shadow:0 1px 0 rgba(0,0,0,0.25);-moz-box-shadow:0 1px 0 rgba(0,0,0,0.25);box-shadow:0 1px 0 rgba(0,0,0,0.25)}.btn-navbar .icon-bar+.icon-bar{margin-top:3px}.nav-collapse.collapse{height:auto}.navbar .brand:hover{text-decoration:none}.navbar .brand{float:left;display:block;padding:8px 20px 12px;margin-left:-20px;font-size:20px;font-weight:200;line-height:1;color:#fff}.navbar .navbar-text{margin-bottom:0;line-height:40px;color:#999}.navbar .navbar-text a:hover{color:#fff;background-color:transparent}.navbar .btn,.navbar .btn-group{margin-top:5px}.navbar .btn-group .btn{margin-top:0}.navbar-form{margin-bottom:0;*zoom:1}.navbar-form:before,.navbar-form:after{display:table;content:""}.navbar-form:after{clear:both}.navbar-form input,.navbar-form select{display:inline-block;margin-top:5px;margin-bottom:0}.navbar-form .radio,.navbar-form .checkbox{margin-top:5px}.navbar-form input[type="image"],.navbar-form input[type="checkbox"],.navbar-form input[type="radio"]{margin-top:3px}.navbar-form .input-append,.navbar-form .input-prepend{margin-top:6px;white-space:nowrap}.navbar-form .input-append input,.navbar-form .input-prepend input{margin-top:0}.navbar-search{position:relative;float:left;margin-top:6px;margin-bottom:0}.navbar-search .search-query{padding:4px 9px;font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:13px;font-weight:400;line-height:1;color:#fff;color:rgba(255,255,255,0.75);background:#666;background:rgba(255,255,255,0.3);border:1px solid #111;-webkit-box-shadow:inset 0 1px 2px rgba(0,0,0,0.1),0 1px 0 rgba(255,255,255,0.15);-moz-box-shadow:inset 0 1px 2px rgba(0,0,0,0.1),0 1px 0 rgba(255,255,255,0.15);box-shadow:inset 0 1px 2px rgba(0,0,0,0.1),0 1px 0 rgba(255,255,255,0.15);-webkit-transition:none;-moz-transition:none;-ms-transition:none;-o-transition:none;transition:none}.navbar-search .search-query:-moz-placeholder{color:#eee}.navbar-search .search-query::-webkit-input-placeholder{color:#eee}.navbar-search .search-query:hover{color:#fff;background-color:#999;background-color:rgba(255,255,255,0.5)}.navbar-search .search-query:focus,.navbar-search .search-query.focused{padding:5px 10px;color:#606060;text-shadow:0 1px 0#fff;background-color:#fff;border:0;-webkit-box-shadow:0 0 3px rgba(0,0,0,0.15);-moz-box-shadow:0 0 3px rgba(0,0,0,0.15);box-shadow:0 0 3px rgba(0,0,0,0.15);outline:0}.navbar-fixed-top{position:fixed;top:0;right:0;left:0;z-index:1030}.navbar-fixed-top .navbar-inner{padding-left:0;padding-right:0;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0}.navbar .nav{position:relative;left:0;display:block;float:left;margin:0 10px 0 0}.navbar .nav.pull-right{float:right}.navbar .nav>li{display:block;float:left}.navbar .nav>li>a{float:none;padding:10px 10px 11px;line-height:19px;color:#999;text-decoration:none;text-shadow:0 -1px 0 rgba(0,0,0,0.25)}.navbar .nav>li>a:hover{background-color:transparent;color:#fff;text-decoration:none}.navbar .nav .active>a,.navbar .nav .active>a:hover{color:#fff;text-decoration:none;background-color:#222}.navbar .divider-vertical{height:40px;width:1px;margin:0 9px;overflow:hidden;background-color:#222;border-right:1px solid #606060}.navbar .nav.pull-right{margin-left:10px;margin-right:0}.navbar .dropdown-menu{margin-top:1px;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}.navbar .dropdown-menu:before{content:'';display:inline-block;border-left:7px solid transparent;border-right:7px solid transparent;border-bottom:7px solid #ccc;border-bottom-color:rgba(0,0,0,0.2);position:absolute;top:-7px;left:9px}.navbar .dropdown-menu:after{content:'';display:inline-block;border-left:6px solid transparent;border-right:6px solid transparent;border-bottom:6px solid#fff;position:absolute;top:-6px;left:10px}.navbar .nav .dropdown-toggle .caret,.navbar .nav .open.dropdown .caret{border-top-color:#fff}.navbar .nav .active .caret{opacity:1;filter:alpha(opacity=100)}.navbar .nav .open>.dropdown-toggle,.navbar .nav .active>.dropdown-toggle,.navbar .nav .open.active>.dropdown-toggle{background-color:transparent}.navbar .nav .active>.dropdown-toggle:hover{color:#fff}.navbar .nav.pull-right .dropdown-menu{left:auto;right:0}.navbar .nav.pull-right .dropdown-menu:before{left:auto;right:12px}.navbar .nav.pull-right .dropdown-menu:after{left:auto;right:13px}.breadcrumb{padding:7px 14px;margin:0 0 18px;background-color:#fbfbfb;background-image:-moz-linear-gradient(top,#fff,#f5f5f5);background-image:-ms-linear-gradient(top,#fff,#f5f5f5);background-image:-webkit-gradient(linear,0 0,0 100%,from(#fff),to(#f5f5f5));background-image:-webkit-linear-gradient(top,#fff,#f5f5f5);background-image:-o-linear-gradient(top,#fff,#f5f5f5);background-image:linear-gradient(top,#fff,#f5f5f5);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffff',endColorstr='#f5f5f5',GradientType=0);border:1px solid #ddd;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;-webkit-box-shadow:inset 0 1px 0#fff;-moz-box-shadow:inset 0 1px 0#fff;box-shadow:inset 0 1px 0#fff}.breadcrumb li{display:inline-block;text-shadow:0 1px 0#fff}.breadcrumb .divider{padding:0 5px;color:#999}.breadcrumb .active a{color:#606060}.pagination{height:36px;margin:18px 0}.pagination ul{display:inline-block;*display:inline;*zoom:1;margin-left:0;margin-bottom:0;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 2px rgba(0,0,0,0.05);-moz-box-shadow:0 1px 2px rgba(0,0,0,0.05);box-shadow:0 1px 2px rgba(0,0,0,0.05)}.pagination li{display:inline}.pagination a{float:left;padding:0 14px;line-height:34px;text-decoration:none;border:1px solid #ddd;border-left-width:0}.pagination a:hover,.pagination .active a{background-color:#f5f5f5}.pagination .active a{color:#999;cursor:default}.pagination .disabled a,.pagination .disabled a:hover{color:#999;background-color:transparent;cursor:default}.pagination li:first-child a{border-left-width:1px;-webkit-border-radius:3px 0 0 3px;-moz-border-radius:3px 0 0 3px;border-radius:3px 0 0 3px}.pagination li:last-child a{-webkit-border-radius:0 3px 3px 0;-moz-border-radius:0 3px 3px 0;border-radius:0 3px 3px 0}.pagination-centered{text-align:center}.pagination-right{text-align:right}.pager{margin-left:0;margin-bottom:18px;list-style:none;text-align:center;*zoom:1}.pager:before,.pager:after{display:table;content:""}.pager:after{clear:both}.pager li{display:inline}.pager a{display:inline-block;padding:5px 14px;background-color:#fff;border:1px solid #ddd;-webkit-border-radius:15px;-moz-border-radius:15px;border-radius:15px}.pager a:hover{text-decoration:none;background-color:#f5f5f5}.pager .next a{float:right}.pager .previous a{float:left}.modal-open .dropdown-menu{z-index:2050}.modal-open .dropdown.open{*z-index:2050}.modal-open .popover{z-index:2060}.modal-open .tooltip{z-index:2070}.modal-backdrop{position:fixed;top:0;right:0;bottom:0;left:0;z-index:1040;background-color:#000}.modal-backdrop.fade{opacity:0}.modal-backdrop,.modal-backdrop.fade.in{opacity:.8;filter:alpha(opacity=80)}.modal{position:fixed;top:50%;left:50%;z-index:1050;max-height:500px;overflow:auto;width:560px;margin:-250px 0 0 -280px;background-color:#fff;border:1px solid #999;border:1px solid rgba(0,0,0,0.3);*border:1px solid #999;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;-webkit-box-shadow:0 3px 7px rgba(0,0,0,0.3);-moz-box-shadow:0 3px 7px rgba(0,0,0,0.3);box-shadow:0 3px 7px rgba(0,0,0,0.3);-webkit-background-clip:padding-box;-moz-background-clip:padding-box;background-clip:padding-box}.modal.fade{-webkit-transition:opacity .3s linear,top .3s ease-out;-moz-transition:opacity .3s linear,top .3s ease-out;-ms-transition:opacity .3s linear,top .3s ease-out;-o-transition:opacity .3s linear,top .3s ease-out;transition:opacity .3s linear,top .3s ease-out;top:-25%}.modal.fade.in{top:50%}.modal-header{padding:9px 15px;border-bottom:1px solid #eee}.modal-header .close{margin-top:2px}.modal-body{padding:15px}.modal-body .modal-form{margin-bottom:0}.modal-footer{padding:14px 15px 15px;margin-bottom:0;background-color:#f5f5f5;border-top:1px solid #ddd;-webkit-border-radius:0 0 6px 6px;-moz-border-radius:0 0 6px 6px;border-radius:0 0 6px 6px;-webkit-box-shadow:inset 0 1px 0#fff;-moz-box-shadow:inset 0 1px 0#fff;box-shadow:inset 0 1px 0#fff;*zoom:1}.modal-footer:before,.modal-footer:after{display:table;content:""}.modal-footer:after{clear:both}.modal-footer .btn{float:right;margin-left:5px;margin-bottom:0}.tooltip{position:absolute;z-index:1020;display:block;visibility:visible;padding:5px;font-size:11px;opacity:0;filter:alpha(opacity=0)}.tooltip.in{opacity:.8;filter:alpha(opacity=80)}.tooltip.top{margin-top:-2px}.tooltip.right{margin-left:2px}.tooltip.bottom{margin-top:2px}.tooltip.left{margin-left:-2px}.tooltip.top .tooltip-arrow{bottom:0;left:50%;margin-left:-5px;border-left:5px solid transparent;border-right:5px solid transparent;border-top:5px solid#000}.tooltip.left .tooltip-arrow{top:50%;right:0;margin-top:-5px;border-top:5px solid transparent;border-bottom:5px solid transparent;border-left:5px solid#000}.tooltip.bottom .tooltip-arrow{top:0;left:50%;margin-left:-5px;border-left:5px solid transparent;border-right:5px solid transparent;border-bottom:5px solid#000}.tooltip.right .tooltip-arrow{top:50%;left:0;margin-top:-5px;border-top:5px solid transparent;border-bottom:5px solid transparent;border-right:5px solid#000}.tooltip-inner{max-width:200px;padding:3px 8px;color:#fff;text-align:center;text-decoration:none;background-color:#000;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}.tooltip-arrow{position:absolute;width:0;height:0}.popover{position:absolute;top:0;left:0;z-index:1010;display:none;padding:5px}.popover.top{margin-top:-5px}.popover.right{margin-left:5px}.popover.bottom{margin-top:5px}.popover.left{margin-left:-5px}.popover.top .arrow{bottom:0;left:50%;margin-left:-5px;border-left:5px solid transparent;border-right:5px solid transparent;border-top:5px solid#000}.popover.right .arrow{top:50%;left:0;margin-top:-5px;border-top:5px solid transparent;border-bottom:5px solid transparent;border-right:5px solid#000}.popover.bottom .arrow{top:0;left:50%;margin-left:-5px;border-left:5px solid transparent;border-right:5px solid transparent;border-bottom:5px solid#000}.popover.left .arrow{top:50%;right:0;margin-top:-5px;border-top:5px solid transparent;border-bottom:5px solid transparent;border-left:5px solid#000}.popover .arrow{position:absolute;width:0;height:0}.popover-inner{padding:3px;width:280px;overflow:hidden;background:#000;background:rgba(0,0,0,0.8);-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;-webkit-box-shadow:0 3px 7px rgba(0,0,0,0.3);-moz-box-shadow:0 3px 7px rgba(0,0,0,0.3);box-shadow:0 3px 7px rgba(0,0,0,0.3)}.popover-title{padding:9px 15px;line-height:1;background-color:#f5f5f5;border-bottom:1px solid #eee;-webkit-border-radius:3px 3px 0 0;-moz-border-radius:3px 3px 0 0;border-radius:3px 3px 0 0}.popover-content{padding:14px;background-color:#fff;-webkit-border-radius:0 0 3px 3px;-moz-border-radius:0 0 3px 3px;border-radius:0 0 3px 3px;-webkit-background-clip:padding-box;-moz-background-clip:padding-box;background-clip:padding-box}.popover-content p,.popover-content ul,.popover-content ol{margin-bottom:0}.thumbnails{margin-left:-20px;list-style:none;*zoom:1}.thumbnails:before,.thumbnails:after{display:table;content:""}.thumbnails:after{clear:both}.thumbnails>li{float:left;margin:0 0 18px 20px}.thumbnail{display:block;padding:4px;line-height:1;border:1px solid #ddd;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;-webkit-box-shadow:0 1px 1px rgba(0,0,0,0.075);-moz-box-shadow:0 1px 1px rgba(0,0,0,0.075);box-shadow:0 1px 1px rgba(0,0,0,0.075)}a.thumbnail:hover{border-color:#08c;-webkit-box-shadow:0 1px 4px rgba(0,105,214,0.25);-moz-box-shadow:0 1px 4px rgba(0,105,214,0.25);box-shadow:0 1px 4px rgba(0,105,214,0.25)}.thumbnail>img{display:block;max-width:100%;margin-left:auto;margin-right:auto}.thumbnail .caption{padding:9px}.label{padding:2px 4px 3px;font-size:13.6px;font-weight:700;color:#fff;text-shadow:0 -1px 0 rgba(0,0,0,0.25);background-color:#999;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px}.label:hover{color:#fff;text-decoration:none}.label-important{background-color:#b94a48}.label-important:hover{background-color:#953b39}.label-warning{background-color:#f89406}.label-warning:hover{background-color:#c67605}.label-success{background-color:#468847}.label-success:hover{background-color:#356635}.label-info{background-color:#3a87ad}.label-info:hover{background-color:#2d6987}@-webkit-keyframes progress-bar-stripes{from{background-position:0 0}to{background-position:40px 0}}@-moz-keyframes progress-bar-stripes{from{background-position:0 0}to{background-position:40px 0}}@keyframes progress-bar-stripes{from{background-position:0 0}to{background-position:40px 0}}.progress{overflow:hidden;height:18px;margin-bottom:18px;background-color:#f7f7f7;background-image:-moz-linear-gradient(top,#f5f5f5,#f9f9f9);background-image:-ms-linear-gradient(top,#f5f5f5,#f9f9f9);background-image:-webkit-gradient(linear,0 0,0 100%,from(#f5f5f5),to(#f9f9f9));background-image:-webkit-linear-gradient(top,#f5f5f5,#f9f9f9);background-image:-o-linear-gradient(top,#f5f5f5,#f9f9f9);background-image:linear-gradient(top,#f5f5f5,#f9f9f9);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#f5f5f5',endColorstr='#f9f9f9',GradientType=0);-webkit-box-shadow:inset 0 1px 2px rgba(0,0,0,0.1);-moz-box-shadow:inset 0 1px 2px rgba(0,0,0,0.1);box-shadow:inset 0 1px 2px rgba(0,0,0,0.1);-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}.progress .bar{width:0;height:18px;color:#fff;font-size:12px;text-align:center;text-shadow:0 -1px 0 rgba(0,0,0,0.25);background-color:#0e90d2;background-image:-moz-linear-gradient(top,#149bdf,#0480be);background-image:-ms-linear-gradient(top,#149bdf,#0480be);background-image:-webkit-gradient(linear,0 0,0 100%,from(#149bdf),to(#0480be));background-image:-webkit-linear-gradient(top,#149bdf,#0480be);background-image:-o-linear-gradient(top,#149bdf,#0480be);background-image:linear-gradient(top,#149bdf,#0480be);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#149bdf',endColorstr='#0480be',GradientType=0);-webkit-box-shadow:inset 0 -1px 0 rgba(0,0,0,0.15);-moz-box-shadow:inset 0 -1px 0 rgba(0,0,0,0.15);box-shadow:inset 0 -1px 0 rgba(0,0,0,0.15);-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;-webkit-transition:width .6s ease;-moz-transition:width .6s ease;-ms-transition:width .6s ease;-o-transition:width .6s ease;transition:width .6s ease}.progress-striped .bar{background-color:#62c462;background-image:-webkit-gradient(linear,0 100%,100% 0,color-stop(0.25,rgba(255,255,255,0.15)),color-stop(0.25,transparent),color-stop(0.5,transparent),color-stop(0.5,rgba(255,255,255,0.15)),color-stop(0.75,rgba(255,255,255,0.15)),color-stop(0.75,transparent),to(transparent));background-image:-webkit-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-moz-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-ms-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-o-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);-webkit-background-size:40px 40px;-moz-background-size:40px 40px;-o-background-size:40px 40px;background-size:40px 40px}.progress.active .bar{-webkit-animation:progress-bar-stripes 2s linear infinite;-moz-animation:progress-bar-stripes 2s linear infinite;animation:progress-bar-stripes 2s linear infinite}.progress-danger .bar{background-color:#dd514c;background-image:-moz-linear-gradient(top,#ee5f5b,#c43c35);background-image:-ms-linear-gradient(top,#ee5f5b,#c43c35);background-image:-webkit-gradient(linear,0 0,0 100%,from(#ee5f5b),to(#c43c35));background-image:-webkit-linear-gradient(top,#ee5f5b,#c43c35);background-image:-o-linear-gradient(top,#ee5f5b,#c43c35);background-image:linear-gradient(top,#ee5f5b,#c43c35);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ee5f5b',endColorstr='#c43c35',GradientType=0)}.progress-danger.progress-striped .bar{background-color:#ee5f5b;background-image:-webkit-gradient(linear,0 100%,100% 0,color-stop(0.25,rgba(255,255,255,0.15)),color-stop(0.25,transparent),color-stop(0.5,transparent),color-stop(0.5,rgba(255,255,255,0.15)),color-stop(0.75,rgba(255,255,255,0.15)),color-stop(0.75,transparent),to(transparent));background-image:-webkit-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-moz-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-ms-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-o-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent)}.progress-success .bar{background-color:#5eb95e;background-image:-moz-linear-gradient(top,#62c462,#57a957);background-image:-ms-linear-gradient(top,#62c462,#57a957);background-image:-webkit-gradient(linear,0 0,0 100%,from(#62c462),to(#57a957));background-image:-webkit-linear-gradient(top,#62c462,#57a957);background-image:-o-linear-gradient(top,#62c462,#57a957);background-image:linear-gradient(top,#62c462,#57a957);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#62c462',endColorstr='#57a957',GradientType=0)}.progress-success.progress-striped .bar{background-color:#62c462;background-image:-webkit-gradient(linear,0 100%,100% 0,color-stop(0.25,rgba(255,255,255,0.15)),color-stop(0.25,transparent),color-stop(0.5,transparent),color-stop(0.5,rgba(255,255,255,0.15)),color-stop(0.75,rgba(255,255,255,0.15)),color-stop(0.75,transparent),to(transparent));background-image:-webkit-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-moz-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-ms-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-o-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent)}.progress-info .bar{background-color:#4bb1cf;background-image:-moz-linear-gradient(top,#5bc0de,#339bb9);background-image:-ms-linear-gradient(top,#5bc0de,#339bb9);background-image:-webkit-gradient(linear,0 0,0 100%,from(#5bc0de),to(#339bb9));background-image:-webkit-linear-gradient(top,#5bc0de,#339bb9);background-image:-o-linear-gradient(top,#5bc0de,#339bb9);background-image:linear-gradient(top,#5bc0de,#339bb9);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#5bc0de',endColorstr='#339bb9',GradientType=0)}.progress-info.progress-striped .bar{background-color:#5bc0de;background-image:-webkit-gradient(linear,0 100%,100% 0,color-stop(0.25,rgba(255,255,255,0.15)),color-stop(0.25,transparent),color-stop(0.5,transparent),color-stop(0.5,rgba(255,255,255,0.15)),color-stop(0.75,rgba(255,255,255,0.15)),color-stop(0.75,transparent),to(transparent));background-image:-webkit-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-moz-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-ms-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:-o-linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);background-image:linear-gradient(-45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent)}.accordion{margin-bottom:18px}.accordion-group{margin-bottom:2px;border:1px solid #e5e5e5;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px}.accordion-heading{border-bottom:0}.accordion-heading .accordion-toggle{display:block;padding:8px 15px}.accordion-inner{padding:9px 15px;border-top:1px solid #e5e5e5}.carousel{position:relative;margin-bottom:18px;line-height:1}.carousel-inner{overflow:hidden;width:100%;position:relative}.carousel .item{display:none;position:relative;-webkit-transition:.6s ease-in-out left;-moz-transition:.6s ease-in-out left;-ms-transition:.6s ease-in-out left;-o-transition:.6s ease-in-out left;transition:.6s ease-in-out left}.carousel .item>img{display:block;line-height:1}.carousel .active,.carousel .next,.carousel .prev{display:block}.carousel .active{left:0}.carousel .next,.carousel .prev{position:absolute;top:0;width:100%}.carousel .next{left:100%}.carousel .prev{left:-100%}.carousel .next.left,.carousel .prev.right{left:0}.carousel .active.left{left:-100%}.carousel .active.right{left:100%}.carousel-control{position:absolute;top:40%;left:15px;width:40px;height:40px;margin-top:-20px;font-size:60px;font-weight:100;line-height:30px;color:#fff;text-align:center;background:#222;border:3px solid#fff;-webkit-border-radius:23px;-moz-border-radius:23px;border-radius:23px;opacity:.5;filter:alpha(opacity=50)}.carousel-control.right{left:auto;right:15px}.carousel-control:hover{color:#fff;text-decoration:none;opacity:.9;filter:alpha(opacity=90)}.carousel-caption{position:absolute;left:0;right:0;bottom:0;padding:10px 15px 5px;background:#606060;background:rgba(0,0,0,0.75)}.carousel-caption h4,.carousel-caption p{color:#fff}.hero-unit{padding:60px;margin-bottom:30px;background-color:#f5f5f5;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px}.hero-unit h1{margin-bottom:0;font-size:60px;line-height:1;letter-spacing:-1px}.hero-unit p{font-size:18px;font-weight:200;line-height:27px}.pull-right{float:right}.pull-left{float:left}.hide{display:none}.show{display:block}.invisible{visibility:hidden};F; I"�!article,aside,details,figcaption,figure,footer,header,hgroup,nav,section{display:block;} audio,canvas,video{display:inline-block;*display:inline;*zoom:1;} audio:not([controls]){display:none;} html{font-size:100%;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%;} a:focus{outline:thin dotted #333;outline:5px auto -webkit-focus-ring-color;outline-offset:-2px;} a:hover,a:active{outline:0;} sub,sup{position:relative;font-size:75%;line-height:0;vertical-align:baseline;} sup{top:-0.5em;} sub{bottom:-0.25em;} img{max-width:100%;height:auto;border:0;-ms-interpolation-mode:bicubic;} button,input,select,textarea{margin:0;font-size:100%;vertical-align:middle;} button,input{*overflow:visible;line-height:normal;} button::-moz-focus-inner,input::-moz-focus-inner{padding:0;border:0;} button,input[type="button"],input[type="reset"],input[type="submit"]{cursor:pointer;-webkit-appearance:button;} input[type="search"]{-webkit-appearance:textfield;-webkit-box-sizing:content-box;-moz-box-sizing:content-box;box-sizing:content-box;} input[type="search"]::-webkit-search-decoration,input[type="search"]::-webkit-search-cancel-button{-webkit-appearance:none;} textarea{overflow:auto;vertical-align:top;} .clearfix{*zoom:1;}.clearfix:before,.clearfix:after{display:table;content:"";} .clearfix:after{clear:both;} body{margin:0;font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:16px;line-height:18px;color:#606060;background-color:#ffffff;} a{color:#0088cc;text-decoration:none;} a:hover{color:#005580;text-decoration:underline;} .row{margin-left:-20px;*zoom:1;}.row:before,.row:after{display:table;content:"";} .row:after{clear:both;} [class*="span"]{float:left;margin-left:20px;} .span1{width:60px;} .span2{width:140px;} .span3{width:220px;} .span4{width:300px;} .span5{width:380px;} .span6{width:460px;} .span7{width:540px;} .span8{width:620px;} .span9{width:700px;} .span10{width:780px;} .span11{width:860px;} .span12,.container{width:940px;} .offset1{margin-left:100px;} .offset2{margin-left:180px;} .offset3{margin-left:260px;} .offset4{margin-left:340px;} .offset5{margin-left:420px;} .offset6{margin-left:500px;} .offset7{margin-left:580px;} .offset8{margin-left:660px;} .offset9{margin-left:740px;} .offset10{margin-left:820px;} .offset11{margin-left:900px;} .row-fluid{width:100%;*zoom:1;}.row-fluid:before,.row-fluid:after{display:table;content:"";} .row-fluid:after{clear:both;} .row-fluid>[class*="span"]{float:left;margin-left:2.127659574%;} .row-fluid>[class*="span"]:first-child{margin-left:0;} .row-fluid>.span1{width:6.382978723%;} .row-fluid>.span2{width:14.89361702%;} .row-fluid>.span3{width:23.404255317%;} .row-fluid>.span4{width:31.914893614%;} .row-fluid>.span5{width:40.425531911%;} .row-fluid>.span6{width:48.93617020799999%;} .row-fluid>.span7{width:57.446808505%;} .row-fluid>.span8{width:65.95744680199999%;} .row-fluid>.span9{width:74.468085099%;} .row-fluid>.span10{width:82.97872339599999%;} .row-fluid>.span11{width:91.489361693%;} .row-fluid>.span12{width:99.99999998999999%;} .container{width:940px;margin-left:auto;margin-right:auto;*zoom:1;}.container:before,.container:after{display:table;content:"";} .container:after{clear:both;} .container-fluid{padding-left:20px;padding-right:20px;*zoom:1;}.container-fluid:before,.container-fluid:after{display:table;content:"";} .container-fluid:after{clear:both;} p{margin:0 0 9px;font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:16px;line-height:18px;}p small{font-size:14px;color:#999999;} .lead{margin-bottom:18px;font-size:20px;font-weight:200;line-height:27px;} h1,h2,h3,h4,h5,h6{margin:0;font-weight:bold;color:#606060;text-rendering:optimizelegibility;}h1 small,h2 small,h3 small,h4 small,h5 small,h6 small{font-weight:normal;color:#999999;} h1{font-size:30px;line-height:36px;}h1 small{font-size:18px;} h2{font-size:24px;line-height:36px;}h2 small{font-size:18px;} h3{line-height:27px;font-size:18px;}h3 small{font-size:14px;} h4,h5,h6{line-height:18px;} h4{font-size:14px;}h4 small{font-size:12px;} h5{font-size:12px;} h6{font-size:11px;color:#999999;text-transform:uppercase;} .page-header{padding-bottom:17px;margin:18px 0;border-bottom:1px solid #eeeeee;} .page-header h1{line-height:1;} ul,ol{padding:0;margin:0 0 9px 25px;} ul ul,ul ol,ol ol,ol ul{margin-bottom:0;} ul{list-style:disc;} ol{list-style:decimal;} li{line-height:18px;} ul.unstyled,ol.unstyled{margin-left:0;list-style:none;} dl{margin-bottom:18px;} dt,dd{line-height:18px;} dt{font-weight:bold;} dd{margin-left:9px;} hr{margin:18px 0;border:0;border-top:1px solid #eeeeee;border-bottom:1px solid #ffffff;} strong{font-weight:bold;} em{font-style:italic;} .muted{color:#999999;} abbr{font-size:90%;text-transform:uppercase;border-bottom:1px dotted #ddd;cursor:help;} blockquote{padding:0 0 0 15px;margin:0 0 18px;border-left:5px solid #eeeeee;}blockquote p{margin-bottom:0;font-size:16px;font-weight:300;line-height:22.5px;} blockquote small{display:block;line-height:18px;color:#999999;}blockquote small:before{content:'\2014 \00A0';} blockquote.pull-right{float:right;padding-left:0;padding-right:15px;border-left:0;border-right:5px solid #eeeeee;}blockquote.pull-right p,blockquote.pull-right small{text-align:right;} q:before,q:after,blockquote:before,blockquote:after{content:"";} address{display:block;margin-bottom:18px;line-height:18px;font-style:normal;} small{font-size:100%;} cite{font-style:normal;} code,pre{padding:0 3px 2px;font-family:Menlo,Monaco,"Courier New",monospace;font-size:15px;color:#606060;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;} code{padding:3px 4px;color:#d14;background-color:#f7f7f9;border:1px solid #e1e1e8;} pre{display:block;padding:8.5px;margin:0 0 9px;font-size:12px;line-height:18px;background-color:#f5f5f5;border:1px solid #ccc;border:1px solid rgba(0, 0, 0, 0.15);-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;white-space:pre;white-space:pre-wrap;word-break:break-all;word-wrap:break-word;}pre.prettyprint{margin-bottom:18px;} pre code{padding:0;color:inherit;background-color:transparent;border:0;} .pre-scrollable{max-height:340px;overflow-y:scroll;} form{margin:0 0 18px;} fieldset{padding:0;margin:0;border:0;} legend{display:block;width:100%;padding:0;margin-bottom:27px;font-size:24px;line-height:36px;color:#606060;border:0;border-bottom:1px solid #eee;}legend small{font-size:13.5px;color:#999999;} label,input,button,select,textarea{font-size:16px;font-weight:normal;line-height:18px;} input,button,select,textarea{font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;} label{display:block;margin-bottom:5px;color:#606060;} input,textarea,select,.uneditable-input{display:inline-block;width:210px;height:18px;padding:4px;margin-bottom:9px;font-size:16px;line-height:18px;color:#555555;border:1px solid #ccc;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;} .uneditable-textarea{width:auto;height:auto;} label input,label textarea,label select{display:block;} input[type="image"],input[type="checkbox"],input[type="radio"]{width:auto;height:auto;padding:0;margin:3px 0;*margin-top:0;line-height:normal;cursor:pointer;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0;border:0 \9;} input[type="image"]{border:0;} input[type="file"]{width:auto;padding:initial;line-height:initial;border:initial;background-color:#ffffff;background-color:initial;-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none;} input[type="button"],input[type="reset"],input[type="submit"]{width:auto;height:auto;} select,input[type="file"]{height:28px;*margin-top:4px;line-height:28px;} input[type="file"]{line-height:18px \9;} select{width:220px;background-color:#ffffff;} select[multiple],select[size]{height:auto;} input[type="image"]{-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none;} textarea{height:auto;} input[type="hidden"]{display:none;} .radio,.checkbox{padding-left:18px;} .radio input[type="radio"],.checkbox input[type="checkbox"]{float:left;margin-left:-18px;} .controls>.radio:first-child,.controls>.checkbox:first-child{padding-top:5px;} .radio.inline,.checkbox.inline{display:inline-block;padding-top:5px;margin-bottom:0;vertical-align:middle;} .radio.inline+.radio.inline,.checkbox.inline+.checkbox.inline{margin-left:10px;} input,textarea{-webkit-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);-moz-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075);-webkit-transition:border linear 0.2s,box-shadow linear 0.2s;-moz-transition:border linear 0.2s,box-shadow linear 0.2s;-ms-transition:border linear 0.2s,box-shadow linear 0.2s;-o-transition:border linear 0.2s,box-shadow linear 0.2s;transition:border linear 0.2s,box-shadow linear 0.2s;} input:focus,textarea:focus{border-color:rgba(82, 168, 236, 0.8);-webkit-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075),0 0 8px rgba(82, 168, 236, 0.6);-moz-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075),0 0 8px rgba(82, 168, 236, 0.6);box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.075),0 0 8px rgba(82, 168, 236, 0.6);outline:0;outline:thin dotted \9;} input[type="file"]:focus,input[type="radio"]:focus,input[type="checkbox"]:focus,select:focus{-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none;outline:thin dotted #333;outline:5px auto -webkit-focus-ring-color;outline-offset:-2px;} .input-mini{width:60px;} .input-small{width:90px;} .input-medium{width:150px;} .input-large{width:210px;} .input-xlarge{width:270px;} .input-xxlarge{width:530px;} input[class*="span"],select[class*="span"],textarea[class*="span"],.uneditable-input{float:none;margin-left:0;} input.span1,textarea.span1,.uneditable-input.span1{width:50px;} input.span2,textarea.span2,.uneditable-input.span2{width:130px;} input.span3,textarea.span3,.uneditable-input.span3{width:210px;} input.span4,textarea.span4,.uneditable-input.span4{width:290px;} input.span5,textarea.span5,.uneditable-input.span5{width:370px;} input.span6,textarea.span6,.uneditable-input.span6{width:450px;} input.span7,textarea.span7,.uneditable-input.span7{width:530px;} input.span8,textarea.span8,.uneditable-input.span8{width:610px;} input.span9,textarea.span9,.uneditable-input.span9{width:690px;} input.span10,textarea.span10,.uneditable-input.span10{width:770px;} input.span11,textarea.span11,.uneditable-input.span11{width:850px;} input.span12,textarea.span12,.uneditable-input.span12{width:930px;} input[disabled],select[disabled],textarea[disabled],input[readonly],select[readonly],textarea[readonly]{background-color:#f5f5f5;border-color:#ddd;cursor:not-allowed;} .control-group.warning>label,.control-group.warning .help-block,.control-group.warning .help-inline{color:#c09853;} .control-group.warning input,.control-group.warning select,.control-group.warning textarea{color:#c09853;border-color:#c09853;}.control-group.warning input:focus,.control-group.warning select:focus,.control-group.warning textarea:focus{border-color:#a47e3c;-webkit-box-shadow:0 0 6px #dbc59e;-moz-box-shadow:0 0 6px #dbc59e;box-shadow:0 0 6px #dbc59e;} .control-group.warning .input-prepend .add-on,.control-group.warning .input-append .add-on{color:#c09853;background-color:#fcf8e3;border-color:#c09853;} .control-group.error>label,.control-group.error .help-block,.control-group.error .help-inline{color:#b94a48;} .control-group.error input,.control-group.error select,.control-group.error textarea{color:#b94a48;border-color:#b94a48;}.control-group.error input:focus,.control-group.error select:focus,.control-group.error textarea:focus{border-color:#953b39;-webkit-box-shadow:0 0 6px #d59392;-moz-box-shadow:0 0 6px #d59392;box-shadow:0 0 6px #d59392;} .control-group.error .input-prepend .add-on,.control-group.error .input-append .add-on{color:#b94a48;background-color:#f2dede;border-color:#b94a48;} .control-group.success>label,.control-group.success .help-block,.control-group.success .help-inline{color:#468847;} .control-group.success input,.control-group.success select,.control-group.success textarea{color:#468847;border-color:#468847;}.control-group.success input:focus,.control-group.success select:focus,.control-group.success textarea:focus{border-color:#356635;-webkit-box-shadow:0 0 6px #7aba7b;-moz-box-shadow:0 0 6px #7aba7b;box-shadow:0 0 6px #7aba7b;} .control-group.success .input-prepend .add-on,.control-group.success .input-append .add-on{color:#468847;background-color:#dff0d8;border-color:#468847;} input:focus:required:invalid,textarea:focus:required:invalid,select:focus:required:invalid{color:#b94a48;border-color:#ee5f5b;}input:focus:required:invalid:focus,textarea:focus:required:invalid:focus,select:focus:required:invalid:focus{border-color:#e9322d;-webkit-box-shadow:0 0 6px #f8b9b7;-moz-box-shadow:0 0 6px #f8b9b7;box-shadow:0 0 6px #f8b9b7;} .form-actions{padding:17px 20px 18px;margin-top:18px;margin-bottom:18px;background-color:#f5f5f5;border-top:1px solid #ddd;} .uneditable-input{display:block;background-color:#ffffff;border-color:#eee;-webkit-box-shadow:inset 0 1px 2px rgba(0, 0, 0, 0.025);-moz-box-shadow:inset 0 1px 2px rgba(0, 0, 0, 0.025);box-shadow:inset 0 1px 2px rgba(0, 0, 0, 0.025);cursor:not-allowed;} :-moz-placeholder{color:#999999;} ::-webkit-input-placeholder{color:#999999;} .help-block{display:block;margin-top:5px;margin-bottom:0;color:#999999;} .help-inline{display:inline-block;*display:inline;*zoom:1;margin-bottom:9px;vertical-align:middle;padding-left:5px;} .input-prepend,.input-append{margin-bottom:5px;*zoom:1;}.input-prepend:before,.input-append:before,.input-prepend:after,.input-append:after{display:table;content:"";} .input-prepend:after,.input-append:after{clear:both;} .input-prepend input,.input-append input,.input-prepend .uneditable-input,.input-append .uneditable-input{-webkit-border-radius:0 3px 3px 0;-moz-border-radius:0 3px 3px 0;border-radius:0 3px 3px 0;}.input-prepend input:focus,.input-append input:focus,.input-prepend .uneditable-input:focus,.input-append .uneditable-input:focus{position:relative;z-index:2;} .input-prepend .uneditable-input,.input-append .uneditable-input{border-left-color:#ccc;} .input-prepend .add-on,.input-append .add-on{float:left;display:block;width:auto;min-width:16px;height:18px;margin-right:-1px;padding:4px 5px;font-weight:normal;line-height:18px;color:#999999;text-align:center;text-shadow:0 1px 0 #ffffff;background-color:#f5f5f5;border:1px solid #ccc;-webkit-border-radius:3px 0 0 3px;-moz-border-radius:3px 0 0 3px;border-radius:3px 0 0 3px;} .input-prepend .active,.input-append .active{background-color:#a9dba9;border-color:#46a546;} .input-prepend .add-on{*margin-top:1px;} .input-append input,.input-append .uneditable-input{float:left;-webkit-border-radius:3px 0 0 3px;-moz-border-radius:3px 0 0 3px;border-radius:3px 0 0 3px;} .input-append .uneditable-input{border-left-color:#eee;border-right-color:#ccc;} .input-append .add-on{margin-right:0;margin-left:-1px;-webkit-border-radius:0 3px 3px 0;-moz-border-radius:0 3px 3px 0;border-radius:0 3px 3px 0;} .input-append input:first-child{*margin-left:-160px;}.input-append input:first-child+.add-on{*margin-left:-21px;} .search-query{padding-left:14px;padding-right:14px;margin-bottom:0;-webkit-border-radius:14px;-moz-border-radius:14px;border-radius:14px;} .form-search input,.form-inline input,.form-horizontal input,.form-search textarea,.form-inline textarea,.form-horizontal textarea,.form-search select,.form-inline select,.form-horizontal select,.form-search .help-inline,.form-inline .help-inline,.form-horizontal .help-inline,.form-search .uneditable-input,.form-inline .uneditable-input,.form-horizontal .uneditable-input{display:inline-block;margin-bottom:0;} .form-search .hide,.form-inline .hide,.form-horizontal .hide{display:none;} .form-search label,.form-inline label,.form-search .input-append,.form-inline .input-append,.form-search .input-prepend,.form-inline .input-prepend{display:inline-block;} .form-search .input-append .add-on,.form-inline .input-prepend .add-on,.form-search .input-append .add-on,.form-inline .input-prepend .add-on{vertical-align:middle;} .form-search .radio,.form-inline .radio,.form-search .checkbox,.form-inline .checkbox{margin-bottom:0;vertical-align:middle;} .control-group{margin-bottom:9px;} legend+.control-group{margin-top:18px;-webkit-margin-top-collapse:separate;} .form-horizontal .control-group{margin-bottom:18px;*zoom:1;}.form-horizontal .control-group:before,.form-horizontal .control-group:after{display:table;content:"";} .form-horizontal .control-group:after{clear:both;} .form-horizontal .control-label{float:left;width:140px;padding-top:5px;text-align:right;} .form-horizontal .controls{margin-left:160px;} .form-horizontal .form-actions{padding-left:160px;} table{max-width:100%;border-collapse:collapse;border-spacing:0;} .table{width:100%;margin-bottom:18px;}.table th,.table td{padding:8px;line-height:18px;text-align:left;vertical-align:top;border-top:1px solid #ddd;} .table th{font-weight:bold;} .table thead th{vertical-align:bottom;} .table thead:first-child tr th,.table thead:first-child tr td{border-top:0;} .table tbody+tbody{border-top:2px solid #ddd;} .table-condensed th,.table-condensed td{padding:4px 5px;} .table-bordered{border:1px solid #ddd;border-collapse:separate;*border-collapse:collapsed;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;}.table-bordered th+th,.table-bordered td+td,.table-bordered th+td,.table-bordered td+th{border-left:1px solid #ddd;} .table-bordered thead:first-child tr:first-child th,.table-bordered tbody:first-child tr:first-child th,.table-bordered tbody:first-child tr:first-child td{border-top:0;} .table-bordered thead:first-child tr:first-child th:first-child,.table-bordered tbody:first-child tr:first-child td:first-child{-webkit-border-radius:4px 0 0 0;-moz-border-radius:4px 0 0 0;border-radius:4px 0 0 0;} .table-bordered thead:first-child tr:first-child th:last-child,.table-bordered tbody:first-child tr:first-child td:last-child{-webkit-border-radius:0 4px 0 0;-moz-border-radius:0 4px 0 0;border-radius:0 4px 0 0;} .table-bordered thead:last-child tr:last-child th:first-child,.table-bordered tbody:last-child tr:last-child td:first-child{-webkit-border-radius:0 0 0 4px;-moz-border-radius:0 0 0 4px;border-radius:0 0 0 4px;} .table-bordered thead:last-child tr:last-child th:last-child,.table-bordered tbody:last-child tr:last-child td:last-child{-webkit-border-radius:0 0 4px 0;-moz-border-radius:0 0 4px 0;border-radius:0 0 4px 0;} .table-striped tbody tr:nth-child(odd) td,.table-striped tbody tr:nth-child(odd) th{background-color:#f9f9f9;} .table tbody tr:hover td,.table tbody tr:hover th{background-color:#f5f5f5;} table .span1{float:none;width:44px;margin-left:0;} table .span2{float:none;width:124px;margin-left:0;} table .span3{float:none;width:204px;margin-left:0;} table .span4{float:none;width:284px;margin-left:0;} table .span5{float:none;width:364px;margin-left:0;} table .span6{float:none;width:444px;margin-left:0;} table .span7{float:none;width:524px;margin-left:0;} table .span8{float:none;width:604px;margin-left:0;} table .span9{float:none;width:684px;margin-left:0;} table .span10{float:none;width:764px;margin-left:0;} table .span11{float:none;width:844px;margin-left:0;} table .span12{float:none;width:924px;margin-left:0;} [class^="icon-"],[class*=" icon-"]{display:inline-block;width:14px;height:14px;line-height:14px;vertical-align:text-top;background-image:url("../img/glyphicons-halflings.png");background-position:14px 14px;background-repeat:no-repeat;*margin-right:.3em;}[class^="icon-"]:last-child,[class*=" icon-"]:last-child{*margin-left:0;} .icon-white{background-image:url("../img/glyphicons-halflings-white.png");} .icon-glass{background-position:0 0;} .icon-music{background-position:-24px 0;} .icon-search{background-position:-48px 0;} .icon-envelope{background-position:-72px 0;} .icon-heart{background-position:-96px 0;} .icon-star{background-position:-120px 0;} .icon-star-empty{background-position:-144px 0;} .icon-user{background-position:-168px 0;} .icon-film{background-position:-192px 0;} .icon-th-large{background-position:-216px 0;} .icon-th{background-position:-240px 0;} .icon-th-list{background-position:-264px 0;} .icon-ok{background-position:-288px 0;} .icon-remove{background-position:-312px 0;} .icon-zoom-in{background-position:-336px 0;} .icon-zoom-out{background-position:-360px 0;} .icon-off{background-position:-384px 0;} .icon-signal{background-position:-408px 0;} .icon-cog{background-position:-432px 0;} .icon-trash{background-position:-456px 0;} .icon-home{background-position:0 -24px;} .icon-file{background-position:-24px -24px;} .icon-time{background-position:-48px -24px;} .icon-road{background-position:-72px -24px;} .icon-download-alt{background-position:-96px -24px;} .icon-download{background-position:-120px -24px;} .icon-upload{background-position:-144px -24px;} .icon-inbox{background-position:-168px -24px;} .icon-play-circle{background-position:-192px -24px;} .icon-repeat{background-position:-216px -24px;} .icon-refresh{background-position:-240px -24px;} .icon-list-alt{background-position:-264px -24px;} .icon-lock{background-position:-287px -24px;} .icon-flag{background-position:-312px -24px;} .icon-headphones{background-position:-336px -24px;} .icon-volume-off{background-position:-360px -24px;} .icon-volume-down{background-position:-384px -24px;} .icon-volume-up{background-position:-408px -24px;} .icon-qrcode{background-position:-432px -24px;} .icon-barcode{background-position:-456px -24px;} .icon-tag{background-position:0 -48px;} .icon-tags{background-position:-25px -48px;} .icon-book{background-position:-48px -48px;} .icon-bookmark{background-position:-72px -48px;} .icon-print{background-position:-96px -48px;} .icon-camera{background-position:-120px -48px;} .icon-font{background-position:-144px -48px;} .icon-bold{background-position:-167px -48px;} .icon-italic{background-position:-192px -48px;} .icon-text-height{background-position:-216px -48px;} .icon-text-width{background-position:-240px -48px;} .icon-align-left{background-position:-264px -48px;} .icon-align-center{background-position:-288px -48px;} .icon-align-right{background-position:-312px -48px;} .icon-align-justify{background-position:-336px -48px;} .icon-list{background-position:-360px -48px;} .icon-indent-left{background-position:-384px -48px;} .icon-indent-right{background-position:-408px -48px;} .icon-facetime-video{background-position:-432px -48px;} .icon-picture{background-position:-456px -48px;} .icon-pencil{background-position:0 -72px;} .icon-map-marker{background-position:-24px -72px;} .icon-adjust{background-position:-48px -72px;} .icon-tint{background-position:-72px -72px;} .icon-edit{background-position:-96px -72px;} .icon-share{background-position:-120px -72px;} .icon-check{background-position:-144px -72px;} .icon-move{background-position:-168px -72px;} .icon-step-backward{background-position:-192px -72px;} .icon-fast-backward{background-position:-216px -72px;} .icon-backward{background-position:-240px -72px;} .icon-play{background-position:-264px -72px;} .icon-pause{background-position:-288px -72px;} .icon-stop{background-position:-312px -72px;} .icon-forward{background-position:-336px -72px;} .icon-fast-forward{background-position:-360px -72px;} .icon-step-forward{background-position:-384px -72px;} .icon-eject{background-position:-408px -72px;} .icon-chevron-left{background-position:-432px -72px;} .icon-chevron-right{background-position:-456px -72px;} .icon-plus-sign{background-position:0 -96px;} .icon-minus-sign{background-position:-24px -96px;} .icon-remove-sign{background-position:-48px -96px;} .icon-ok-sign{background-position:-72px -96px;} .icon-question-sign{background-position:-96px -96px;} .icon-info-sign{background-position:-120px -96px;} .icon-screenshot{background-position:-144px -96px;} .icon-remove-circle{background-position:-168px -96px;} .icon-ok-circle{background-position:-192px -96px;} .icon-ban-circle{background-position:-216px -96px;} .icon-arrow-left{background-position:-240px -96px;} .icon-arrow-right{background-position:-264px -96px;} .icon-arrow-up{background-position:-289px -96px;} .icon-arrow-down{background-position:-312px -96px;} .icon-share-alt{background-position:-336px -96px;} .icon-resize-full{background-position:-360px -96px;} .icon-resize-small{background-position:-384px -96px;} .icon-plus{background-position:-408px -96px;} .icon-minus{background-position:-433px -96px;} .icon-asterisk{background-position:-456px -96px;} .icon-exclamation-sign{background-position:0 -120px;} .icon-gift{background-position:-24px -120px;} .icon-leaf{background-position:-48px -120px;} .icon-fire{background-position:-72px -120px;} .icon-eye-open{background-position:-96px -120px;} .icon-eye-close{background-position:-120px -120px;} .icon-warning-sign{background-position:-144px -120px;} .icon-plane{background-position:-168px -120px;} .icon-calendar{background-position:-192px -120px;} .icon-random{background-position:-216px -120px;} .icon-comment{background-position:-240px -120px;} .icon-magnet{background-position:-264px -120px;} .icon-chevron-up{background-position:-288px -120px;} .icon-chevron-down{background-position:-313px -119px;} .icon-retweet{background-position:-336px -120px;} .icon-shopping-cart{background-position:-360px -120px;} .icon-folder-close{background-position:-384px -120px;} .icon-folder-open{background-position:-408px -120px;} .icon-resize-vertical{background-position:-432px -119px;} .icon-resize-horizontal{background-position:-456px -118px;} .dropdown{position:relative;} .dropdown-toggle{*margin-bottom:-3px;} .dropdown-toggle:active,.open .dropdown-toggle{outline:0;} .caret{display:inline-block;width:0;height:0;text-indent:-99999px;*text-indent:0;vertical-align:top;border-left:4px solid transparent;border-right:4px solid transparent;border-top:4px solid #000000;opacity:0.3;filter:alpha(opacity=30);content:"\2193";} .dropdown .caret{margin-top:8px;margin-left:2px;} .dropdown:hover .caret,.open.dropdown .caret{opacity:1;filter:alpha(opacity=100);} .dropdown-menu{position:absolute;top:100%;left:0;z-index:1000;float:left;display:none;min-width:160px;_width:160px;padding:4px 0;margin:0;list-style:none;background-color:#ffffff;border-color:#ccc;border-color:rgba(0, 0, 0, 0.2);border-style:solid;border-width:1px;-webkit-border-radius:0 0 5px 5px;-moz-border-radius:0 0 5px 5px;border-radius:0 0 5px 5px;-webkit-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);-moz-box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);box-shadow:0 5px 10px rgba(0, 0, 0, 0.2);-webkit-background-clip:padding-box;-moz-background-clip:padding;background-clip:padding-box;*border-right-width:2px;*border-bottom-width:2px;}.dropdown-menu.bottom-up{top:auto;bottom:100%;margin-bottom:2px;} .dropdown-menu .divider{height:1px;margin:5px 1px;overflow:hidden;background-color:#e5e5e5;border-bottom:1px solid #ffffff;*width:100%;*margin:-5px 0 5px;} .dropdown-menu a{display:block;padding:3px 15px;clear:both;font-weight:normal;line-height:18px;color:#555555;white-space:nowrap;} .dropdown-menu li>a:hover,.dropdown-menu .active>a,.dropdown-menu .active>a:hover{color:#ffffff;text-decoration:none;background-color:#0088cc;} .dropdown.open{*z-index:1000;}.dropdown.open .dropdown-toggle{color:#ffffff;background:#ccc;background:rgba(0, 0, 0, 0.3);} .dropdown.open .dropdown-menu{display:block;} .typeahead{margin-top:2px;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;} .well{min-height:20px;padding:19px;margin-bottom:20px;background-color:#f5f5f5;border:1px solid #eee;border:1px solid rgba(0, 0, 0, 0.05);-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;-webkit-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.05);box-shadow:inset 0 1px 1px rgba(0, 0, 0, 0.05);}.well blockquote{border-color:#ddd;border-color:rgba(0, 0, 0, 0.15);} .fade{-webkit-transition:opacity 0.15s linear;-moz-transition:opacity 0.15s linear;-ms-transition:opacity 0.15s linear;-o-transition:opacity 0.15s linear;transition:opacity 0.15s linear;opacity:0;}.fade.in{opacity:1;} .collapse{-webkit-transition:height 0.35s ease;-moz-transition:height 0.35s ease;-ms-transition:height 0.35s ease;-o-transition:height 0.35s ease;transition:height 0.35s ease;position:relative;overflow:hidden;height:0;}.collapse.in{height:auto;} .close{float:right;font-size:20px;font-weight:bold;line-height:18px;color:#000000;text-shadow:0 1px 0 #ffffff;opacity:0.2;filter:alpha(opacity=20);}.close:hover{color:#000000;text-decoration:none;opacity:0.4;filter:alpha(opacity=40);cursor:pointer;} .btn{display:inline-block;padding:4px 10px 4px;margin-bottom:0;font-size:16px;line-height:18px;color:#606060;text-align:center;text-shadow:0 1px 1px rgba(255, 255, 255, 0.75);vertical-align:middle;background-color:#f5f5f5;background-image:-moz-linear-gradient(top, #ffffff, #e6e6e6);background-image:-ms-linear-gradient(top, #ffffff, #e6e6e6);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#ffffff), to(#e6e6e6));background-image:-webkit-linear-gradient(top, #ffffff, #e6e6e6);background-image:-o-linear-gradient(top, #ffffff, #e6e6e6);background-image:linear-gradient(top, #ffffff, #e6e6e6);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffff', endColorstr='#e6e6e6', GradientType=0);border-color:#e6e6e6 #e6e6e6 #bfbfbf;border-color:rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);border:1px solid #ccc;border-bottom-color:#bbb;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;-webkit-box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2),0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2),0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.2),0 1px 2px rgba(0, 0, 0, 0.05);cursor:pointer;filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);*margin-left:.3em;}.btn:hover,.btn:active,.btn.active,.btn.disabled,.btn[disabled]{background-color:#e6e6e6;} .btn:active,.btn.active{background-color:#cccccc \9;} .btn:first-child{*margin-left:0;} .btn:hover{color:#606060;text-decoration:none;background-color:#e6e6e6;background-position:0 -15px;-webkit-transition:background-position 0.1s linear;-moz-transition:background-position 0.1s linear;-ms-transition:background-position 0.1s linear;-o-transition:background-position 0.1s linear;transition:background-position 0.1s linear;} .btn:focus{outline:thin dotted #333;outline:5px auto -webkit-focus-ring-color;outline-offset:-2px;} .btn.active,.btn:active{background-image:none;-webkit-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15),0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15),0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 2px 4px rgba(0, 0, 0, 0.15),0 1px 2px rgba(0, 0, 0, 0.05);background-color:#e6e6e6;background-color:#d9d9d9 \9;outline:0;} .btn.disabled,.btn[disabled]{cursor:default;background-image:none;background-color:#e6e6e6;opacity:0.65;filter:alpha(opacity=65);-webkit-box-shadow:none;-moz-box-shadow:none;box-shadow:none;} .btn-large{padding:9px 14px;font-size:18px;line-height:normal;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;} .btn-large [class^="icon-"]{margin-top:1px;} .btn-small{padding:5px 9px;font-size:14px;line-height:16px;} .btn-small [class^="icon-"]{margin-top:-1px;} .btn-mini{padding:2px 6px;font-size:14px;line-height:14px;} .btn-primary,.btn-primary:hover,.btn-warning,.btn-warning:hover,.btn-danger,.btn-danger:hover,.btn-success,.btn-success:hover,.btn-info,.btn-info:hover,.btn-inverse,.btn-inverse:hover{text-shadow:0 -1px 0 rgba(0, 0, 0, 0.25);color:#ffffff;} .btn-primary.active,.btn-warning.active,.btn-danger.active,.btn-success.active,.btn-info.active,.btn-dark.active{color:rgba(255, 255, 255, 0.75);} .btn-primary{background-color:#006dcc;background-image:-moz-linear-gradient(top, #0088cc, #0044cc);background-image:-ms-linear-gradient(top, #0088cc, #0044cc);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#0088cc), to(#0044cc));background-image:-webkit-linear-gradient(top, #0088cc, #0044cc);background-image:-o-linear-gradient(top, #0088cc, #0044cc);background-image:linear-gradient(top, #0088cc, #0044cc);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#0088cc', endColorstr='#0044cc', GradientType=0);border-color:#0044cc #0044cc #002a80;border-color:rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);}.btn-primary:hover,.btn-primary:active,.btn-primary.active,.btn-primary.disabled,.btn-primary[disabled]{background-color:#0044cc;} .btn-primary:active,.btn-primary.active{background-color:#003399 \9;} .btn-warning{background-color:#faa732;background-image:-moz-linear-gradient(top, #fbb450, #f89406);background-image:-ms-linear-gradient(top, #fbb450, #f89406);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#fbb450), to(#f89406));background-image:-webkit-linear-gradient(top, #fbb450, #f89406);background-image:-o-linear-gradient(top, #fbb450, #f89406);background-image:linear-gradient(top, #fbb450, #f89406);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#fbb450', endColorstr='#f89406', GradientType=0);border-color:#f89406 #f89406 #ad6704;border-color:rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);}.btn-warning:hover,.btn-warning:active,.btn-warning.active,.btn-warning.disabled,.btn-warning[disabled]{background-color:#f89406;} .btn-warning:active,.btn-warning.active{background-color:#c67605 \9;} .btn-danger{background-color:#da4f49;background-image:-moz-linear-gradient(top, #ee5f5b, #bd362f);background-image:-ms-linear-gradient(top, #ee5f5b, #bd362f);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#ee5f5b), to(#bd362f));background-image:-webkit-linear-gradient(top, #ee5f5b, #bd362f);background-image:-o-linear-gradient(top, #ee5f5b, #bd362f);background-image:linear-gradient(top, #ee5f5b, #bd362f);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ee5f5b', endColorstr='#bd362f', GradientType=0);border-color:#bd362f #bd362f #802420;border-color:rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);}.btn-danger:hover,.btn-danger:active,.btn-danger.active,.btn-danger.disabled,.btn-danger[disabled]{background-color:#bd362f;} .btn-danger:active,.btn-danger.active{background-color:#942a25 \9;} .btn-success{background-color:#5bb75b;background-image:-moz-linear-gradient(top, #62c462, #51a351);background-image:-ms-linear-gradient(top, #62c462, #51a351);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#62c462), to(#51a351));background-image:-webkit-linear-gradient(top, #62c462, #51a351);background-image:-o-linear-gradient(top, #62c462, #51a351);background-image:linear-gradient(top, #62c462, #51a351);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#62c462', endColorstr='#51a351', GradientType=0);border-color:#51a351 #51a351 #387038;border-color:rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);}.btn-success:hover,.btn-success:active,.btn-success.active,.btn-success.disabled,.btn-success[disabled]{background-color:#51a351;} .btn-success:active,.btn-success.active{background-color:#408140 \9;} .btn-info{background-color:#49afcd;background-image:-moz-linear-gradient(top, #5bc0de, #2f96b4);background-image:-ms-linear-gradient(top, #5bc0de, #2f96b4);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#5bc0de), to(#2f96b4));background-image:-webkit-linear-gradient(top, #5bc0de, #2f96b4);background-image:-o-linear-gradient(top, #5bc0de, #2f96b4);background-image:linear-gradient(top, #5bc0de, #2f96b4);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#5bc0de', endColorstr='#2f96b4', GradientType=0);border-color:#2f96b4 #2f96b4 #1f6377;border-color:rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);}.btn-info:hover,.btn-info:active,.btn-info.active,.btn-info.disabled,.btn-info[disabled]{background-color:#2f96b4;} .btn-info:active,.btn-info.active{background-color:#24748c \9;} .btn-inverse{background-color:#393939;background-image:-moz-linear-gradient(top, #454545, #262626);background-image:-ms-linear-gradient(top, #454545, #262626);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#454545), to(#262626));background-image:-webkit-linear-gradient(top, #454545, #262626);background-image:-o-linear-gradient(top, #454545, #262626);background-image:linear-gradient(top, #454545, #262626);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#454545', endColorstr='#262626', GradientType=0);border-color:#262626 #262626 #000000;border-color:rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);}.btn-inverse:hover,.btn-inverse:active,.btn-inverse.active,.btn-inverse.disabled,.btn-inverse[disabled]{background-color:#262626;} .btn-inverse:active,.btn-inverse.active{background-color:#0c0c0c \9;} button.btn,input[type="submit"].btn{*padding-top:2px;*padding-bottom:2px;}button.btn::-moz-focus-inner,input[type="submit"].btn::-moz-focus-inner{padding:0;border:0;} button.btn.large,input[type="submit"].btn.large{*padding-top:7px;*padding-bottom:7px;} button.btn.small,input[type="submit"].btn.small{*padding-top:3px;*padding-bottom:3px;} .btn-group{position:relative;*zoom:1;*margin-left:.3em;}.btn-group:before,.btn-group:after{display:table;content:"";} .btn-group:after{clear:both;} .btn-group:first-child{*margin-left:0;} .btn-group+.btn-group{margin-left:5px;} .btn-toolbar{margin-top:9px;margin-bottom:9px;}.btn-toolbar .btn-group{display:inline-block;*display:inline;*zoom:1;} .btn-group .btn{position:relative;float:left;margin-left:-1px;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0;} .btn-group .btn:first-child{margin-left:0;-webkit-border-top-left-radius:4px;-moz-border-radius-topleft:4px;border-top-left-radius:4px;-webkit-border-bottom-left-radius:4px;-moz-border-radius-bottomleft:4px;border-bottom-left-radius:4px;} .btn-group .btn:last-child,.btn-group .dropdown-toggle{-webkit-border-top-right-radius:4px;-moz-border-radius-topright:4px;border-top-right-radius:4px;-webkit-border-bottom-right-radius:4px;-moz-border-radius-bottomright:4px;border-bottom-right-radius:4px;} .btn-group .btn.large:first-child{margin-left:0;-webkit-border-top-left-radius:6px;-moz-border-radius-topleft:6px;border-top-left-radius:6px;-webkit-border-bottom-left-radius:6px;-moz-border-radius-bottomleft:6px;border-bottom-left-radius:6px;} .btn-group .btn.large:last-child,.btn-group .large.dropdown-toggle{-webkit-border-top-right-radius:6px;-moz-border-radius-topright:6px;border-top-right-radius:6px;-webkit-border-bottom-right-radius:6px;-moz-border-radius-bottomright:6px;border-bottom-right-radius:6px;} .btn-group .btn:hover,.btn-group .btn:focus,.btn-group .btn:active,.btn-group .btn.active{z-index:2;} .btn-group .dropdown-toggle:active,.btn-group.open .dropdown-toggle{outline:0;} .btn-group .dropdown-toggle{padding-left:8px;padding-right:8px;-webkit-box-shadow:inset 1px 0 0 rgba(255, 255, 255, 0.125),inset 0 1px 0 rgba(255, 255, 255, 0.2),0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 1px 0 0 rgba(255, 255, 255, 0.125),inset 0 1px 0 rgba(255, 255, 255, 0.2),0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 1px 0 0 rgba(255, 255, 255, 0.125),inset 0 1px 0 rgba(255, 255, 255, 0.2),0 1px 2px rgba(0, 0, 0, 0.05);*padding-top:5px;*padding-bottom:5px;} .btn-group.open{*z-index:1000;}.btn-group.open .dropdown-menu{display:block;margin-top:1px;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;} .btn-group.open .dropdown-toggle{background-image:none;-webkit-box-shadow:inset 0 1px 6px rgba(0, 0, 0, 0.15),0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:inset 0 1px 6px rgba(0, 0, 0, 0.15),0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:inset 0 1px 6px rgba(0, 0, 0, 0.15),0 1px 2px rgba(0, 0, 0, 0.05);} .btn .caret{margin-top:7px;margin-left:0;} .btn:hover .caret,.open.btn-group .caret{opacity:1;filter:alpha(opacity=100);} .btn-primary .caret,.btn-danger .caret,.btn-info .caret,.btn-success .caret,.btn-inverse .caret{border-top-color:#ffffff;opacity:0.75;filter:alpha(opacity=75);} .btn-small .caret{margin-top:4px;} .alert{padding:8px 35px 8px 14px;margin-bottom:18px;text-shadow:0 1px 0 rgba(255, 255, 255, 0.5);background-color:#fcf8e3;border:1px solid #fbeed5;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;} .alert,.alert-heading{color:#c09853;} .alert .close{position:relative;top:-2px;right:-21px;line-height:18px;} .alert-success{background-color:#dff0d8;border-color:#d6e9c6;} .alert-success,.alert-success .alert-heading{color:#468847;} .alert-danger,.alert-error{background-color:#f2dede;border-color:#eed3d7;} .alert-danger,.alert-error,.alert-danger .alert-heading,.alert-error .alert-heading{color:#b94a48;} .alert-info{background-color:#d9edf7;border-color:#bce8f1;} .alert-info,.alert-info .alert-heading{color:#3a87ad;} .alert-block{padding-top:14px;padding-bottom:14px;} .alert-block>p,.alert-block>ul{margin-bottom:0;} .alert-block p+p{margin-top:5px;} .nav{margin-left:0;margin-bottom:18px;list-style:none;} .nav>li>a{display:block;} .nav>li>a:hover{text-decoration:none;background-color:#eeeeee;} .nav .nav-header{display:block;padding:3px 15px;font-size:11px;font-weight:bold;line-height:18px;color:#999999;text-shadow:0 1px 0 rgba(255, 255, 255, 0.5);text-transform:uppercase;} .nav li+.nav-header{margin-top:9px;} .nav-list{padding-left:14px;padding-right:14px;margin-bottom:0;} .nav-list>li>a,.nav-list .nav-header{margin-left:-15px;margin-right:-15px;text-shadow:0 1px 0 rgba(255, 255, 255, 0.5);} .nav-list>li>a{padding:3px 15px;} .nav-list .active>a,.nav-list .active>a:hover{color:#ffffff;text-shadow:0 -1px 0 rgba(0, 0, 0, 0.2);background-color:#0088cc;} .nav-list [class^="icon-"]{margin-right:2px;} .nav-tabs,.nav-pills{*zoom:1;}.nav-tabs:before,.nav-pills:before,.nav-tabs:after,.nav-pills:after{display:table;content:"";} .nav-tabs:after,.nav-pills:after{clear:both;} .nav-tabs>li,.nav-pills>li{float:left;} .nav-tabs>li>a,.nav-pills>li>a{padding-right:12px;padding-left:12px;margin-right:2px;line-height:14px;} .nav-tabs{border-bottom:1px solid #ddd;} .nav-tabs>li{margin-bottom:-1px;} .nav-tabs>li>a{padding-top:9px;padding-bottom:9px;border:1px solid transparent;-webkit-border-radius:4px 4px 0 0;-moz-border-radius:4px 4px 0 0;border-radius:4px 4px 0 0;}.nav-tabs>li>a:hover{border-color:#eeeeee #eeeeee #dddddd;} .nav-tabs>.active>a,.nav-tabs>.active>a:hover{color:#555555;background-color:#ffffff;border:1px solid #ddd;border-bottom-color:transparent;cursor:default;} .nav-pills>li>a{padding-top:8px;padding-bottom:8px;margin-top:2px;margin-bottom:2px;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;} .nav-pills .active>a,.nav-pills .active>a:hover{color:#ffffff;background-color:#0088cc;} .nav-stacked>li{float:none;} .nav-stacked>li>a{margin-right:0;} .nav-tabs.nav-stacked{border-bottom:0;} .nav-tabs.nav-stacked>li>a{border:1px solid #ddd;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0;} .nav-tabs.nav-stacked>li:first-child>a{-webkit-border-radius:4px 4px 0 0;-moz-border-radius:4px 4px 0 0;border-radius:4px 4px 0 0;} .nav-tabs.nav-stacked>li:last-child>a{-webkit-border-radius:0 0 4px 4px;-moz-border-radius:0 0 4px 4px;border-radius:0 0 4px 4px;} .nav-tabs.nav-stacked>li>a:hover{border-color:#ddd;z-index:2;} .nav-pills.nav-stacked>li>a{margin-bottom:3px;} .nav-pills.nav-stacked>li:last-child>a{margin-bottom:1px;} .nav-tabs .dropdown-menu,.nav-pills .dropdown-menu{margin-top:1px;border-width:1px;} .nav-pills .dropdown-menu{-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;} .nav-tabs .dropdown-toggle .caret,.nav-pills .dropdown-toggle .caret{border-top-color:#0088cc;margin-top:6px;} .nav-tabs .dropdown-toggle:hover .caret,.nav-pills .dropdown-toggle:hover .caret{border-top-color:#005580;} .nav-tabs .active .dropdown-toggle .caret,.nav-pills .active .dropdown-toggle .caret{border-top-color:#606060;} .nav>.dropdown.active>a:hover{color:#000000;cursor:pointer;} .nav-tabs .open .dropdown-toggle,.nav-pills .open .dropdown-toggle,.nav>.open.active>a:hover{color:#ffffff;background-color:#999999;border-color:#999999;} .nav .open .caret,.nav .open.active .caret,.nav .open a:hover .caret{border-top-color:#ffffff;opacity:1;filter:alpha(opacity=100);} .tabs-stacked .open>a:hover{border-color:#999999;} .tabbable{*zoom:1;}.tabbable:before,.tabbable:after{display:table;content:"";} .tabbable:after{clear:both;} .tab-content{overflow:hidden;} .tabs-below .nav-tabs,.tabs-right .nav-tabs,.tabs-left .nav-tabs{border-bottom:0;} .tab-content>.tab-pane,.pill-content>.pill-pane{display:none;} .tab-content>.active,.pill-content>.active{display:block;} .tabs-below .nav-tabs{border-top:1px solid #ddd;} .tabs-below .nav-tabs>li{margin-top:-1px;margin-bottom:0;} .tabs-below .nav-tabs>li>a{-webkit-border-radius:0 0 4px 4px;-moz-border-radius:0 0 4px 4px;border-radius:0 0 4px 4px;}.tabs-below .nav-tabs>li>a:hover{border-bottom-color:transparent;border-top-color:#ddd;} .tabs-below .nav-tabs .active>a,.tabs-below .nav-tabs .active>a:hover{border-color:transparent #ddd #ddd #ddd;} .tabs-left .nav-tabs>li,.tabs-right .nav-tabs>li{float:none;} .tabs-left .nav-tabs>li>a,.tabs-right .nav-tabs>li>a{min-width:74px;margin-right:0;margin-bottom:3px;} .tabs-left .nav-tabs{float:left;margin-right:19px;border-right:1px solid #ddd;} .tabs-left .nav-tabs>li>a{margin-right:-1px;-webkit-border-radius:4px 0 0 4px;-moz-border-radius:4px 0 0 4px;border-radius:4px 0 0 4px;} .tabs-left .nav-tabs>li>a:hover{border-color:#eeeeee #dddddd #eeeeee #eeeeee;} .tabs-left .nav-tabs .active>a,.tabs-left .nav-tabs .active>a:hover{border-color:#ddd transparent #ddd #ddd;*border-right-color:#ffffff;} .tabs-right .nav-tabs{float:right;margin-left:19px;border-left:1px solid #ddd;} .tabs-right .nav-tabs>li>a{margin-left:-1px;-webkit-border-radius:0 4px 4px 0;-moz-border-radius:0 4px 4px 0;border-radius:0 4px 4px 0;} .tabs-right .nav-tabs>li>a:hover{border-color:#eeeeee #eeeeee #eeeeee #dddddd;} .tabs-right .nav-tabs .active>a,.tabs-right .nav-tabs .active>a:hover{border-color:#ddd #ddd #ddd transparent;*border-left-color:#ffffff;} .navbar{overflow:visible;margin-bottom:18px;} .navbar-inner{padding-left:20px;padding-right:20px;background-color:#474747;background-image:-moz-linear-gradient(top, #606060, #222222);background-image:-ms-linear-gradient(top, #606060, #222222);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#606060), to(#222222));background-image:-webkit-linear-gradient(top, #606060, #222222);background-image:-o-linear-gradient(top, #606060, #222222);background-image:linear-gradient(top, #606060, #222222);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#606060', endColorstr='#222222', GradientType=0);-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;-webkit-box-shadow:0 1px 3px rgba(0, 0, 0, 0.25),inset 0 -1px 0 rgba(0, 0, 0, 0.1);-moz-box-shadow:0 1px 3px rgba(0, 0, 0, 0.25),inset 0 -1px 0 rgba(0, 0, 0, 0.1);box-shadow:0 1px 3px rgba(0, 0, 0, 0.25),inset 0 -1px 0 rgba(0, 0, 0, 0.1);} .btn-navbar{display:none;float:right;padding:7px 10px;margin-left:5px;margin-right:5px;background-color:#474747;background-image:-moz-linear-gradient(top, #606060, #222222);background-image:-ms-linear-gradient(top, #606060, #222222);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#606060), to(#222222));background-image:-webkit-linear-gradient(top, #606060, #222222);background-image:-o-linear-gradient(top, #606060, #222222);background-image:linear-gradient(top, #606060, #222222);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#606060', endColorstr='#222222', GradientType=0);border-color:#222222 #222222 #000000;border-color:rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.1) rgba(0, 0, 0, 0.25);filter:progid:DXImageTransform.Microsoft.gradient(enabled = false);-webkit-box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.1),0 1px 0 rgba(255, 255, 255, 0.075);-moz-box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.1),0 1px 0 rgba(255, 255, 255, 0.075);box-shadow:inset 0 1px 0 rgba(255, 255, 255, 0.1),0 1px 0 rgba(255, 255, 255, 0.075);}.btn-navbar:hover,.btn-navbar:active,.btn-navbar.active,.btn-navbar.disabled,.btn-navbar[disabled]{background-color:#222222;} .btn-navbar:active,.btn-navbar.active{background-color:#080808 \9;} .btn-navbar .icon-bar{display:block;width:18px;height:2px;background-color:#f5f5f5;-webkit-border-radius:1px;-moz-border-radius:1px;border-radius:1px;-webkit-box-shadow:0 1px 0 rgba(0, 0, 0, 0.25);-moz-box-shadow:0 1px 0 rgba(0, 0, 0, 0.25);box-shadow:0 1px 0 rgba(0, 0, 0, 0.25);} .btn-navbar .icon-bar+.icon-bar{margin-top:3px;} .nav-collapse.collapse{height:auto;} .navbar .brand:hover{text-decoration:none;} .navbar .brand{float:left;display:block;padding:8px 20px 12px;margin-left:-20px;font-size:20px;font-weight:200;line-height:1;color:#ffffff;} .navbar .navbar-text{margin-bottom:0;line-height:40px;color:#999999;}.navbar .navbar-text a:hover{color:#ffffff;background-color:transparent;} .navbar .btn,.navbar .btn-group{margin-top:5px;} .navbar .btn-group .btn{margin-top:0;} .navbar-form{margin-bottom:0;*zoom:1;}.navbar-form:before,.navbar-form:after{display:table;content:"";} .navbar-form:after{clear:both;} .navbar-form input,.navbar-form select{display:inline-block;margin-top:5px;margin-bottom:0;} .navbar-form .radio,.navbar-form .checkbox{margin-top:5px;} .navbar-form input[type="image"],.navbar-form input[type="checkbox"],.navbar-form input[type="radio"]{margin-top:3px;} .navbar-form .input-append,.navbar-form .input-prepend{margin-top:6px;white-space:nowrap;}.navbar-form .input-append input,.navbar-form .input-prepend input{margin-top:0;} .navbar-search{position:relative;float:left;margin-top:6px;margin-bottom:0;}.navbar-search .search-query{padding:4px 9px;font-family:"Helvetica Neue",Helvetica,Arial,sans-serif;font-size:13px;font-weight:normal;line-height:1;color:#ffffff;color:rgba(255, 255, 255, 0.75);background:#666;background:rgba(255, 255, 255, 0.3);border:1px solid #111;-webkit-box-shadow:inset 0 1px 2px rgba(0, 0, 0, 0.1),0 1px 0px rgba(255, 255, 255, 0.15);-moz-box-shadow:inset 0 1px 2px rgba(0, 0, 0, 0.1),0 1px 0px rgba(255, 255, 255, 0.15);box-shadow:inset 0 1px 2px rgba(0, 0, 0, 0.1),0 1px 0px rgba(255, 255, 255, 0.15);-webkit-transition:none;-moz-transition:none;-ms-transition:none;-o-transition:none;transition:none;}.navbar-search .search-query :-moz-placeholder{color:#eeeeee;} .navbar-search .search-query ::-webkit-input-placeholder{color:#eeeeee;} .navbar-search .search-query:hover{color:#ffffff;background-color:#999999;background-color:rgba(255, 255, 255, 0.5);} .navbar-search .search-query:focus,.navbar-search .search-query.focused{padding:5px 10px;color:#606060;text-shadow:0 1px 0 #ffffff;background-color:#ffffff;border:0;-webkit-box-shadow:0 0 3px rgba(0, 0, 0, 0.15);-moz-box-shadow:0 0 3px rgba(0, 0, 0, 0.15);box-shadow:0 0 3px rgba(0, 0, 0, 0.15);outline:0;} .navbar-fixed-top{position:fixed;top:0;right:0;left:0;z-index:1030;} .navbar-fixed-top .navbar-inner{padding-left:0;padding-right:0;-webkit-border-radius:0;-moz-border-radius:0;border-radius:0;} .navbar .nav{position:relative;left:0;display:block;float:left;margin:0 10px 0 0;} .navbar .nav.pull-right{float:right;} .navbar .nav>li{display:block;float:left;} .navbar .nav>li>a{float:none;padding:10px 10px 11px;line-height:19px;color:#999999;text-decoration:none;text-shadow:0 -1px 0 rgba(0, 0, 0, 0.25);} .navbar .nav>li>a:hover{background-color:transparent;color:#ffffff;text-decoration:none;} .navbar .nav .active>a,.navbar .nav .active>a:hover{color:#ffffff;text-decoration:none;background-color:#222222;} .navbar .divider-vertical{height:40px;width:1px;margin:0 9px;overflow:hidden;background-color:#222222;border-right:1px solid #606060;} .navbar .nav.pull-right{margin-left:10px;margin-right:0;} .navbar .dropdown-menu{margin-top:1px;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;}.navbar .dropdown-menu:before{content:'';display:inline-block;border-left:7px solid transparent;border-right:7px solid transparent;border-bottom:7px solid #ccc;border-bottom-color:rgba(0, 0, 0, 0.2);position:absolute;top:-7px;left:9px;} .navbar .dropdown-menu:after{content:'';display:inline-block;border-left:6px solid transparent;border-right:6px solid transparent;border-bottom:6px solid #ffffff;position:absolute;top:-6px;left:10px;} .navbar .nav .dropdown-toggle .caret,.navbar .nav .open.dropdown .caret{border-top-color:#ffffff;} .navbar .nav .active .caret{opacity:1;filter:alpha(opacity=100);} .navbar .nav .open>.dropdown-toggle,.navbar .nav .active>.dropdown-toggle,.navbar .nav .open.active>.dropdown-toggle{background-color:transparent;} .navbar .nav .active>.dropdown-toggle:hover{color:#ffffff;} .navbar .nav.pull-right .dropdown-menu{left:auto;right:0;}.navbar .nav.pull-right .dropdown-menu:before{left:auto;right:12px;} .navbar .nav.pull-right .dropdown-menu:after{left:auto;right:13px;} .breadcrumb{padding:7px 14px;margin:0 0 18px;background-color:#fbfbfb;background-image:-moz-linear-gradient(top, #ffffff, #f5f5f5);background-image:-ms-linear-gradient(top, #ffffff, #f5f5f5);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#ffffff), to(#f5f5f5));background-image:-webkit-linear-gradient(top, #ffffff, #f5f5f5);background-image:-o-linear-gradient(top, #ffffff, #f5f5f5);background-image:linear-gradient(top, #ffffff, #f5f5f5);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ffffff', endColorstr='#f5f5f5', GradientType=0);border:1px solid #ddd;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;-webkit-box-shadow:inset 0 1px 0 #ffffff;-moz-box-shadow:inset 0 1px 0 #ffffff;box-shadow:inset 0 1px 0 #ffffff;}.breadcrumb li{display:inline-block;text-shadow:0 1px 0 #ffffff;} .breadcrumb .divider{padding:0 5px;color:#999999;} .breadcrumb .active a{color:#606060;} .pagination{height:36px;margin:18px 0;} .pagination ul{display:inline-block;*display:inline;*zoom:1;margin-left:0;margin-bottom:0;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;-webkit-box-shadow:0 1px 2px rgba(0, 0, 0, 0.05);-moz-box-shadow:0 1px 2px rgba(0, 0, 0, 0.05);box-shadow:0 1px 2px rgba(0, 0, 0, 0.05);} .pagination li{display:inline;} .pagination a{float:left;padding:0 14px;line-height:34px;text-decoration:none;border:1px solid #ddd;border-left-width:0;} .pagination a:hover,.pagination .active a{background-color:#f5f5f5;} .pagination .active a{color:#999999;cursor:default;} .pagination .disabled a,.pagination .disabled a:hover{color:#999999;background-color:transparent;cursor:default;} .pagination li:first-child a{border-left-width:1px;-webkit-border-radius:3px 0 0 3px;-moz-border-radius:3px 0 0 3px;border-radius:3px 0 0 3px;} .pagination li:last-child a{-webkit-border-radius:0 3px 3px 0;-moz-border-radius:0 3px 3px 0;border-radius:0 3px 3px 0;} .pagination-centered{text-align:center;} .pagination-right{text-align:right;} .pager{margin-left:0;margin-bottom:18px;list-style:none;text-align:center;*zoom:1;}.pager:before,.pager:after{display:table;content:"";} .pager:after{clear:both;} .pager li{display:inline;} .pager a{display:inline-block;padding:5px 14px;background-color:#fff;border:1px solid #ddd;-webkit-border-radius:15px;-moz-border-radius:15px;border-radius:15px;} .pager a:hover{text-decoration:none;background-color:#f5f5f5;} .pager .next a{float:right;} .pager .previous a{float:left;} .modal-open .dropdown-menu{z-index:2050;} .modal-open .dropdown.open{*z-index:2050;} .modal-open .popover{z-index:2060;} .modal-open .tooltip{z-index:2070;} .modal-backdrop{position:fixed;top:0;right:0;bottom:0;left:0;z-index:1040;background-color:#000000;}.modal-backdrop.fade{opacity:0;} .modal-backdrop,.modal-backdrop.fade.in{opacity:0.8;filter:alpha(opacity=80);} .modal{position:fixed;top:50%;left:50%;z-index:1050;max-height:500px;overflow:auto;width:560px;margin:-250px 0 0 -280px;background-color:#ffffff;border:1px solid #999;border:1px solid rgba(0, 0, 0, 0.3);*border:1px solid #999;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;-webkit-box-shadow:0 3px 7px rgba(0, 0, 0, 0.3);-moz-box-shadow:0 3px 7px rgba(0, 0, 0, 0.3);box-shadow:0 3px 7px rgba(0, 0, 0, 0.3);-webkit-background-clip:padding-box;-moz-background-clip:padding-box;background-clip:padding-box;}.modal.fade{-webkit-transition:opacity .3s linear, top .3s ease-out;-moz-transition:opacity .3s linear, top .3s ease-out;-ms-transition:opacity .3s linear, top .3s ease-out;-o-transition:opacity .3s linear, top .3s ease-out;transition:opacity .3s linear, top .3s ease-out;top:-25%;} .modal.fade.in{top:50%;} .modal-header{padding:9px 15px;border-bottom:1px solid #eee;}.modal-header .close{margin-top:2px;} .modal-body{padding:15px;} .modal-body .modal-form{margin-bottom:0;} .modal-footer{padding:14px 15px 15px;margin-bottom:0;background-color:#f5f5f5;border-top:1px solid #ddd;-webkit-border-radius:0 0 6px 6px;-moz-border-radius:0 0 6px 6px;border-radius:0 0 6px 6px;-webkit-box-shadow:inset 0 1px 0 #ffffff;-moz-box-shadow:inset 0 1px 0 #ffffff;box-shadow:inset 0 1px 0 #ffffff;*zoom:1;}.modal-footer:before,.modal-footer:after{display:table;content:"";} .modal-footer:after{clear:both;} .modal-footer .btn{float:right;margin-left:5px;margin-bottom:0;} .tooltip{position:absolute;z-index:1020;display:block;visibility:visible;padding:5px;font-size:11px;opacity:0;filter:alpha(opacity=0);}.tooltip.in{opacity:0.8;filter:alpha(opacity=80);} .tooltip.top{margin-top:-2px;} .tooltip.right{margin-left:2px;} .tooltip.bottom{margin-top:2px;} .tooltip.left{margin-left:-2px;} .tooltip.top .tooltip-arrow{bottom:0;left:50%;margin-left:-5px;border-left:5px solid transparent;border-right:5px solid transparent;border-top:5px solid #000000;} .tooltip.left .tooltip-arrow{top:50%;right:0;margin-top:-5px;border-top:5px solid transparent;border-bottom:5px solid transparent;border-left:5px solid #000000;} .tooltip.bottom .tooltip-arrow{top:0;left:50%;margin-left:-5px;border-left:5px solid transparent;border-right:5px solid transparent;border-bottom:5px solid #000000;} .tooltip.right .tooltip-arrow{top:50%;left:0;margin-top:-5px;border-top:5px solid transparent;border-bottom:5px solid transparent;border-right:5px solid #000000;} .tooltip-inner{max-width:200px;padding:3px 8px;color:#ffffff;text-align:center;text-decoration:none;background-color:#000000;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;} .tooltip-arrow{position:absolute;width:0;height:0;} .popover{position:absolute;top:0;left:0;z-index:1010;display:none;padding:5px;}.popover.top{margin-top:-5px;} .popover.right{margin-left:5px;} .popover.bottom{margin-top:5px;} .popover.left{margin-left:-5px;} .popover.top .arrow{bottom:0;left:50%;margin-left:-5px;border-left:5px solid transparent;border-right:5px solid transparent;border-top:5px solid #000000;} .popover.right .arrow{top:50%;left:0;margin-top:-5px;border-top:5px solid transparent;border-bottom:5px solid transparent;border-right:5px solid #000000;} .popover.bottom .arrow{top:0;left:50%;margin-left:-5px;border-left:5px solid transparent;border-right:5px solid transparent;border-bottom:5px solid #000000;} .popover.left .arrow{top:50%;right:0;margin-top:-5px;border-top:5px solid transparent;border-bottom:5px solid transparent;border-left:5px solid #000000;} .popover .arrow{position:absolute;width:0;height:0;} .popover-inner{padding:3px;width:280px;overflow:hidden;background:#000000;background:rgba(0, 0, 0, 0.8);-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;-webkit-box-shadow:0 3px 7px rgba(0, 0, 0, 0.3);-moz-box-shadow:0 3px 7px rgba(0, 0, 0, 0.3);box-shadow:0 3px 7px rgba(0, 0, 0, 0.3);} .popover-title{padding:9px 15px;line-height:1;background-color:#f5f5f5;border-bottom:1px solid #eee;-webkit-border-radius:3px 3px 0 0;-moz-border-radius:3px 3px 0 0;border-radius:3px 3px 0 0;} .popover-content{padding:14px;background-color:#ffffff;-webkit-border-radius:0 0 3px 3px;-moz-border-radius:0 0 3px 3px;border-radius:0 0 3px 3px;-webkit-background-clip:padding-box;-moz-background-clip:padding-box;background-clip:padding-box;}.popover-content p,.popover-content ul,.popover-content ol{margin-bottom:0;} .thumbnails{margin-left:-20px;list-style:none;*zoom:1;}.thumbnails:before,.thumbnails:after{display:table;content:"";} .thumbnails:after{clear:both;} .thumbnails>li{float:left;margin:0 0 18px 20px;} .thumbnail{display:block;padding:4px;line-height:1;border:1px solid #ddd;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;-webkit-box-shadow:0 1px 1px rgba(0, 0, 0, 0.075);-moz-box-shadow:0 1px 1px rgba(0, 0, 0, 0.075);box-shadow:0 1px 1px rgba(0, 0, 0, 0.075);} a.thumbnail:hover{border-color:#0088cc;-webkit-box-shadow:0 1px 4px rgba(0, 105, 214, 0.25);-moz-box-shadow:0 1px 4px rgba(0, 105, 214, 0.25);box-shadow:0 1px 4px rgba(0, 105, 214, 0.25);} .thumbnail>img{display:block;max-width:100%;margin-left:auto;margin-right:auto;} .thumbnail .caption{padding:9px;} .label{padding:2px 4px 3px;font-size:13.6px;font-weight:bold;color:#ffffff;text-shadow:0 -1px 0 rgba(0, 0, 0, 0.25);background-color:#999999;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;} .label:hover{color:#ffffff;text-decoration:none;} .label-important{background-color:#b94a48;} .label-important:hover{background-color:#953b39;} .label-warning{background-color:#f89406;} .label-warning:hover{background-color:#c67605;} .label-success{background-color:#468847;} .label-success:hover{background-color:#356635;} .label-info{background-color:#3a87ad;} .label-info:hover{background-color:#2d6987;} @-webkit-keyframes progress-bar-stripes{from{background-position:0 0;} to{background-position:40px 0;}}@-moz-keyframes progress-bar-stripes{from{background-position:0 0;} to{background-position:40px 0;}}@keyframes progress-bar-stripes{from{background-position:0 0;} to{background-position:40px 0;}}.progress{overflow:hidden;height:18px;margin-bottom:18px;background-color:#f7f7f7;background-image:-moz-linear-gradient(top, #f5f5f5, #f9f9f9);background-image:-ms-linear-gradient(top, #f5f5f5, #f9f9f9);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#f5f5f5), to(#f9f9f9));background-image:-webkit-linear-gradient(top, #f5f5f5, #f9f9f9);background-image:-o-linear-gradient(top, #f5f5f5, #f9f9f9);background-image:linear-gradient(top, #f5f5f5, #f9f9f9);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#f5f5f5', endColorstr='#f9f9f9', GradientType=0);-webkit-box-shadow:inset 0 1px 2px rgba(0, 0, 0, 0.1);-moz-box-shadow:inset 0 1px 2px rgba(0, 0, 0, 0.1);box-shadow:inset 0 1px 2px rgba(0, 0, 0, 0.1);-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;} .progress .bar{width:0%;height:18px;color:#ffffff;font-size:12px;text-align:center;text-shadow:0 -1px 0 rgba(0, 0, 0, 0.25);background-color:#0e90d2;background-image:-moz-linear-gradient(top, #149bdf, #0480be);background-image:-ms-linear-gradient(top, #149bdf, #0480be);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#149bdf), to(#0480be));background-image:-webkit-linear-gradient(top, #149bdf, #0480be);background-image:-o-linear-gradient(top, #149bdf, #0480be);background-image:linear-gradient(top, #149bdf, #0480be);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#149bdf', endColorstr='#0480be', GradientType=0);-webkit-box-shadow:inset 0 -1px 0 rgba(0, 0, 0, 0.15);-moz-box-shadow:inset 0 -1px 0 rgba(0, 0, 0, 0.15);box-shadow:inset 0 -1px 0 rgba(0, 0, 0, 0.15);-webkit-box-sizing:border-box;-moz-box-sizing:border-box;box-sizing:border-box;-webkit-transition:width 0.6s ease;-moz-transition:width 0.6s ease;-ms-transition:width 0.6s ease;-o-transition:width 0.6s ease;transition:width 0.6s ease;} .progress-striped .bar{background-color:#62c462;background-image:-webkit-gradient(linear, 0 100%, 100% 0, color-stop(0.25, rgba(255, 255, 255, 0.15)), color-stop(0.25, transparent), color-stop(0.5, transparent), color-stop(0.5, rgba(255, 255, 255, 0.15)), color-stop(0.75, rgba(255, 255, 255, 0.15)), color-stop(0.75, transparent), to(transparent));background-image:-webkit-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:-moz-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:-ms-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:-o-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);-webkit-background-size:40px 40px;-moz-background-size:40px 40px;-o-background-size:40px 40px;background-size:40px 40px;} .progress.active .bar{-webkit-animation:progress-bar-stripes 2s linear infinite;-moz-animation:progress-bar-stripes 2s linear infinite;animation:progress-bar-stripes 2s linear infinite;} .progress-danger .bar{background-color:#dd514c;background-image:-moz-linear-gradient(top, #ee5f5b, #c43c35);background-image:-ms-linear-gradient(top, #ee5f5b, #c43c35);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#ee5f5b), to(#c43c35));background-image:-webkit-linear-gradient(top, #ee5f5b, #c43c35);background-image:-o-linear-gradient(top, #ee5f5b, #c43c35);background-image:linear-gradient(top, #ee5f5b, #c43c35);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#ee5f5b', endColorstr='#c43c35', GradientType=0);} .progress-danger.progress-striped .bar{background-color:#ee5f5b;background-image:-webkit-gradient(linear, 0 100%, 100% 0, color-stop(0.25, rgba(255, 255, 255, 0.15)), color-stop(0.25, transparent), color-stop(0.5, transparent), color-stop(0.5, rgba(255, 255, 255, 0.15)), color-stop(0.75, rgba(255, 255, 255, 0.15)), color-stop(0.75, transparent), to(transparent));background-image:-webkit-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:-moz-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:-ms-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:-o-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);} .progress-success .bar{background-color:#5eb95e;background-image:-moz-linear-gradient(top, #62c462, #57a957);background-image:-ms-linear-gradient(top, #62c462, #57a957);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#62c462), to(#57a957));background-image:-webkit-linear-gradient(top, #62c462, #57a957);background-image:-o-linear-gradient(top, #62c462, #57a957);background-image:linear-gradient(top, #62c462, #57a957);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#62c462', endColorstr='#57a957', GradientType=0);} .progress-success.progress-striped .bar{background-color:#62c462;background-image:-webkit-gradient(linear, 0 100%, 100% 0, color-stop(0.25, rgba(255, 255, 255, 0.15)), color-stop(0.25, transparent), color-stop(0.5, transparent), color-stop(0.5, rgba(255, 255, 255, 0.15)), color-stop(0.75, rgba(255, 255, 255, 0.15)), color-stop(0.75, transparent), to(transparent));background-image:-webkit-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:-moz-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:-ms-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:-o-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);} .progress-info .bar{background-color:#4bb1cf;background-image:-moz-linear-gradient(top, #5bc0de, #339bb9);background-image:-ms-linear-gradient(top, #5bc0de, #339bb9);background-image:-webkit-gradient(linear, 0 0, 0 100%, from(#5bc0de), to(#339bb9));background-image:-webkit-linear-gradient(top, #5bc0de, #339bb9);background-image:-o-linear-gradient(top, #5bc0de, #339bb9);background-image:linear-gradient(top, #5bc0de, #339bb9);background-repeat:repeat-x;filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#5bc0de', endColorstr='#339bb9', GradientType=0);} .progress-info.progress-striped .bar{background-color:#5bc0de;background-image:-webkit-gradient(linear, 0 100%, 100% 0, color-stop(0.25, rgba(255, 255, 255, 0.15)), color-stop(0.25, transparent), color-stop(0.5, transparent), color-stop(0.5, rgba(255, 255, 255, 0.15)), color-stop(0.75, rgba(255, 255, 255, 0.15)), color-stop(0.75, transparent), to(transparent));background-image:-webkit-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:-moz-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:-ms-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:-o-linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);background-image:linear-gradient(-45deg, rgba(255, 255, 255, 0.15) 25%, transparent 25%, transparent 50%, rgba(255, 255, 255, 0.15) 50%, rgba(255, 255, 255, 0.15) 75%, transparent 75%, transparent);} .accordion{margin-bottom:18px;} .accordion-group{margin-bottom:2px;border:1px solid #e5e5e5;-webkit-border-radius:4px;-moz-border-radius:4px;border-radius:4px;} .accordion-heading{border-bottom:0;} .accordion-heading .accordion-toggle{display:block;padding:8px 15px;} .accordion-inner{padding:9px 15px;border-top:1px solid #e5e5e5;} .carousel{position:relative;margin-bottom:18px;line-height:1;} .carousel-inner{overflow:hidden;width:100%;position:relative;} .carousel .item{display:none;position:relative;-webkit-transition:0.6s ease-in-out left;-moz-transition:0.6s ease-in-out left;-ms-transition:0.6s ease-in-out left;-o-transition:0.6s ease-in-out left;transition:0.6s ease-in-out left;} .carousel .item>img{display:block;line-height:1;} .carousel .active,.carousel .next,.carousel .prev{display:block;} .carousel .active{left:0;} .carousel .next,.carousel .prev{position:absolute;top:0;width:100%;} .carousel .next{left:100%;} .carousel .prev{left:-100%;} .carousel .next.left,.carousel .prev.right{left:0;} .carousel .active.left{left:-100%;} .carousel .active.right{left:100%;} .carousel-control{position:absolute;top:40%;left:15px;width:40px;height:40px;margin-top:-20px;font-size:60px;font-weight:100;line-height:30px;color:#ffffff;text-align:center;background:#222222;border:3px solid #ffffff;-webkit-border-radius:23px;-moz-border-radius:23px;border-radius:23px;opacity:0.5;filter:alpha(opacity=50);}.carousel-control.right{left:auto;right:15px;} .carousel-control:hover{color:#ffffff;text-decoration:none;opacity:0.9;filter:alpha(opacity=90);} .carousel-caption{position:absolute;left:0;right:0;bottom:0;padding:10px 15px 5px;background:#606060;background:rgba(0, 0, 0, 0.75);} .carousel-caption h4,.carousel-caption p{color:#ffffff;} .hero-unit{padding:60px;margin-bottom:30px;background-color:#f5f5f5;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;}.hero-unit h1{margin-bottom:0;font-size:60px;line-height:1;letter-spacing:-1px;} .hero-unit p{font-size:18px;font-weight:200;line-height:27px;} .pull-right{float:right;} .pull-left{float:left;} .hide{display:none;} .show{display:block;} .invisible{visibility:hidden;} ;T; @3I"/assets/css/application/;T{;{;I"�body{padding-top:60px;background-position-y:40px}.content{background:#fff;padding:0 1em;box-shadow:0 1px 10px rgba(0,0,0,0.25)}.article-nav{float:right;width:250px;margin:0 0 2em 2em;padding:.5em auto}.news{background:#fff;margin:1em}.tweet_list li{list-style:none;border-top:1px solid #eee;padding:5px 0;font-size:9pt}.tweet_list li.tweet_first{border-style:none}.tweet_list li img{float:left;margin:0 5px 2px 0}.tweet_list{margin:0}.grad1{background:#F9FCFC;background:-moz-linear-gradient(top,rgba(249,252,252,1) 0,rgba(237,245,245,1) 75%,rgba(239,247,245,1) 100%);background:-webkit-gradient(linear,left top,left bottom,color-stop(0%,rgba(249,252,252,1)),color-stop(75%,rgba(237,245,245,1)),color-stop(100%,rgba(239,247,245,1)));background:-webkit-linear-gradient(top,rgba(249,252,252,1) 0,rgba(237,245,245,1) 75%,rgba(239,247,245,1) 100%);background:-o-linear-gradient(top,rgba(249,252,252,1) 0,rgba(237,245,245,1) 75%,rgba(239,247,245,1) 100%);background:-ms-linear-gradient(top,rgba(249,252,252,1) 0,rgba(237,245,245,1) 75%,rgba(239,247,245,1) 100%);background:linear-gradient(top,rgba(249,252,252,1) 0,rgba(237,245,245,1) 75%,rgba(239,247,245,1) 100%);filter:progid:DXImageTransform.Microsoft.gradient( startColorstr='#f9fcfc',endColorstr='#eff7f5',GradientType=0 )}.about{font-size:16px}h3{margin:.5em 0;color:#000;font-size:22px;font-weight:400}h4{color:#000}.about ul li{list-style:square;font-size:16px;font-weight:300;line-height:22.5px}.about blockquote{padding-right:.5em;margin-top:30px}.footer{clear:both;margin-top:45px;padding:35px 0 36px;border-top:1px solid #E5E5E5;color:#777;font-size:14px}.footer p{font-size:14px}code .constant{color:teal}code .symbol{color:#990073}code .string{color:#D14}figcaption{color:#555;font-size:90%}.container ul.top-nav{float:left;top:15px}.label a{color:#fff}.navbar .nav .active > a,.navbar .nav .active > a:hover{background-color:#0D84BD;-moz-border-radius:3px;-webkit-border-radius:3px}.navbar-fixed-top .navbar-inner{height:60px}.navbar-fixed-top{margin-bottom:0}.footer-right{text-align:right}.intro{height:180px;background:url('../img/introbg.png');box-shadow:0 1px 10px rgba(0,0,0,0.25)}.home-text{margin-top:4.5em}.container h1{margin-top:20px};F; I"� body { padding-top: 60px; background-position-y : 40px; } .content { background : #fff; padding : 0 1em; box-shadow: 0 1px 10px rgba(0, 0, 0, 0.25); } .article-nav { float : right; width : 250px; margin : 0 0 2em 2em; padding : 0.5em auto; } .news { background : #fff; margin : 1em; } .tweet_list li { list-style: none; border-top : 1px solid #eee; padding : 5px 0; font-size : 9pt; } .tweet_list li.tweet_first { border-style : none; } .tweet_list li img { float : left; margin : 0 5px 2px 0; } .tweet_list { margin : 0; } .grad1 { background: #F9FCFC; background: -moz-linear-gradient(top, rgba(249, 252, 252, 1) 0%, rgba(237, 245, 245, 1) 75%, rgba(239, 247, 245, 1) 100%); background: -webkit-gradient(linear, left top, left bottom, color-stop(0%,rgba(249, 252, 252, 1)), color-stop(75%,rgba(237, 245, 245, 1)), color-stop(100%,rgba(239, 247, 245, 1))); background: -webkit-linear-gradient(top, rgba(249, 252, 252, 1) 0%,rgba(237, 245, 245, 1) 75%,rgba(239, 247, 245, 1) 100%); background: -o-linear-gradient(top, rgba(249, 252, 252, 1) 0%,rgba(237, 245, 245, 1) 75%,rgba(239, 247, 245, 1) 100%); background: -ms-linear-gradient(top, rgba(249, 252, 252, 1) 0%,rgba(237, 245, 245, 1) 75%,rgba(239, 247, 245, 1) 100%); background: linear-gradient(top, rgba(249, 252, 252, 1) 0%,rgba(237, 245, 245, 1) 75%,rgba(239, 247, 245, 1) 100%); filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='#f9fcfc', endColorstr='#eff7f5',GradientType=0 ); } .about { font-size : 16px; } h3 { margin : 0.5em 0; color : #000; font-size: 22px; font-weight: 400; } h4 { color : #000; } .about ul li { list-style : square; font-size: 16px; font-weight: 300; line-height: 22.5px; } .about blockquote { padding-right : 0.5em; margin-top : 30px; } .footer { clear : both; margin-top: 45px; padding: 35px 0 36px; border-top: 1px solid #E5E5E5; color : #777; font-size : 14px; } .footer p { font-size : 14px; } code .constant { color: teal; } code .symbol { color: #990073; } code .string { color : #D14; } figcaption { color : #555; font-size : 90%; } .container ul.top-nav { float : left; top : 15px; } .label a { color : #fff; } .navbar .nav .active > a, .navbar .nav .active > a:hover { background-color : #0D84BD; -moz-border-radius: 3px; -webkit-border-radius: 3px; } .navbar-fixed-top .navbar-inner { height : 60px; } .navbar-fixed-top { margin-bottom : 0px; } .footer-right { text-align : right; } .intro { height : 180px; /*background : #505050; */ background : url('../img/introbg.png'); box-shadow: 0 1px 10px rgba(0, 0, 0, 0.25); } .home-text { margin-top : 4.5em; } .container h1 { margin-top : 20px; } ;T; @8I"'/assets/less/component-animations/;T{;{;I"// COMPONENT ANIMATIONS // -------------------- .fade { .transition(opacity .15s linear); opacity: 0; &.in { opacity: 1; } } .collapse { .transition(height .35s ease); position:relative; overflow:hidden; height: 0; &.in { height: auto; } } ;T; @=; @=I"/assets/less/close/;T{;{;I"4// CLOSE ICONS // ----------- .close { float: right; font-size: 20px; font-weight: bold; line-height: @baseLineHeight; color: @black; text-shadow: 0 1px 0 rgba(255,255,255,1); .opacity(20); &:hover { color: @black; text-decoration: none; .opacity(40); cursor: pointer; } } ;T; @A; @AI"/assets/less/pagination/;T{;{;I"�// PAGINATION // ---------- .pagination { height: @baseLineHeight * 2; margin: @baseLineHeight 0; } .pagination ul { display: inline-block; .ie7-inline-block(); margin-left: 0; margin-bottom: 0; .border-radius(3px); .box-shadow(0 1px 2px rgba(0,0,0,.05)); } .pagination li { display: inline; } .pagination a { float: left; padding: 0 14px; line-height: (@baseLineHeight * 2) - 2; text-decoration: none; border: 1px solid #ddd; border-left-width: 0; } .pagination a:hover, .pagination .active a { background-color: #f5f5f5; } .pagination .active a { color: @grayLight; cursor: default; } .pagination .disabled a, .pagination .disabled a:hover { color: @grayLight; background-color: transparent; cursor: default; } .pagination li:first-child a { border-left-width: 1px; .border-radius(3px 0 0 3px); } .pagination li:last-child a { .border-radius(0 3px 3px 0); } // Centered .pagination-centered { text-align: center; } .pagination-right { text-align: right; } ;T; @E; @EI"/assets/less/buttons/;T{;{;I"�// BUTTON STYLES // ------------- // Base styles // -------------------------------------------------- // Core .btn { display: inline-block; padding: 4px 10px 4px; margin-bottom: 0; // For input.btn font-size: @baseFontSize; line-height: @baseLineHeight; color: @grayDark; text-align: center; text-shadow: 0 1px 1px rgba(255,255,255,.75); vertical-align: middle; .buttonBackground(@white, darken(@white, 10%)); border: 1px solid #ccc; border-bottom-color: #bbb; .border-radius(4px); @shadow: inset 0 1px 0 rgba(255,255,255,.2), 0 1px 2px rgba(0,0,0,.05); .box-shadow(@shadow); cursor: pointer; // Give IE7 some love .reset-filter(); .ie7-restore-left-whitespace(); } // Hover state .btn:hover { color: @grayDark; text-decoration: none; background-color: darken(@white, 10%); background-position: 0 -15px; // transition is only when going to hover, otherwise the background // behind the gradient (there for IE<=9 fallback) gets mismatched .transition(background-position .1s linear); } // Focus state for keyboard and accessibility .btn:focus { .tab-focus(); } // Active state .btn.active, .btn:active { background-image: none; @shadow: inset 0 2px 4px rgba(0,0,0,.15), 0 1px 2px rgba(0,0,0,.05); .box-shadow(@shadow); background-color: darken(@white, 10%); background-color: darken(@white, 15%) e("\9"); outline: 0; } // Disabled state .btn.disabled, .btn[disabled] { cursor: default; background-image: none; background-color: darken(@white, 10%); .opacity(65); .box-shadow(none); } // Button Sizes // -------------------------------------------------- // Large .btn-large { padding: 9px 14px; font-size: @baseFontSize + 2px; line-height: normal; .border-radius(5px); } .btn-large [class^="icon-"] { margin-top: 1px; } // Small .btn-small { padding: 5px 9px; font-size: @baseFontSize - 2px; line-height: @baseLineHeight - 2px; } .btn-small [class^="icon-"] { margin-top: -1px; } // Mini .btn-mini { padding: 2px 6px; font-size: @baseFontSize - 2px; line-height: @baseLineHeight - 4px; } // Alternate buttons // -------------------------------------------------- // Set text color // ------------------------- .btn-primary, .btn-primary:hover, .btn-warning, .btn-warning:hover, .btn-danger, .btn-danger:hover, .btn-success, .btn-success:hover, .btn-info, .btn-info:hover, .btn-inverse, .btn-inverse:hover { text-shadow: 0 -1px 0 rgba(0,0,0,.25); color: @white; } // Provide *some* extra contrast for those who can get it .btn-primary.active, .btn-warning.active, .btn-danger.active, .btn-success.active, .btn-info.active, .btn-dark.active { color: rgba(255,255,255,.75); } // Set the backgrounds // ------------------------- .btn-primary { .buttonBackground(@primaryButtonBackground, spin(@primaryButtonBackground, 20)); } // Warning appears are orange .btn-warning { .buttonBackground(lighten(@orange, 15%), @orange); } // Danger and error appear as red .btn-danger { .buttonBackground(#ee5f5b, #bd362f); } // Success appears as green .btn-success { .buttonBackground(#62c462, #51a351); } // Info appears as a neutral blue .btn-info { .buttonBackground(#5bc0de, #2f96b4); } // Inverse appears as dark gray .btn-inverse { .buttonBackground(#454545, #262626); } // Cross-browser Jank // -------------------------------------------------- button.btn, input[type="submit"].btn { // Firefox 3.6 only I believe &::-moz-focus-inner { padding: 0; border: 0; } // IE7 has some default padding on button controls *padding-top: 2px; *padding-bottom: 2px; &.large { *padding-top: 7px; *padding-bottom: 7px; } &.small { *padding-top: 3px; *padding-bottom: 3px; } } ;T; @I; @II"/assets/less/breadcrumbs/;T{;{;I"�// BREADCRUMBS // ----------- .breadcrumb { padding: 7px 14px; margin: 0 0 @baseLineHeight; #gradient > .vertical(@white, #f5f5f5); border: 1px solid #ddd; .border-radius(3px); .box-shadow(inset 0 1px 0 @white); li { display: inline-block; text-shadow: 0 1px 0 @white; } .divider { padding: 0 5px; color: @grayLight; } .active a { color: @grayDark; } } ;T; @M; @MI"/assets/less/forms/;T{;{;I"N(// Forms.less // Base styles for various input types, form layouts, and states // ------------------------------------------------------------- // GENERAL STYLES // -------------- // Make all forms have space below them form { margin: 0 0 @baseLineHeight; } fieldset { padding: 0; margin: 0; border: 0; } // Groups of fields with labels on top (legends) legend { display: block; width: 100%; padding: 0; margin-bottom: @baseLineHeight * 1.5; font-size: @baseFontSize * 1.5; line-height: @baseLineHeight * 2; color: @grayDark; border: 0; border-bottom: 1px solid #eee; // Small small { font-size: @baseLineHeight * .75; color: @grayLight; } } // Set font for forms label, input, button, select, textarea { #font > .shorthand(@baseFontSize,normal,@baseLineHeight); // Set size, weight, line-height here } input, button, select, textarea { #font > #family > .sans-serif(); // And only set font-family here for those that need it (note the missing label element) } // Identify controls by their labels label { display: block; margin-bottom: 5px; color: @grayDark; } // Inputs, Textareas, Selects input, textarea, select, .uneditable-input { display: inline-block; width: 210px; height: @baseLineHeight; padding: 4px; margin-bottom: 9px; font-size: @baseFontSize; line-height: @baseLineHeight; color: @gray; border: 1px solid #ccc; .border-radius(3px); } .uneditable-textarea { width: auto; height: auto; } // Inputs within a label label input, label textarea, label select { display: block; } // Mini reset for unique input types input[type="image"], input[type="checkbox"], input[type="radio"] { width: auto; height: auto; padding: 0; margin: 3px 0; *margin-top: 0; /* IE7 */ line-height: normal; cursor: pointer; .border-radius(0); border: 0 \9; /* IE9 and down */ } input[type="image"] { border: 0; } // Reset the file input to browser defaults input[type="file"] { width: auto; padding: initial; line-height: initial; border: initial; background-color: @white; background-color: initial; .box-shadow(none); } // Help out input buttons input[type="button"], input[type="reset"], input[type="submit"] { width: auto; height: auto; } // Set the height of select and file controls to match text inputs select, input[type="file"] { height: 28px; /* In IE7, the height of the select element cannot be changed by height, only font-size */ *margin-top: 4px; /* For IE7, add top margin to align select with labels */ line-height: 28px; } // Reset line-height for IE input[type="file"] { line-height: 18px \9; } // Chrome on Linux and Mobile Safari need background-color select { width: 220px; // default input width + 10px of padding that doesn't get applied background-color: @white; } // Make multiple select elements height not fixed select[multiple], select[size] { height: auto; } // Remove shadow from image inputs input[type="image"] { .box-shadow(none); } // Make textarea height behave textarea { height: auto; } // Hidden inputs input[type="hidden"] { display: none; } // CHECKBOXES & RADIOS // ------------------- // Indent the labels to position radios/checkboxes as hanging .radio, .checkbox { padding-left: 18px; } .radio input[type="radio"], .checkbox input[type="checkbox"] { float: left; margin-left: -18px; } // Move the options list down to align with labels .controls > .radio:first-child, .controls > .checkbox:first-child { padding-top: 5px; // has to be padding because margin collaspes } // Radios and checkboxes on same line // TODO v3: Convert .inline to .control-inline .radio.inline, .checkbox.inline { display: inline-block; padding-top: 5px; margin-bottom: 0; vertical-align: middle; } .radio.inline + .radio.inline, .checkbox.inline + .checkbox.inline { margin-left: 10px; // space out consecutive inline controls } // FOCUS STATE // ----------- input, textarea { .box-shadow(inset 0 1px 1px rgba(0,0,0,.075)); @transition: border linear .2s, box-shadow linear .2s; .transition(@transition); } input:focus, textarea:focus { border-color: rgba(82,168,236,.8); @shadow: inset 0 1px 1px rgba(0,0,0,.075), 0 0 8px rgba(82,168,236,.6); .box-shadow(@shadow); outline: 0; outline: thin dotted \9; /* IE6-9 */ } input[type="file"]:focus, input[type="radio"]:focus, input[type="checkbox"]:focus, select:focus { .box-shadow(none); // override for file inputs .tab-focus(); } // INPUT SIZES // ----------- // General classes for quick sizes .input-mini { width: 60px; } .input-small { width: 90px; } .input-medium { width: 150px; } .input-large { width: 210px; } .input-xlarge { width: 270px; } .input-xxlarge { width: 530px; } // Grid style input sizes input[class*="span"], select[class*="span"], textarea[class*="span"], .uneditable-input { float: none; margin-left: 0; } // GRID SIZING FOR INPUTS // ---------------------- #inputGridSystem > .generate(@gridColumns, @gridColumnWidth, @gridGutterWidth); // DISABLED STATE // -------------- // Disabled and read-only inputs input[disabled], select[disabled], textarea[disabled], input[readonly], select[readonly], textarea[readonly] { background-color: #f5f5f5; border-color: #ddd; cursor: not-allowed; } // FORM FIELD FEEDBACK STATES // -------------------------- // Warning .control-group.warning { .formFieldState(@warningText, @warningText, @warningBackground); } // Error .control-group.error { .formFieldState(@errorText, @errorText, @errorBackground); } // Success .control-group.success { .formFieldState(@successText, @successText, @successBackground); } // HTML5 invalid states // Shares styles with the .control-group.error above input:focus:required:invalid, textarea:focus:required:invalid, select:focus:required:invalid { color: #b94a48; border-color: #ee5f5b; &:focus { border-color: darken(#ee5f5b, 10%); .box-shadow(0 0 6px lighten(#ee5f5b, 20%)); } } // FORM ACTIONS // ------------ .form-actions { padding: (@baseLineHeight - 1) 20px @baseLineHeight; margin-top: @baseLineHeight; margin-bottom: @baseLineHeight; background-color: #f5f5f5; border-top: 1px solid #ddd; } // For text that needs to appear as an input but should not be an input .uneditable-input { display: block; background-color: @white; border-color: #eee; .box-shadow(inset 0 1px 2px rgba(0,0,0,.025)); cursor: not-allowed; } // Placeholder text gets special styles; can't be bundled together though for some reason .placeholder(@grayLight); // HELP TEXT // --------- .help-block { display: block; // account for any element using help-block margin-top: 5px; margin-bottom: 0; color: @grayLight; } .help-inline { display: inline-block; .ie7-inline-block(); margin-bottom: 9px; vertical-align: middle; padding-left: 5px; } // INPUT GROUPS // ------------ // Allow us to put symbols and text within the input field for a cleaner look .input-prepend, .input-append { margin-bottom: 5px; .clearfix(); // Clear the float to prevent wrapping input, .uneditable-input { .border-radius(0 3px 3px 0); &:focus { position: relative; z-index: 2; } } .uneditable-input { border-left-color: #ccc; } .add-on { float: left; display: block; width: auto; min-width: 16px; height: @baseLineHeight; margin-right: -1px; padding: 4px 5px; font-weight: normal; line-height: @baseLineHeight; color: @grayLight; text-align: center; text-shadow: 0 1px 0 @white; background-color: #f5f5f5; border: 1px solid #ccc; .border-radius(3px 0 0 3px); } .active { background-color: lighten(@green, 30); border-color: @green; } } .input-prepend { .add-on { *margin-top: 1px; /* IE6-7 */ } } .input-append { input, .uneditable-input { float: left; .border-radius(3px 0 0 3px); } .uneditable-input { border-left-color: #eee; border-right-color: #ccc; } .add-on { margin-right: 0; margin-left: -1px; .border-radius(0 3px 3px 0); } input:first-child { // In IE7, having a hasLayout container (from clearfix's zoom:1) can make the first input // inherit the sum of its ancestors' margins. *margin-left: -160px; &+.add-on { *margin-left: -21px; } } } // SEARCH FORM // ----------- .search-query { padding-left: 14px; padding-right: 14px; margin-bottom: 0; // remove the default margin on all inputs .border-radius(14px); } // HORIZONTAL & VERTICAL FORMS // --------------------------- // Common properties // ----------------- .form-search, .form-inline, .form-horizontal { input, textarea, select, .help-inline, .uneditable-input { display: inline-block; margin-bottom: 0; } // Re-hide hidden elements due to specifity .hide { display: none; } } .form-search label, .form-inline label, .form-search .input-append, .form-inline .input-append, .form-search .input-prepend, .form-inline .input-prepend { display: inline-block; } // Make the prepend and append add-on vertical-align: middle; .form-search .input-append .add-on, .form-inline .input-prepend .add-on, .form-search .input-append .add-on, .form-inline .input-prepend .add-on { vertical-align: middle; } // Inline checkbox/radio labels .form-search .radio, .form-inline .radio, .form-search .checkbox, .form-inline .checkbox { margin-bottom: 0; vertical-align: middle; } // Margin to space out fieldsets .control-group { margin-bottom: @baseLineHeight / 2; } // Legend collapses margin, so next element is responsible for spacing legend + .control-group { margin-top: @baseLineHeight; -webkit-margin-top-collapse: separate; } // Horizontal-specific styles // -------------------------- .form-horizontal { // Increase spacing between groups .control-group { margin-bottom: @baseLineHeight; .clearfix(); } // Float the labels left .control-label { float: left; width: 140px; padding-top: 5px; text-align: right; } // Move over all input controls and content .controls { margin-left: 160px; } // Move over buttons in .form-actions to align with .controls .form-actions { padding-left: 160px; } } ;T; @Q; @QI"/assets/less/bootstrap/;T{;{;I"�/*! * Bootstrap v2.0.1 * * Copyright 2012 Twitter, Inc * Licensed under the Apache License v2.0 * http://www.apache.org/licenses/LICENSE-2.0 * * Designed and built with all the love in the world @twitter by @mdo and @fat. */ // CSS Reset @import "reset.less"; // Core variables and mixins @import "variables.less"; // Modify this for custom colors, font-sizes, etc @import "mixins.less"; // Grid system and page structure @import "scaffolding.less"; @import "grid.less"; @import "layouts.less"; // Base CSS @import "type.less"; @import "code.less"; @import "forms.less"; @import "tables.less"; // Components: common @import "sprites.less"; @import "dropdowns.less"; @import "wells.less"; @import "component-animations.less"; @import "close.less"; // Components: Buttons & Alerts @import "buttons.less"; @import "button-groups.less"; @import "alerts.less"; // Note: alerts share common CSS with buttons and thus have styles in buttons.less // Components: Nav @import "navs.less"; @import "navbar.less"; @import "breadcrumbs.less"; @import "pagination.less"; @import "pager.less"; // Components: Popovers @import "modals.less"; @import "tooltip.less"; @import "popovers.less"; // Components: Misc @import "thumbnails.less"; @import "labels.less"; @import "progress-bars.less"; @import "accordion.less"; @import "carousel.less"; @import "hero-unit.less"; // Utility classes @import "utilities.less"; // Has to be last to override when necessary ;T; @U; @UI"/assets/less/navs/;T{;{;I"�// NAVIGATIONS // ----------- // BASE CLASS // ---------- .nav { margin-left: 0; margin-bottom: @baseLineHeight; list-style: none; } // Make links block level .nav > li > a { display: block; } .nav > li > a:hover { text-decoration: none; background-color: @grayLighter; } // Nav headers (for dropdowns and lists) .nav .nav-header { display: block; padding: 3px 15px; font-size: 11px; font-weight: bold; line-height: @baseLineHeight; color: @grayLight; text-shadow: 0 1px 0 rgba(255,255,255,.5); text-transform: uppercase; } // Space them out when they follow another list item (link) .nav li + .nav-header { margin-top: 9px; } // NAV LIST // -------- .nav-list { padding-left: 14px; padding-right: 14px; margin-bottom: 0; } .nav-list > li > a, .nav-list .nav-header { margin-left: -15px; margin-right: -15px; text-shadow: 0 1px 0 rgba(255,255,255,.5); } .nav-list > li > a { padding: 3px 15px; } .nav-list .active > a, .nav-list .active > a:hover { color: @white; text-shadow: 0 -1px 0 rgba(0,0,0,.2); background-color: @linkColor; } .nav-list [class^="icon-"] { margin-right: 2px; } // TABS AND PILLS // ------------- // Common styles .nav-tabs, .nav-pills { .clearfix(); } .nav-tabs > li, .nav-pills > li { float: left; } .nav-tabs > li > a, .nav-pills > li > a { padding-right: 12px; padding-left: 12px; margin-right: 2px; line-height: 14px; // keeps the overall height an even number } // TABS // ---- // Give the tabs something to sit on .nav-tabs { border-bottom: 1px solid #ddd; } // Make the list-items overlay the bottom border .nav-tabs > li { margin-bottom: -1px; } // Actual tabs (as links) .nav-tabs > li > a { padding-top: 9px; padding-bottom: 9px; border: 1px solid transparent; .border-radius(4px 4px 0 0); &:hover { border-color: @grayLighter @grayLighter #ddd; } } // Active state, and it's :hover to override normal :hover .nav-tabs > .active > a, .nav-tabs > .active > a:hover { color: @gray; background-color: @white; border: 1px solid #ddd; border-bottom-color: transparent; cursor: default; } // PILLS // ----- // Links rendered as pills .nav-pills > li > a { padding-top: 8px; padding-bottom: 8px; margin-top: 2px; margin-bottom: 2px; .border-radius(5px); } // Active state .nav-pills .active > a, .nav-pills .active > a:hover { color: @white; background-color: @linkColor; } // STACKED NAV // ----------- // Stacked tabs and pills .nav-stacked > li { float: none; } .nav-stacked > li > a { margin-right: 0; // no need for the gap between nav items } // Tabs .nav-tabs.nav-stacked { border-bottom: 0; } .nav-tabs.nav-stacked > li > a { border: 1px solid #ddd; .border-radius(0); } .nav-tabs.nav-stacked > li:first-child > a { .border-radius(4px 4px 0 0); } .nav-tabs.nav-stacked > li:last-child > a { .border-radius(0 0 4px 4px); } .nav-tabs.nav-stacked > li > a:hover { border-color: #ddd; z-index: 2; } // Pills .nav-pills.nav-stacked > li > a { margin-bottom: 3px; } .nav-pills.nav-stacked > li:last-child > a { margin-bottom: 1px; // decrease margin to match sizing of stacked tabs } // DROPDOWNS // --------- // Position the menu .nav-tabs .dropdown-menu, .nav-pills .dropdown-menu { margin-top: 1px; border-width: 1px; } .nav-pills .dropdown-menu { .border-radius(4px); } // Default dropdown links // ------------------------- // Make carets use linkColor to start .nav-tabs .dropdown-toggle .caret, .nav-pills .dropdown-toggle .caret { border-top-color: @linkColor; margin-top: 6px; } .nav-tabs .dropdown-toggle:hover .caret, .nav-pills .dropdown-toggle:hover .caret { border-top-color: @linkColorHover; } // Active dropdown links // ------------------------- .nav-tabs .active .dropdown-toggle .caret, .nav-pills .active .dropdown-toggle .caret { border-top-color: @grayDark; } // Active:hover dropdown links // ------------------------- .nav > .dropdown.active > a:hover { color: @black; cursor: pointer; } // Open dropdowns // ------------------------- .nav-tabs .open .dropdown-toggle, .nav-pills .open .dropdown-toggle, .nav > .open.active > a:hover { color: @white; background-color: @grayLight; border-color: @grayLight; } .nav .open .caret, .nav .open.active .caret, .nav .open a:hover .caret { border-top-color: @white; .opacity(100); } // Dropdowns in stacked tabs .tabs-stacked .open > a:hover { border-color: @grayLight; } // TABBABLE // -------- // COMMON STYLES // ------------- // Clear any floats .tabbable { .clearfix(); } .tab-content { overflow: hidden; // prevent content from running below tabs } // Remove border on bottom, left, right .tabs-below .nav-tabs, .tabs-right .nav-tabs, .tabs-left .nav-tabs { border-bottom: 0; } // Show/hide tabbable areas .tab-content > .tab-pane, .pill-content > .pill-pane { display: none; } .tab-content > .active, .pill-content > .active { display: block; } // BOTTOM // ------ .tabs-below .nav-tabs { border-top: 1px solid #ddd; } .tabs-below .nav-tabs > li { margin-top: -1px; margin-bottom: 0; } .tabs-below .nav-tabs > li > a { .border-radius(0 0 4px 4px); &:hover { border-bottom-color: transparent; border-top-color: #ddd; } } .tabs-below .nav-tabs .active > a, .tabs-below .nav-tabs .active > a:hover { border-color: transparent #ddd #ddd #ddd; } // LEFT & RIGHT // ------------ // Common styles .tabs-left .nav-tabs > li, .tabs-right .nav-tabs > li { float: none; } .tabs-left .nav-tabs > li > a, .tabs-right .nav-tabs > li > a { min-width: 74px; margin-right: 0; margin-bottom: 3px; } // Tabs on the left .tabs-left .nav-tabs { float: left; margin-right: 19px; border-right: 1px solid #ddd; } .tabs-left .nav-tabs > li > a { margin-right: -1px; .border-radius(4px 0 0 4px); } .tabs-left .nav-tabs > li > a:hover { border-color: @grayLighter #ddd @grayLighter @grayLighter; } .tabs-left .nav-tabs .active > a, .tabs-left .nav-tabs .active > a:hover { border-color: #ddd transparent #ddd #ddd; *border-right-color: @white; } // Tabs on the right .tabs-right .nav-tabs { float: right; margin-left: 19px; border-left: 1px solid #ddd; } .tabs-right .nav-tabs > li > a { margin-left: -1px; .border-radius(0 4px 4px 0); } .tabs-right .nav-tabs > li > a:hover { border-color: @grayLighter @grayLighter @grayLighter #ddd; } .tabs-right .nav-tabs .active > a, .tabs-right .nav-tabs .active > a:hover { border-color: #ddd #ddd #ddd transparent; *border-left-color: @white; } ;T; @Y; @YI"/assets/less/pager/;T{;{;I"�// PAGER // ----- .pager { margin-left: 0; margin-bottom: @baseLineHeight; list-style: none; text-align: center; .clearfix(); } .pager li { display: inline; } .pager a { display: inline-block; padding: 5px 14px; background-color: #fff; border: 1px solid #ddd; .border-radius(15px); } .pager a:hover { text-decoration: none; background-color: #f5f5f5; } .pager .next a { float: right; } .pager .previous a { float: left; } ;T; @]; @]I"/assets/less/layouts/;T{;{;I"s// // Layouts // Fixed-width and fluid (with sidebar) layouts // -------------------------------------------- // Container (centered, fixed-width layouts) .container { .container-fixed(); } // Fluid layouts (left aligned, with sidebar, min- & max-width content) .container-fluid { padding-left: @gridGutterWidth; padding-right: @gridGutterWidth; .clearfix(); };T; @a; @aI"/assets/less/thumbnails/;T{;{;I"�// THUMBNAILS // ---------- .thumbnails { margin-left: -@gridGutterWidth; list-style: none; .clearfix(); } .thumbnails > li { float: left; margin: 0 0 @baseLineHeight @gridGutterWidth; } .thumbnail { display: block; padding: 4px; line-height: 1; border: 1px solid #ddd; .border-radius(4px); .box-shadow(0 1px 1px rgba(0,0,0,.075)); } // Add a hover state for linked versions only a.thumbnail:hover { border-color: @linkColor; .box-shadow(0 1px 4px rgba(0,105,214,.25)); } // Images and captions .thumbnail > img { display: block; max-width: 100%; margin-left: auto; margin-right: auto; } .thumbnail .caption { padding: 9px; } ;T; @e; @eI"/assets/less/utilities/;T{;{;I"�// UTILITY CLASSES // --------------- // Quick floats .pull-right { float: right; } .pull-left { float: left; } // Toggling content .hide { display: none; } .show { display: block; } // Visibility .invisible { visibility: hidden; } ;T; @i; @iI"/assets/less/responsive/;T{;{;I"N/*! * Bootstrap Responsive v2.0.1 * * Copyright 2012 Twitter, Inc * Licensed under the Apache License v2.0 * http://www.apache.org/licenses/LICENSE-2.0 * * Designed and built with all the love in the world @twitter by @mdo and @fat. */ // Responsive.less // For phone and tablet devices // ------------------------------------------------------------- // REPEAT VARIABLES & MIXINS // ------------------------- // Required since we compile the responsive stuff separately @import "variables.less"; // Modify this for custom colors, font-sizes, etc @import "mixins.less"; // RESPONSIVE CLASSES // ------------------ // Hide from screenreaders and browsers // Credit: HTML5 Boilerplate .hidden { display: none; visibility: hidden; } // UP TO LANDSCAPE PHONE // --------------------- @media (max-width: 480px) { // Smooth out the collapsing/expanding nav .nav-collapse { -webkit-transform: translate3d(0, 0, 0); // activate the GPU } // Block level the page header small tag for readability .page-header h1 small { display: block; line-height: @baseLineHeight; } // Make span* classes full width input[class*="span"], select[class*="span"], textarea[class*="span"], .uneditable-input { display: block; width: 100%; min-height: 28px; /* Make inputs at least the height of their button counterpart */ /* Makes inputs behave like true block-level elements */ -webkit-box-sizing: border-box; /* Older Webkit */ -moz-box-sizing: border-box; /* Older FF */ -ms-box-sizing: border-box; /* IE8 */ box-sizing: border-box; /* CSS3 spec*/ } // But don't let it screw up prepend/append inputs .input-prepend input[class*="span"], .input-append input[class*="span"] { width: auto; } // Update checkboxes for iOS input[type="checkbox"], input[type="radio"] { border: 1px solid #ccc; } // Remove the horizontal form styles .form-horizontal .control-group > label { float: none; width: auto; padding-top: 0; text-align: left; } // Move over all input controls and content .form-horizontal .controls { margin-left: 0; } // Move the options list down to align with labels .form-horizontal .control-list { padding-top: 0; // has to be padding because margin collaspes } // Move over buttons in .form-actions to align with .controls .form-horizontal .form-actions { padding-left: 10px; padding-right: 10px; } // Modals .modal { position: absolute; top: 10px; left: 10px; right: 10px; width: auto; margin: 0; &.fade.in { top: auto; } } .modal-header .close { padding: 10px; margin: -10px; } // Carousel .carousel-caption { position: static; } } // LANDSCAPE PHONE TO SMALL DESKTOP & PORTRAIT TABLET // -------------------------------------------------- @media (max-width: 767px) { // GRID & CONTAINERS // ----------------- // Remove width from containers .container { width: auto; padding: 0 20px; } // Fluid rows .row-fluid { width: 100%; } // Undo negative margin on rows .row { margin-left: 0; } // Make all columns even .row > [class*="span"], .row-fluid > [class*="span"] { float: none; display: block; width: auto; margin: 0; } } // PORTRAIT TABLET TO DEFAULT DESKTOP // ---------------------------------- @media (min-width: 768px) and (max-width: 979px) { // Fixed grid #gridSystem > .generate(12, 42px, 20px); // Fluid grid #fluidGridSystem > .generate(12, 5.801104972%, 2.762430939%); // Input grid #inputGridSystem > .generate(12, 42px, 20px); } // TABLETS AND BELOW // ----------------- @media (max-width: 979px) { // UNFIX THE TOPBAR // ---------------- // Remove any padding from the body body { padding-top: 0; } // Unfix the navbar .navbar-fixed-top { position: static; margin-bottom: @baseLineHeight; } .navbar-fixed-top .navbar-inner { padding: 5px; } .navbar .container { width: auto; padding: 0; } // Account for brand name .navbar .brand { padding-left: 10px; padding-right: 10px; margin: 0 0 0 -5px; } // Nav collapse clears brand .navbar .nav-collapse { clear: left; } // Block-level the nav .navbar .nav { float: none; margin: 0 0 (@baseLineHeight / 2); } .navbar .nav > li { float: none; } .navbar .nav > li > a { margin-bottom: 2px; } .navbar .nav > .divider-vertical { display: none; } .navbar .nav .nav-header { color: @navbarText; text-shadow: none; } // Nav and dropdown links in navbar .navbar .nav > li > a, .navbar .dropdown-menu a { padding: 6px 15px; font-weight: bold; color: @navbarLinkColor; .border-radius(3px); } .navbar .dropdown-menu li + li a { margin-bottom: 2px; } .navbar .nav > li > a:hover, .navbar .dropdown-menu a:hover { background-color: @navbarBackground; } // Dropdowns in the navbar .navbar .dropdown-menu { position: static; top: auto; left: auto; float: none; display: block; max-width: none; margin: 0 15px; padding: 0; background-color: transparent; border: none; .border-radius(0); .box-shadow(none); } .navbar .dropdown-menu:before, .navbar .dropdown-menu:after { display: none; } .navbar .dropdown-menu .divider { display: none; } // Forms in navbar .navbar-form, .navbar-search { float: none; padding: (@baseLineHeight / 2) 15px; margin: (@baseLineHeight / 2) 0; border-top: 1px solid @navbarBackground; border-bottom: 1px solid @navbarBackground; @shadow: inset 0 1px 0 rgba(255,255,255,.1), 0 1px 0 rgba(255,255,255,.1); .box-shadow(@shadow); } // Pull right (secondary) nav content .navbar .nav.pull-right { float: none; margin-left: 0; } // Static navbar .navbar-static .navbar-inner { padding-left: 10px; padding-right: 10px; } // Navbar button .btn-navbar { display: block; } // Hide everything in the navbar save .brand and toggle button */ .nav-collapse { overflow: hidden; height: 0; } } // DEFAULT DESKTOP // --------------- @media (min-width: 980px) { .nav-collapse.collapse { height: auto !important; } } // LARGE DESKTOP & UP // ------------------ @media (min-width: 1200px) { // Fixed grid #gridSystem > .generate(12, 70px, 30px); // Fluid grid #fluidGridSystem > .generate(12, 5.982905983%, 2.564102564%); // Input grid #inputGridSystem > .generate(12, 70px, 30px); // Thumbnails .thumbnails { margin-left: -30px; } .thumbnails > li { margin-left: 30px; } } ;T; @m; @mI"/assets/less/code/;T{;{;I"�// Code.less // Code typography styles for the

 and  elements
// --------------------------------------------------------

// Inline and block code styles
code,
pre {
  padding: 0 3px 2px;
  #font > #family > .monospace;
  font-size: @baseFontSize - 1;
  color: @grayDark;
  .border-radius(3px);
}

// Inline code
code {
  padding: 3px 4px;
  color: #d14;
  background-color: #f7f7f9;
  border: 1px solid #e1e1e8;
}

// Blocks of code
pre {
  display: block;
  padding: (@baseLineHeight - 1) / 2;
  margin: 0 0 @baseLineHeight / 2;
  font-size: 12px;
  line-height: @baseLineHeight;
  background-color: #f5f5f5;
  border: 1px solid #ccc; // fallback for IE7-8
  border: 1px solid rgba(0,0,0,.15);
  .border-radius(4px);
  white-space: pre;
  white-space: pre-wrap;
  word-break: break-all;
  word-wrap: break-word;

  // Make prettyprint styles more spaced out for readability
  &.prettyprint {
    margin-bottom: @baseLineHeight;
  }

  // Account for some code outputs that place code tags in pre tags
  code {
    padding: 0;
    color: inherit;
    background-color: transparent;
    border: 0;
  }
}

// Enable scrollable blocks of code
.pre-scrollable {
  max-height: 340px;
  overflow-y: scroll;
};T;	@q;
@qI"/assets/less/popovers/;T{;{;I"M// POPOVERS
// --------

.popover {
  position: absolute;
  top: 0;
  left: 0;
  z-index: @zindexPopover;
  display: none;
  padding: 5px;
  &.top    { margin-top:  -5px; }
  &.right  { margin-left:  5px; }
  &.bottom { margin-top:   5px; }
  &.left   { margin-left: -5px; }
  &.top .arrow    { #popoverArrow > .top(); }
  &.right .arrow  { #popoverArrow > .right(); }
  &.bottom .arrow { #popoverArrow > .bottom(); }
  &.left .arrow   { #popoverArrow > .left();  }
  .arrow {
    position: absolute;
    width: 0;
    height: 0;
  }
}
.popover-inner {
  padding: 3px;
  width: 280px;
  overflow: hidden;
  background: @black; // has to be full background declaration for IE fallback
  background: rgba(0,0,0,.8);
  .border-radius(6px);
  .box-shadow(0 3px 7px rgba(0,0,0,0.3));
}
.popover-title {
  padding: 9px 15px;
  line-height: 1;
  background-color: #f5f5f5;
  border-bottom:1px solid #eee;
  .border-radius(3px 3px 0 0);
}
.popover-content {
  padding: 14px;
  background-color: @white;
  .border-radius(0 0 3px 3px);
  .background-clip(padding-box);
  p, ul, ol {
    margin-bottom: 0;
  }
}
;T;	@u;
@uI"/assets/less/type/;T{;{;I"�// Typography.less
// Headings, body text, lists, code, and more for a versatile and durable typography system
// ----------------------------------------------------------------------------------------


// BODY TEXT
// ---------

p {
  margin: 0 0 @baseLineHeight / 2;
  font-family: @baseFontFamily;
  font-size: @baseFontSize;
  line-height: @baseLineHeight;
  small {
    font-size: @baseFontSize - 2;
    color: @grayLight;
  }
}
.lead {
  margin-bottom: @baseLineHeight;
  font-size: 20px;
  font-weight: 200;
  line-height: @baseLineHeight * 1.5;
}

// HEADINGS
// --------

h1, h2, h3, h4, h5, h6 {
  margin: 0;
  font-weight: bold;
  color: @grayDark;
  text-rendering: optimizelegibility; // Fix the character spacing for headings
  small {
    font-weight: normal;
    color: @grayLight;
  }
}
h1 {
  font-size: 30px;
  line-height: @baseLineHeight * 2;
  small {
    font-size: 18px;
  }
}
h2 {
  font-size: 24px;
  line-height: @baseLineHeight * 2;
  small {
    font-size: 18px;
  }
}
h3 {
  line-height: @baseLineHeight * 1.5;
  font-size: 18px;
  small {
    font-size: 14px;
  }
}
h4, h5, h6 {
  line-height: @baseLineHeight;
}
h4 {
  font-size: 14px;
  small {
    font-size: 12px;
  }
}
h5 {
  font-size: 12px;
}
h6 {
  font-size: 11px;
  color: @grayLight;
  text-transform: uppercase;
}

// Page header
.page-header {
  padding-bottom: @baseLineHeight - 1;
  margin: @baseLineHeight 0;
  border-bottom: 1px solid @grayLighter;
}
.page-header h1 {
  line-height: 1;
}



// LISTS
// -----

// Unordered and Ordered lists
ul, ol {
  padding: 0;
  margin: 0 0 @baseLineHeight / 2 25px;
}
ul ul,
ul ol,
ol ol,
ol ul {
  margin-bottom: 0;
}
ul {
  list-style: disc;
}
ol {
  list-style: decimal;
}
li {
  line-height: @baseLineHeight;
}
ul.unstyled,
ol.unstyled {
  margin-left: 0;
  list-style: none;
}

// Description Lists
dl {
  margin-bottom: @baseLineHeight;
}
dt,
dd {
  line-height: @baseLineHeight;
}
dt {
  font-weight: bold;
}
dd {
  margin-left: @baseLineHeight / 2;
}

// MISC
// ----

// Horizontal rules
hr {
  margin: @baseLineHeight 0;
  border: 0;
  border-top: 1px solid @hrBorder;
  border-bottom: 1px solid @white;
}

// Emphasis
strong {
  font-weight: bold;
}
em {
  font-style: italic;
}
.muted {
  color: @grayLight;
}

// Abbreviations and acronyms
abbr {
  font-size: 90%;
  text-transform: uppercase;
  border-bottom: 1px dotted #ddd;
  cursor: help;
}

// Blockquotes
blockquote {
  padding: 0 0 0 15px;
  margin: 0 0 @baseLineHeight;
  border-left: 5px solid @grayLighter;
  p {
    margin-bottom: 0;
    #font > .shorthand(16px,300,@baseLineHeight * 1.25);
  }
  small {
    display: block;
    line-height: @baseLineHeight;
    color: @grayLight;
    &:before {
      content: '\2014 \00A0';
    }
  }

  // Float right with text-align: right
  &.pull-right {
    float: right;
    padding-left: 0;
    padding-right: 15px;
    border-left: 0;
    border-right: 5px solid @grayLighter;
    p,
    small {
      text-align: right;
    }
  }
}

// Quotes
q:before,
q:after,
blockquote:before, 
blockquote:after {
  content: "";
}

// Addresses
address {
  display: block;
  margin-bottom: @baseLineHeight;
  line-height: @baseLineHeight;
  font-style: normal;
}

// Misc
small {
  font-size: 100%;
}
cite {
  font-style: normal;
}
;T;	@y;
@yI"/assets/less/variables/;T{;{;I"�// Variables.less
// Variables to customize the look and feel of Bootstrap
// -----------------------------------------------------



// GLOBAL VALUES
// --------------------------------------------------

// Links
@linkColor:             #08c;
@linkColorHover:        darken(@linkColor, 15%);

// Grays
@black:                 #000;
@grayDarker:            #222;
@grayDark:              #606060;
@gray:                  #555;
@grayLight:             #999;
@grayLighter:           #eee;
@white:                 #fff;

// Accent colors
@blue:                  #049cdb;
@blueDark:              #0064cd;
@green:                 #46a546;
@red:                   #9d261d;
@yellow:                #ffc40d;
@orange:                #f89406;
@pink:                  #c3325f;
@purple:                #7a43b6;

// Typography
@baseFontSize:          16px;
@baseFontFamily:        "Helvetica Neue", Helvetica, Arial, sans-serif;
@baseLineHeight:        18px;
@textColor:             @grayDark;

// Buttons
@primaryButtonBackground:    @linkColor;



// COMPONENT VARIABLES
// --------------------------------------------------

// Z-index master list
// Used for a bird's eye view of components dependent on the z-axis
// Try to avoid customizing these :)
@zindexDropdown:          1000;
@zindexPopover:           1010;
@zindexTooltip:           1020;
@zindexFixedNavbar:       1030;
@zindexModalBackdrop:     1040;
@zindexModal:             1050;

// Sprite icons path
@iconSpritePath:          "../img/glyphicons-halflings.png";
@iconWhiteSpritePath:     "../img/glyphicons-halflings-white.png";

// Input placeholder text color
@placeholderText:         @grayLight;

// Hr border color
@hrBorder:                @grayLighter;

// Navbar
@navbarHeight:                    40px;
@navbarBackground:                @grayDarker;
@navbarBackgroundHighlight:       @grayDark;
@navbarLinkBackgroundHover:       transparent;

@navbarText:                      @grayLight;
@navbarLinkColor:                 @grayLight;
@navbarLinkColorHover:            @white;

// Form states and alerts
@warningText:             #c09853;
@warningBackground:       #fcf8e3;
@warningBorder:           darken(spin(@warningBackground, -10), 3%);

@errorText:               #b94a48;
@errorBackground:         #f2dede;
@errorBorder:             darken(spin(@errorBackground, -10), 3%);

@successText:             #468847;
@successBackground:       #dff0d8;
@successBorder:           darken(spin(@successBackground, -10), 5%);

@infoText:                #3a87ad;
@infoBackground:          #d9edf7;
@infoBorder:              darken(spin(@infoBackground, -10), 7%);



// GRID
// --------------------------------------------------

// Default 940px grid
@gridColumns:             12;
@gridColumnWidth:         60px;
@gridGutterWidth:         20px;
@gridRowWidth:            (@gridColumns * @gridColumnWidth) + (@gridGutterWidth * (@gridColumns - 1));

// Fluid grid
@fluidGridColumnWidth:    6.382978723%;
@fluidGridGutterWidth:    2.127659574%;
;T;	@};
@}I"/assets/less/hero-unit/;T{;{;I"G// HERO UNIT
// ---------

.hero-unit {
  padding: 60px;
  margin-bottom: 30px;
  background-color: #f5f5f5;
  .border-radius(6px);
  h1 {
    margin-bottom: 0;
    font-size: 60px;
    line-height: 1;
    letter-spacing: -1px;
  }
  p {
    font-size: 18px;
    font-weight: 200;
    line-height: @baseLineHeight * 1.5;
  }
}
;T;	@�;
@�I"/assets/less/mixins/;T{;{;I"W// Mixins.less
// Snippets of reusable CSS to develop faster and keep code readable
// -----------------------------------------------------------------


// UTILITY MIXINS
// --------------------------------------------------

// Clearfix
// --------
// For clearing floats like a boss h5bp.com/q
.clearfix {
  *zoom: 1;
  &:before,
  &:after {
    display: table;
    content: "";
  }
  &:after {
    clear: both;
  }
}

// Webkit-style focus
// ------------------
.tab-focus() {
  // Default
  outline: thin dotted #333;
  // Webkit
  outline: 5px auto -webkit-focus-ring-color;
  outline-offset: -2px;
}

// Center-align a block level element
// ----------------------------------
.center-block() {
  display: block;
  margin-left: auto;
  margin-right: auto;
}

// IE7 inline-block
// ----------------
.ie7-inline-block() {
  *display: inline; /* IE7 inline-block hack */
  *zoom: 1;
}

// IE7 likes to collapse whitespace on either side of the inline-block elements.
// Ems because we're attempting to match the width of a space character. Left
// version is for form buttons, which typically come after other elements, and
// right version is for icons, which come before. Applying both is ok, but it will
// mean that space between those elements will be .6em (~2 space characters) in IE7,
// instead of the 1 space in other browsers.
.ie7-restore-left-whitespace() {
  *margin-left: .3em;

  &:first-child {
    *margin-left: 0;
  }
}

.ie7-restore-right-whitespace() {
  *margin-right: .3em;

  &:last-child {
    *margin-left: 0;
  }
}

// Sizing shortcuts
// -------------------------
.size(@height: 5px, @width: 5px) {
  width: @width;
  height: @height;
}
.square(@size: 5px) {
  .size(@size, @size);
}

// Placeholder text
// -------------------------
.placeholder(@color: @placeholderText) {
  :-moz-placeholder {
    color: @color;
  }
  ::-webkit-input-placeholder {
    color: @color;
  }
}

// Text overflow
// -------------------------
// Requires inline-block or block for proper styling
.text-overflow() {
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}



// FONTS
// --------------------------------------------------

#font {
  #family {
    .serif() {
      font-family: Georgia, "Times New Roman", Times, serif;
    }
    .sans-serif() {
      font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
    }
    .monospace() {
      font-family: Menlo, Monaco, "Courier New", monospace;
    }
  }
  .shorthand(@size: @baseFontSize, @weight: normal, @lineHeight: @baseLineHeight) {
    font-size: @size;
    font-weight: @weight;
    line-height: @lineHeight;
  }
  .serif(@size: @baseFontSize, @weight: normal, @lineHeight: @baseLineHeight) {
    #font > #family > .serif;
    #font > .shorthand(@size, @weight, @lineHeight);
  }
  .sans-serif(@size: @baseFontSize, @weight: normal, @lineHeight: @baseLineHeight) {
    #font > #family > .sans-serif;
    #font > .shorthand(@size, @weight, @lineHeight);
  }
  .monospace(@size: @baseFontSize, @weight: normal, @lineHeight: @baseLineHeight) {
    #font > #family > .monospace;
    #font > .shorthand(@size, @weight, @lineHeight);
  }
}



// GRID SYSTEM
// --------------------------------------------------

// Site container
// -------------------------
.container-fixed() {
  width: @gridRowWidth;
  margin-left: auto;
  margin-right: auto;
  .clearfix();
}

// Le grid system
// -------------------------
#gridSystem {
  // Setup the mixins to be used
  .columns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, @columns) {
    width: (@gridColumnWidth * @columns) + (@gridGutterWidth * (@columns - 1));
  } 
  .offset(@gridColumnWidth, @gridGutterWidth, @columns) {
    margin-left: (@gridColumnWidth * @columns) + (@gridGutterWidth * (@columns - 1)) + (@gridGutterWidth * 2);
  }
  .gridColumn(@gridGutterWidth) {
    float: left;
    margin-left: @gridGutterWidth;
  }
  // Take these values and mixins, and make 'em do their thang
  .generate(@gridColumns, @gridColumnWidth, @gridGutterWidth) {
    // Row surrounds the columns
    .row {
      margin-left: @gridGutterWidth * -1;
      .clearfix();
    }
    // Find all .span# classes within .row and give them the necessary properties for grid columns (supported by all browsers back to IE7, thanks @dhg)
    [class*="span"] {
      #gridSystem > .gridColumn(@gridGutterWidth);
    }
    // Default columns
    .span1     { #gridSystem > .columns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 1); }
    .span2     { #gridSystem > .columns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 2); }
    .span3     { #gridSystem > .columns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 3); }
    .span4     { #gridSystem > .columns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 4); }
    .span5     { #gridSystem > .columns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 5); }
    .span6     { #gridSystem > .columns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 6); }
    .span7     { #gridSystem > .columns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 7); }
    .span8     { #gridSystem > .columns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 8); }
    .span9     { #gridSystem > .columns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 9); }
    .span10    { #gridSystem > .columns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 10); }
    .span11    { #gridSystem > .columns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 11); }
    .span12,
    .container { #gridSystem > .columns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 12); }
    // Offset column options
    .offset1   { #gridSystem > .offset(@gridColumnWidth, @gridGutterWidth, 1); }
    .offset2   { #gridSystem > .offset(@gridColumnWidth, @gridGutterWidth, 2); }
    .offset3   { #gridSystem > .offset(@gridColumnWidth, @gridGutterWidth, 3); }
    .offset4   { #gridSystem > .offset(@gridColumnWidth, @gridGutterWidth, 4); }
    .offset5   { #gridSystem > .offset(@gridColumnWidth, @gridGutterWidth, 5); }
    .offset6   { #gridSystem > .offset(@gridColumnWidth, @gridGutterWidth, 6); }
    .offset7   { #gridSystem > .offset(@gridColumnWidth, @gridGutterWidth, 7); }
    .offset8   { #gridSystem > .offset(@gridColumnWidth, @gridGutterWidth, 8); }
    .offset9   { #gridSystem > .offset(@gridColumnWidth, @gridGutterWidth, 9); }
    .offset10  { #gridSystem > .offset(@gridColumnWidth, @gridGutterWidth, 10); }
    .offset11  { #gridSystem > .offset(@gridColumnWidth, @gridGutterWidth, 11); }
  }
}

// Fluid grid system
// -------------------------
#fluidGridSystem {
  // Setup the mixins to be used
  .columns(@fluidGridGutterWidth, @fluidGridColumnWidth, @columns) {
    width: 1% * (@fluidGridColumnWidth * @columns) + (@fluidGridGutterWidth * (@columns - 1));
  }
  .gridColumn(@fluidGridGutterWidth) {
    float: left;
    margin-left: @fluidGridGutterWidth;
  }
  // Take these values and mixins, and make 'em do their thang
  .generate(@gridColumns, @fluidGridColumnWidth, @fluidGridGutterWidth) {
    // Row surrounds the columns
    .row-fluid {
      width: 100%;
      .clearfix();

      // Find all .span# classes within .row and give them the necessary properties for grid columns (supported by all browsers back to IE7, thanks @dhg)
      > [class*="span"] {
        #fluidGridSystem > .gridColumn(@fluidGridGutterWidth);
      }
      > [class*="span"]:first-child {
        margin-left: 0;
      }
      // Default columns
      > .span1     { #fluidGridSystem > .columns(@fluidGridGutterWidth, @fluidGridColumnWidth, 1); }
      > .span2     { #fluidGridSystem > .columns(@fluidGridGutterWidth, @fluidGridColumnWidth, 2); }
      > .span3     { #fluidGridSystem > .columns(@fluidGridGutterWidth, @fluidGridColumnWidth, 3); }
      > .span4     { #fluidGridSystem > .columns(@fluidGridGutterWidth, @fluidGridColumnWidth, 4); }
      > .span5     { #fluidGridSystem > .columns(@fluidGridGutterWidth, @fluidGridColumnWidth, 5); }
      > .span6     { #fluidGridSystem > .columns(@fluidGridGutterWidth, @fluidGridColumnWidth, 6); }
      > .span7     { #fluidGridSystem > .columns(@fluidGridGutterWidth, @fluidGridColumnWidth, 7); }
      > .span8     { #fluidGridSystem > .columns(@fluidGridGutterWidth, @fluidGridColumnWidth, 8); }
      > .span9     { #fluidGridSystem > .columns(@fluidGridGutterWidth, @fluidGridColumnWidth, 9); }
      > .span10    { #fluidGridSystem > .columns(@fluidGridGutterWidth, @fluidGridColumnWidth, 10); }
      > .span11    { #fluidGridSystem > .columns(@fluidGridGutterWidth, @fluidGridColumnWidth, 11); }
      > .span12    { #fluidGridSystem > .columns(@fluidGridGutterWidth, @fluidGridColumnWidth, 12); }
    }
  }
}

// Input grid system
// -------------------------
#inputGridSystem {
  .inputColumns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, @columns) {
    width: ((@gridColumnWidth) * @columns) + (@gridGutterWidth * (@columns - 1)) - 10;
  }
  .generate(@gridColumns, @gridColumnWidth, @gridGutterWidth) {
    input,
    textarea,
    .uneditable-input {
      &.span1     { #inputGridSystem > .inputColumns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 1); }
      &.span2     { #inputGridSystem > .inputColumns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 2); }
      &.span3     { #inputGridSystem > .inputColumns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 3); }
      &.span4     { #inputGridSystem > .inputColumns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 4); }
      &.span5     { #inputGridSystem > .inputColumns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 5); }
      &.span6     { #inputGridSystem > .inputColumns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 6); }
      &.span7     { #inputGridSystem > .inputColumns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 7); }
      &.span8     { #inputGridSystem > .inputColumns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 8); }
      &.span9     { #inputGridSystem > .inputColumns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 9); }
      &.span10    { #inputGridSystem > .inputColumns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 10); }
      &.span11    { #inputGridSystem > .inputColumns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 11); }
      &.span12    { #inputGridSystem > .inputColumns(@gridGutterWidth, @gridColumnWidth, @gridRowWidth, 12); }
    }
  }
}

// Make a Grid
// -------------------------
// Use .makeRow and .makeColumn to assign semantic layouts grid system behavior
.makeRow() {
  margin-left: @gridGutterWidth * -1;
  .clearfix();
}
.makeColumn(@columns: 1) {
  float: left;
  margin-left: @gridGutterWidth;
  width: (@gridColumnWidth * @columns) + (@gridGutterWidth * (@columns - 1));
}



// Form field states (used in forms.less)
// --------------------------------------------------

// Mixin for form field states
.formFieldState(@textColor: #555, @borderColor: #ccc, @backgroundColor: #f5f5f5) {
  // Set the text color
  > label,
  .help-block,
  .help-inline {
    color: @textColor;
  }
  // Style inputs accordingly
  input,
  select,
  textarea {
    color: @textColor;
    border-color: @borderColor;
    &:focus {
      border-color: darken(@borderColor, 10%);
      .box-shadow(0 0 6px lighten(@borderColor, 20%));
    }
  }
  // Give a small background color for input-prepend/-append
  .input-prepend .add-on,
  .input-append .add-on {
    color: @textColor;
    background-color: @backgroundColor;
    border-color: @textColor;
  }
}



// CSS3 PROPERTIES
// --------------------------------------------------

// Border Radius
.border-radius(@radius: 5px) {
  -webkit-border-radius: @radius;
     -moz-border-radius: @radius;
          border-radius: @radius;
}

// Drop shadows
.box-shadow(@shadow: 0 1px 3px rgba(0,0,0,.25)) {
  -webkit-box-shadow: @shadow;
     -moz-box-shadow: @shadow;
          box-shadow: @shadow;
}

// Transitions
.transition(@transition) {
  -webkit-transition: @transition;
     -moz-transition: @transition;
      -ms-transition: @transition;
       -o-transition: @transition;
          transition: @transition;
}

// Transformations
.rotate(@degrees) {
  -webkit-transform: rotate(@degrees);
     -moz-transform: rotate(@degrees);
      -ms-transform: rotate(@degrees);
       -o-transform: rotate(@degrees);
          transform: rotate(@degrees);
}
.scale(@ratio) {
  -webkit-transform: scale(@ratio);
     -moz-transform: scale(@ratio);
      -ms-transform: scale(@ratio);
       -o-transform: scale(@ratio);
          transform: scale(@ratio);
}
.translate(@x: 0, @y: 0) {
  -webkit-transform: translate(@x, @y);
     -moz-transform: translate(@x, @y);
      -ms-transform: translate(@x, @y);
       -o-transform: translate(@x, @y);
          transform: translate(@x, @y);
}
.skew(@x: 0, @y: 0) {
  -webkit-transform: skew(@x, @y);
     -moz-transform: skew(@x, @y);
      -ms-transform: skew(@x, @y);
       -o-transform: skew(@x, @y);
          transform: skew(@x, @y);
}
.translate3d(@x: 0, @y: 0, @z: 0) {
  -webkit-transform: translate(@x, @y, @z);
     -moz-transform: translate(@x, @y, @z);
      -ms-transform: translate(@x, @y, @z);
       -o-transform: translate(@x, @y, @z);
          transform: translate(@x, @y, @z);
}

// Background clipping
// Heads up: FF 3.6 and under need "padding" instead of "padding-box"
.background-clip(@clip) {
  -webkit-background-clip: @clip;
     -moz-background-clip: @clip;
          background-clip: @clip;
}

// Background sizing
.background-size(@size){
  -webkit-background-size: @size;
     -moz-background-size: @size;
       -o-background-size: @size;
          background-size: @size;
}


// Box sizing
.box-sizing(@boxmodel) {
  -webkit-box-sizing: @boxmodel;
     -moz-box-sizing: @boxmodel;
          box-sizing: @boxmodel;
}

// User select
// For selecting text on the page
.user-select(@select) {
  -webkit-user-select: @select;
     -moz-user-select: @select;
       -o-user-select: @select;
          user-select: @select;
}

// Resize anything
.resizable(@direction: both) {
  resize: @direction; // Options: horizontal, vertical, both
  overflow: auto; // Safari fix
}

// CSS3 Content Columns
.content-columns(@columnCount, @columnGap: @gridColumnGutter) {
  -webkit-column-count: @columnCount;
     -moz-column-count: @columnCount;
          column-count: @columnCount;
  -webkit-column-gap: @columnGap;
     -moz-column-gap: @columnGap;
          column-gap: @columnGap;
}

// Opacity
.opacity(@opacity: 100) {
  opacity: @opacity / 100;
   filter: e(%("alpha(opacity=%d)", @opacity));
}



// BACKGROUNDS
// --------------------------------------------------

// Add an alphatransparency value to any background or border color (via Elyse Holladay)
#translucent {
  .background(@color: @white, @alpha: 1) {
    background-color: hsla(hue(@color), saturation(@color), lightness(@color), @alpha);
  }
  .border(@color: @white, @alpha: 1) {
    border-color: hsla(hue(@color), saturation(@color), lightness(@color), @alpha);
    .background-clip(padding-box);
  }
}

// Gradient Bar Colors for buttons and alerts
.gradientBar(@primaryColor, @secondaryColor) {
  #gradient > .vertical(@primaryColor, @secondaryColor);
  border-color: @secondaryColor @secondaryColor darken(@secondaryColor, 15%);
  border-color: rgba(0,0,0,.1) rgba(0,0,0,.1) fadein(rgba(0,0,0,.1), 15%);
}

// Gradients
#gradient {
  .horizontal(@startColor: #555, @endColor: #333) {
    background-color: @endColor;
    background-image: -moz-linear-gradient(left, @startColor, @endColor); // FF 3.6+
    background-image: -ms-linear-gradient(left, @startColor, @endColor); // IE10
    background-image: -webkit-gradient(linear, 0 0, 100% 0, from(@startColor), to(@endColor)); // Safari 4+, Chrome 2+
    background-image: -webkit-linear-gradient(left, @startColor, @endColor); // Safari 5.1+, Chrome 10+
    background-image: -o-linear-gradient(left, @startColor, @endColor); // Opera 11.10
    background-image: linear-gradient(left, @startColor, @endColor); // Le standard
    background-repeat: repeat-x;
    filter: e(%("progid:DXImageTransform.Microsoft.gradient(startColorstr='%d', endColorstr='%d', GradientType=1)",@startColor,@endColor)); // IE9 and down
  }
  .vertical(@startColor: #555, @endColor: #333) {
    background-color: mix(@startColor, @endColor, 60%);
    background-image: -moz-linear-gradient(top, @startColor, @endColor); // FF 3.6+
    background-image: -ms-linear-gradient(top, @startColor, @endColor); // IE10
    background-image: -webkit-gradient(linear, 0 0, 0 100%, from(@startColor), to(@endColor)); // Safari 4+, Chrome 2+
    background-image: -webkit-linear-gradient(top, @startColor, @endColor); // Safari 5.1+, Chrome 10+
    background-image: -o-linear-gradient(top, @startColor, @endColor); // Opera 11.10
    background-image: linear-gradient(top, @startColor, @endColor); // The standard
    background-repeat: repeat-x;
    filter: e(%("progid:DXImageTransform.Microsoft.gradient(startColorstr='%d', endColorstr='%d', GradientType=0)",@startColor,@endColor)); // IE9 and down
  }
  .directional(@startColor: #555, @endColor: #333, @deg: 45deg) {
    background-color: @endColor;
    background-repeat: repeat-x;
    background-image: -moz-linear-gradient(@deg, @startColor, @endColor); // FF 3.6+
    background-image: -ms-linear-gradient(@deg, @startColor, @endColor); // IE10
    background-image: -webkit-linear-gradient(@deg, @startColor, @endColor); // Safari 5.1+, Chrome 10+
    background-image: -o-linear-gradient(@deg, @startColor, @endColor); // Opera 11.10
    background-image: linear-gradient(@deg, @startColor, @endColor); // The standard
  }
  .vertical-three-colors(@startColor: #00b3ee, @midColor: #7a43b6, @colorStop: 50%, @endColor: #c3325f) {
    background-color: mix(@midColor, @endColor, 80%);
    background-image: -webkit-gradient(linear, 0 0, 0 100%, from(@startColor), color-stop(@colorStop, @midColor), to(@endColor));
    background-image: -webkit-linear-gradient(@startColor, @midColor @colorStop, @endColor);
    background-image: -moz-linear-gradient(top, @startColor, @midColor @colorStop, @endColor);
    background-image: -ms-linear-gradient(@startColor, @midColor @colorStop, @endColor);
    background-image: -o-linear-gradient(@startColor, @midColor @colorStop, @endColor);
    background-image: linear-gradient(@startColor, @midColor @colorStop, @endColor);
    background-repeat: no-repeat;
    filter: e(%("progid:DXImageTransform.Microsoft.gradient(startColorstr='%d', endColorstr='%d', GradientType=0)",@startColor,@endColor)); // IE9 and down, gets no color-stop at all for proper fallback
  }
  .radial(@innerColor: #555, @outerColor: #333)  {
    background-color: @outerColor;
    background-image: -webkit-gradient(radial, center center, 0, center center, 460, from(@innerColor), to(@outerColor));
    background-image: -webkit-radial-gradient(circle, @innerColor, @outerColor);
    background-image: -moz-radial-gradient(circle, @innerColor, @outerColor);
    background-image: -ms-radial-gradient(circle, @innerColor, @outerColor);
    background-repeat: no-repeat;
    // Opera cannot do radial gradients yet
  }
  .striped(@color, @angle: -45deg) {
    background-color: @color;
    background-image: -webkit-gradient(linear, 0 100%, 100% 0, color-stop(.25, rgba(255,255,255,.15)), color-stop(.25, transparent), color-stop(.5, transparent), color-stop(.5, rgba(255,255,255,.15)), color-stop(.75, rgba(255,255,255,.15)), color-stop(.75, transparent), to(transparent));
    background-image: -webkit-linear-gradient(@angle, rgba(255,255,255,.15) 25%, transparent 25%, transparent 50%, rgba(255,255,255,.15) 50%, rgba(255,255,255,.15) 75%, transparent 75%, transparent);
    background-image: -moz-linear-gradient(@angle, rgba(255,255,255,.15) 25%, transparent 25%, transparent 50%, rgba(255,255,255,.15) 50%, rgba(255,255,255,.15) 75%, transparent 75%, transparent);
    background-image: -ms-linear-gradient(@angle, rgba(255,255,255,.15) 25%, transparent 25%, transparent 50%, rgba(255,255,255,.15) 50%, rgba(255,255,255,.15) 75%, transparent 75%, transparent);
    background-image: -o-linear-gradient(@angle, rgba(255,255,255,.15) 25%, transparent 25%, transparent 50%, rgba(255,255,255,.15) 50%, rgba(255,255,255,.15) 75%, transparent 75%, transparent);
    background-image: linear-gradient(@angle, rgba(255,255,255,.15) 25%, transparent 25%, transparent 50%, rgba(255,255,255,.15) 50%, rgba(255,255,255,.15) 75%, transparent 75%, transparent);
  }
}
// Reset filters for IE
.reset-filter() {
  filter: e(%("progid:DXImageTransform.Microsoft.gradient(enabled = false)"));
}


// Mixin for generating button backgrounds
// ---------------------------------------
.buttonBackground(@startColor, @endColor) {
  // gradientBar will set the background to a pleasing blend of these, to support IE<=9
  .gradientBar(@startColor, @endColor);
  .reset-filter();

  // in these cases the gradient won't cover the background, so we override
  &:hover, &:active, &.active, &.disabled, &[disabled] {
    background-color: @endColor;
  }

  // IE 7 + 8 can't handle box-shadow to show active, so we darken a bit ourselves
  &:active,
  &.active {
    background-color: darken(@endColor, 10%) e("\9");
  }
}


// COMPONENT MIXINS
// --------------------------------------------------

// POPOVER ARROWS
// -------------------------
// For tipsies and popovers
#popoverArrow {
  .top(@arrowWidth: 5px) {
    bottom: 0;
    left: 50%;
    margin-left: -@arrowWidth;
    border-left: @arrowWidth solid transparent;
    border-right: @arrowWidth solid transparent;
    border-top: @arrowWidth solid @black;
  }
  .left(@arrowWidth: 5px) {
    top: 50%;
    right: 0;
    margin-top: -@arrowWidth;
    border-top: @arrowWidth solid transparent;
    border-bottom: @arrowWidth solid transparent;
    border-left: @arrowWidth solid @black;
  }
  .bottom(@arrowWidth: 5px) {
    top: 0;
    left: 50%;
    margin-left: -@arrowWidth;
    border-left: @arrowWidth solid transparent;
    border-right: @arrowWidth solid transparent;
    border-bottom: @arrowWidth solid @black;
  }
  .right(@arrowWidth: 5px) {
    top: 50%;
    left: 0;
    margin-top: -@arrowWidth;
    border-top: @arrowWidth solid transparent;
    border-bottom: @arrowWidth solid transparent;
    border-right: @arrowWidth solid @black;
  }
}
;T;	@�;
@�I"/assets/less/navbar/;T{;{;I"// NAVBAR (FIXED AND STATIC)
// -------------------------


// COMMON STYLES
// -------------

.navbar {
  overflow: visible;
  margin-bottom: @baseLineHeight;
}

// Gradient is applied to it's own element because overflow visible is not honored by IE when filter is present
.navbar-inner {
  padding-left:  20px;
  padding-right: 20px;
  #gradient > .vertical(@navbarBackgroundHighlight, @navbarBackground);
  .border-radius(4px);
  @shadow: 0 1px 3px rgba(0,0,0,.25), inset 0 -1px 0 rgba(0,0,0,.1);
  .box-shadow(@shadow);
}

// Navbar button for toggling navbar items in responsive layouts
.btn-navbar {
  display: none;
  float: right;
  padding: 7px 10px;
  margin-left: 5px;
  margin-right: 5px;
  .buttonBackground(@navbarBackgroundHighlight, @navbarBackground);
  @shadow: inset 0 1px 0 rgba(255,255,255,.1), 0 1px 0 rgba(255,255,255,.075);
  .box-shadow(@shadow);
}
.btn-navbar .icon-bar {
  display: block;
  width: 18px;
  height: 2px;
  background-color: #f5f5f5;
  .border-radius(1px);
  .box-shadow(0 1px 0 rgba(0,0,0,.25));
}
.btn-navbar .icon-bar + .icon-bar {
  margin-top: 3px;
}
// Override the default collapsed state
.nav-collapse.collapse {
  height: auto;
}


// Brand, links, text, and buttons
.navbar {
  // Hover and active states
  .brand:hover {
    text-decoration: none;
  }
  // Website or project name
  .brand {
    float: left;
    display: block;
    padding: 8px 20px 12px;
    margin-left: -20px; // negative indent to left-align the text down the page
    font-size: 20px;
    font-weight: 200;
    line-height: 1;
    color: @white;
  }
  // Plain text in topbar
  .navbar-text {
    margin-bottom: 0;
    line-height: 40px;
    color: @navbarText;
    a:hover {
      color: @white;
      background-color: transparent;
    }
  }
  // Buttons in navbar
  .btn,
  .btn-group {
    margin-top: 5px; // make buttons vertically centered in navbar
  }
  .btn-group .btn {
    margin-top: 0; // then undo the margin here so we don't accidentally double it
  }
}

// Navbar forms
.navbar-form {
  margin-bottom: 0; // remove default bottom margin
  .clearfix();
  input,
  select {
    display: inline-block;
    margin-top: 5px;
    margin-bottom: 0;
  }
  .radio,
  .checkbox {
    margin-top: 5px;
  }
  input[type="image"],
  input[type="checkbox"],
  input[type="radio"] {
    margin-top: 3px;
  }
  .input-append,
  .input-prepend {
    margin-top: 6px;
    white-space: nowrap; // preven two  items from separating within a .navbar-form that has .pull-left
    input {
      margin-top: 0; // remove the margin on top since it's on the parent
    }
  }
}

// Navbar search
.navbar-search {
  position: relative;
  float: left;
  margin-top: 6px;
  margin-bottom: 0;
  .search-query {
    padding: 4px 9px;
    #font > .sans-serif(13px, normal, 1);
    color: @white;
    color: rgba(255,255,255,.75);
    background: #666;
    background: rgba(255,255,255,.3);
    border: 1px solid #111;
    @shadow: inset 0 1px 2px rgba(0,0,0,.1), 0 1px 0px rgba(255,255,255,.15);
    .box-shadow(@shadow);
    .transition(none);

    // Placeholder text gets special styles; can't be bundled together though for some reason
    .placeholder(@grayLighter);

    // Hover states
    &:hover {
      color: @white;
      background-color: @grayLight;
      background-color: rgba(255,255,255,.5);
    }
    // Focus states (we use .focused since IE7-8 and down doesn't support :focus)
    &:focus,
    &.focused {
      padding: 5px 10px;
      color: @grayDark;
      text-shadow: 0 1px 0 @white;
      background-color: @white;
      border: 0;
      .box-shadow(0 0 3px rgba(0,0,0,.15));
      outline: 0;
    }
  }
}


// FIXED NAVBAR
// ------------

.navbar-fixed-top {
  position: fixed;
  top: 0;
  right: 0;
  left: 0;
  z-index: @zindexFixedNavbar;
}
.navbar-fixed-top .navbar-inner {
  padding-left:  0;
  padding-right: 0;
  .border-radius(0);
}


// NAVIGATION
// ----------

.navbar .nav {
  position: relative;
  left: 0;
  display: block;
  float: left;
  margin: 0 10px 0 0;
}
.navbar .nav.pull-right {
  float: right; // redeclare due to specificity
}
.navbar .nav > li {
  display: block;
  float: left;
}

// Links
.navbar .nav > li > a {
  float: none;
  padding: 10px 10px 11px;
  line-height: 19px;
  color: @navbarLinkColor;
  text-decoration: none;
  text-shadow: 0 -1px 0 rgba(0,0,0,.25);
}
// Hover
.navbar .nav > li > a:hover {
  background-color: @navbarLinkBackgroundHover; // "transparent" is default to differentiate :hover from .active
  color: @navbarLinkColorHover;
  text-decoration: none;
}

// Active nav items
.navbar .nav .active > a,
.navbar .nav .active > a:hover {
  color: @navbarLinkColorHover;
  text-decoration: none;
  background-color: @navbarBackground;
}

// Dividers (basically a vertical hr)
.navbar .divider-vertical {
  height: @navbarHeight;
  width: 1px;
  margin: 0 9px;
  overflow: hidden;
  background-color: @navbarBackground;
  border-right: 1px solid @navbarBackgroundHighlight;
}

// Secondary (floated right) nav in topbar
.navbar .nav.pull-right {
  margin-left: 10px;
  margin-right: 0;
}



// Dropdown menus
// --------------

// Menu position and menu carets
.navbar .dropdown-menu {
  margin-top: 1px;
  .border-radius(4px);
  &:before {
    content: '';
    display: inline-block;
    border-left:   7px solid transparent;
    border-right:  7px solid transparent;
    border-bottom: 7px solid #ccc;
    border-bottom-color: rgba(0,0,0,.2);
    position: absolute;
    top: -7px;
    left: 9px;
  }
  &:after {
    content: '';
    display: inline-block;
    border-left:   6px solid transparent;
    border-right:  6px solid transparent;
    border-bottom: 6px solid @white;
    position: absolute;
    top: -6px;
    left: 10px;
  }
}

// Dropdown toggle caret
.navbar .nav .dropdown-toggle .caret,
.navbar .nav .open.dropdown .caret {
  border-top-color: @white;
}
.navbar .nav .active .caret {
  .opacity(100);
}

// Remove background color from open dropdown
.navbar .nav .open > .dropdown-toggle,
.navbar .nav .active > .dropdown-toggle,
.navbar .nav .open.active > .dropdown-toggle {
  background-color: transparent;
}

// Dropdown link on hover
.navbar .nav .active > .dropdown-toggle:hover {
  color: @white;
}

// Right aligned menus need alt position
.navbar .nav.pull-right .dropdown-menu {
  left: auto;
  right: 0;
  &:before {
    left: auto;
    right: 12px;
  }
  &:after {
    left: auto;
    right: 13px;
  }
};T;	@�;
@�I"/assets/less/wells/;T{;{;I"J// WELLS
// -----

.well {
  min-height: 20px;
  padding: 19px;
  margin-bottom: 20px;
  background-color: #f5f5f5;
  border: 1px solid #eee;
  border: 1px solid rgba(0,0,0,.05);
  .border-radius(4px);
  .box-shadow(inset 0 1px 1px rgba(0,0,0,.05));
  blockquote {
    border-color: #ddd;
    border-color: rgba(0,0,0,.15);
  }
}
;T;	@�;
@�I"/assets/less/alerts/;T{;{;I"�// ALERT STYLES
// ------------

// Base alert styles
.alert {
  padding: 8px 35px 8px 14px;
  margin-bottom: @baseLineHeight;
  text-shadow: 0 1px 0 rgba(255,255,255,.5);
  background-color: @warningBackground;
  border: 1px solid @warningBorder;
  .border-radius(4px);
}
.alert,
.alert-heading {
  color: @warningText;
}

// Adjust close link position
.alert .close {
  position: relative;
  top: -2px;
  right: -21px;
  line-height: 18px;
}

// Alternate styles
// ----------------

.alert-success {
  background-color: @successBackground;
  border-color: @successBorder;  
}
.alert-success,
.alert-success .alert-heading {
  color: @successText;
}
.alert-danger,
.alert-error {
  background-color: @errorBackground;
  border-color: @errorBorder;
}
.alert-danger,
.alert-error,
.alert-danger .alert-heading,
.alert-error .alert-heading {
  color: @errorText;
}
.alert-info {
  background-color: @infoBackground;
  border-color: @infoBorder;
}
.alert-info,
.alert-info .alert-heading {
  color: @infoText;
}


// Block alerts
// ------------------------
.alert-block {
  padding-top: 14px;
  padding-bottom: 14px;
}
.alert-block > p,
.alert-block > ul {
  margin-bottom: 0;
}
.alert-block p + p {
  margin-top: 5px;
}
;T;	@�;
@�I"/assets/less/labels/;T{;{;I"A// LABELS
// ------

// Base
.label {
  padding: 2px 4px 3px;
  font-size: @baseFontSize * .85;
  font-weight: bold;
  color: @white;
  text-shadow: 0 -1px 0 rgba(0,0,0,.25);
  background-color: @grayLight;
  .border-radius(3px);
}

// Hover state
.label:hover {
  color: @white;
  text-decoration: none;
}

// Colors
.label-important        { background-color: @errorText; }
.label-important:hover  { background-color: darken(@errorText, 10%); }

.label-warning          { background-color: @orange; }
.label-warning:hover    { background-color: darken(@orange, 10%); }

.label-success          { background-color: @successText; }
.label-success:hover    { background-color: darken(@successText, 10%); }

.label-info             { background-color: @infoText; }
.label-info:hover       { background-color: darken(@infoText, 10%); }
;T;	@�;
@�I"/assets/less/sprites/;T{;{;I"4!// SPRITES
// Glyphs and icons for buttons, nav, and more
// -------------------------------------------


// ICONS
// -----

// All icons receive the styles of the  tag with a base class 
// of .i and are then given a unique class to add width, height, 
// and background-position. Your resulting HTML will look like
// .

// For the white version of the  icons, just add the .icon-white class:
// 

[class^="icon-"],
[class*=" icon-"] {
  display: inline-block;
  width: 14px;
  height: 14px;
  line-height: 14px;
  vertical-align: text-top;
  background-image: url(@iconSpritePath);
  background-position: 14px 14px;
  background-repeat: no-repeat;

  .ie7-restore-right-whitespace();
}
.icon-white {
  background-image: url(@iconWhiteSpritePath);
}

.icon-glass              { background-position: 0      0; }
.icon-music              { background-position: -24px  0; }
.icon-search             { background-position: -48px  0; }
.icon-envelope           { background-position: -72px  0; }
.icon-heart              { background-position: -96px  0; }
.icon-star               { background-position: -120px 0; }
.icon-star-empty         { background-position: -144px 0; }
.icon-user               { background-position: -168px 0; }
.icon-film               { background-position: -192px 0; }
.icon-th-large           { background-position: -216px 0; }
.icon-th                 { background-position: -240px 0; }
.icon-th-list            { background-position: -264px 0; }
.icon-ok                 { background-position: -288px 0; }
.icon-remove             { background-position: -312px 0; }
.icon-zoom-in            { background-position: -336px 0; }
.icon-zoom-out           { background-position: -360px 0; }
.icon-off                { background-position: -384px 0; }
.icon-signal             { background-position: -408px 0; }
.icon-cog                { background-position: -432px 0; }
.icon-trash              { background-position: -456px 0; }

.icon-home               { background-position: 0      -24px; }
.icon-file               { background-position: -24px  -24px; }
.icon-time               { background-position: -48px  -24px; }
.icon-road               { background-position: -72px  -24px; }
.icon-download-alt       { background-position: -96px  -24px; }
.icon-download           { background-position: -120px -24px; }
.icon-upload             { background-position: -144px -24px; }
.icon-inbox              { background-position: -168px -24px; }
.icon-play-circle        { background-position: -192px -24px; }
.icon-repeat             { background-position: -216px -24px; }
.icon-refresh            { background-position: -240px -24px; }
.icon-list-alt           { background-position: -264px -24px; }
.icon-lock               { background-position: -287px -24px; } // 1px off
.icon-flag               { background-position: -312px -24px; }
.icon-headphones         { background-position: -336px -24px; }
.icon-volume-off         { background-position: -360px -24px; }
.icon-volume-down        { background-position: -384px -24px; }
.icon-volume-up          { background-position: -408px -24px; }
.icon-qrcode             { background-position: -432px -24px; }
.icon-barcode            { background-position: -456px -24px; }

.icon-tag                { background-position: 0      -48px; }
.icon-tags               { background-position: -25px  -48px; } // 1px off
.icon-book               { background-position: -48px  -48px; }
.icon-bookmark           { background-position: -72px  -48px; }
.icon-print              { background-position: -96px  -48px; }
.icon-camera             { background-position: -120px -48px; }
.icon-font               { background-position: -144px -48px; }
.icon-bold               { background-position: -167px -48px; } // 1px off
.icon-italic             { background-position: -192px -48px; }
.icon-text-height        { background-position: -216px -48px; }
.icon-text-width         { background-position: -240px -48px; }
.icon-align-left         { background-position: -264px -48px; }
.icon-align-center       { background-position: -288px -48px; }
.icon-align-right        { background-position: -312px -48px; }
.icon-align-justify      { background-position: -336px -48px; }
.icon-list               { background-position: -360px -48px; }
.icon-indent-left        { background-position: -384px -48px; }
.icon-indent-right       { background-position: -408px -48px; }
.icon-facetime-video     { background-position: -432px -48px; }
.icon-picture            { background-position: -456px -48px; }

.icon-pencil             { background-position: 0      -72px; }
.icon-map-marker         { background-position: -24px  -72px; }
.icon-adjust             { background-position: -48px  -72px; }
.icon-tint               { background-position: -72px  -72px; }
.icon-edit               { background-position: -96px  -72px; }
.icon-share              { background-position: -120px -72px; }
.icon-check              { background-position: -144px -72px; }
.icon-move               { background-position: -168px -72px; }
.icon-step-backward      { background-position: -192px -72px; }
.icon-fast-backward      { background-position: -216px -72px; }
.icon-backward           { background-position: -240px -72px; }
.icon-play               { background-position: -264px -72px; }
.icon-pause              { background-position: -288px -72px; }
.icon-stop               { background-position: -312px -72px; }
.icon-forward            { background-position: -336px -72px; }
.icon-fast-forward       { background-position: -360px -72px; }
.icon-step-forward       { background-position: -384px -72px; }
.icon-eject              { background-position: -408px -72px; }
.icon-chevron-left       { background-position: -432px -72px; }
.icon-chevron-right      { background-position: -456px -72px; }

.icon-plus-sign          { background-position: 0      -96px; }
.icon-minus-sign         { background-position: -24px  -96px; }
.icon-remove-sign        { background-position: -48px  -96px; }
.icon-ok-sign            { background-position: -72px  -96px; }
.icon-question-sign      { background-position: -96px  -96px; }
.icon-info-sign          { background-position: -120px -96px; }
.icon-screenshot         { background-position: -144px -96px; }
.icon-remove-circle      { background-position: -168px -96px; }
.icon-ok-circle          { background-position: -192px -96px; }
.icon-ban-circle         { background-position: -216px -96px; }
.icon-arrow-left         { background-position: -240px -96px; }
.icon-arrow-right        { background-position: -264px -96px; }
.icon-arrow-up           { background-position: -289px -96px; } // 1px off
.icon-arrow-down         { background-position: -312px -96px; }
.icon-share-alt          { background-position: -336px -96px; }
.icon-resize-full        { background-position: -360px -96px; }
.icon-resize-small       { background-position: -384px -96px; }
.icon-plus               { background-position: -408px -96px; }
.icon-minus              { background-position: -433px -96px; }
.icon-asterisk           { background-position: -456px -96px; }

.icon-exclamation-sign   { background-position: 0      -120px; }
.icon-gift               { background-position: -24px  -120px; }
.icon-leaf               { background-position: -48px  -120px; }
.icon-fire               { background-position: -72px  -120px; }
.icon-eye-open           { background-position: -96px  -120px; }
.icon-eye-close          { background-position: -120px -120px; }
.icon-warning-sign       { background-position: -144px -120px; }
.icon-plane              { background-position: -168px -120px; }
.icon-calendar           { background-position: -192px -120px; }
.icon-random             { background-position: -216px -120px; }
.icon-comment            { background-position: -240px -120px; }
.icon-magnet             { background-position: -264px -120px; }
.icon-chevron-up         { background-position: -288px -120px; }
.icon-chevron-down       { background-position: -313px -119px; } // 1px off
.icon-retweet            { background-position: -336px -120px; }
.icon-shopping-cart      { background-position: -360px -120px; }
.icon-folder-close       { background-position: -384px -120px; }
.icon-folder-open        { background-position: -408px -120px; }
.icon-resize-vertical    { background-position: -432px -119px; }
.icon-resize-horizontal  { background-position: -456px -118px; }
;T;	@�;
@�I" /assets/less/button-groups/;T{;{;I",// BUTTON GROUPS
// -------------


// Make the div behave like a button
.btn-group {
  position: relative;
  .clearfix(); // clears the floated buttons
  .ie7-restore-left-whitespace();
}

// Space out series of button groups
.btn-group + .btn-group {
  margin-left: 5px;
}

// Optional: Group multiple button groups together for a toolbar
.btn-toolbar {
  margin-top: @baseLineHeight / 2;
  margin-bottom: @baseLineHeight / 2;
  .btn-group {
    display: inline-block;
    .ie7-inline-block();
  }
}

// Float them, remove border radius, then re-add to first and last elements
.btn-group .btn {
  position: relative;
  float: left;
  margin-left: -1px;
  .border-radius(0);
}
// Set corners individual because sometimes a single button can be in a .btn-group and we need :first-child and :last-child to both match
.btn-group .btn:first-child {
  margin-left: 0;
     -webkit-border-top-left-radius: 4px;
         -moz-border-radius-topleft: 4px;
             border-top-left-radius: 4px;
  -webkit-border-bottom-left-radius: 4px;
      -moz-border-radius-bottomleft: 4px;
          border-bottom-left-radius: 4px;
}
.btn-group .btn:last-child,
.btn-group .dropdown-toggle {
     -webkit-border-top-right-radius: 4px;
         -moz-border-radius-topright: 4px;
             border-top-right-radius: 4px;
  -webkit-border-bottom-right-radius: 4px;
      -moz-border-radius-bottomright: 4px;
          border-bottom-right-radius: 4px;
}
// Reset corners for large buttons
.btn-group .btn.large:first-child {
  margin-left: 0;
     -webkit-border-top-left-radius: 6px;
         -moz-border-radius-topleft: 6px;
             border-top-left-radius: 6px;
  -webkit-border-bottom-left-radius: 6px;
      -moz-border-radius-bottomleft: 6px;
          border-bottom-left-radius: 6px;
}
.btn-group .btn.large:last-child,
.btn-group .large.dropdown-toggle {
     -webkit-border-top-right-radius: 6px;
         -moz-border-radius-topright: 6px;
             border-top-right-radius: 6px;
  -webkit-border-bottom-right-radius: 6px;
      -moz-border-radius-bottomright: 6px;
          border-bottom-right-radius: 6px;
}

// On hover/focus/active, bring the proper btn to front
.btn-group .btn:hover,
.btn-group .btn:focus,
.btn-group .btn:active,
.btn-group .btn.active {
  z-index: 2;
}

// On active and open, don't show outline
.btn-group .dropdown-toggle:active,
.btn-group.open .dropdown-toggle {
  outline: 0;
}



// Split button dropdowns
// ----------------------

// Give the line between buttons some depth
.btn-group .dropdown-toggle {
  padding-left: 8px;
  padding-right: 8px;
  @shadow: inset 1px 0 0 rgba(255,255,255,.125), inset 0 1px 0 rgba(255,255,255,.2), 0 1px 2px rgba(0,0,0,.05);
  .box-shadow(@shadow);
  *padding-top: 5px;
  *padding-bottom: 5px;
}

.btn-group.open {
  // IE7's z-index only goes to the nearest positioned ancestor, which would
  // make the menu appear below buttons that appeared later on the page
  *z-index: @zindexDropdown;

  // Reposition menu on open and round all corners
  .dropdown-menu {
    display: block;
    margin-top: 1px;
    .border-radius(5px);
  }

  .dropdown-toggle {
    background-image: none;
    @shadow: inset 0 1px 6px rgba(0,0,0,.15), 0 1px 2px rgba(0,0,0,.05);
    .box-shadow(@shadow);
  }
}

// Reposition the caret
.btn .caret {
  margin-top: 7px;
  margin-left: 0;
}
.btn:hover .caret,
.open.btn-group .caret {
  .opacity(100);
}


// Account for other colors
.btn-primary,
.btn-danger,
.btn-info,
.btn-success,
.btn-inverse {
  .caret {
    border-top-color: @white;
    .opacity(75);
  }
}

// Small button dropdowns
.btn-small .caret {
  margin-top: 4px;
}

;T;	@�;
@�I"/assets/less/tables/;T{;{;I"�//
// Tables.less
// Tables for, you guessed it, tabular data
// ----------------------------------------


// BASE TABLES
// -----------------

table {
  max-width: 100%;
  border-collapse: collapse;
  border-spacing: 0;
}

// BASELINE STYLES
// ---------------

.table {
  width: 100%;
  margin-bottom: @baseLineHeight;
  // Cells
  th,
  td {
    padding: 8px;
    line-height: @baseLineHeight;
    text-align: left;
    vertical-align: top;
    border-top: 1px solid #ddd;
  }
  th {
    font-weight: bold;
  }
  // Bottom align for column headings
  thead th {
    vertical-align: bottom;
  }
  // Remove top border from thead by default
  thead:first-child tr th,
  thead:first-child tr td {
    border-top: 0;
  }
  // Account for multiple tbody instances
  tbody + tbody {
    border-top: 2px solid #ddd;
  }
}



// CONDENSED TABLE W/ HALF PADDING
// -------------------------------

.table-condensed {
  th,
  td {
    padding: 4px 5px;
  }
}


// BORDERED VERSION
// ----------------

.table-bordered {
  border: 1px solid #ddd;
  border-collapse: separate; // Done so we can round those corners!
  *border-collapse: collapsed; // IE7 can't round corners anyway
  .border-radius(4px);
  th + th,
  td + td,
  th + td,
  td + th {
    border-left: 1px solid #ddd;
  }
  // Prevent a double border
  thead:first-child tr:first-child th,
  tbody:first-child tr:first-child th,
  tbody:first-child tr:first-child td {
    border-top: 0;
  }
  // For first th or td in the first row in the first thead or tbody
  thead:first-child tr:first-child th:first-child,
  tbody:first-child tr:first-child td:first-child {
    .border-radius(4px 0 0 0);
  }
  thead:first-child tr:first-child th:last-child,
  tbody:first-child tr:first-child td:last-child {
    .border-radius(0 4px 0 0);
  }
  // For first th or td in the first row in the first thead or tbody
  thead:last-child tr:last-child th:first-child,
  tbody:last-child tr:last-child td:first-child {
    .border-radius(0 0 0 4px);
  }
  thead:last-child tr:last-child th:last-child,
  tbody:last-child tr:last-child td:last-child {
    .border-radius(0 0 4px 0);
  }
}


// ZEBRA-STRIPING
// --------------

// Default zebra-stripe styles (alternating gray and transparent backgrounds)
.table-striped {
  tbody {
    tr:nth-child(odd) td,
    tr:nth-child(odd) th {
      background-color: #f9f9f9;
    }
  }
}


// HOVER EFFECT
// ------------
// Placed here since it has to come after the potential zebra striping
.table {
  tbody tr:hover td,
  tbody tr:hover th {
    background-color: #f5f5f5;
  }
}


// TABLE CELL SIZING
// -----------------

// Change the columns
.tableColumns(@columnSpan: 1) {
  float: none;
  width: ((@gridColumnWidth) * @columnSpan) + (@gridGutterWidth * (@columnSpan - 1)) - 16;
  margin-left: 0;
}
table {
  .span1     { .tableColumns(1); }
  .span2     { .tableColumns(2); }
  .span3     { .tableColumns(3); }
  .span4     { .tableColumns(4); }
  .span5     { .tableColumns(5); }
  .span6     { .tableColumns(6); }
  .span7     { .tableColumns(7); }
  .span8     { .tableColumns(8); }
  .span9     { .tableColumns(9); }
  .span10    { .tableColumns(10); }
  .span11    { .tableColumns(11); }
  .span12    { .tableColumns(12); }
}
;T;	@�;
@�I"/assets/less/tooltip/;T{;{;I"#// TOOLTIP
// ------=

.tooltip {
  position: absolute;
  z-index: @zindexTooltip;
  display: block;
  visibility: visible;
  padding: 5px;
  font-size: 11px;
  .opacity(0);
  &.in     { .opacity(80); }
  &.top    { margin-top:  -2px; }
  &.right  { margin-left:  2px; }
  &.bottom { margin-top:   2px; }
  &.left   { margin-left: -2px; }
  &.top .tooltip-arrow    { #popoverArrow > .top(); }
  &.left .tooltip-arrow   { #popoverArrow > .left(); }
  &.bottom .tooltip-arrow { #popoverArrow > .bottom(); }
  &.right .tooltip-arrow  { #popoverArrow > .right(); }
}
.tooltip-inner {
  max-width: 200px;
  padding: 3px 8px;
  color: @white;
  text-align: center;
  text-decoration: none;
  background-color: @black;
  .border-radius(4px);
}
.tooltip-arrow {
  position: absolute;
  width: 0;
  height: 0;
}
;T;	@�;
@�I"/assets/less/dropdowns/;T{;{;I"'// DROPDOWN MENUS
// --------------

// Use the .menu class on any  element within the topbar or ul.tabs and you'll get some superfancy dropdowns
.dropdown {
  position: relative;
}
.dropdown-toggle {
  // The caret makes the toggle a bit too tall in IE7
  *margin-bottom: -3px;
}
.dropdown-toggle:active,
.open .dropdown-toggle {
  outline: 0;
}
// Dropdown arrow/caret
.caret {
  display: inline-block;
  width: 0;
  height: 0;
  text-indent: -99999px;
  // IE7 won't do the border trick if there's a text indent, but it doesn't
  // do the content that text-indent is hiding, either, so we're ok.
  *text-indent: 0;
  vertical-align: top;
  border-left:  4px solid transparent;
  border-right: 4px solid transparent;
  border-top:   4px solid @black;
  .opacity(30);
  content: "\2193";
}
.dropdown .caret {
  margin-top: 8px;
  margin-left: 2px;
}
.dropdown:hover .caret,
.open.dropdown .caret {
  .opacity(100);
}
// The dropdown menu (ul)
.dropdown-menu {
  position: absolute;
  top: 100%;
  left: 0;
  z-index: @zindexDropdown;
  float: left;
  display: none; // none by default, but block on "open" of the menu
  min-width: 160px;
  _width: 160px;
  padding: 4px 0;
  margin: 0; // override default ul
  list-style: none;
  background-color: @white;
  border-color: #ccc;
  border-color: rgba(0,0,0,.2);
  border-style: solid;
  border-width: 1px;
  .border-radius(0 0 5px 5px);
  .box-shadow(0 5px 10px rgba(0,0,0,.2));
  -webkit-background-clip: padding-box;
     -moz-background-clip: padding;
          background-clip: padding-box;
  *border-right-width: 2px;
  *border-bottom-width: 2px;

  // Allow for dropdowns to go bottom up (aka, dropup-menu)
  &.bottom-up {
    top: auto;
    bottom: 100%;
    margin-bottom: 2px;
  }

  // Dividers (basically an hr) within the dropdown
  .divider {
    height: 1px;
    margin: 5px 1px;
    overflow: hidden;
    background-color: #e5e5e5;
    border-bottom: 1px solid @white;

    // IE7 needs a set width since we gave a height. Restricting just
    // to IE7 to keep the 1px left/right space in other browsers.
    // It is unclear where IE is getting the extra space that we need
    // to negative-margin away, but so it goes.
    *width: 100%;
    *margin: -5px 0 5px;
  }

  // Links within the dropdown menu
  a {
    display: block;
    padding: 3px 15px;
    clear: both;
    font-weight: normal;
    line-height: @baseLineHeight;
    color: @gray;
    white-space: nowrap;
  }
}

// Hover state
.dropdown-menu li > a:hover,
.dropdown-menu .active > a,
.dropdown-menu .active > a:hover {
  color: @white;
  text-decoration: none;
  background-color: @linkColor;
}

// Open state for the dropdown
.dropdown.open {
  // IE7's z-index only goes to the nearest positioned ancestor, which would
  // make the menu appear below buttons that appeared later on the page
  *z-index: @zindexDropdown;

  .dropdown-toggle {
    color: @white;
    background: #ccc;
    background: rgba(0,0,0,.3);
  }
  .dropdown-menu {
    display: block;
  }
}

// Typeahead
.typeahead {
  margin-top: 2px; // give it some space to breathe
  .border-radius(4px);
}
;T;	@�;
@�I" /assets/less/progress-bars/;T{;{;I"M// PROGRESS BARS
// -------------


// ANIMATIONS
// ----------

// Webkit
@-webkit-keyframes progress-bar-stripes {
  from  { background-position: 0 0; }
  to    { background-position: 40px 0; }
}

// Firefox
@-moz-keyframes progress-bar-stripes {
  from  { background-position: 0 0; }
  to    { background-position: 40px 0; }
}

// Spec
@keyframes progress-bar-stripes {
  from  { background-position: 0 0; }
  to    { background-position: 40px 0; }
}



// THE BARS
// --------

// Outer container
.progress {
  overflow: hidden;
  height: 18px;
  margin-bottom: 18px;
  #gradient > .vertical(#f5f5f5, #f9f9f9);
  .box-shadow(inset 0 1px 2px rgba(0,0,0,.1));
  .border-radius(4px);
}

// Bar of progress
.progress .bar {
  width: 0%;
  height: 18px;
  color: @white;
  font-size: 12px;
  text-align: center;
  text-shadow: 0 -1px 0 rgba(0,0,0,.25);
  #gradient > .vertical(#149bdf, #0480be);
  .box-shadow(inset 0 -1px 0 rgba(0,0,0,.15));
  .box-sizing(border-box);
  .transition(width .6s ease);
}

// Striped bars
.progress-striped .bar {
  #gradient > .striped(#62c462);
  .background-size(40px 40px);
}

// Call animation for the active one
.progress.active .bar {
  -webkit-animation: progress-bar-stripes 2s linear infinite;
     -moz-animation: progress-bar-stripes 2s linear infinite;
          animation: progress-bar-stripes 2s linear infinite;
}



// COLORS
// ------

// Danger (red)
.progress-danger .bar {
  #gradient > .vertical(#ee5f5b, #c43c35);
}
.progress-danger.progress-striped .bar {
  #gradient > .striped(#ee5f5b);
}

// Success (green)
.progress-success .bar {
  #gradient > .vertical(#62c462, #57a957);
}
.progress-success.progress-striped .bar {
  #gradient > .striped(#62c462);
}

// Info (teal)
.progress-info .bar {
  #gradient > .vertical(#5bc0de, #339bb9);
}
.progress-info.progress-striped .bar {
  #gradient > .striped(#5bc0de);
}
;T;	@�;
@�I"/assets/less/scaffolding/;T{;{;I"*// Scaffolding
// Basic and global styles for generating a grid system, structural layout, and page templates
// -------------------------------------------------------------------------------------------


// STRUCTURAL LAYOUT
// -----------------

body {
  margin: 0;
  font-family: @baseFontFamily;
  font-size: @baseFontSize;
  line-height: @baseLineHeight;
  color: @textColor;
  background-color: @white;
}


// LINKS
// -----

a {
  color: @linkColor;
  text-decoration: none;
}
a:hover {
  color: @linkColorHover;
  text-decoration: underline;
}
;T;	@�;
@�I"/assets/less/modals/;T{;{;I"// MODALS
// ------

// Recalculate z-index where appropriate
.modal-open {
  .dropdown-menu {  z-index: @zindexDropdown + @zindexModal; }
  .dropdown.open { *z-index: @zindexDropdown + @zindexModal; }
  .popover       {  z-index: @zindexPopover  + @zindexModal; }
  .tooltip       {  z-index: @zindexTooltip  + @zindexModal; }
}

// Background
.modal-backdrop {
  position: fixed;
  top: 0;
  right: 0;
  bottom: 0;
  left: 0;
  z-index: @zindexModalBackdrop;
  background-color: @black;
  // Fade for backdrop
  &.fade { opacity: 0; }
}

.modal-backdrop,
.modal-backdrop.fade.in {
  .opacity(80);
}

// Base modal
.modal {
  position: fixed;
  top: 50%;
  left: 50%;
  z-index: @zindexModal;
  max-height: 500px;
  overflow: auto;
  width: 560px;
  margin: -250px 0 0 -280px;
  background-color: @white;
  border: 1px solid #999;
  border: 1px solid rgba(0,0,0,.3);
  *border: 1px solid #999; /* IE6-7 */
  .border-radius(6px);
  .box-shadow(0 3px 7px rgba(0,0,0,0.3));
  .background-clip(padding-box);
  &.fade {
    .transition(e('opacity .3s linear, top .3s ease-out'));
    top: -25%;
  }
  &.fade.in { top: 50%; }
}
.modal-header {
  padding: 9px 15px;
  border-bottom: 1px solid #eee;
  // Close icon
  .close { margin-top: 2px; }
}

// Body (where all modal content resises)
.modal-body {
  padding: 15px;
}
// Remove bottom margin if need be
.modal-body .modal-form {
  margin-bottom: 0;
}

// Footer (for actions)
.modal-footer {
  padding: 14px 15px 15px;
  margin-bottom: 0;
  background-color: #f5f5f5;
  border-top: 1px solid #ddd;
  .border-radius(0 0 6px 6px);
  .box-shadow(inset 0 1px 0 @white);
  .clearfix();
  .btn {
    float: right;
    margin-left: 5px;
    margin-bottom: 0; // account for input[type="submit"] which gets the bottom margin like all other inputs
  }
}
;T;	@�;
@�I"/assets/less/reset/;T{;{;I"�	// Reset.less
// Adapted from Normalize.css http://github.com/necolas/normalize.css
// ------------------------------------------------------------------------

// Display in IE6-9 and FF3
// -------------------------

article,
aside,
details,
figcaption,
figure,
footer,
header,
hgroup,
nav,
section {
  display: block;
}

// Display block in IE6-9 and FF3
// -------------------------

audio,
canvas,
video {
  display: inline-block;
  *display: inline;
  *zoom: 1;
}

// Prevents modern browsers from displaying 'audio' without controls
// -------------------------

audio:not([controls]) {
    display: none;
}

// Base settings
// -------------------------

html {
  font-size: 100%;
  -webkit-text-size-adjust: 100%;
      -ms-text-size-adjust: 100%;
}
// Focus states
a:focus {
  .tab-focus();
}
// Hover & Active
a:hover,
a:active {
  outline: 0;
}

// Prevents sub and sup affecting line-height in all browsers
// -------------------------

sub,
sup {
  position: relative;
  font-size: 75%;
  line-height: 0;
  vertical-align: baseline;
}
sup {
  top: -0.5em;
}
sub {
  bottom: -0.25em;
}

// Img border in a's and image quality
// -------------------------

img {
  max-width: 100%;
  height: auto;
  border: 0;
  -ms-interpolation-mode: bicubic;
}

// Forms
// -------------------------

// Font size in all browsers, margin changes, misc consistency
button,
input,
select,
textarea {
  margin: 0;
  font-size: 100%;
  vertical-align: middle;
}
button,
input {
  *overflow: visible; // Inner spacing ie IE6/7
  line-height: normal; // FF3/4 have !important on line-height in UA stylesheet
}
button::-moz-focus-inner,
input::-moz-focus-inner { // Inner padding and border oddities in FF3/4
  padding: 0;
  border: 0;
}
button,
input[type="button"],
input[type="reset"],
input[type="submit"] {
  cursor: pointer; // Cursors on all buttons applied consistently
  -webkit-appearance: button; // Style clickable inputs in iOS
}
input[type="search"] { // Appearance in Safari/Chrome
  -webkit-appearance: textfield;
  -webkit-box-sizing: content-box;
     -moz-box-sizing: content-box;
          box-sizing: content-box;
}
input[type="search"]::-webkit-search-decoration,
input[type="search"]::-webkit-search-cancel-button {
  -webkit-appearance: none; // Inner-padding issues in Chrome OSX, Safari 5
}
textarea {
  overflow: auto; // Remove vertical scrollbar in IE6-9
  vertical-align: top; // Readability and alignment cross-browser
}
;T;	@�;
@�I"/assets/less/carousel/;T{;{;I"
// CAROUSEL
// --------

.carousel {
  position: relative;
  margin-bottom: @baseLineHeight;
  line-height: 1;
}

.carousel-inner {
  overflow: hidden;
  width: 100%;
  position: relative;
}

.carousel {

  .item {
    display: none;
    position: relative;
    .transition(.6s ease-in-out left);
  }

  // Account for jankitude on images
  .item > img {
    display: block;
    line-height: 1;
  }

  .active,
  .next,
  .prev { display: block; }

  .active {
    left: 0;
  }

  .next,
  .prev {
    position: absolute;
    top: 0;
    width: 100%;
  }

  .next {
    left: 100%;
  }
  .prev {
    left: -100%;
  }
  .next.left,
  .prev.right {
    left: 0;
  }

  .active.left {
    left: -100%;
  }
  .active.right {
    left: 100%;
  }

}

// Left/right controls for nav
// ---------------------------

.carousel-control {
  position: absolute;
  top: 40%;
  left: 15px;
  width: 40px;
  height: 40px;
  margin-top: -20px;
  font-size: 60px;
  font-weight: 100;
  line-height: 30px;
  color: @white;
  text-align: center;
  background: @grayDarker;
  border: 3px solid @white;
  .border-radius(23px);
  .opacity(50);

  // we can't have this transition here
  // because webkit cancels the carousel
  // animation if you trip this while
  // in the middle of another animation
  // ;_;
  // .transition(opacity .2s linear);

  // Reposition the right one
  &.right {
    left: auto;
    right: 15px;
  }

  // Hover state
  &:hover {
    color: @white;
    text-decoration: none;
    .opacity(90);
  }
}

// Caption for text below images
// -----------------------------

.carousel-caption {
  position: absolute;
  left: 0;
  right: 0;
  bottom: 0;
  padding: 10px 15px 5px;
  background: @grayDark;
  background: rgba(0,0,0,.75);
}
.carousel-caption h4,
.carousel-caption p {
  color: @white;
}
;T;	@�;
@�I"/assets/less/patterns/;T{;{;I"SO/* Patterns.less
 * Repeatable UI elements outside the base styles provided from the scaffolding
 * ---------------------------------------------------------------------------- */


// TOPBAR
// ------

// Topbar for Branding and Nav
.topbar {
  height: 40px;
  position: fixed;
  top: 0;
  left: 0;
  right: 0;
  z-index: 10000;
  overflow: visible;

  // Links get text shadow
  a {
    color: @grayLight;
    text-shadow: 0 -1px 0 rgba(0,0,0,.25);
  }

  // Hover and active states
  // h3 for backwards compatibility
  h3 a:hover,
  .brand a:hover,
  ul .active > a {
    background-color: #333;
    background-color: rgba(255,255,255,.05);
    color: @white;
    text-decoration: none;
  }

  // Website name
  // h3 left for backwards compatibility
  h3 {
    position: relative;
  }
  h3 a,
  .brand {
    float: left;
    display: block;
    padding: 8px 20px 12px;
    margin-left: -20px; // negative indent to left-align the text down the page
    color: @white;
    font-size: 20px;
    font-weight: 200;
    line-height: 1;
  }

  // Plain text in topbar
  p {
    margin: 0;
    line-height: 40px;
    a:hover {
      background-color: transparent;
      color: @white;
    }
  }

  // Search Form
  form {
    float: left;
    margin: 5px 0 0 0;
    position: relative;
    .opacity(100);
  }
  // Todo: remove from v2.0 when ready, added for legacy
  form.pull-right {
    float: right;
  }
  input {
    background-color: #444;
    background-color: rgba(255,255,255,.3);
    #font > .sans-serif(13px, normal, 1);
    padding: 4px 9px;
    color: @white;
    color: rgba(255,255,255,.75);
    border: 1px solid #111;
    .border-radius(4px);
    @shadow: inset 0 1px 2px rgba(0,0,0,.1), 0 1px 0px rgba(255,255,255,.25);
    .box-shadow(@shadow);
    .transition(none);

    // Placeholder text gets special styles; can't be bundled together though for some reason
    &:-moz-placeholder {
      color: @grayLighter;
    }
    &::-webkit-input-placeholder {
      color: @grayLighter;
    }
    // Hover states
    &:hover {
      background-color: @grayLight;
      background-color: rgba(255,255,255,.5);
      color: @white;
    }
    // Focus states (we use .focused since IE8 and down doesn't support :focus)
    &:focus,
    &.focused {
      outline: 0;
      background-color: @white;
      color: @grayDark;
      text-shadow: 0 1px 0 @white;
      border: 0;
      padding: 5px 10px;
      .box-shadow(0 0 3px rgba(0,0,0,.15));
    }
  }
}

// gradient is applied to it's own element because overflow visible is not honored by ie when filter is present
// For backwards compatibility, include .topbar .fill
.topbar-inner,
.topbar .fill {
  background-color: #222;
  #gradient > .vertical(#333, #222);
  @shadow: 0 1px 3px rgba(0,0,0,.25), inset 0 -1px 0 rgba(0,0,0,.1);
  .box-shadow(@shadow);
}


// NAVIGATION
// ----------

// Topbar Nav
// ul.nav for all topbar based navigation to avoid inheritance issues and over-specificity
// For backwards compatibility, leave in .topbar div > ul
.topbar div > ul,
.nav {
  display: block;
  float: left;
  margin: 0 10px 0 0;
  position: relative;
  left: 0;
  > li {
    display: block;
    float: left;
  }
  a {
    display: block;
    float: none;
    padding: 10px 10px 11px;
    line-height: 19px;
    text-decoration: none;
    &:hover {
      color: @white;
      text-decoration: none;
    }
  }
  .active > a {
    background-color: #222;
    background-color: rgba(0,0,0,.5);
  }

  // Secondary (floated right) nav in topbar
  &.secondary-nav {
    float: right;
    margin-left: 10px;
    margin-right: 0;
    // backwards compatibility
    .menu-dropdown,
    .dropdown-menu {
      right: 0;
      border: 0;
    }
  }
  // Dropdowns within the .nav
  // a.menu:hover and li.open .menu for backwards compatibility
  a.menu:hover,
  li.open .menu,
  .dropdown-toggle:hover,
  .dropdown.open .dropdown-toggle {
    background: #444;
    background: rgba(255,255,255,.05);
  }
  // .menu-dropdown for backwards compatibility
  .menu-dropdown,
  .dropdown-menu {
    background-color: #333;
    // a.menu for backwards compatibility
    a.menu,
    .dropdown-toggle {
      color: @white;
      &.open {
        background: #444;
        background: rgba(255,255,255,.05);
      }
    }
    li a {
      color: #999;
      text-shadow: 0 1px 0 rgba(0,0,0,.5);
      &:hover {
        #gradient > .vertical(#292929,#191919);
        color: @white;
      }
    }
    .active a {
      color: @white;
    }
    .divider {
      background-color: #222;
      border-color: #444;
    }
  }
}

// For backwards compatibility with new dropdowns, redeclare dropdown link padding
.topbar ul .menu-dropdown li a,
.topbar ul .dropdown-menu li a {
  padding: 4px 15px;
}

// Dropdown Menus
// Use the .menu class on any 
 element within the topbar or ul.tabs and you'll get some superfancy dropdowns
// li.menu for backwards compatibility
li.menu,
.dropdown {
  position: relative;
}
// The link that is clicked to toggle the dropdown
// a.menu for backwards compatibility
a.menu:after,
.dropdown-toggle:after {
  width: 0;
  height: 0;
  display: inline-block;
  content: "↓";
  text-indent: -99999px;
  vertical-align: top;
  margin-top: 8px;
  margin-left: 4px;
  border-left: 4px solid transparent;
  border-right: 4px solid transparent;
  border-top: 4px solid @white;
  .opacity(50);
}
// The dropdown menu (ul)
// .menu-dropdown for backwards compatibility
.menu-dropdown,
.dropdown-menu {
  background-color: @white;
  float: left;
  display: none; // None by default, but block on "open" of the menu
  position: absolute;
  top: 40px;
  z-index: 900;
  min-width: 160px;
  max-width: 220px;
  _width: 160px;
  margin-left: 0; // override default ul styles
  margin-right: 0;
  padding: 6px 0;
  zoom: 1; // do we need this?
  border-color: #999;
  border-color: rgba(0,0,0,.2);
  border-style: solid;
  border-width: 0 1px 1px;
  .border-radius(0 0 6px 6px);
  .box-shadow(0 2px 4px rgba(0,0,0,.2));
  .background-clip(padding-box);

  // Unfloat any li's to make them stack
  li {
    float: none;
    display: block;
    background-color: none;
  }
  // Dividers (basically an hr) within the dropdown
  .divider {
    height: 1px;
    margin: 5px 0;
    overflow: hidden;
    background-color: #eee;
    border-bottom: 1px solid @white;
  }
}

.topbar .dropdown-menu, .dropdown-menu {
  // Links within the dropdown menu
  a {
    display: block;
    padding: 4px 15px;
    clear: both;
    font-weight: normal;
    line-height: 18px;
    color: @gray;
    text-shadow: 0 1px 0 @white;
    // Hover state
    &:hover {
      #gradient > .vertical(#eeeeee, #dddddd);
      color: @grayDark;
      text-decoration: none;
      @shadow: inset 0 1px 0 rgba(0,0,0,.025), inset 0 -1px rgba(0,0,0,.025);
      .box-shadow(@shadow);
    }
  }
}

// Open state for the dropdown
// .open for backwards compatibility
.open,
.dropdown.open {
  // .menu for backwards compatibility
  .menu,
  .dropdown-toggle {
    color: @white;
    background: #ccc;
    background: rgba(0,0,0,.3);
  }
  // .menu-dropdown for backwards compatibility
  .menu-dropdown,
  .dropdown-menu {
    display: block;
  }
}


// Tabs and Pills
.tabs,
.pills {
  margin: 0 0 20px;
  padding: 0;
  list-style: none;
  .clearfix();
  > li {
    float: left;
    > a {
      display: block;
    }
  }
}

// Basic Tabs
.tabs {
  float: left;
  width: 100%;
  border-bottom: 1px solid #ddd;
  > li {
    position: relative; // For the dropdowns mostly
    top: 1px;
    > a {
      padding: 0 15px;
      margin-right: 2px;
      line-height: @baseline * 2;
      border: 1px solid transparent;
      .border-radius(4px 4px 0 0);
      &:hover {
        text-decoration: none;
        background-color: #eee;
        border-color: #eee #eee #ddd;
      }
    }
    &.active > a {
      color: @gray;
      background-color: @white;
      border: 1px solid #ddd;
      border-bottom-color: transparent;
    }
  }
  // first one for backwards compatibility
  .menu-dropdown,
  .dropdown-menu {
    top: 35px;
    border-width: 1px;
    .border-radius(0 6px 6px 6px);
  }
  // first one for backwards compatibility
  a.menu:after,
  .dropdown-toggle:after {
    border-top-color: #999;
    margin-top: 15px;
    margin-left: 5px;
  }
  // first one for backwards compatibility
  li.open.menu .menu,
  .open.dropdown .dropdown-toggle {
    border-color: #999;
  }
  // first one for backwards compatibility
  li.open a.menu:after,
  .dropdown.open .dropdown-toggle:after {
    border-top-color: #555;
  }
}
.tab-content {
  clear: both;
}

// Basic pill nav
.pills {
  a {
      margin: 5px 3px 5px 0;
    padding: 0 15px;
    text-shadow: 0 1px 1px @white;
    line-height: 30px;
    .border-radius(15px);
    &:hover {
      background: @linkColorHover;
      color: @white;
      text-decoration: none;
      text-shadow: 0 1px 1px rgba(0,0,0,.25);
    }
  }
  .active a {
    background: @linkColor;
    color: @white;
    text-shadow: 0 1px 1px rgba(0,0,0,.25);
  }
}

.tab-content > *,
.pill-content > * {
  display: none;
}

.tab-content > .active,
.pill-content > .active {
  display:block;
}


// BREADCRUMBS
// -----------

.breadcrumb {
  margin: 0 0 @baseline;
  padding: 7px 14px;
  #gradient > .vertical(#ffffff, #f5f5f5);
  border: 1px solid #ddd;
  .border-radius(3px);
  .box-shadow(inset 0 1px 0 @white);
  li {
    display: inline;
    text-shadow: 0 1px 0 @white;
  }
  .divider {
    padding: 0 5px;
    color: @grayLight;
  }
  a {
  }
  .active a {
    color: @grayDark;
  }
}


// PAGE HEADERS
// ------------

.hero-unit {
  background-color: #f5f5f5;
  margin-bottom: 30px;
  padding: 60px;
  .border-radius(6px);
  h1 {
    margin-bottom: 0;
    font-size: 60px;
    line-height: 1;
    letter-spacing: -1px;
  }
  p {
    font-size: 18px;
    font-weight: 200;
    line-height: @baseline * 1.5;
  }
}
footer {
  margin-top: @baseline - 1;
  padding-top: @baseline - 1;
  border-top: 1px solid #eee;
}


// PAGE HEADERS
// ------------

.page-header {
  margin-bottom: @baseline - 1;
  border-bottom: 1px solid #ddd;
  .box-shadow(0 1px 0 rgba(255,255,255,.5));
  h1 {
    margin-bottom: (@baseline / 2) - 1px;
  }
}


// BUTTON STYLES
// -------------

// Shared colors for buttons and alerts
.btn,
.alert-message {
  // Set text color
  &.danger,
  &.danger:hover,
  &.error,
  &.error:hover,
  &.success,
  &.success:hover,
  &.info,
  &.info:hover {
    color: @white
  }
  // Danger and error appear as red
  &.danger,
  &.error {
    .gradientBar(#ee5f5b, #c43c35);
  }
  // Success appears as green
  &.success {
    .gradientBar(#62c462, #57a957);
  }
  // Info appears as a neutral blue
  &.info {
    .gradientBar(#5bc0de, #339bb9);
  }
}

// Base .btn styles
.btn {
  // Button Base
  cursor: pointer;
  display: inline-block;
  #gradient > .vertical-three-colors(#ffffff, #ffffff, 25%, darken(#ffffff, 10%)); // Don't use .gradientbar() here since it does a three-color gradient
  padding: 5px 14px 6px;
  text-shadow: 0 1px 1px rgba(255,255,255,.75);
  color: #333;
  font-size: @basefont;
  line-height: normal;
  border: 1px solid #ccc;
  border-bottom-color: #bbb;
  .border-radius(4px);
  @shadow: inset 0 1px 0 rgba(255,255,255,.2), 0 1px 2px rgba(0,0,0,.05);
  .box-shadow(@shadow);

  &:hover {
    background-position: 0 -15px;
    color: #333;
    text-decoration: none;
  }

  // Focus state for keyboard and accessibility
  &:focus {
    outline: 1px dotted #666;
  }

  // Primary Button Type
  &.primary {
    color: @white;
    .gradientBar(@blue, @blueDark)
  }

   // Transitions
  .transition(.1s linear all);

  // Active and Disabled states
  &:active {
    @shadow: inset 0 2px 4px rgba(0,0,0,.25), 0 1px 2px rgba(0,0,0,.05);
    .box-shadow(@shadow);
  }
  &.disabled {
    cursor: default;
    background-image: none;
    .reset-filter();
    .opacity(65);
    .box-shadow(none);
  }
  &[disabled] {
    // disabled pseudo can't be included with .disabled
    // def because IE8 and below will drop it ;_;
    cursor: default;
    background-image: none;
    .reset-filter();
    .opacity(65);
    .box-shadow(none);
  }

  // Button Sizes
  &.large {
    font-size: @basefont + 2px;
    line-height: normal;
    padding: 9px 14px 9px;
    .border-radius(6px);
  }
  &.small {
    padding: 7px 9px 7px;
    font-size: @basefont - 2px;
  }
}
// Super jank hack for removing border-radius from IE9 so we can keep filter gradients on alerts and buttons
:root .alert-message,
:root .btn {
  border-radius: 0 \0;
}

// Help Firefox not be a jerk about adding extra padding to buttons
button.btn,
input[type=submit].btn {
  &::-moz-focus-inner {
  	padding: 0;
  	border: 0;
  }
}


// CLOSE ICONS
// -----------
.close {
  float: right;
  color: @black;
  font-size: 20px;
  font-weight: bold;
  line-height: @baseline * .75;
  text-shadow: 0 1px 0 rgba(255,255,255,1);
  .opacity(20);
  &:hover {
    color: @black;
    text-decoration: none;
    .opacity(40);
  }
}


// ERROR STYLES
// ------------

// Base alert styles
.alert-message {
  position: relative;
  padding: 7px 15px;
  margin-bottom: @baseline;
  color: @grayDark;
  .gradientBar(#fceec1, #eedc94); // warning by default
  text-shadow: 0 1px 0 rgba(255,255,255,.5);
  border-width: 1px;
  border-style: solid;
  .border-radius(4px);
  .box-shadow(inset 0 1px 0 rgba(255,255,255,.25));

  // Adjust close icon
  .close {
    *margin-top: 3px; /* IE7 spacing */
  }

  // Remove extra margin from content
  h5 {
    line-height: @baseline;
  }
  p {
    margin-bottom: 0;
  }
  div {
    margin-top: 5px;
    margin-bottom: 2px;
    line-height: 28px;
  }
  .btn {
    // Provide actions with buttons
    .box-shadow(0 1px 0 rgba(255,255,255,.25));
  }

  &.block-message {
    background-image: none;
    background-color: lighten(#fceec1, 5%);
    .reset-filter();
    padding: 14px;
    border-color: #fceec1;
    .box-shadow(none);
    ul, p {
      margin-right: 30px;
    }
    ul {
      margin-bottom: 0;
    }
    li {
      color: @grayDark;
    }
    .alert-actions {
      margin-top: 5px;
    }
    &.error,
    &.success,
    &.info {
      color: @grayDark;
      text-shadow: 0 1px 0 rgba(255,255,255,.5);
    }
    &.error {
      background-color: lighten(#f56a66, 25%);
      border-color: lighten(#f56a66, 20%);
    }
    &.success {
      background-color: lighten(#62c462, 30%);
      border-color: lighten(#62c462, 25%);
    }
    &.info {
      background-color: lighten(#6bd0ee, 25%);
      border-color: lighten(#6bd0ee, 20%);
    }
  }
}


// PAGINATION
// ----------

.pagination {
  height: @baseline * 2;
  margin: @baseline 0;
  ul {
    float: left;
    margin: 0;
    border: 1px solid #ddd;
    border: 1px solid rgba(0,0,0,.15);
    .border-radius(3px);
    .box-shadow(0 1px 2px rgba(0,0,0,.05));
  }
  li {
    display: inline;
  }
  a {
    float: left;
    padding: 0 14px;
    line-height: (@baseline * 2) - 2;
    border-right: 1px solid;
    border-right-color: #ddd;
    border-right-color: rgba(0,0,0,.15);
    *border-right-color: #ddd; /* IE6-7 */
    text-decoration: none;
  }
  a:hover,
  .active a {
    background-color: lighten(@blue, 45%);
  }
  .disabled a,
  .disabled a:hover {
    background-color: transparent;
    color: @grayLight;
  }
  .next a {
    border: 0;
  }
}


// WELLS
// -----

.well {
  background-color: #f5f5f5;
  margin-bottom: 20px;
  padding: 19px;
  min-height: 20px;
  border: 1px solid #eee;
  border: 1px solid rgba(0,0,0,.05);
  .border-radius(4px);
  .box-shadow(inset 0 1px 1px rgba(0,0,0,.05));
  blockquote {
    border-color: #ddd;
    border-color: rgba(0,0,0,.15);
  }
}


// MODALS
// ------

.modal-backdrop {
  background-color: @black;
  position: fixed;
  top: 0;
  left: 0;
  right: 0;
  bottom: 0;
  z-index: 10000;
  // Fade for backdrop
  &.fade { opacity: 0; }
}

.modal-backdrop, .modal-backdrop.fade.in {
  .opacity(80);
}

.modal {
  position: fixed;
  top: 50%;
  left: 50%;
  z-index: 11000;
  width: 560px;
  margin: -250px 0 0 -250px;
  background-color: @white;
  border: 1px solid #999;
  border: 1px solid rgba(0,0,0,.3);
  *border: 1px solid #999; /* IE6-7 */
  .border-radius(6px);
  .box-shadow(0 3px 7px rgba(0,0,0,0.3));
  .background-clip(padding-box);
  .close { margin-top: 7px; }
  &.fade {
    .transition(e('opacity .3s linear, top .3s ease-out'));
    top: -25%;
  }
  &.fade.in { top: 50%; }
}
.modal-header {
  border-bottom: 1px solid #eee;
  padding: 5px 15px;
}
.modal-body {
  padding: 15px;
}
.modal-footer {
  background-color: #f5f5f5;
  padding: 14px 15px 15px;
  border-top: 1px solid #ddd;
  .border-radius(0 0 6px 6px);
  .box-shadow(inset 0 1px 0 @white);
  .clearfix();
  margin-bottom: 0;
  .btn {
    float: right;
    margin-left: 5px;
  }
}


// POPOVER ARROWS
// --------------

#popoverArrow {
  .above(@arrowWidth: 5px) {
    bottom: 0;
    left: 50%;
    margin-left: -@arrowWidth;
    border-left: @arrowWidth solid transparent;
    border-right: @arrowWidth solid transparent;
    border-top: @arrowWidth solid @black;
  }
  .left(@arrowWidth: 5px) {
    top: 50%;
    right: 0;
    margin-top: -@arrowWidth;
    border-top: @arrowWidth solid transparent;
    border-bottom: @arrowWidth solid transparent;
    border-left: @arrowWidth solid @black;
  }
  .below(@arrowWidth: 5px) {
    top: 0;
    left: 50%;
    margin-left: -@arrowWidth;
    border-left: @arrowWidth solid transparent;
    border-right: @arrowWidth solid transparent;
    border-bottom: @arrowWidth solid @black;
  }
  .right(@arrowWidth: 5px) {
    top: 50%;
    left: 0;
    margin-top: -@arrowWidth;
    border-top: @arrowWidth solid transparent;
    border-bottom: @arrowWidth solid transparent;
    border-right: @arrowWidth solid @black;
  }
}

// TWIPSY
// ------

.twipsy {
  display: block;
  position: absolute;
  visibility: visible;
  padding: 5px;
  font-size: 11px;
  z-index: 1000;
  .opacity(80);
  &.fade.in {
    .opacity(80);
  }
  &.above .twipsy-arrow   { #popoverArrow > .above(); }
  &.left .twipsy-arrow    { #popoverArrow > .left(); }
  &.below .twipsy-arrow   { #popoverArrow > .below(); }
  &.right .twipsy-arrow   { #popoverArrow > .right(); }
}
.twipsy-inner {
  padding: 3px 8px;
  background-color: @black;
  color: white;
  text-align: center;
  max-width: 200px;
  text-decoration: none;
  .border-radius(4px);
}
.twipsy-arrow {
  position: absolute;
  width: 0;
  height: 0;
}


// POPOVERS
// --------

.popover {
  position: absolute;
  top: 0;
  left: 0;
  z-index: 1000;
  padding: 5px;
  display: none;
  &.above .arrow { #popoverArrow > .above(); }
  &.right .arrow { #popoverArrow > .right(); }
  &.below .arrow { #popoverArrow > .below(); }
  &.left .arrow  { #popoverArrow > .left(); }
  .arrow {
    position: absolute;
    width: 0;
    height: 0;
  }
  .inner {
    background-color: @black;
    background-color: rgba(0,0,0,.8);
    padding: 3px;
    overflow: hidden;
    width: 280px;
    .border-radius(6px);
    .box-shadow(0 3px 7px rgba(0,0,0,0.3));
  }
  .title {
    background-color: #f5f5f5;
    padding: 9px 15px;
    line-height: 1;
    .border-radius(3px 3px 0 0);
    border-bottom:1px solid #eee;
  }
  .content {
    background-color: @white;
    padding: 14px;
    .border-radius(0 0 3px 3px);
    .background-clip(padding-box);
    p, ul, ol {
      margin-bottom: 0;
    }
  }
}


// PATTERN ANIMATIONS
// ------------------

.fade {
  .transition(opacity .15s linear);
  opacity: 0;
  &.in {
    opacity: 1;
  }
}


// LABELS
// ------

.label {
  padding: 1px 3px 2px;
  background-color: @grayLight;
  font-size: @basefont * .75;
  font-weight: bold;
  color: @white;
  text-transform: uppercase;
  .border-radius(3px);
  &.important { background-color: #c43c35; }
  &.warning   { background-color: @orange; }
  &.success   { background-color: @green; }
  &.notice    { background-color: lighten(@blue, 25%); }
}


// MEDIA GRIDS
// -----------

.media-grid {
  margin-left: -20px;
  margin-bottom: 0;
  .clearfix();
  li {
    display: inline;
  }
  a {
    float: left;
    padding: 4px;
    margin: 0 0 20px 20px;
    border: 1px solid #ddd;
    .border-radius(4px);
    .box-shadow(0 1px 1px rgba(0,0,0,.075));
    img {
      display: block;
    }
    &:hover {
      border-color: @linkColor;
      .box-shadow(0 1px 4px rgba(0,105,214,.25));
    }
  }
};T;	@�;
@�I"/assets/less/grid/;T{;{;I"�// GRID SYSTEM
// -----------

// Fixed (940px)
#gridSystem > .generate(@gridColumns, @gridColumnWidth, @gridGutterWidth);

// Fluid (940px)
#fluidGridSystem > .generate(@gridColumns, @fluidGridColumnWidth, @fluidGridGutterWidth);
;T;	@�;
@�I"/assets/less/accordion/;T{;{;I"�// ACCORDION
// ---------


// Parent container
.accordion {
  margin-bottom: @baseLineHeight;
}

// Group == heading + body
.accordion-group {
  margin-bottom: 2px;
  border: 1px solid #e5e5e5;
  .border-radius(4px);
}
.accordion-heading {
  border-bottom: 0;
}
.accordion-heading .accordion-toggle {
  display: block;
  padding: 8px 15px;
}

// Inner needs the styles because you can't animate properly with any styles on the element
.accordion-inner {
  padding: 9px 15px;
  border-top: 1px solid #e5e5e5;
}
;T;	@�;
@�I"/contribute/;T{;{	;I"|

  
    
    Contribute
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      

      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I";F;
I";F;@�I"/rest-api/;T{;{	;I"�8

  
    
    Deltacloud REST API
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

The Deltacloud REST API


Apache Deltacloud is a REST-based (HATEOAS) cloud abstraction API. It enables management of resources in different IaaS clouds using a single API. There are back-end drivers communicating with each cloud provider's native API and the Deltacloud Core Framework provides the basis for implementing drivers to new IaaS clouds. Apache Deltacloud currently supports many back-end cloud providers.



With Deltacloud project, you don't have to limit yourself to a single cloud provider. Instead of taking care of a number of clouds, you are dealing with just one API abstraction.


Collections


The following terms describe abstractions used in the Apache Deltacloud API. Each collection represents an entity in the back-end provider cloud, such as a running virtual server or a server image. Please note that the list of supported collections may differ from cloud to cloud. Only the appropriate collections are exposed for a given back-end driver (e.g. the Microsoft Azure driver currently exposes only the Buckets collection).


  
  



    Deltacloud REST API
  
  Introduction
  
Collections
    Client requests
    Authentication
    Server responses
    API conventions
    API stability
    Online documentation
  
API entry point
  Compute resources
  Storage resources





Realms
  
  A distinct organizational unit within the back-end cloud, for exapmle a datacenter. A realm may but does not necessarily represent the geographical location of the compute resources which you access.
  
  Instances
  
  A realized virtual server, running in a given back-end cloud. Instances are instantiated from server images.
  
  Images
  
  Templates (virtual machine images) from which instances are created. Each image defines the root partition and initial storage for the instance operating system.
  
Instance states
  
  Instance states represent the instance lifecycle. at any time an instance is in one of states: start, pending, running, stopped, shutting_down, finished.
  
  Keys
  
  Keys represent credentials used to access a running instance. Keys can take the form of key (for example an RSA key) or of password (with username and password attributes).
  
  Storage volume
  
  A virtual storage device that can be attached to an instance and mounted by the OS.
  
  Storage snapshot
  
  Storage snapshots are copies, snapshots of a storage volume at a specified time.
  
  Bucket
  
  A container for data blobs. The organizational unit of a generic key ==> value based on data store (such as Rackspace CloudFiles or Amazon S3). Individual data items, blobs, are exposed as a subcollection under a bucket.
  
  Blob
  
  A generic binary data item that exists within a specified bucket (an object in Amazon S3 and Rackspace CloudFiles).
  
  Address
  
  Address represents an IP address. Depending on the back-end cloud provider, address can be public or private. Public address represents a unique, globally routable IP address, private address represents an address routable only within a private network.
  
  Load Balancer
  
  A load balancer allows a distribution of ingress network traffic received by a specified IP address to a number of instances.
  
  Firewalls
  Sets of rules that govern the accessibility of a running instance over the public Internet.
  
  Metrics
  
  Metrics collection provides useful information about your cloud resources, e.g. CPU utilization or network throughput. It may be helpful for developers for better scaling and monitoring. The collection is currently supported for Amazon EC2 cloud, collecting information from Amazon CloudWatch service, and Fujitsu GCP.
  


Client Requests


In accordance with REST principles, clients make requests through HTTP with the usual meanings assigned to the standard HTTP verbs GET, POST, PUT, and DELETE.



Besides the generally accepted REST design principles, Apache Deltacloud follows the guidelines discussed in the Fedora Project Cloud APIs Rest Style Guide.



The URL space of the API is structured into collections of resources. The top level entities used in the Deltacloud API are: realms, images, instance states, instances, keys, storage volumes, storage snapshots, blob storage, hardware profiles and drivers.


Authentication


The Deltacloud API server is stateless and does not keep any information about the current client. The Deltalcloud server does not store the credentials for the back-end cloud which the server is talking to. Instead, the server uses HTTP basic authentication and clients have to send the username/password for the back-end cloud on every request.



The specifics of what needs to be sent varies from cloud to cloud; some cloud providers request a username and password for API access, the others use special-purpose API keys. Check the list of the credentials to find out what kind of information a specific cloud provider expects.


Server responses


The server can respond to client requests in various formats. The appropriate response format is determined by HTTP content negotiation. The primary format is XML. The output is also available as JSON and as HTML (mostly for testing). Clients can also explicitly request a specific response format by including the format= request parameter (http://deltacloudserver.foo/api?format=xml or http://deltacloudserver.foo/api?format=json).



In general (especially for the HTML interface), list operations such as GET /api/realms will provide a list of objects of this resource type with only brief details. Full details can be retrieved by making a request GET /api/realms/:id to the URL of the individual realm.


API conventions


Any XML element which represents an object (such as an instance) has a href and an id attribute. The href attribute provides the URL at which object-specific actions can be performed (for example a GET action applied to the URL will return details of the object). The id provides an identifier of the object, which is unique within its collection (there is a unique id for each Instance, Image, Realm etc).



Objects also have a human-readable name. The name is provided in a <name/> child element of the object’s container tag.


API stability and evolution


Every change to the API is made in a way that allows old clients to work against newer versions of the API server.



You may come across the following changes in newer versions of the API:



adding new collections, or supporting new operations on existing collections
  adding optional parameters to existing operations
  adding additional attributes and elements to the XML/JSON responses


On the other hand, these changes would violate API stability and therefore they are not made:



removing an operation on a collection
  making an optional parameter for an operation mandatory
  removing attributes or elements from XML responses

Online documentation


You can access an automatically generated documentation on every server running the Deltacloud Core API service through the URL http://localhost:3001/api/docs/. The documentation is both available in HTML and XML, though the XML format is not part of this specification and may change in an incompatible way.


API entry point  





      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"d#



  

The Deltacloud REST API


Apache Deltacloud is a REST-based (HATEOAS) cloud abstraction API. It enables management of resources in different IaaS clouds using a single API. There are back-end drivers communicating with each cloud provider's native API and the Deltacloud Core Framework provides the basis for implementing drivers to new IaaS clouds. Apache Deltacloud currently supports many back-end cloud providers.



With Deltacloud project, you don't have to limit yourself to a single cloud provider. Instead of taking care of a number of clouds, you are dealing with just one API abstraction.


Collections


The following terms describe abstractions used in the Apache Deltacloud API. Each collection represents an entity in the back-end provider cloud, such as a running virtual server or a server image. Please note that the list of supported collections may differ from cloud to cloud. Only the appropriate collections are exposed for a given back-end driver (e.g. the Microsoft Azure driver currently exposes only the Buckets collection).


  
  


  
    Deltacloud REST API
  
  Introduction
  
    Collections
    Client requests
    Authentication
    Server responses
    API conventions
    API stability
    Online documentation
  
  API entry point
  Compute resources
  Storage resources


  



Realms
  
  A distinct organizational unit within the back-end cloud, for exapmle a datacenter. A realm may but does not necessarily represent the geographical location of the compute resources which you access.
  
  Instances
  
  A realized virtual server, running in a given back-end cloud. Instances are instantiated from server images.
  
  Images
  
  Templates (virtual machine images) from which instances are created. Each image defines the root partition and initial storage for the instance operating system.
  
Instance states
  
  Instance states represent the instance lifecycle. at any time an instance is in one of states: start, pending, running, stopped, shutting_down, finished.
  
  Keys
  
  Keys represent credentials used to access a running instance. Keys can take the form of key (for example an RSA key) or of password (with username and password attributes).
  
  Storage volume
  
  A virtual storage device that can be attached to an instance and mounted by the OS.
  
  Storage snapshot
  
  Storage snapshots are copies, snapshots of a storage volume at a specified time.
  
  Bucket
  
  A container for data blobs. The organizational unit of a generic key ==> value based on data store (such as Rackspace CloudFiles or Amazon S3). Individual data items, blobs, are exposed as a subcollection under a bucket.
  
  Blob
  
  A generic binary data item that exists within a specified bucket (an object in Amazon S3 and Rackspace CloudFiles).
  
  Address
  
  Address represents an IP address. Depending on the back-end cloud provider, address can be public or private. Public address represents a unique, globally routable IP address, private address represents an address routable only within a private network.
  
  Load Balancer
  
  A load balancer allows a distribution of ingress network traffic received by a specified IP address to a number of instances.
  
  Firewalls
  Sets of rules that govern the accessibility of a running instance over the public Internet.
  
  Metrics
  
  Metrics collection provides useful information about your cloud resources, e.g. CPU utilization or network throughput. It may be helpful for developers for better scaling and monitoring. The collection is currently supported for Amazon EC2 cloud, collecting information from Amazon CloudWatch service, and Fujitsu GCP.
  


Client Requests


In accordance with REST principles, clients make requests through HTTP with the usual meanings assigned to the standard HTTP verbs GET, POST, PUT, and DELETE.



Besides the generally accepted REST design principles, Apache Deltacloud follows the guidelines discussed in the Fedora Project Cloud APIs Rest Style Guide.



The URL space of the API is structured into collections of resources. The top level entities used in the Deltacloud API are: realms, images, instance states, instances, keys, storage volumes, storage snapshots, blob storage, hardware profiles and drivers.


Authentication


The Deltacloud API server is stateless and does not keep any information about the current client. The Deltalcloud server does not store the credentials for the back-end cloud which the server is talking to. Instead, the server uses HTTP basic authentication and clients have to send the username/password for the back-end cloud on every request.



The specifics of what needs to be sent varies from cloud to cloud; some cloud providers request a username and password for API access, the others use special-purpose API keys. Check the list of the credentials to find out what kind of information a specific cloud provider expects.


Server responses


The server can respond to client requests in various formats. The appropriate response format is determined by HTTP content negotiation. The primary format is XML. The output is also available as JSON and as HTML (mostly for testing). Clients can also explicitly request a specific response format by including the format= request parameter (http://deltacloudserver.foo/api?format=xml or http://deltacloudserver.foo/api?format=json).



In general (especially for the HTML interface), list operations such as GET /api/realms will provide a list of objects of this resource type with only brief details. Full details can be retrieved by making a request GET /api/realms/:id to the URL of the individual realm.


API conventions


Any XML element which represents an object (such as an instance) has a href and an id attribute. The href attribute provides the URL at which object-specific actions can be performed (for example a GET action applied to the URL will return details of the object). The id provides an identifier of the object, which is unique within its collection (there is a unique id for each Instance, Image, Realm etc).



Objects also have a human-readable name. The name is provided in a <name/> child element of the object’s container tag.


API stability and evolution


Every change to the API is made in a way that allows old clients to work against newer versions of the API server.



You may come across the following changes in newer versions of the API:



  adding new collections, or supporting new operations on existing collections
  adding optional parameters to existing operations
  adding additional attributes and elements to the XML/JSON responses



On the other hand, these changes would violate API stability and therefore they are not made:



  removing an operation on a collection
  making an optional parameter for an operation mandatory
  removing attributes or elements from XML responses


Online documentation


You can access an automatically generated documentation on every server running the Deltacloud Core API service through the URL http://localhost:3001/api/docs/. The documentation is both available in HTML and XML, though the XML format is not part of this specification and may change in an incompatible way.


API entry point  


;T;
I"\#



  

The Deltacloud REST API


Apache Deltacloud is a REST-based (HATEOAS) cloud abstraction API. It enables management of resources in different IaaS clouds using a single API. There are back-end drivers communicating with each cloud provider's native API and the Deltacloud Core Framework provides the basis for implementing drivers to new IaaS clouds. Apache Deltacloud currently supports many back-end cloud providers.



With Deltacloud project, you don't have to limit yourself to a single cloud provider. Instead of taking care of a number of clouds, you are dealing with just one API abstraction.


Collections


The following terms describe abstractions used in the Apache Deltacloud API. Each collection represents an entity in the back-end provider cloud, such as a running virtual server or a server image. Please note that the list of supported collections may differ from cloud to cloud. Only the appropriate collections are exposed for a given back-end driver (e.g. the Microsoft Azure driver currently exposes only the Buckets collection).


  
  



    Deltacloud REST API
  
  Introduction
  
Collections
    Client requests
    Authentication
    Server responses
    API conventions
    API stability
    Online documentation
  
API entry point
  Compute resources
  Storage resources





Realms
  
  A distinct organizational unit within the back-end cloud, for exapmle a datacenter. A realm may but does not necessarily represent the geographical location of the compute resources which you access.
  
  Instances
  
  A realized virtual server, running in a given back-end cloud. Instances are instantiated from server images.
  
  Images
  
  Templates (virtual machine images) from which instances are created. Each image defines the root partition and initial storage for the instance operating system.
  
Instance states
  
  Instance states represent the instance lifecycle. at any time an instance is in one of states: start, pending, running, stopped, shutting_down, finished.
  
  Keys
  
  Keys represent credentials used to access a running instance. Keys can take the form of key (for example an RSA key) or of password (with username and password attributes).
  
  Storage volume
  
  A virtual storage device that can be attached to an instance and mounted by the OS.
  
  Storage snapshot
  
  Storage snapshots are copies, snapshots of a storage volume at a specified time.
  
  Bucket
  
  A container for data blobs. The organizational unit of a generic key ==> value based on data store (such as Rackspace CloudFiles or Amazon S3). Individual data items, blobs, are exposed as a subcollection under a bucket.
  
  Blob
  
  A generic binary data item that exists within a specified bucket (an object in Amazon S3 and Rackspace CloudFiles).
  
  Address
  
  Address represents an IP address. Depending on the back-end cloud provider, address can be public or private. Public address represents a unique, globally routable IP address, private address represents an address routable only within a private network.
  
  Load Balancer
  
  A load balancer allows a distribution of ingress network traffic received by a specified IP address to a number of instances.
  
  Firewalls
  Sets of rules that govern the accessibility of a running instance over the public Internet.
  
  Metrics
  
  Metrics collection provides useful information about your cloud resources, e.g. CPU utilization or network throughput. It may be helpful for developers for better scaling and monitoring. The collection is currently supported for Amazon EC2 cloud, collecting information from Amazon CloudWatch service, and Fujitsu GCP.
  


Client Requests


In accordance with REST principles, clients make requests through HTTP with the usual meanings assigned to the standard HTTP verbs GET, POST, PUT, and DELETE.



Besides the generally accepted REST design principles, Apache Deltacloud follows the guidelines discussed in the Fedora Project Cloud APIs Rest Style Guide.



The URL space of the API is structured into collections of resources. The top level entities used in the Deltacloud API are: realms, images, instance states, instances, keys, storage volumes, storage snapshots, blob storage, hardware profiles and drivers.


Authentication


The Deltacloud API server is stateless and does not keep any information about the current client. The Deltalcloud server does not store the credentials for the back-end cloud which the server is talking to. Instead, the server uses HTTP basic authentication and clients have to send the username/password for the back-end cloud on every request.



The specifics of what needs to be sent varies from cloud to cloud; some cloud providers request a username and password for API access, the others use special-purpose API keys. Check the list of the credentials to find out what kind of information a specific cloud provider expects.


Server responses


The server can respond to client requests in various formats. The appropriate response format is determined by HTTP content negotiation. The primary format is XML. The output is also available as JSON and as HTML (mostly for testing). Clients can also explicitly request a specific response format by including the format= request parameter (http://deltacloudserver.foo/api?format=xml or http://deltacloudserver.foo/api?format=json).



In general (especially for the HTML interface), list operations such as GET /api/realms will provide a list of objects of this resource type with only brief details. Full details can be retrieved by making a request GET /api/realms/:id to the URL of the individual realm.


API conventions


Any XML element which represents an object (such as an instance) has a href and an id attribute. The href attribute provides the URL at which object-specific actions can be performed (for example a GET action applied to the URL will return details of the object). The id provides an identifier of the object, which is unique within its collection (there is a unique id for each Instance, Image, Realm etc).



Objects also have a human-readable name. The name is provided in a <name/> child element of the object’s container tag.


API stability and evolution


Every change to the API is made in a way that allows old clients to work against newer versions of the API server.



You may come across the following changes in newer versions of the API:



adding new collections, or supporting new operations on existing collections
  adding optional parameters to existing operations
  adding additional attributes and elements to the XML/JSON responses


On the other hand, these changes would violate API stability and therefore they are not made:



removing an operation on a collection
  making an optional parameter for an operation mandatory
  removing attributes or elements from XML responses

Online documentation


You can access an automatically generated documentation on every server running the Deltacloud Core API service through the URL http://localhost:3001/api/docs/. The documentation is both available in HTML and XML, though the XML format is not part of this specification and may change in an incompatible way.


API entry point  



;T;@�I"/keys/;T{;{	;I"/<

  
    
    Keys
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

Keys


A key captures the credentials required to access an Instance. The Deltacloud API supports two main types of keys:



the password with username and password attributes
  the key with fingerprint and pem (private key) attributes (public/private keypair)


The key type is determined by the back-end cloud provider.



Some cloud providers require the specification of the credentials used for connecting to an instance as a parameter for instance creation. For example, the Amazon EC2 cloud uses key type of keys; the identifier of the key used with a given instance is supplied within the keyname parameter to the POST /api/instances call (see the Create an instance section).



Other cloud providers report the instance credentials in response to instance creation and make them available for subsequent retrieval. For example, the Gogrid Cloud uses the password type of keys. 



The Rackspace cloud also reports credentials during instance creation though it does not provide a mechanism with which to retrieve those passwords thereafter).


  
  



    REST API
  
  Introduction
  API entry point
  Compute resources
  
Realms
    Hardware profiles
    Images
    Instance states
    Instances
    Keys
    Firewalls
    Addresses
    Load balancers
  
Storage resources





Get a list of all keys
  Get the description of a key
  Create/delete a key

  
  
Get a list of all keys


To get a list of all available keys use call GET /api/keys. The example below shows keys from the Amazon EC2 cloud (key type). The XML response does not contain the private key attribute. It is because EC2 only provides the private key once, when the key is created (see the Create/delete a key
 section).


Example request:

GET /api/keys?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*


Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Tue, 26 Jul 2011 08:09:26 GMT
Content-Length: 733

<?xml version='1.0' encoding='utf-8' ?>
<keys>
  <key href='http://localhost:3001/api/keys/deltacloud_jsmith' id='deltacloud_jsmith' type='key'>
    <actions>
      <link href='http://localhost:3001/api/keys/deltacloud_jsmith' method='delete' rel='destroy' />
    </actions>
    <fingerprint>38:93:81:11:83:c2:c7:27:e8:79:17:e2:08:c9:13:99:73:90:8e:cc</fingerprint>
    <state>AVAILABLE</state>
  </key>
  <key href='http://localhost:3001/api/keys/the_key' id='the_key' type='key'>
    <actions>
      <link href='http://localhost:3001/api/keys/the_key' method='delete' rel='destroy' />
    </actions>
    <fingerprint>39:d3:9b:bb:93:92:97:27:e9:7d:b7:e2:09:9d:b3:dd:73:d0:9e:99</fingerprint>
    <state>AVAILABLE</state>
  </key>
</keys>


  
  

Get the description of a key


To get the XML description for a specific key use call GET /api/keys/:id. The example below shows a password type of key from the Gogrid cloud:


Example request:

GET /api/keys/72398?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.21.2 (x86_64-apple-darwin10.3.1)
Host: localhost:3001
Accept: */*


Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Tue, 26 Jul 2011 11:13:25 GMT
Content-Length: 269

<?xml version='1.0' encoding='utf-8' ?>
<key href='http://localhost:3001/api/keys/72398' id='72398' type='password'>
    <actions>
    </actions>
    <username><![CDATA[26648]]></username>
    <password><![CDATA[3woc7UWdJsJEcm8@]]></password>
    <state></state>
</key>


  
  

Create a new key


To create a new key use call POST /api/keys. Some back-end cloud providers allow a client to create new credentials for accessing instances. The parameters (key attributes) required by this function will depend on the back-end cloud provider and are specified in the relevant driver. At present, only the Amazon EC2 cloud implements a key creation method. The method requires to specify the key name as a parameter. 



Note that the private key attribute of a newly created key is reported only once, in response to the create operation (see the example below). The client should save the private key for following use with instance authentication. In all subsequent calls, the Deltacloud server response displays only the fingerprint attribute, as illustrated in the Get a list of all keys section.



As with other HTTP POST calls in the Deltacloud REST API, client requests may specify the required parameters as multipart/form-data, or using the application/x-www-form-urlencoded content type.


Example request:

POST /api/keys?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 19
Content-Type: application/x-www-form-urlencoded

name=jsmith_new_key


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Date: Tue, 26 Jul 2011 10:58:58 GMT
Content-Length: 2062

<?xml version='1.0' encoding='utf-8' ?>
<key href='http://localhost:3001/api/keys/jsmith_new_key' id='jsmith_new_key' type='key'>
  <actions>
    <link href='http://localhost:3001/api/keys/jsmith_new_key' method='delete' rel='destroy' />
  </actions>
  <fingerprint>c6:80:5c:0a:b8:66:0d:58:5a:bf:0f:c2:5d:35:d3:c7:49:f3:5a:5f</fingerprint>
  <pem>
    <![CDATA[-----BEGIN RSA PRIVATE KEY-----
    MIIEpgIBAAKCAQEAsPIzLQEpoLkxd0WESPEWQ4AMn9e0T6jHIMl/a2GUx2TA2Q10n6i5h4VAXXrK
    m9fNnPJhw1uRbuL7Oz57QSftGUfz05EaLOsvIEq3OXA0HqnFPF7Dd4yvy07KfgNHe2c26NqIqxgw
    GCy6tfd/9iKQIlFCG8I/M6fgEG/vw30GP5EywYLS0J7lYfNHJAVAznjX0LoOWvT0zYajZ7gWJ30/
    sQ/IFaKxC3BpT6K2aQP+RgAimALHinFuoT4+07SsrQXEezLemAG/gdbw3+7DL9BGq0CCoY1RxeC7
    qNh9BJwHtq9QPYg/RKruiYak/TSoB71/VP67lJv0WEkCRJKEFpz5SQIDAQABAoIBAQChVyZcmdvI
    JjS5aVSWYeWIBMD+GmPZ4q428iPR2LcdHHxPLVqyndkVfeXTlrwZX6umuMd1pw+zyRmEypL+NRaW
    36mutnbkkEl3K0loASw07V3fjxSx9EDyo1Q1lG3gUpuZtHG7eCGaWWahtxwhZSCBehBKWVLhmefP
    dRFs8Zn56LhfxByS/HcmHYddq1ggynFgg1DszYKTiJ0k5Zd/w4gh3GXH02S50cNFumJh9tbZNeDz
    yqa6a12N21loZ/VRRL7lEjpf3K2n0DCQ5pp0I9/FiwuwHMWr6qPSsQt9N/XclNiVg7fz+btNsqVY
    US1kBkvazoaANmF3VOXT9bmiFnuBAoGBAOkURD2uBe9UUl7xvWON7yS+tBcs1KyYDsTEhsS5dLdk
    n73/5vyEVzozdywTR7lQWVQhWWwkK/FJd9Xo/VV5bGXl+MK/JxIQHrEhLzO1OeYEBiw2eKhigyDb
    lm7pk/DuBNqgnA9YVnSvRYjpnvgBeb89CHvdhqn52GcbB2ShXurRAoGBAMJYyqNyl8CiIqesigts
    tlRk0UmS/LS6I58f7nbcrkgO3ZDsYhXhj9aKSJx56bpWTwoFdl7nTSUwkFgq2ts3g7EPQbYD/5G6
    kwpq0tvC23zZTfYvjExNVORh9PJBCrBl1tC/5nqYSrHC7H3Ys/SW3DF+0LPTdOtx5FwL5Utr3lT5
    AoGBAM3Y8EvpHaS5O+ZOaY07FTHGmxa8qTelM6XkS4ICqGovnEUZdM8fskncmit6+6VWqQ38RhWT
    /Jsk34k0NEkA7BMyf/i/CaqSQgj93co1C+VxOGJj2TwdhOHIDZv2/omSLQdJQYrr4a87/JVmftdZ
    tkSHiq6afwwvdEfbPzRIsKOBAoGBAK5EjEAP6z+So1yS/J3N95ipZnmA0hUErBhtu5jdvXFj0w22
    ySUxw5bvHLkjIJA0AF/OEhx7b9OfPm+wzdqwZugH9DZQU4TLNjqrGzRv//xtptjQPg/Vb//yToBE
    Dl+qkftReEwJ70CCtykJfiQeeofvXRlCzZ6p28kl6Y+9w/mRAoGBANI8AGB1iUDMQDiEfTAuH7jB
    nZTZUsfAaysoku3gyVmtcu1Zo7T02b8YW3ypuNu664KO7eNik9q68yKa7oDuLVrVj6Sh2DInoeW9
    vbjp2KcyMVEPHzWh86LV9IY5oHjQxlK/PMhQWMEeysi6j2qFqrx2rqRhG6kZUcFHFoHQpmv2
    -----END RSA PRIVATE KEY-----]]>
  </pem>
  <state>AVAILABLE</state>
</key>


Delete a key


To delete a key, specified by its :id attribute, use call DELETE /api/keys/:id. As well as the create operation, this feature is currently only available in the Amazon EC2 driver.


Example request:

DELETE /api/keys/jsmith_new_key?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*


Server response:

HTTP/1.1 204 No Content
Date: Tue, 26 Jul 2011 10:18:38 GMT


  


Firewalls  




      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"�&



  

Keys


A key captures the credentials required to access an Instance. The Deltacloud API supports two main types of keys:



  the password with username and password attributes
  the key with fingerprint and pem (private key) attributes (public/private keypair)



The key type is determined by the back-end cloud provider.



Some cloud providers require the specification of the credentials used for connecting to an instance as a parameter for instance creation. For example, the Amazon EC2 cloud uses key type of keys; the identifier of the key used with a given instance is supplied within the keyname parameter to the POST /api/instances call (see the Create an instance section).



Other cloud providers report the instance credentials in response to instance creation and make them available for subsequent retrieval. For example, the Gogrid Cloud uses the password type of keys. 



The Rackspace cloud also reports credentials during instance creation though it does not provide a mechanism with which to retrieve those passwords thereafter).


  
  


  
    REST API
  
  Introduction
  API entry point
  Compute resources
  
    Realms
    Hardware profiles
    Images
    Instance states
    Instances
    Keys
    Firewalls
    Addresses
    Load balancers
  
  Storage resources


  



  Get a list of all keys
  Get the description of a key
  Create/delete a key





  
  
Get a list of all keys


To get a list of all available keys use call GET /api/keys. The example below shows keys from the Amazon EC2 cloud (key type). The XML response does not contain the private key attribute. It is because EC2 only provides the private key once, when the key is created (see the Create/delete a key
 section).


Example request:

GET /api/keys?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*


Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Tue, 26 Jul 2011 08:09:26 GMT
Content-Length: 733

<?xml version='1.0' encoding='utf-8' ?>
<keys>
  <key href='http://localhost:3001/api/keys/deltacloud_jsmith' id='deltacloud_jsmith' type='key'>
    <actions>
      <link href='http://localhost:3001/api/keys/deltacloud_jsmith' method='delete' rel='destroy' />
    </actions>
    <fingerprint>38:93:81:11:83:c2:c7:27:e8:79:17:e2:08:c9:13:99:73:90:8e:cc</fingerprint>
    <state>AVAILABLE</state>
  </key>
  <key href='http://localhost:3001/api/keys/the_key' id='the_key' type='key'>
    <actions>
      <link href='http://localhost:3001/api/keys/the_key' method='delete' rel='destroy' />
    </actions>
    <fingerprint>39:d3:9b:bb:93:92:97:27:e9:7d:b7:e2:09:9d:b3:dd:73:d0:9e:99</fingerprint>
    <state>AVAILABLE</state>
  </key>
</keys>


  
  

Get the description of a key


To get the XML description for a specific key use call GET /api/keys/:id. The example below shows a password type of key from the Gogrid cloud:


Example request:

GET /api/keys/72398?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.21.2 (x86_64-apple-darwin10.3.1)
Host: localhost:3001
Accept: */*


Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Tue, 26 Jul 2011 11:13:25 GMT
Content-Length: 269

<?xml version='1.0' encoding='utf-8' ?>
<key href='http://localhost:3001/api/keys/72398' id='72398' type='password'>
    <actions>
    </actions>
    <username><![CDATA[26648]]></username>
    <password><![CDATA[3woc7UWdJsJEcm8@]]></password>
    <state></state>
</key>


  
  

Create a new key


To create a new key use call POST /api/keys. Some back-end cloud providers allow a client to create new credentials for accessing instances. The parameters (key attributes) required by this function will depend on the back-end cloud provider and are specified in the relevant driver. At present, only the Amazon EC2 cloud implements a key creation method. The method requires to specify the key name as a parameter. 



Note that the private key attribute of a newly created key is reported only once, in response to the create operation (see the example below). The client should save the private key for following use with instance authentication. In all subsequent calls, the Deltacloud server response displays only the fingerprint attribute, as illustrated in the Get a list of all keys section.



As with other HTTP POST calls in the Deltacloud REST API, client requests may specify the required parameters as multipart/form-data, or using the application/x-www-form-urlencoded content type.


Example request:

POST /api/keys?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 19
Content-Type: application/x-www-form-urlencoded

name=jsmith_new_key


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Date: Tue, 26 Jul 2011 10:58:58 GMT
Content-Length: 2062

<?xml version='1.0' encoding='utf-8' ?>
<key href='http://localhost:3001/api/keys/jsmith_new_key' id='jsmith_new_key' type='key'>
  <actions>
    <link href='http://localhost:3001/api/keys/jsmith_new_key' method='delete' rel='destroy' />
  </actions>
  <fingerprint>c6:80:5c:0a:b8:66:0d:58:5a:bf:0f:c2:5d:35:d3:c7:49:f3:5a:5f</fingerprint>
  <pem>
    <![CDATA[-----BEGIN RSA PRIVATE KEY-----
    MIIEpgIBAAKCAQEAsPIzLQEpoLkxd0WESPEWQ4AMn9e0T6jHIMl/a2GUx2TA2Q10n6i5h4VAXXrK
    m9fNnPJhw1uRbuL7Oz57QSftGUfz05EaLOsvIEq3OXA0HqnFPF7Dd4yvy07KfgNHe2c26NqIqxgw
    GCy6tfd/9iKQIlFCG8I/M6fgEG/vw30GP5EywYLS0J7lYfNHJAVAznjX0LoOWvT0zYajZ7gWJ30/
    sQ/IFaKxC3BpT6K2aQP+RgAimALHinFuoT4+07SsrQXEezLemAG/gdbw3+7DL9BGq0CCoY1RxeC7
    qNh9BJwHtq9QPYg/RKruiYak/TSoB71/VP67lJv0WEkCRJKEFpz5SQIDAQABAoIBAQChVyZcmdvI
    JjS5aVSWYeWIBMD+GmPZ4q428iPR2LcdHHxPLVqyndkVfeXTlrwZX6umuMd1pw+zyRmEypL+NRaW
    36mutnbkkEl3K0loASw07V3fjxSx9EDyo1Q1lG3gUpuZtHG7eCGaWWahtxwhZSCBehBKWVLhmefP
    dRFs8Zn56LhfxByS/HcmHYddq1ggynFgg1DszYKTiJ0k5Zd/w4gh3GXH02S50cNFumJh9tbZNeDz
    yqa6a12N21loZ/VRRL7lEjpf3K2n0DCQ5pp0I9/FiwuwHMWr6qPSsQt9N/XclNiVg7fz+btNsqVY
    US1kBkvazoaANmF3VOXT9bmiFnuBAoGBAOkURD2uBe9UUl7xvWON7yS+tBcs1KyYDsTEhsS5dLdk
    n73/5vyEVzozdywTR7lQWVQhWWwkK/FJd9Xo/VV5bGXl+MK/JxIQHrEhLzO1OeYEBiw2eKhigyDb
    lm7pk/DuBNqgnA9YVnSvRYjpnvgBeb89CHvdhqn52GcbB2ShXurRAoGBAMJYyqNyl8CiIqesigts
    tlRk0UmS/LS6I58f7nbcrkgO3ZDsYhXhj9aKSJx56bpWTwoFdl7nTSUwkFgq2ts3g7EPQbYD/5G6
    kwpq0tvC23zZTfYvjExNVORh9PJBCrBl1tC/5nqYSrHC7H3Ys/SW3DF+0LPTdOtx5FwL5Utr3lT5
    AoGBAM3Y8EvpHaS5O+ZOaY07FTHGmxa8qTelM6XkS4ICqGovnEUZdM8fskncmit6+6VWqQ38RhWT
    /Jsk34k0NEkA7BMyf/i/CaqSQgj93co1C+VxOGJj2TwdhOHIDZv2/omSLQdJQYrr4a87/JVmftdZ
    tkSHiq6afwwvdEfbPzRIsKOBAoGBAK5EjEAP6z+So1yS/J3N95ipZnmA0hUErBhtu5jdvXFj0w22
    ySUxw5bvHLkjIJA0AF/OEhx7b9OfPm+wzdqwZugH9DZQU4TLNjqrGzRv//xtptjQPg/Vb//yToBE
    Dl+qkftReEwJ70CCtykJfiQeeofvXRlCzZ6p28kl6Y+9w/mRAoGBANI8AGB1iUDMQDiEfTAuH7jB
    nZTZUsfAaysoku3gyVmtcu1Zo7T02b8YW3ypuNu664KO7eNik9q68yKa7oDuLVrVj6Sh2DInoeW9
    vbjp2KcyMVEPHzWh86LV9IY5oHjQxlK/PMhQWMEeysi6j2qFqrx2rqRhG6kZUcFHFoHQpmv2
    -----END RSA PRIVATE KEY-----]]>
  </pem>
  <state>AVAILABLE</state>
</key>


Delete a key


To delete a key, specified by its :id attribute, use call DELETE /api/keys/:id. As well as the create operation, this feature is currently only available in the Amazon EC2 driver.


Example request:

DELETE /api/keys/jsmith_new_key?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*


Server response:

HTTP/1.1 204 No Content
Date: Tue, 26 Jul 2011 10:18:38 GMT


  


Firewalls  


;T;
I"�&



  

Keys


A key captures the credentials required to access an Instance. The Deltacloud API supports two main types of keys:



the password with username and password attributes
  the key with fingerprint and pem (private key) attributes (public/private keypair)


The key type is determined by the back-end cloud provider.



Some cloud providers require the specification of the credentials used for connecting to an instance as a parameter for instance creation. For example, the Amazon EC2 cloud uses key type of keys; the identifier of the key used with a given instance is supplied within the keyname parameter to the POST /api/instances call (see the Create an instance section).



Other cloud providers report the instance credentials in response to instance creation and make them available for subsequent retrieval. For example, the Gogrid Cloud uses the password type of keys. 



The Rackspace cloud also reports credentials during instance creation though it does not provide a mechanism with which to retrieve those passwords thereafter).


  
  



    REST API
  
  Introduction
  API entry point
  Compute resources
  
Realms
    Hardware profiles
    Images
    Instance states
    Instances
    Keys
    Firewalls
    Addresses
    Load balancers
  
Storage resources





Get a list of all keys
  Get the description of a key
  Create/delete a key

  
  
Get a list of all keys


To get a list of all available keys use call GET /api/keys. The example below shows keys from the Amazon EC2 cloud (key type). The XML response does not contain the private key attribute. It is because EC2 only provides the private key once, when the key is created (see the Create/delete a key
 section).


Example request:

GET /api/keys?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*


Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Tue, 26 Jul 2011 08:09:26 GMT
Content-Length: 733

<?xml version='1.0' encoding='utf-8' ?>
<keys>
  <key href='http://localhost:3001/api/keys/deltacloud_jsmith' id='deltacloud_jsmith' type='key'>
    <actions>
      <link href='http://localhost:3001/api/keys/deltacloud_jsmith' method='delete' rel='destroy' />
    </actions>
    <fingerprint>38:93:81:11:83:c2:c7:27:e8:79:17:e2:08:c9:13:99:73:90:8e:cc</fingerprint>
    <state>AVAILABLE</state>
  </key>
  <key href='http://localhost:3001/api/keys/the_key' id='the_key' type='key'>
    <actions>
      <link href='http://localhost:3001/api/keys/the_key' method='delete' rel='destroy' />
    </actions>
    <fingerprint>39:d3:9b:bb:93:92:97:27:e9:7d:b7:e2:09:9d:b3:dd:73:d0:9e:99</fingerprint>
    <state>AVAILABLE</state>
  </key>
</keys>


  
  

Get the description of a key


To get the XML description for a specific key use call GET /api/keys/:id. The example below shows a password type of key from the Gogrid cloud:


Example request:

GET /api/keys/72398?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.21.2 (x86_64-apple-darwin10.3.1)
Host: localhost:3001
Accept: */*


Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Date: Tue, 26 Jul 2011 11:13:25 GMT
Content-Length: 269

<?xml version='1.0' encoding='utf-8' ?>
<key href='http://localhost:3001/api/keys/72398' id='72398' type='password'>
    <actions>
    </actions>
    <username><![CDATA[26648]]></username>
    <password><![CDATA[3woc7UWdJsJEcm8@]]></password>
    <state></state>
</key>


  
  

Create a new key


To create a new key use call POST /api/keys. Some back-end cloud providers allow a client to create new credentials for accessing instances. The parameters (key attributes) required by this function will depend on the back-end cloud provider and are specified in the relevant driver. At present, only the Amazon EC2 cloud implements a key creation method. The method requires to specify the key name as a parameter. 



Note that the private key attribute of a newly created key is reported only once, in response to the create operation (see the example below). The client should save the private key for following use with instance authentication. In all subsequent calls, the Deltacloud server response displays only the fingerprint attribute, as illustrated in the Get a list of all keys section.



As with other HTTP POST calls in the Deltacloud REST API, client requests may specify the required parameters as multipart/form-data, or using the application/x-www-form-urlencoded content type.


Example request:

POST /api/keys?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*
Content-Length: 19
Content-Type: application/x-www-form-urlencoded

name=jsmith_new_key


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Date: Tue, 26 Jul 2011 10:58:58 GMT
Content-Length: 2062

<?xml version='1.0' encoding='utf-8' ?>
<key href='http://localhost:3001/api/keys/jsmith_new_key' id='jsmith_new_key' type='key'>
  <actions>
    <link href='http://localhost:3001/api/keys/jsmith_new_key' method='delete' rel='destroy' />
  </actions>
  <fingerprint>c6:80:5c:0a:b8:66:0d:58:5a:bf:0f:c2:5d:35:d3:c7:49:f3:5a:5f</fingerprint>
  <pem>
    <![CDATA[-----BEGIN RSA PRIVATE KEY-----
    MIIEpgIBAAKCAQEAsPIzLQEpoLkxd0WESPEWQ4AMn9e0T6jHIMl/a2GUx2TA2Q10n6i5h4VAXXrK
    m9fNnPJhw1uRbuL7Oz57QSftGUfz05EaLOsvIEq3OXA0HqnFPF7Dd4yvy07KfgNHe2c26NqIqxgw
    GCy6tfd/9iKQIlFCG8I/M6fgEG/vw30GP5EywYLS0J7lYfNHJAVAznjX0LoOWvT0zYajZ7gWJ30/
    sQ/IFaKxC3BpT6K2aQP+RgAimALHinFuoT4+07SsrQXEezLemAG/gdbw3+7DL9BGq0CCoY1RxeC7
    qNh9BJwHtq9QPYg/RKruiYak/TSoB71/VP67lJv0WEkCRJKEFpz5SQIDAQABAoIBAQChVyZcmdvI
    JjS5aVSWYeWIBMD+GmPZ4q428iPR2LcdHHxPLVqyndkVfeXTlrwZX6umuMd1pw+zyRmEypL+NRaW
    36mutnbkkEl3K0loASw07V3fjxSx9EDyo1Q1lG3gUpuZtHG7eCGaWWahtxwhZSCBehBKWVLhmefP
    dRFs8Zn56LhfxByS/HcmHYddq1ggynFgg1DszYKTiJ0k5Zd/w4gh3GXH02S50cNFumJh9tbZNeDz
    yqa6a12N21loZ/VRRL7lEjpf3K2n0DCQ5pp0I9/FiwuwHMWr6qPSsQt9N/XclNiVg7fz+btNsqVY
    US1kBkvazoaANmF3VOXT9bmiFnuBAoGBAOkURD2uBe9UUl7xvWON7yS+tBcs1KyYDsTEhsS5dLdk
    n73/5vyEVzozdywTR7lQWVQhWWwkK/FJd9Xo/VV5bGXl+MK/JxIQHrEhLzO1OeYEBiw2eKhigyDb
    lm7pk/DuBNqgnA9YVnSvRYjpnvgBeb89CHvdhqn52GcbB2ShXurRAoGBAMJYyqNyl8CiIqesigts
    tlRk0UmS/LS6I58f7nbcrkgO3ZDsYhXhj9aKSJx56bpWTwoFdl7nTSUwkFgq2ts3g7EPQbYD/5G6
    kwpq0tvC23zZTfYvjExNVORh9PJBCrBl1tC/5nqYSrHC7H3Ys/SW3DF+0LPTdOtx5FwL5Utr3lT5
    AoGBAM3Y8EvpHaS5O+ZOaY07FTHGmxa8qTelM6XkS4ICqGovnEUZdM8fskncmit6+6VWqQ38RhWT
    /Jsk34k0NEkA7BMyf/i/CaqSQgj93co1C+VxOGJj2TwdhOHIDZv2/omSLQdJQYrr4a87/JVmftdZ
    tkSHiq6afwwvdEfbPzRIsKOBAoGBAK5EjEAP6z+So1yS/J3N95ipZnmA0hUErBhtu5jdvXFj0w22
    ySUxw5bvHLkjIJA0AF/OEhx7b9OfPm+wzdqwZugH9DZQU4TLNjqrGzRv//xtptjQPg/Vb//yToBE
    Dl+qkftReEwJ70CCtykJfiQeeofvXRlCzZ6p28kl6Y+9w/mRAoGBANI8AGB1iUDMQDiEfTAuH7jB
    nZTZUsfAaysoku3gyVmtcu1Zo7T02b8YW3ypuNu664KO7eNik9q68yKa7oDuLVrVj6Sh2DInoeW9
    vbjp2KcyMVEPHzWh86LV9IY5oHjQxlK/PMhQWMEeysi6j2qFqrx2rqRhG6kZUcFHFoHQpmv2
    -----END RSA PRIVATE KEY-----]]>
  </pem>
  <state>AVAILABLE</state>
</key>


Delete a key


To delete a key, specified by its :id attribute, use call DELETE /api/keys/:id. As well as the create operation, this feature is currently only available in the Amazon EC2 driver.


Example request:

DELETE /api/keys/jsmith_new_key?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*


Server response:

HTTP/1.1 204 No Content
Date: Tue, 26 Jul 2011 10:18:38 GMT


  


Firewalls  


;T;@�I"/api-entry-point/;T{;{	;I"�0

  
    
    API entry point
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

The API entry point


Any part of the official API can be reached through the main entry point, by default http://localhost:3001/api. The entry point lists the resources for the current cloud provider, which the server knows about. For example, for the Amazon EC2 driver these are:



instances
instance states
images
realms


  



    REST API
  
  Introduction
  API entry point
    
Features
    
Compute resources
  Storage resources





hardware profiles
keys
buckets
storage volumes
storage snapshots
load balancers
addresses
firewalls
Example request:

GET /api?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*


Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1439

<api driver='ec2' version='0.3.0'>
  <link href='http://localhost:3001/api/instance_states' rel='instance_states'>
  </link>
  <link href='http://localhost:3001/api/drivers' rel='drivers'>
  </link>
  <link href='http://localhost:3001/api/addresses' rel='addresses'>
  </link>
  <link href='http://localhost:3001/api/hardware_profiles' rel='hardware_profiles'>
  </link>
  <link href='http://localhost:3001/api/firewalls' rel='firewalls'>
  </link>
  <link href='http://localhost:3001/api/storage_volumes' rel='storage_volumes'>
  </link>
  <link href='http://localhost:3001/api/images' rel='images'>
    <feature name='owner_id'>
    </feature>
  </link>
  <link href='http://localhost:3001/api/realms' rel='realms'>
  </link>
  <link href='http://localhost:3001/api/buckets' rel='buckets'>
    <feature name='bucket_location'>
    </feature>
  </link>
  <link href='http://localhost:3001/api/instances' rel='instances'>
    <feature name='user_data'>
    </feature>
    <feature name='authentication_key'>
    </feature>
    <feature name='firewalls'>
    </feature>
    <feature name='instance_count'>
    </feature>
    <feature name='attach_snapshot'>
    </feature>
  </link>
  <link href='http://localhost:3001/api/storage_snapshots' rel='storage_snapshots'>
  </link>
  <link href='http://localhost:3001/api/keys' rel='keys'>
  </link>
  <link href='http://localhost:3001/api/load_balancers' rel='load_balancers'>
  </link>
</api>



Some implementations for the Apache Deltacloud API may not support all resource types defined by API. For example, a Deltacloud instance pointing at a storage-only service will not expose compute resources like instances and hardware profiles.


Features


The Apache Deltacloud API defines the standard behavior and semantics for each of the resource types as a baseline for any API implementation. It is often desirable to enhance standard API behavior with specific features. The API also defines all features that can be supported by the API implementation - each of them has a fixed predefined meaning. For example, the feature user_name indicates that a user-specified name can be assigned to an instance when it is created. Features are advertised in the top-level entry point as illustrated below:


<api driver='mock' version='0.3.0'>
  ...
  <link href='http://localhost:3001/api/instances' rel='instances'>
    <feature name='hardware_profiles'></feature>
    <feature name='user_name'></feature>
    <feature name='authentication_key'></feature>
  </link>
  ...
</api>



These features are available to each collection in the Deltacloud API:

Feature	Collection	Operation	Description
owner_id	Images	GET /api/images	allows filtering of the image list by owner_id
user_name	Instances	POST /api/instances	accepts a user-defined name on instance creation
user_data	Instances	POST /api/instances	provide user-defined data that is accessible by the running instance
user_iso	Instances	POST /api/instances	provides a base64 encoded gzipped ISO file accessible as CD-ROM drive by the running instnace
user_files	Instances	POST /api/instances	accept files that will be placed into the launched instance
firewalls	Instances	POST /api/instances	put the instance into one or more firewalls on launch
authentication_key	Instances	POST /api/instances	provides the authentication key to access the instance
authentication_password	Instances	POST /api/instances	provides the password to access the running instance
instance_count	Instances	POST /api/instances	specifies the number of instances to launch in one operation
attach_snapshot	Instances	POST /api/instances	attaches a storage snapshot to an instance as a storage volume
sandboxing	Instances	POST /api/instances	launches an instance from a sandbox image (Gogrid specific)
bucket_location	Buckets	POST /api/buckets	specifies a location that the bucket should be created in (e.g. specific cloud-provider datacenter)

Compute resources






      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users.

 





  

;T;	I"�



  

The API entry point


Any part of the official API can be reached through the main entry point, by default http://localhost:3001/api. The entry point lists the resources for the current cloud provider, which the server knows about. For example, for the Amazon EC2 driver these are:



instances
instance states
images
realms


  
  


  
    REST API
  
  Introduction
  API entry point
    
      Features
    
  Compute resources
  Storage resources


  



hardware profiles
keys
buckets
storage volumes
storage snapshots
load balancers
addresses
firewalls


Example request:

GET /api?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*


Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1439

<api driver='ec2' version='0.3.0'>
  <link href='http://localhost:3001/api/instance_states' rel='instance_states'>
  </link>
  <link href='http://localhost:3001/api/drivers' rel='drivers'>
  </link>
  <link href='http://localhost:3001/api/addresses' rel='addresses'>
  </link>
  <link href='http://localhost:3001/api/hardware_profiles' rel='hardware_profiles'>
  </link>
  <link href='http://localhost:3001/api/firewalls' rel='firewalls'>
  </link>
  <link href='http://localhost:3001/api/storage_volumes' rel='storage_volumes'>
  </link>
  <link href='http://localhost:3001/api/images' rel='images'>
    <feature name='owner_id'>
    </feature>
  </link>
  <link href='http://localhost:3001/api/realms' rel='realms'>
  </link>
  <link href='http://localhost:3001/api/buckets' rel='buckets'>
    <feature name='bucket_location'>
    </feature>
  </link>
  <link href='http://localhost:3001/api/instances' rel='instances'>
    <feature name='user_data'>
    </feature>
    <feature name='authentication_key'>
    </feature>
    <feature name='firewalls'>
    </feature>
    <feature name='instance_count'>
    </feature>
    <feature name='attach_snapshot'>
    </feature>
  </link>
  <link href='http://localhost:3001/api/storage_snapshots' rel='storage_snapshots'>
  </link>
  <link href='http://localhost:3001/api/keys' rel='keys'>
  </link>
  <link href='http://localhost:3001/api/load_balancers' rel='load_balancers'>
  </link>
</api>



Some implementations for the Apache Deltacloud API may not support all resource types defined by API. For example, a Deltacloud instance pointing at a storage-only service will not expose compute resources like instances and hardware profiles.


Features


The Apache Deltacloud API defines the standard behavior and semantics for each of the resource types as a baseline for any API implementation. It is often desirable to enhance standard API behavior with specific features. The API also defines all features that can be supported by the API implementation - each of them has a fixed predefined meaning. For example, the feature user_name indicates that a user-specified name can be assigned to an instance when it is created. Features are advertised in the top-level entry point as illustrated below:


<api driver='mock' version='0.3.0'>
  ...
  <link href='http://localhost:3001/api/instances' rel='instances'>
    <feature name='hardware_profiles'></feature>
    <feature name='user_name'></feature>
    <feature name='authentication_key'></feature>
  </link>
  ...
</api>



These features are available to each collection in the Deltacloud API:



  
    
      Feature
      Collection
      Operation
      Description
    
  
  
    
      owner_id
      Images
      GET /api/images
      allows filtering of the image list by owner_id
    
    
      user_name
      Instances
      POST /api/instances
      accepts a user-defined name on instance creation
    
    
      user_data
      Instances
      POST /api/instances
      provide user-defined data that is accessible by the running instance
    
    
      user_iso
      Instances
      POST /api/instances
      provides a base64 encoded gzipped ISO file accessible as CD-ROM drive by the running instnace
    
    
      user_files
      Instances
      POST /api/instances
      accept files that will be placed into the launched instance
    
    
      firewalls
      Instances
      POST /api/instances
      put the instance into one or more firewalls on launch
    
    
      authentication_key
      Instances
      POST /api/instances
      provides the authentication key to access the instance
    
    
      authentication_password
      Instances
      POST /api/instances
      provides the password to access the running instance
    
    
      instance_count
      Instances
      POST /api/instances
      specifies the number of instances to launch in one operation
    
    
      attach_snapshot
      Instances
      POST /api/instances
      attaches a storage snapshot to an instance as a storage volume
    
    
      sandboxing
      Instances
      POST /api/instances
      launches an instance from a sandbox image (Gogrid specific)
    
    
      bucket_location
      Buckets
      POST /api/buckets
      specifies a location that the bucket should be created in (e.g. specific cloud-provider datacenter)
    
  


Compute resources  


;T;
I"U



  

The API entry point


Any part of the official API can be reached through the main entry point, by default http://localhost:3001/api. The entry point lists the resources for the current cloud provider, which the server knows about. For example, for the Amazon EC2 driver these are:



instances
instance states
images
realms


  



    REST API
  
  Introduction
  API entry point
    
Features
    
Compute resources
  Storage resources





hardware profiles
keys
buckets
storage volumes
storage snapshots
load balancers
addresses
firewalls
Example request:

GET /api?format=xml HTTP/1.1
Authorization: Basic AU1J3UB2121Afd1DdyQWxLaTYTmJMNF4zTXBoRGdhMDh2RUw5ZDAN9zVXVa==
User-Agent: curl/7.20.1 (i386-redhat-linux-gnu)
Host: localhost:3001
Accept: */*


Server response:

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 1439

<api driver='ec2' version='0.3.0'>
  <link href='http://localhost:3001/api/instance_states' rel='instance_states'>
  </link>
  <link href='http://localhost:3001/api/drivers' rel='drivers'>
  </link>
  <link href='http://localhost:3001/api/addresses' rel='addresses'>
  </link>
  <link href='http://localhost:3001/api/hardware_profiles' rel='hardware_profiles'>
  </link>
  <link href='http://localhost:3001/api/firewalls' rel='firewalls'>
  </link>
  <link href='http://localhost:3001/api/storage_volumes' rel='storage_volumes'>
  </link>
  <link href='http://localhost:3001/api/images' rel='images'>
    <feature name='owner_id'>
    </feature>
  </link>
  <link href='http://localhost:3001/api/realms' rel='realms'>
  </link>
  <link href='http://localhost:3001/api/buckets' rel='buckets'>
    <feature name='bucket_location'>
    </feature>
  </link>
  <link href='http://localhost:3001/api/instances' rel='instances'>
    <feature name='user_data'>
    </feature>
    <feature name='authentication_key'>
    </feature>
    <feature name='firewalls'>
    </feature>
    <feature name='instance_count'>
    </feature>
    <feature name='attach_snapshot'>
    </feature>
  </link>
  <link href='http://localhost:3001/api/storage_snapshots' rel='storage_snapshots'>
  </link>
  <link href='http://localhost:3001/api/keys' rel='keys'>
  </link>
  <link href='http://localhost:3001/api/load_balancers' rel='load_balancers'>
  </link>
</api>



Some implementations for the Apache Deltacloud API may not support all resource types defined by API. For example, a Deltacloud instance pointing at a storage-only service will not expose compute resources like instances and hardware profiles.


Features


The Apache Deltacloud API defines the standard behavior and semantics for each of the resource types as a baseline for any API implementation. It is often desirable to enhance standard API behavior with specific features. The API also defines all features that can be supported by the API implementation - each of them has a fixed predefined meaning. For example, the feature user_name indicates that a user-specified name can be assigned to an instance when it is created. Features are advertised in the top-level entry point as illustrated below:


<api driver='mock' version='0.3.0'>
  ...
  <link href='http://localhost:3001/api/instances' rel='instances'>
    <feature name='hardware_profiles'></feature>
    <feature name='user_name'></feature>
    <feature name='authentication_key'></feature>
  </link>
  ...
</api>



These features are available to each collection in the Deltacloud API:




Feature
      Collection
      Operation
      Description
    


owner_id
      Images
      GET /api/images
      allows filtering of the image list by owner_id
    

user_name
      Instances
      POST /api/instances
      accepts a user-defined name on instance creation
    

user_data
      Instances
      POST /api/instances
      provide user-defined data that is accessible by the running instance
    

user_iso
      Instances
      POST /api/instances
      provides a base64 encoded gzipped ISO file accessible as CD-ROM drive by the running instnace
    

user_files
      Instances
      POST /api/instances
      accept files that will be placed into the launched instance
    

firewalls
      Instances
      POST /api/instances
      put the instance into one or more firewalls on launch
    

authentication_key
      Instances
      POST /api/instances
      provides the authentication key to access the instance
    

authentication_password
      Instances
      POST /api/instances
      provides the password to access the running instance
    

instance_count
      Instances
      POST /api/instances
      specifies the number of instances to launch in one operation
    

attach_snapshot
      Instances
      POST /api/instances
      attaches a storage snapshot to an instance as a storage volume
    

sandboxing
      Instances
      POST /api/instances
      launches an instance from a sandbox image (Gogrid specific)
    

bucket_location
      Buckets
      POST /api/buckets
      specifies a location that the bucket should be created in (e.g. specific cloud-provider datacenter)
    

Compute resources  


;T;@�I"/run-deltacloud-server/;T{;{	;I"�%

  
    
    Run the Deltacloud server
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      

 Quick-start guide
This guide focuses on a linux environment. Some of the Deltacloud developers are running recent versions of Fedora. However, you should be able to install Deltacloud on any OS that supports Ruby. If you are having any problems with installation, please let us know, we'd love to hear from you!

Running the Deltacloud server
Start the server by typing deltacloudd -i driver_id.
The driver_id is the name of the cloud provider that you have an account with, for example deltacloudd -i ec2.
If you don't yet have an account with a cloud provider, you can still try the Deltacloud mock driver:
deltacloudd -i mock
This will start the Deltacloud server on your local machine with the mock driver, accepting connections on port 3001 (default). From version 0.4.0 of Deltacloud, you can use the '-l' flag to see all available driver_ids that can be used with the deltacloudd executable:
$ deltacloudd -l

Available drivers:
* condor
* vsphere
* opennebula
* eucalyptus
* rhevm
* sbc
* azure
* gogrid
* mock
* rackspace
* rimuhosting
* terremark
* ec2


Deltacloud HTML interface
After you start the server, you are ready to use the Deltacloud HTML interface.
Open the address http://localhost:3001/api in your web browser:

To display the XML output from the server in the browser, append format=xml to each URL. On Webkit based browsers like Safari, you might need to instruct the server explicitly to return HTML. Do this by appending format=html to each URL.

Your browser will prompt you for credentials when you invoke an operation that requires authentication.

The '-h' flag will list all available options for deltacloudd. For example, to start the Deltacloud server with the Rackspace driver on port 10000 you can use:

$ deltacloudd -i rackspace -p 10000

If you want to install the server on another machine and make Deltacloud available on your local network, you need to bind the Deltacloud server to an address other than 'localhost' (default). To start the server use the IP address of a machine where you installed and started Deltacloud. For instance:

$ deltacloudd -i ec2 -p 5000 -r 192.168.10.200

This will make the Deltacloud server available at the address http://192.168.10.200:5000/api. Instead of IP address you can also use the hostname to start the server on another machine.

Using CIMI


To use CIMI, first, go to the direcotry ~/deltacloud/server/bin and start the Deltacloud server in the background:


./deltacloudd -i mock --cimi &



Then go to the directory ~/deltacloud/clients/cimi and start the CIMI client server in the background:


bin/start -u http://localhost:3001/cimi -r <your_server_host_name> &



Use the -r option to make your client accessible from other machines different from the machine on which you are running both servers.



If there are some problems when you start up the servers, you may have missing dependencies. Check the RubyGems list with the list above and make sure you don't have anything missing. If there are no problems with starting the servers, access the application using your browser by following URL:


http://<your_server_host_name>:4001/cimi



The browser will ask for credentials. To log in use mockuser and mockpassword as user ID and password.


Use Deltacloud




      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"

 Quick-start guide
This guide focuses on a linux environment. Some of the Deltacloud developers are running recent versions of Fedora. However, you should be able to install Deltacloud on any OS that supports Ruby. If you are having any problems with installation, please let us know, we'd love to hear from you!

Running the Deltacloud server
Start the server by typing deltacloudd -i driver_id.
The driver_id is the name of the cloud provider that you have an account with, for example deltacloudd -i ec2.
If you don't yet have an account with a cloud provider, you can still try the Deltacloud mock driver: 
deltacloudd -i mock
This will start the Deltacloud server on your local machine with the mock driver, accepting connections on port 3001 (default). From version 0.4.0 of Deltacloud, you can use the '-l' flag to see all available driver_ids that can be used with the deltacloudd executable:
$ deltacloudd -l

Available drivers:
* condor
* vsphere
* opennebula
* eucalyptus
* rhevm
* sbc
* azure
* gogrid
* mock
* rackspace
* rimuhosting
* terremark
* ec2


Deltacloud HTML interface
After you start the server, you are ready to use the Deltacloud HTML interface.
Open the address http://localhost:3001/api in your web browser:

To display the XML output from the server in the browser, append format=xml to each URL. On Webkit based browsers like Safari, you might need to instruct the server explicitly to return HTML. Do this by appending format=html to each URL.

Your browser will prompt you for credentials when you invoke an operation that requires authentication.

The '-h' flag will list all available options for deltacloudd. For example, to start the Deltacloud server with the Rackspace driver on port 10000 you can use:

$ deltacloudd -i rackspace -p 10000

If you want to install the server on another machine and make Deltacloud available on your local network, you need to bind the Deltacloud server to an address other than 'localhost' (default). To start the server use the IP address of a machine where you installed and started Deltacloud. For instance:

$ deltacloudd -i ec2 -p 5000 -r 192.168.10.200

This will make the Deltacloud server available at the address http://192.168.10.200:5000/api. Instead of IP address you can also use the hostname to start the server on another machine.

Using CIMI


To use CIMI, first, go to the direcotry ~/deltacloud/server/bin and start the Deltacloud server in the background:


./deltacloudd -i mock --cimi &



Then go to the directory ~/deltacloud/clients/cimi and start the CIMI client server in the background:


bin/start -u http://localhost:3001/cimi -r <your_server_host_name> &



Use the -r option to make your client accessible from other machines different from the machine on which you are running both servers.



If there are some problems when you start up the servers, you may have missing dependencies. Check the RubyGems list with the list above and make sure you don't have anything missing. If there are no problems with starting the servers, access the application using your browser by following URL:


http://<your_server_host_name>:4001/cimi



The browser will ask for credentials. To log in use mockuser and mockpassword as user ID and password.


Use Deltacloud


;T;
I"

 Quick-start guide
This guide focuses on a linux environment. Some of the Deltacloud developers are running recent versions of Fedora. However, you should be able to install Deltacloud on any OS that supports Ruby. If you are having any problems with installation, please let us know, we'd love to hear from you!

Running the Deltacloud server
Start the server by typing deltacloudd -i driver_id.
The driver_id is the name of the cloud provider that you have an account with, for example deltacloudd -i ec2.
If you don't yet have an account with a cloud provider, you can still try the Deltacloud mock driver:
deltacloudd -i mock
This will start the Deltacloud server on your local machine with the mock driver, accepting connections on port 3001 (default). From version 0.4.0 of Deltacloud, you can use the '-l' flag to see all available driver_ids that can be used with the deltacloudd executable:
$ deltacloudd -l

Available drivers:
* condor
* vsphere
* opennebula
* eucalyptus
* rhevm
* sbc
* azure
* gogrid
* mock
* rackspace
* rimuhosting
* terremark
* ec2


Deltacloud HTML interface
After you start the server, you are ready to use the Deltacloud HTML interface.
Open the address http://localhost:3001/api in your web browser:

To display the XML output from the server in the browser, append format=xml to each URL. On Webkit based browsers like Safari, you might need to instruct the server explicitly to return HTML. Do this by appending format=html to each URL.

Your browser will prompt you for credentials when you invoke an operation that requires authentication.

The '-h' flag will list all available options for deltacloudd. For example, to start the Deltacloud server with the Rackspace driver on port 10000 you can use:

$ deltacloudd -i rackspace -p 10000

If you want to install the server on another machine and make Deltacloud available on your local network, you need to bind the Deltacloud server to an address other than 'localhost' (default). To start the server use the IP address of a machine where you installed and started Deltacloud. For instance:

$ deltacloudd -i ec2 -p 5000 -r 192.168.10.200

This will make the Deltacloud server available at the address http://192.168.10.200:5000/api. Instead of IP address you can also use the hostname to start the server on another machine.

Using CIMI


To use CIMI, first, go to the direcotry ~/deltacloud/server/bin and start the Deltacloud server in the background:


./deltacloudd -i mock --cimi &



Then go to the directory ~/deltacloud/clients/cimi and start the CIMI client server in the background:


bin/start -u http://localhost:3001/cimi -r <your_server_host_name> &



Use the -r option to make your client accessible from other machines different from the machine on which you are running both servers.



If there are some problems when you start up the servers, you may have missing dependencies. Check the RubyGems list with the list above and make sure you don't have anything missing. If there are no problems with starting the servers, access the application using your browser by following URL:


http://<your_server_host_name>:4001/cimi



The browser will ask for credentials. To log in use mockuser and mockpassword as user ID and password.


Use Deltacloud


;T;@�I"/cimi-rest/;T{;{	;I"�!

  
    
    CIMI REST Examples
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

The CIMI REST API


Apache Deltacloud exposes the DMTF Cloud Infrastructure Management Interface (CIMI) as an alternative to the native Deltacloud API. This means that clients can 'speak' the CIMI API to a Deltacloud server on the frontend, managing resources in any of the backend cloud providers supported by Deltacloud.




  Note: 
  
    This is  NOT  a definitive guide to the DMTF CIMI specification. The full CIMI spec is available from the DMTF Cloud Management Initiative (DSP0263).
  


 

  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    







This page shows examples of interactions with the CIMI interface exposed by a Deltacloud server. The examples here cover the CIMI resources and collections that are currently supported in Deltacloud; we are constantly improving our CIMI implementation. If you come across any bugs or inconsistencies we'd be very happy to hear about them.



In the following sections, the textual definitions following the title of each resource (e.g. "Machine") that are rendered in bold and italic type are taken from the CIMI 1.0.1 specification, available from the DMTF Cloud Management Initiative (DSP0263).


Starting Deltacloud with the CIMI interface

The  –frontends (-f) flag is used to specify which frontends a deltacloud server should expose:




[user@name ~]$ deltacloudd -i ec2 -f cimi
Starting Deltacloud API :: ec2 :: http://localhost:3001/cimi/cloudEntryPoint

>> Thin web server (v1.5.0 codename Knife)
>> Debugging ON
>> Maximum connections set to 1024
>> Listening on localhost:3001, CTRL+C to stop




The example above shows the deltacloud server with the CIMI interface and the EC2 driver. You can even expose both the deltacloud and the CIMI frontends with a single server, e.g.  -f cimi,deltacloud .

As can be seen above, starting deltacloud in this way will expose the CIMI cloud entry point at localhost:3001/cimi/cloudEntryPoint.

      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"



  

The CIMI REST API


Apache Deltacloud exposes the DMTF Cloud Infrastructure Management Interface (CIMI) as an alternative to the native Deltacloud API. This means that clients can 'speak' the CIMI API to a Deltacloud server on the frontend, managing resources in any of the backend cloud providers supported by Deltacloud.




  Note: 
  
    This is  NOT  a definitive guide to the DMTF CIMI specification. The full CIMI spec is available from the DMTF Cloud Management Initiative (DSP0263).
  


 

  



  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
      ResourceMetadata
      Machine
      Volume
    
  



  



This page shows examples of interactions with the CIMI interface exposed by a Deltacloud server. The examples here cover the CIMI resources and collections that are currently supported in Deltacloud; we are constantly improving our CIMI implementation. If you come across any bugs or inconsistencies we'd be very happy to hear about them.




In the following sections, the textual definitions following the title of each resource (e.g. "Machine") that are rendered in bold and italic type are taken from the CIMI 1.0.1 specification, available from the DMTF Cloud Management Initiative (DSP0263).




Starting Deltacloud with the CIMI interface

The  --frontends (-f) flag is used to specify which frontends a deltacloud server should expose:





[user@name ~]$ deltacloudd -i ec2 -f cimi
Starting Deltacloud API :: ec2 :: http://localhost:3001/cimi/cloudEntryPoint

>> Thin web server (v1.5.0 codename Knife)
>> Debugging ON
>> Maximum connections set to 1024
>> Listening on localhost:3001, CTRL+C to stop




The example above shows the deltacloud server with the CIMI interface and the EC2 driver. You can even expose both the deltacloud and the CIMI frontends with a single server, e.g.  -f cimi,deltacloud .

As can be seen above, starting deltacloud in this way will expose the CIMI cloud entry point at localhost:3001/cimi/cloudEntryPoint.;T;
I"6



  

The CIMI REST API


Apache Deltacloud exposes the DMTF Cloud Infrastructure Management Interface (CIMI) as an alternative to the native Deltacloud API. This means that clients can 'speak' the CIMI API to a Deltacloud server on the frontend, managing resources in any of the backend cloud providers supported by Deltacloud.




  Note: 
  
    This is  NOT  a definitive guide to the DMTF CIMI specification. The full CIMI spec is available from the DMTF Cloud Management Initiative (DSP0263).
  


 

  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    







This page shows examples of interactions with the CIMI interface exposed by a Deltacloud server. The examples here cover the CIMI resources and collections that are currently supported in Deltacloud; we are constantly improving our CIMI implementation. If you come across any bugs or inconsistencies we'd be very happy to hear about them.



In the following sections, the textual definitions following the title of each resource (e.g. "Machine") that are rendered in bold and italic type are taken from the CIMI 1.0.1 specification, available from the DMTF Cloud Management Initiative (DSP0263).


Starting Deltacloud with the CIMI interface

The  –frontends (-f) flag is used to specify which frontends a deltacloud server should expose:




[user@name ~]$ deltacloudd -i ec2 -f cimi
Starting Deltacloud API :: ec2 :: http://localhost:3001/cimi/cloudEntryPoint

>> Thin web server (v1.5.0 codename Knife)
>> Debugging ON
>> Maximum connections set to 1024
>> Listening on localhost:3001, CTRL+C to stop




The example above shows the deltacloud server with the CIMI interface and the EC2 driver. You can even expose both the deltacloud and the CIMI frontends with a single server, e.g.  -f cimi,deltacloud .

As can be seen above, starting deltacloud in this way will expose the CIMI cloud entry point at localhost:3001/cimi/cloudEntryPoint.;T;@�I"/assets/img/logo_black/;T{;{I"/assets/img/logo2/;T{;{I"/assets/img/logo_old/;T{;{I"/cimi-rest-entry-point/;T{;{	;I"L#

  
    
    CIMI Cloud Entry Point
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      REST API
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

The CIMI Cloud Entry Point


The Cloud Entry Point represents the entry point into the cloud defined by the CIMI Model. The Cloud
Entry Point implements a catalog of resources, such as Systems, System Templates, Machines, Machine
Templates, etc., that can be queried and browsed by the Consumer.


A deltacloud server exposes the CIMI Cloud Entry Point at /cimi/cloudEntryPoint. When dereferencing this URI, the resources listed in the response include only those that are supported by the current deltacloud driver - whether the 'default' driver the server was started with, or that specified with the X-Deltacloud-Driver header.


 

  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  CIMI Resources






Example request:

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



Example response:


HTTP/1.1 200 OK
Content-Type: application/xml
CIMI-Specification-Version: 1.0.1
Content-Length: 1754
ETag: 503bc06f24d1a51eddc62b33b870c70f
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 27 Dec 2012 15:23:23 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<CloudEntryPoint xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/CloudEntryPoint">
  <id>http://localhost:3001/cimi/cloudEntryPoint</id>
  <name>mock</name>
  <description>Cloud Entry Point for the Deltacloud mock driver</description>
  <created>2012-12-27T17:23:23+02:00</created>
  <baseURI>http://localhost:3001/cimi/</baseURI>
  <resourceMetadata href="http://localhost:3001/cimi/resource_metadata" />
  <machines href="http://localhost:3001/cimi/machines" />
  <machineTemplates href="http://localhost:3001/cimi/machine_templates" />
  <machineImages href="http://localhost:3001/cimi/machine_images" />
  <credentials href="http://localhost:3001/cimi/credentials" />
  <volumes href="http://localhost:3001/cimi/volumes" />
  <volumeImages href="http://localhost:3001/cimi/volume_images" />
  <networks href="http://localhost:3001/cimi/networks" />
  <networkTemplates href="http://localhost:3001/cimi/network_templates" />
  <networkPorts href="http://localhost:3001/cimi/network_ports" />
  <networkPortTemplates href="http://localhost:3001/cimi/network_port_templates" />
  <addresses href="http://localhost:3001/cimi/addresses" />
  <addressTemplates href="http://localhost:3001/cimi/address_templates" />
  <forwardingGroups href="http://localhost:3001/cimi/forwarding_groups" />
  <forwardingGroupTemplates href="http://localhost:3001/cimi/forwarding_group_templates" />
  <volumeConfigs href="http://localhost:3001/cimi/volume_configurations" />
  <machineConfigs href="http://localhost:3001/cimi/machine_configurations" />
  <networkConfigs href="http://localhost:3001/cimi/network_configurations" />
  <networkPortConfigs href="http://localhost:3001/cimi/network_port_configurations" />
</CloudEntryPoint>


      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I" 



  

The CIMI Cloud Entry Point


The Cloud Entry Point represents the entry point into the cloud defined by the CIMI Model. The Cloud
Entry Point implements a catalog of resources, such as Systems, System Templates, Machines, Machine
Templates, etc., that can be queried and browsed by the Consumer.


A deltacloud server exposes the CIMI Cloud Entry Point at /cimi/cloudEntryPoint. When dereferencing this URI, the resources listed in the response include only those that are supported by the current deltacloud driver - whether the 'default' driver the server was started with, or that specified with the X-Deltacloud-Driver header.


 

  


  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  CIMI Resources


  




Example request:

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



Example response:


HTTP/1.1 200 OK
Content-Type: application/xml
CIMI-Specification-Version: 1.0.1
Content-Length: 1754
ETag: 503bc06f24d1a51eddc62b33b870c70f
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 27 Dec 2012 15:23:23 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<CloudEntryPoint xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/CloudEntryPoint">
  <id>http://localhost:3001/cimi/cloudEntryPoint</id>
  <name>mock</name>
  <description>Cloud Entry Point for the Deltacloud mock driver</description>
  <created>2012-12-27T17:23:23+02:00</created>
  <baseURI>http://localhost:3001/cimi/</baseURI>
  <resourceMetadata href="http://localhost:3001/cimi/resource_metadata" />
  <machines href="http://localhost:3001/cimi/machines" />
  <machineTemplates href="http://localhost:3001/cimi/machine_templates" />
  <machineImages href="http://localhost:3001/cimi/machine_images" />
  <credentials href="http://localhost:3001/cimi/credentials" />
  <volumes href="http://localhost:3001/cimi/volumes" />
  <volumeImages href="http://localhost:3001/cimi/volume_images" />
  <networks href="http://localhost:3001/cimi/networks" />
  <networkTemplates href="http://localhost:3001/cimi/network_templates" />
  <networkPorts href="http://localhost:3001/cimi/network_ports" />
  <networkPortTemplates href="http://localhost:3001/cimi/network_port_templates" />
  <addresses href="http://localhost:3001/cimi/addresses" />
  <addressTemplates href="http://localhost:3001/cimi/address_templates" />
  <forwardingGroups href="http://localhost:3001/cimi/forwarding_groups" />
  <forwardingGroupTemplates href="http://localhost:3001/cimi/forwarding_group_templates" />
  <volumeConfigs href="http://localhost:3001/cimi/volume_configurations" />
  <machineConfigs href="http://localhost:3001/cimi/machine_configurations" />
  <networkConfigs href="http://localhost:3001/cimi/network_configurations" />
  <networkPortConfigs href="http://localhost:3001/cimi/network_port_configurations" />
</CloudEntryPoint>
;T;
I"



  

The CIMI Cloud Entry Point


The Cloud Entry Point represents the entry point into the cloud defined by the CIMI Model. The Cloud
Entry Point implements a catalog of resources, such as Systems, System Templates, Machines, Machine
Templates, etc., that can be queried and browsed by the Consumer.


A deltacloud server exposes the CIMI Cloud Entry Point at /cimi/cloudEntryPoint. When dereferencing this URI, the resources listed in the response include only those that are supported by the current deltacloud driver - whether the 'default' driver the server was started with, or that specified with the X-Deltacloud-Driver header.


 

  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  CIMI Resources






Example request:

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



Example response:


HTTP/1.1 200 OK
Content-Type: application/xml
CIMI-Specification-Version: 1.0.1
Content-Length: 1754
ETag: 503bc06f24d1a51eddc62b33b870c70f
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 27 Dec 2012 15:23:23 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<CloudEntryPoint xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/CloudEntryPoint">
  <id>http://localhost:3001/cimi/cloudEntryPoint</id>
  <name>mock</name>
  <description>Cloud Entry Point for the Deltacloud mock driver</description>
  <created>2012-12-27T17:23:23+02:00</created>
  <baseURI>http://localhost:3001/cimi/</baseURI>
  <resourceMetadata href="http://localhost:3001/cimi/resource_metadata" />
  <machines href="http://localhost:3001/cimi/machines" />
  <machineTemplates href="http://localhost:3001/cimi/machine_templates" />
  <machineImages href="http://localhost:3001/cimi/machine_images" />
  <credentials href="http://localhost:3001/cimi/credentials" />
  <volumes href="http://localhost:3001/cimi/volumes" />
  <volumeImages href="http://localhost:3001/cimi/volume_images" />
  <networks href="http://localhost:3001/cimi/networks" />
  <networkTemplates href="http://localhost:3001/cimi/network_templates" />
  <networkPorts href="http://localhost:3001/cimi/network_ports" />
  <networkPortTemplates href="http://localhost:3001/cimi/network_port_templates" />
  <addresses href="http://localhost:3001/cimi/addresses" />
  <addressTemplates href="http://localhost:3001/cimi/address_templates" />
  <forwardingGroups href="http://localhost:3001/cimi/forwarding_groups" />
  <forwardingGroupTemplates href="http://localhost:3001/cimi/forwarding_group_templates" />
  <volumeConfigs href="http://localhost:3001/cimi/volume_configurations" />
  <machineConfigs href="http://localhost:3001/cimi/machine_configurations" />
  <networkConfigs href="http://localhost:3001/cimi/network_configurations" />
  <networkPortConfigs href="http://localhost:3001/cimi/network_port_configurations" />
</CloudEntryPoint>
;T;@�I"/cimi-rest-collections/;T{;{	;I"�?

  
    
    CIMI Resource Collections - Machine
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      REST API
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

CIMI Resources and Collections

 We are continually improving CIMI support in Deltacloud. If you come across any inconsistencies or errors in the Deltacloud CIMI implementation we'll be very glad to hear about them.


In the following sections, the textual definitions following the title of each resource (e.g. "Machine") that are rendered in bold and italic type are taken from the CIMI 1.0.1 specification, available from the DMTF Cloud Management Initiative (DSP0263).



Machine


An instantiated compute resource that encapsulates both CPU and Memory.
A Machine Collection resource represents the collection of Machine resources within a Provider



 

 



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  CIMI Resources
    
Machine
      MachineImage
    






Retrieve the Machine Collection
  Retrieve a single Machine
  Create a new Machine
  Perform a Machine Operation

  

Retrieve the Machine Collection

Note the 'add' URI of the Machine Collection resource in the example response below. This is the URI that is used for creating a new Machine (adding to the Machine Collection).


Example request:

GET /cimi/machines 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: 2293
ETag: 5c6dc8cfbceeb1f3c610765a4aa600dd
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:08:27 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/MachineCollection">
  <id>http://localhost:3001/cimi/machines</id>
  <count>2</count>
  <Machine>
    <id>http://localhost:3001/cimi/machines/inst0</id>
    <name>Mock Instance With Profile Change</name>
    <description>No description set for Machine Mock Instance With Profile Change</description>
    <created>2012-12-28T13:08:27+02:00</created>
    <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
    <property key="credential">http://localhost:3001/cimi/credentials</property>
    <state>STARTED</state>
    <cpu>1</cpu>
    <memory>12582912</memory>
    <disks href="http://localhost:3001/cimi/machines/inst0/disks" />
    <volumes href="http://localhost:3001/cimi/machines/inst0/volumes" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
        href="http://localhost:3001/cimi/machines/inst0/restart" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
        href="http://localhost:3001/cimi/machines/inst0/stop" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
        href="http://localhost:3001/cimi/machine_images" />
  </Machine>
  <Machine>
    <id>http://localhost:3001/cimi/machines/inst1</id>
    <name>MockUserInstance</name>
    <description>No description set for Machine MockUserInstance</description>
    <created>2012-12-28T13:08:27+02:00</created>
    <property key="machine_image">http://localhost:3001/cimi/machine_images/img3</property>
    <property key="credential">http://localhost:3001/cimi/credentials</property>
    <state>STARTED</state>
    <cpu>1</cpu>
    <memory>1782579</memory>
    <disks href="http://localhost:3001/cimi/machines/inst1/disks" />
    <volumes href="http://localhost:3001/cimi/machines/inst1/volumes" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
        href="http://localhost:3001/cimi/machines/inst1/restart" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
        href="http://localhost:3001/cimi/machines/inst1/stop" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
        href="http://localhost:3001/cimi/machine_images" />
  </Machine>
  <operation rel="add" href="http://localhost:3001/cimi/machines" />
</Collection>




  
  

Retrieve a single Machine

Example request:

GET /cimi/machines/inst0 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: 1092
ETag: 2d57aa01f1a50b2d13c04f0c51f08ab9
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:20:28 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Machine xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/Machine">
  <id>http://localhost:3001/cimi/machines/inst0</id>
  <name>Mock Instance With Profile Change</name>
  <description>No description set for Machine Mock Instance With Profile Change</description>
  <created>2012-12-28T13:20:28+02:00</created>
  <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
  <property key="credential">http://localhost:3001/cimi/credentials</property>
  <state>STARTED</state>
  <cpu>1</cpu>
  <memory>12582912</memory>
  <disks href="http://localhost:3001/cimi/machines/inst0/disks" />
  <volumes href="http://localhost:3001/cimi/machines/inst0/volumes" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
          href="http://localhost:3001/cimi/machines/inst0/restart" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
          href="http://localhost:3001/cimi/machines/inst0/stop" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
          href="http://localhost:3001/cimi/machine_images" />
</Machine>




  

  

Create a new Machine


The 'add' URI of the Machine Collection is used to create a new Machine. This is returned when retrieving the Machine Collection resource.


Example request:

POST /cimi/machines 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: 370

<MachineCreate xmlns="http://schemas.dmtf.org/cimi/1">
  <name> myMachine1 </name>
  <description> my machine description </description>
  <machineTemplate>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small">
    </machineConfig>
    <machineImage href="http://localhost:3001/cimi/machine_images/img1">
    </machineImage>
  </machineTemplate>
</MachineCreate>



Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machines/inst3
CIMI-Specification-Version: 1.0.1
Content-Length: 1030
ETag: 360992481f1450f9d475f439e5105f9d
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:47:58 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Machine xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Machine">
  <id>http://localhost:3001/cimi/machines/inst3</id>
  <name> myMachine1 </name>
  <description> my machine description </description>
  <created>2012-12-28T13:47:58+02:00</created>
  <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
  <property key="credential">http://localhost:3001/cimi/credentials</property>
  <state>STARTED</state>
  <cpu>1</cpu>
  <memory>1782579</memory>
  <disks href="http://localhost:3001/cimi/machines/inst3/disks" />
  <volumes href="http://localhost:3001/cimi/machines/inst3/volumes" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
          href="http://localhost:3001/cimi/machines/inst3/restart" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
          href="http://localhost:3001/cimi/machines/inst3/stop" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
          href="http://localhost:3001/cimi/machine_images" />
</Machine>





  


  

Perform a Machine Operation


The list of Machine operations is returned when the URI of a specific Machine resource is dereferenced. Examples of operations are 'stop', 'restart' and 'capture'. An 'Action' resource is used in the POST message body corresponding to the operation to be executed. The example below shows the 'stop' action.


Example request:
POST /cimi/machines/inst3/stop 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: 125

<Action xmlns="http://schemas.dmtf.org/cimi/1">
  <action> http://http://schemas.dmtf.org/cimi/1/action/stop </action>
</Action>


Server response:
HTTP/1.1 202 Accepted
CIMI-Specification-Version: 1.0.1
Content-Length: 0
Date: Fri, 28 Dec 2012 14:01:43 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife



  




      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"i*



  

CIMI Resources and Collections

 We are continually improving CIMI support in Deltacloud. If you come across any inconsistencies or errors in the Deltacloud CIMI implementation we'll be very glad to hear about them.


In the following sections, the textual definitions following the title of each resource (e.g. "Machine") that are rendered in bold and italic type are taken from the CIMI 1.0.1 specification, available from the DMTF Cloud Management Initiative (DSP0263).




Machine


An instantiated compute resource that encapsulates both CPU and Memory.
A Machine Collection resource represents the collection of Machine resources within a Provider



 

 


  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  CIMI Resources
    
      Machine
      MachineImage
    



  




  Retrieve the Machine Collection
  Retrieve a single Machine
  Create a new Machine
  Perform a Machine Operation





  

Retrieve the Machine Collection

Note the 'add' URI of the Machine Collection resource in the example response below. This is the URI that is used for creating a new Machine (adding to the Machine Collection).





Example request:

GET /cimi/machines 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: 2293
ETag: 5c6dc8cfbceeb1f3c610765a4aa600dd
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:08:27 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/MachineCollection">
  <id>http://localhost:3001/cimi/machines</id>
  <count>2</count>
  <Machine>
    <id>http://localhost:3001/cimi/machines/inst0</id>
    <name>Mock Instance With Profile Change</name>
    <description>No description set for Machine Mock Instance With Profile Change</description>
    <created>2012-12-28T13:08:27+02:00</created>
    <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
    <property key="credential">http://localhost:3001/cimi/credentials</property>
    <state>STARTED</state>
    <cpu>1</cpu>
    <memory>12582912</memory>
    <disks href="http://localhost:3001/cimi/machines/inst0/disks" />
    <volumes href="http://localhost:3001/cimi/machines/inst0/volumes" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
        href="http://localhost:3001/cimi/machines/inst0/restart" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
        href="http://localhost:3001/cimi/machines/inst0/stop" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
        href="http://localhost:3001/cimi/machine_images" />
  </Machine>
  <Machine>
    <id>http://localhost:3001/cimi/machines/inst1</id>
    <name>MockUserInstance</name>
    <description>No description set for Machine MockUserInstance</description>
    <created>2012-12-28T13:08:27+02:00</created>
    <property key="machine_image">http://localhost:3001/cimi/machine_images/img3</property>
    <property key="credential">http://localhost:3001/cimi/credentials</property>
    <state>STARTED</state>
    <cpu>1</cpu>
    <memory>1782579</memory>
    <disks href="http://localhost:3001/cimi/machines/inst1/disks" />
    <volumes href="http://localhost:3001/cimi/machines/inst1/volumes" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
        href="http://localhost:3001/cimi/machines/inst1/restart" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
        href="http://localhost:3001/cimi/machines/inst1/stop" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
        href="http://localhost:3001/cimi/machine_images" />
  </Machine>
  <operation rel="add" href="http://localhost:3001/cimi/machines" />
</Collection>




  
  

Retrieve a single Machine

Example request:

GET /cimi/machines/inst0 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: 1092
ETag: 2d57aa01f1a50b2d13c04f0c51f08ab9
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:20:28 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Machine xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/Machine">
  <id>http://localhost:3001/cimi/machines/inst0</id>
  <name>Mock Instance With Profile Change</name>
  <description>No description set for Machine Mock Instance With Profile Change</description>
  <created>2012-12-28T13:20:28+02:00</created>
  <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
  <property key="credential">http://localhost:3001/cimi/credentials</property>
  <state>STARTED</state>
  <cpu>1</cpu>
  <memory>12582912</memory>
  <disks href="http://localhost:3001/cimi/machines/inst0/disks" />
  <volumes href="http://localhost:3001/cimi/machines/inst0/volumes" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
          href="http://localhost:3001/cimi/machines/inst0/restart" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
          href="http://localhost:3001/cimi/machines/inst0/stop" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
          href="http://localhost:3001/cimi/machine_images" />
</Machine>




  

  

Create a new Machine


The 'add' URI of the Machine Collection is used to create a new Machine. This is returned when retrieving the Machine Collection resource.


Example request:

POST /cimi/machines 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: 370

<MachineCreate xmlns="http://schemas.dmtf.org/cimi/1">
  <name> myMachine1 </name>
  <description> my machine description </description>
  <machineTemplate>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small">
    </machineConfig>
    <machineImage href="http://localhost:3001/cimi/machine_images/img1">
    </machineImage>
  </machineTemplate>
</MachineCreate>



Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machines/inst3
CIMI-Specification-Version: 1.0.1
Content-Length: 1030
ETag: 360992481f1450f9d475f439e5105f9d
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:47:58 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Machine xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Machine">
  <id>http://localhost:3001/cimi/machines/inst3</id>
  <name> myMachine1 </name>
  <description> my machine description </description>
  <created>2012-12-28T13:47:58+02:00</created>
  <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
  <property key="credential">http://localhost:3001/cimi/credentials</property>
  <state>STARTED</state>
  <cpu>1</cpu>
  <memory>1782579</memory>
  <disks href="http://localhost:3001/cimi/machines/inst3/disks" />
  <volumes href="http://localhost:3001/cimi/machines/inst3/volumes" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
          href="http://localhost:3001/cimi/machines/inst3/restart" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
          href="http://localhost:3001/cimi/machines/inst3/stop" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
          href="http://localhost:3001/cimi/machine_images" />
</Machine>





  


  

Perform a Machine Operation


The list of Machine operations is returned when the URI of a specific Machine resource is dereferenced. Examples of operations are 'stop', 'restart' and 'capture'. An 'Action' resource is used in the POST message body corresponding to the operation to be executed. The example below shows the 'stop' action.


Example request:
POST /cimi/machines/inst3/stop 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: 125

<Action xmlns="http://schemas.dmtf.org/cimi/1">
  <action> http://http://schemas.dmtf.org/cimi/1/action/stop </action>
</Action>


Server response:
HTTP/1.1 202 Accepted
CIMI-Specification-Version: 1.0.1
Content-Length: 0
Date: Fri, 28 Dec 2012 14:01:43 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife



  


;T;
I"P*



  

CIMI Resources and Collections

 We are continually improving CIMI support in Deltacloud. If you come across any inconsistencies or errors in the Deltacloud CIMI implementation we'll be very glad to hear about them.


In the following sections, the textual definitions following the title of each resource (e.g. "Machine") that are rendered in bold and italic type are taken from the CIMI 1.0.1 specification, available from the DMTF Cloud Management Initiative (DSP0263).



Machine


An instantiated compute resource that encapsulates both CPU and Memory.
A Machine Collection resource represents the collection of Machine resources within a Provider



 

 



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  CIMI Resources
    
Machine
      MachineImage
    






Retrieve the Machine Collection
  Retrieve a single Machine
  Create a new Machine
  Perform a Machine Operation

  

Retrieve the Machine Collection

Note the 'add' URI of the Machine Collection resource in the example response below. This is the URI that is used for creating a new Machine (adding to the Machine Collection).


Example request:

GET /cimi/machines 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: 2293
ETag: 5c6dc8cfbceeb1f3c610765a4aa600dd
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:08:27 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/MachineCollection">
  <id>http://localhost:3001/cimi/machines</id>
  <count>2</count>
  <Machine>
    <id>http://localhost:3001/cimi/machines/inst0</id>
    <name>Mock Instance With Profile Change</name>
    <description>No description set for Machine Mock Instance With Profile Change</description>
    <created>2012-12-28T13:08:27+02:00</created>
    <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
    <property key="credential">http://localhost:3001/cimi/credentials</property>
    <state>STARTED</state>
    <cpu>1</cpu>
    <memory>12582912</memory>
    <disks href="http://localhost:3001/cimi/machines/inst0/disks" />
    <volumes href="http://localhost:3001/cimi/machines/inst0/volumes" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
        href="http://localhost:3001/cimi/machines/inst0/restart" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
        href="http://localhost:3001/cimi/machines/inst0/stop" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
        href="http://localhost:3001/cimi/machine_images" />
  </Machine>
  <Machine>
    <id>http://localhost:3001/cimi/machines/inst1</id>
    <name>MockUserInstance</name>
    <description>No description set for Machine MockUserInstance</description>
    <created>2012-12-28T13:08:27+02:00</created>
    <property key="machine_image">http://localhost:3001/cimi/machine_images/img3</property>
    <property key="credential">http://localhost:3001/cimi/credentials</property>
    <state>STARTED</state>
    <cpu>1</cpu>
    <memory>1782579</memory>
    <disks href="http://localhost:3001/cimi/machines/inst1/disks" />
    <volumes href="http://localhost:3001/cimi/machines/inst1/volumes" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
        href="http://localhost:3001/cimi/machines/inst1/restart" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
        href="http://localhost:3001/cimi/machines/inst1/stop" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
        href="http://localhost:3001/cimi/machine_images" />
  </Machine>
  <operation rel="add" href="http://localhost:3001/cimi/machines" />
</Collection>




  
  

Retrieve a single Machine

Example request:

GET /cimi/machines/inst0 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: 1092
ETag: 2d57aa01f1a50b2d13c04f0c51f08ab9
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:20:28 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Machine xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/Machine">
  <id>http://localhost:3001/cimi/machines/inst0</id>
  <name>Mock Instance With Profile Change</name>
  <description>No description set for Machine Mock Instance With Profile Change</description>
  <created>2012-12-28T13:20:28+02:00</created>
  <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
  <property key="credential">http://localhost:3001/cimi/credentials</property>
  <state>STARTED</state>
  <cpu>1</cpu>
  <memory>12582912</memory>
  <disks href="http://localhost:3001/cimi/machines/inst0/disks" />
  <volumes href="http://localhost:3001/cimi/machines/inst0/volumes" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
          href="http://localhost:3001/cimi/machines/inst0/restart" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
          href="http://localhost:3001/cimi/machines/inst0/stop" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
          href="http://localhost:3001/cimi/machine_images" />
</Machine>




  

  

Create a new Machine


The 'add' URI of the Machine Collection is used to create a new Machine. This is returned when retrieving the Machine Collection resource.


Example request:

POST /cimi/machines 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: 370

<MachineCreate xmlns="http://schemas.dmtf.org/cimi/1">
  <name> myMachine1 </name>
  <description> my machine description </description>
  <machineTemplate>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small">
    </machineConfig>
    <machineImage href="http://localhost:3001/cimi/machine_images/img1">
    </machineImage>
  </machineTemplate>
</MachineCreate>



Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machines/inst3
CIMI-Specification-Version: 1.0.1
Content-Length: 1030
ETag: 360992481f1450f9d475f439e5105f9d
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:47:58 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Machine xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Machine">
  <id>http://localhost:3001/cimi/machines/inst3</id>
  <name> myMachine1 </name>
  <description> my machine description </description>
  <created>2012-12-28T13:47:58+02:00</created>
  <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
  <property key="credential">http://localhost:3001/cimi/credentials</property>
  <state>STARTED</state>
  <cpu>1</cpu>
  <memory>1782579</memory>
  <disks href="http://localhost:3001/cimi/machines/inst3/disks" />
  <volumes href="http://localhost:3001/cimi/machines/inst3/volumes" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
          href="http://localhost:3001/cimi/machines/inst3/restart" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
          href="http://localhost:3001/cimi/machines/inst3/stop" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
          href="http://localhost:3001/cimi/machine_images" />
</Machine>





  


  

Perform a Machine Operation


The list of Machine operations is returned when the URI of a specific Machine resource is dereferenced. Examples of operations are 'stop', 'restart' and 'capture'. An 'Action' resource is used in the POST message body corresponding to the operation to be executed. The example below shows the 'stop' action.


Example request:
POST /cimi/machines/inst3/stop 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: 125

<Action xmlns="http://schemas.dmtf.org/cimi/1">
  <action> http://http://schemas.dmtf.org/cimi/1/action/stop </action>
</Action>


Server response:
HTTP/1.1 202 Accepted
CIMI-Specification-Version: 1.0.1
Content-Length: 0
Date: Fri, 28 Dec 2012 14:01:43 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife



  


;T;@I"/cimi-rest-machine-images/;T{;{	;I"L4

  
    
    CIMI Resource Collections - Machine Image
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      REST API
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

Machine Image


This resource represents the information necessary for hardware virtualized resources to create a Machine Instance; it contains configuration data such as startup instructions, including possible combinations of the following items, depending on the 'type' of Machine Image created: the software image, installation software, both a disk image and a set of software and parameters. 


A Machine Image Collection resource represents the collection of Machine Image resources within a Provider.



  
  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  CIMI Resources
    
Machine
      MachineImage
    






Retrieve the Machine Image Collection
  Retrieve a single Machine Image
  Create or Delete a Machine Image

  

Retrieve the Machine Image Collection


Note the 'add' URI of the Machine Image Collection resource in the example response below. This is the URI that is used for creating a new Machine Image (adding to the Machine Image Collection). This URI is also returned when dereferencing a Machine resource, as the href attribute of the 'capture' operation (when this is possible for the given Machine on the particular Cloud Provider).


Example request:
GET /cimi/machine_images 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: 1195
ETag: e2f73ed48eb2abeae77322eea56dfc5d
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 14:23:35 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/MachineImageCollection">
  <id>http://localhost:3001/cimi/machine_images</id>
  <count>3</count>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img1</id>
    <name>img1</name>
    <description>Fedora 10</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img1</imageLocation>
  </MachineImage>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img2</id>
    <name>img2</name>
    <description>Fedora 10</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img2</imageLocation>
  </MachineImage>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img3</id>
    <name>img3</name>
    <description>JBoss</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img3</imageLocation>
  </MachineImage>
  <operation rel="add" href="http://localhost:3001/cimi/machine_images" />
</Collection>


  
  

Retrieve a single Machine Image

Example request:

GET /cimi/machine_images/img1 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: 385
ETag: 130f8e9592138afc544d65d73039e540
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 14:55:42 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineImage xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineImage">
  <id>http://localhost:3001/cimi/machine_images/img1</id>
  <name>img1</name>
  <description>Fedora 10</description>
  <created>2012-12-28T16:55:42+02:00</created>
  <state>AVAILABLE</state>
  <type>IMAGE</type>
  <imageLocation>mock://img1</imageLocation>
</MachineImage>


  

  


Create a new Machine Image


The example below shows the creation of a new Machine Image resource from an existing Machine resource. When supported by the Machine and the given Cloud Provider, the href attribute of the serialized Machine resource's 'capture' operation provides the URI to which the request body should be sent with HTTP POST in order to create the new Machine Image. The message body is the representation of the to be created Machine Image resource, with the 'imageLocation' attribute referring to the Machine resource from which the Machine Image is to be created, as shown in the example below:


Example request:

POST /cimi/machine_images 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: 188
<MachineImage>
  <name>some_name</name>
  <description>my new machine_image</description>
  <type>IMAGE</type>
  <imageLocation>http://localhost:3001/cimi/machines/inst1</imageLocation>
</MachineImage>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machine_images/some_name
CIMI-Specification-Version: 1.0.1
Content-Length: 411
ETag: c929191a65da6564f9f69301d38eb6fc
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 15:10:12 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineImage xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineImage">
  <id>http://localhost:3001/cimi/machine_images/some_name</id>
  <name>some_name</name>
  <description>my new machine image</description>
  <created>2012-12-28T17:10:12+02:00</created>
  <state>AVAILABLE</state>
  <type>IMAGE</type>
  <imageLocation>mock://some_name</imageLocation>
</MachineImage>




Delete a Machine Image

Example request:

DELETE /cimi/machine_images/some_name 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, 28 Dec 2012 15:21:14 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife


  


      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I""



  

Machine Image


This resource represents the information necessary for hardware virtualized resources to create a Machine Instance; it contains configuration data such as startup instructions, including possible combinations of the following items, depending on the 'type' of Machine Image created: the software image, installation software, both a disk image and a set of software and parameters. 
 

A Machine Image Collection resource represents the collection of Machine Image resources within a Provider.



  
  


  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  CIMI Resources
    
      Machine
      MachineImage
    



  




  Retrieve the Machine Image Collection
  Retrieve a single Machine Image
  Create or Delete a Machine Image





  

Retrieve the Machine Image Collection


Note the 'add' URI of the Machine Image Collection resource in the example response below. This is the URI that is used for creating a new Machine Image (adding to the Machine Image Collection). This URI is also returned when dereferencing a Machine resource, as the href attribute of the 'capture' operation (when this is possible for the given Machine on the particular Cloud Provider).


Example request:
GET /cimi/machine_images 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: 1195
ETag: e2f73ed48eb2abeae77322eea56dfc5d
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 14:23:35 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/MachineImageCollection">
  <id>http://localhost:3001/cimi/machine_images</id>
  <count>3</count>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img1</id>
    <name>img1</name>
    <description>Fedora 10</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img1</imageLocation>
  </MachineImage>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img2</id>
    <name>img2</name>
    <description>Fedora 10</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img2</imageLocation>
  </MachineImage>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img3</id>
    <name>img3</name>
    <description>JBoss</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img3</imageLocation>
  </MachineImage>
  <operation rel="add" href="http://localhost:3001/cimi/machine_images" />
</Collection>


  
  

Retrieve a single Machine Image

Example request:

GET /cimi/machine_images/img1 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: 385
ETag: 130f8e9592138afc544d65d73039e540
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 14:55:42 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineImage xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineImage">
  <id>http://localhost:3001/cimi/machine_images/img1</id>
  <name>img1</name>
  <description>Fedora 10</description>
  <created>2012-12-28T16:55:42+02:00</created>
  <state>AVAILABLE</state>
  <type>IMAGE</type>
  <imageLocation>mock://img1</imageLocation>
</MachineImage>


  

  


Create a new Machine Image


The example below shows the creation of a new Machine Image resource from an existing Machine resource. When supported by the Machine and the given Cloud Provider, the href attribute of the serialized Machine resource's 'capture' operation provides the URI to which the request body should be sent with HTTP POST in order to create the new Machine Image. The message body is the representation of the to be created Machine Image resource, with the 'imageLocation' attribute referring to the Machine resource from which the Machine Image is to be created, as shown in the example below:


Example request:

POST /cimi/machine_images 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: 188
<MachineImage>
  <name>some_name</name>
  <description>my new machine_image</description>
  <type>IMAGE</type>
  <imageLocation>http://localhost:3001/cimi/machines/inst1</imageLocation>
</MachineImage>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machine_images/some_name
CIMI-Specification-Version: 1.0.1
Content-Length: 411
ETag: c929191a65da6564f9f69301d38eb6fc
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 15:10:12 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineImage xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineImage">
  <id>http://localhost:3001/cimi/machine_images/some_name</id>
  <name>some_name</name>
  <description>my new machine image</description>
  <created>2012-12-28T17:10:12+02:00</created>
  <state>AVAILABLE</state>
  <type>IMAGE</type>
  <imageLocation>mock://some_name</imageLocation>
</MachineImage>






Delete a Machine Image

Example request:

DELETE /cimi/machine_images/some_name 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, 28 Dec 2012 15:21:14 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife


  
;T;
I"




  

Machine Image


This resource represents the information necessary for hardware virtualized resources to create a Machine Instance; it contains configuration data such as startup instructions, including possible combinations of the following items, depending on the 'type' of Machine Image created: the software image, installation software, both a disk image and a set of software and parameters. 


A Machine Image Collection resource represents the collection of Machine Image resources within a Provider.



  
  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  CIMI Resources
    
Machine
      MachineImage
    






Retrieve the Machine Image Collection
  Retrieve a single Machine Image
  Create or Delete a Machine Image

  

Retrieve the Machine Image Collection


Note the 'add' URI of the Machine Image Collection resource in the example response below. This is the URI that is used for creating a new Machine Image (adding to the Machine Image Collection). This URI is also returned when dereferencing a Machine resource, as the href attribute of the 'capture' operation (when this is possible for the given Machine on the particular Cloud Provider).


Example request:
GET /cimi/machine_images 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: 1195
ETag: e2f73ed48eb2abeae77322eea56dfc5d
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 14:23:35 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/MachineImageCollection">
  <id>http://localhost:3001/cimi/machine_images</id>
  <count>3</count>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img1</id>
    <name>img1</name>
    <description>Fedora 10</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img1</imageLocation>
  </MachineImage>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img2</id>
    <name>img2</name>
    <description>Fedora 10</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img2</imageLocation>
  </MachineImage>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img3</id>
    <name>img3</name>
    <description>JBoss</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img3</imageLocation>
  </MachineImage>
  <operation rel="add" href="http://localhost:3001/cimi/machine_images" />
</Collection>


  
  

Retrieve a single Machine Image

Example request:

GET /cimi/machine_images/img1 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: 385
ETag: 130f8e9592138afc544d65d73039e540
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 14:55:42 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineImage xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineImage">
  <id>http://localhost:3001/cimi/machine_images/img1</id>
  <name>img1</name>
  <description>Fedora 10</description>
  <created>2012-12-28T16:55:42+02:00</created>
  <state>AVAILABLE</state>
  <type>IMAGE</type>
  <imageLocation>mock://img1</imageLocation>
</MachineImage>


  

  


Create a new Machine Image


The example below shows the creation of a new Machine Image resource from an existing Machine resource. When supported by the Machine and the given Cloud Provider, the href attribute of the serialized Machine resource's 'capture' operation provides the URI to which the request body should be sent with HTTP POST in order to create the new Machine Image. The message body is the representation of the to be created Machine Image resource, with the 'imageLocation' attribute referring to the Machine resource from which the Machine Image is to be created, as shown in the example below:


Example request:

POST /cimi/machine_images 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: 188
<MachineImage>
  <name>some_name</name>
  <description>my new machine_image</description>
  <type>IMAGE</type>
  <imageLocation>http://localhost:3001/cimi/machines/inst1</imageLocation>
</MachineImage>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machine_images/some_name
CIMI-Specification-Version: 1.0.1
Content-Length: 411
ETag: c929191a65da6564f9f69301d38eb6fc
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 15:10:12 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineImage xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineImage">
  <id>http://localhost:3001/cimi/machine_images/some_name</id>
  <name>some_name</name>
  <description>my new machine image</description>
  <created>2012-12-28T17:10:12+02:00</created>
  <state>AVAILABLE</state>
  <type>IMAGE</type>
  <imageLocation>mock://some_name</imageLocation>
</MachineImage>




Delete a Machine Image

Example request:

DELETE /cimi/machine_images/some_name 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, 28 Dec 2012 15:21:14 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife


  
;T;@I"/cimi-curl/;T{;{	;I"�

  
    
    CIMI cURL Examples
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      




  

    Working with cURL against the Deltacloud CIMI frontend

     The cURL documentation is pretty comprehensive, but the following are some general points to remember for using cURL against the Deltacloud CIMI frontend. All the examples on this page assume the Deltacloud server is running at localhost:3001: 

  

      Credentials are specified with  --user "name:password"  
    
    
      Request headers are specified with  -H "header: value" .
    
    
      HTTP verbs are specified with -X VERB
    
    
      The  -i  flag will show you the response headers and the  -v  flag will show you request and response headers as well as info about cURL activity:
    
  
curl -v -X DELETE --user "username:password" -H "Accept: application/xml" http://localhost:3001/cimi/machine_images/my_image
      


Select a CIMI resource from the right-hand navigation bar to see cURL examples for that resource.


 

  



      curl for CIMI Resources
  
  
Machine
    Volume
    ResourceMetadata
  







      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"f




  

    Working with cURL against the Deltacloud CIMI frontend

     The cURL documentation is pretty comprehensive, but the following are some general points to remember for using cURL against the Deltacloud CIMI frontend. All the examples on this page assume the Deltacloud server is running at localhost:3001: 

  
    
      Credentials are specified with  --user "name:password"  
    
    
      Request headers are specified with  -H "header: value" .
    
    
      HTTP verbs are specified with -X VERB
    
    
      The  -i  flag will show you the response headers and the  -v  flag will show you request and response headers as well as info about cURL activity:
    
  

      curl -v -X DELETE --user "username:password" -H "Accept: application/xml" http://localhost:3001/cimi/machine_images/my_image
      


Select a CIMI resource from the right-hand navigation bar to see cURL examples for that resource.


 

  


  
      curl for CIMI Resources
  
  
    Machine
    Volume
    ResourceMetadata
  
  



  

;T;
I"Q




  

    Working with cURL against the Deltacloud CIMI frontend

     The cURL documentation is pretty comprehensive, but the following are some general points to remember for using cURL against the Deltacloud CIMI frontend. All the examples on this page assume the Deltacloud server is running at localhost:3001: 

  

      Credentials are specified with  --user "name:password"  
    
    
      Request headers are specified with  -H "header: value" .
    
    
      HTTP verbs are specified with -X VERB
    
    
      The  -i  flag will show you the response headers and the  -v  flag will show you request and response headers as well as info about cURL activity:
    
  
curl -v -X DELETE --user "username:password" -H "Accept: application/xml" http://localhost:3001/cimi/machine_images/my_image
      


Select a CIMI resource from the right-hand navigation bar to see cURL examples for that resource.


 

  



      curl for CIMI Resources
  
  
Machine
    Volume
    ResourceMetadata
  





;T;@I" /cimi-rest-machine-configs/;T{;{	;I"j+

  
    
    CIMI Resource Collections - Machine Configuration
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      REST API
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

Machine Configuration


The Machine Configuration resource represents the set of configuration values that define the (virtual)
hardware resources of a to-be-realized Machine Instance. Machine Configurations are created by
Providers and may, at the Providers discretion, be created by Consumers.

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



  
  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
Machine
      Volume
    

  

    Machine Resources
  
  
Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  






Retrieve the Machine Configuration Collection
  Retrieve a single Machine Configuration

  

Retrieve the Machine Configuration Collection

Example request:
GET /cimi/machine_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: 1504
ETag: 69348a8afa58a1c35b6cfad7c4066a9e
Cache-Control: max-age=0, private, must-revalidate
Date: Wed, 02 Jan 2013 14:12:23 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/MachineConfigurationCollection">
  <id>http://localhost:3001/cimi/machine_configurations</id>
  <count>3</count>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-small</id>
    <name>m1-small</name>
    <description>Machine Configuration with 1782579 KiB of memory and 1 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>1</cpu>
    <memory>1782579</memory>
    <disk>
      <capacity>167772160</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-large</id>
    <name>m1-large</name>
    <description>Machine Configuration with 10485760 KiB of memory and 1 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>1</cpu>
    <memory>10485760</memory>
    <disk>
      <capacity>891289600</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-xlarge</id>
    <name>m1-xlarge</name>
    <description>Machine Configuration with 12582912 KiB of memory and 4 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>4</cpu>
    <memory>12582912</memory>
    <disk>
      <capacity>1073741824</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
</Collection>

  


  

Retrieve a single Machine Configuration

Example request:
GET /cimi/machine_configurations/m1-large 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: 508
ETag: 33c094bbcec51437860280fd053f1023
Cache-Control: max-age=0, private, must-revalidate
Date: Wed, 02 Jan 2013 14:20:52 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineConfiguration xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineConfiguration">
  <id>http://localhost:3001/cimi/machine_configurations/m1-large</id>
  <name>m1-large</name>
  <description>Machine Configuration with 10485760 KiB of memory and 1 CPU</description>
  <created>2013-01-02T16:20:52+02:00</created>
  <cpu>1</cpu>
  <memory>10485760</memory>
  <disk>
    <capacity>891289600</capacity>
    <format>unknown</format>
  </disk>
</MachineConfiguration>



  


      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"=



  

Machine Configuration


The Machine Configuration resource represents the set of configuration values that define the (virtual)
hardware resources of a to-be-realized Machine Instance. Machine Configurations are created by
Providers and may, at the Providers discretion, be created by Consumers.

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



  
  


  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
      Machine
      Volume
    
  
  
  
    Machine Resources
  
  
    Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  



  




  Retrieve the Machine Configuration Collection
  Retrieve a single Machine Configuration





  

Retrieve the Machine Configuration Collection

Example request:
GET /cimi/machine_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: 1504
ETag: 69348a8afa58a1c35b6cfad7c4066a9e
Cache-Control: max-age=0, private, must-revalidate
Date: Wed, 02 Jan 2013 14:12:23 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/MachineConfigurationCollection">
  <id>http://localhost:3001/cimi/machine_configurations</id>
  <count>3</count>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-small</id>
    <name>m1-small</name>
    <description>Machine Configuration with 1782579 KiB of memory and 1 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>1</cpu>
    <memory>1782579</memory>
    <disk>
      <capacity>167772160</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-large</id>
    <name>m1-large</name>
    <description>Machine Configuration with 10485760 KiB of memory and 1 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>1</cpu>
    <memory>10485760</memory>
    <disk>
      <capacity>891289600</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-xlarge</id>
    <name>m1-xlarge</name>
    <description>Machine Configuration with 12582912 KiB of memory and 4 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>4</cpu>
    <memory>12582912</memory>
    <disk>
      <capacity>1073741824</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
</Collection>

  


  

Retrieve a single Machine Configuration

Example request:
GET /cimi/machine_configurations/m1-large 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: 508
ETag: 33c094bbcec51437860280fd053f1023
Cache-Control: max-age=0, private, must-revalidate
Date: Wed, 02 Jan 2013 14:20:52 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineConfiguration xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineConfiguration">
  <id>http://localhost:3001/cimi/machine_configurations/m1-large</id>
  <name>m1-large</name>
  <description>Machine Configuration with 10485760 KiB of memory and 1 CPU</description>
  <created>2013-01-02T16:20:52+02:00</created>
  <cpu>1</cpu>
  <memory>10485760</memory>
  <disk>
    <capacity>891289600</capacity>
    <format>unknown</format>
  </disk>
</MachineConfiguration>



  
;T;
I" 



  

Machine Configuration


The Machine Configuration resource represents the set of configuration values that define the (virtual)
hardware resources of a to-be-realized Machine Instance. Machine Configurations are created by
Providers and may, at the Providers discretion, be created by Consumers.

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



  
  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
Machine
      Volume
    

  

    Machine Resources
  
  
Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  






Retrieve the Machine Configuration Collection
  Retrieve a single Machine Configuration

  

Retrieve the Machine Configuration Collection

Example request:
GET /cimi/machine_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: 1504
ETag: 69348a8afa58a1c35b6cfad7c4066a9e
Cache-Control: max-age=0, private, must-revalidate
Date: Wed, 02 Jan 2013 14:12:23 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/MachineConfigurationCollection">
  <id>http://localhost:3001/cimi/machine_configurations</id>
  <count>3</count>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-small</id>
    <name>m1-small</name>
    <description>Machine Configuration with 1782579 KiB of memory and 1 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>1</cpu>
    <memory>1782579</memory>
    <disk>
      <capacity>167772160</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-large</id>
    <name>m1-large</name>
    <description>Machine Configuration with 10485760 KiB of memory and 1 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>1</cpu>
    <memory>10485760</memory>
    <disk>
      <capacity>891289600</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-xlarge</id>
    <name>m1-xlarge</name>
    <description>Machine Configuration with 12582912 KiB of memory and 4 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>4</cpu>
    <memory>12582912</memory>
    <disk>
      <capacity>1073741824</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
</Collection>

  


  

Retrieve a single Machine Configuration

Example request:
GET /cimi/machine_configurations/m1-large 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: 508
ETag: 33c094bbcec51437860280fd053f1023
Cache-Control: max-age=0, private, must-revalidate
Date: Wed, 02 Jan 2013 14:20:52 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineConfiguration xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineConfiguration">
  <id>http://localhost:3001/cimi/machine_configurations/m1-large</id>
  <name>m1-large</name>
  <description>Machine Configuration with 10485760 KiB of memory and 1 CPU</description>
  <created>2013-01-02T16:20:52+02:00</created>
  <cpu>1</cpu>
  <memory>10485760</memory>
  <disk>
    <capacity>891289600</capacity>
    <format>unknown</format>
  </disk>
</MachineConfiguration>



  
;T;@I""/cimi-rest-machine-templates/;T{;{	;I"Z6

  
    
    CIMI Resource Collections - Machine Template
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      REST API
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

Machine Template


A Machine Template represents the set of metadata and instructions used in the creation of a Machine.

A Machine Template Collection resource represents the collection of Machine Template resources within
a Provider.




The CIMI specification follows a distinctive pattern with respect to creation of new resources - the machine template is a good example of this:


machineConfiguration + machineImage = machineTemplate ===> machine



A CIMI client (a consumer in CIMI terminology) uses a Machine Template to  create a new Machine; a Machine Template consists of (amongst other attributes) a Machine Configuration and a Machine Image. Generally speaking - many CIMI resources require use of a template for their creation and a template will typically consist of an image plus a configuration resource.


  
  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
Machine
      Volume
    

  

    Machine Resources
  
  
Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  






Retrieve the Machine Template Collection
  Retrieve a single Machine Template
  Create a new Machine Template
  Delete a Machine Template

  

Retrieve the Machine Template Collection
Example request:
GET /cimi/machine_templates 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: 1275
ETag: fba471ae32eca2b58fa02644b81b73aa
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 15:04:26 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/MachineTemplateCollection">
  <id>http://localhost:3001/cimi/machine_templates</id>
  <count>2</count>
  <MachineTemplate>
    <id>http://localhost:3001/cimi/machine_templates/1</id>
    <name>myXmlTestMachineTemplate1</name>
    <description>Description of my MachineTemplate</description>
    <property key="test">value</property>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge" />
    <machineImage href="http://localhost:3001/cimi/machine_images/img3" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/1" />
  </MachineTemplate>
  <MachineTemplate>
    <id>http://localhost:3001/cimi/machine_templates/2</id>
    <name>my_template_2</name>
    <description>Description of my MachineTemplate</description>
    <property key="test">value</property>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small" />
    <machineImage href="http://localhost:3001/cimi/machine_images/img1" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/2" />
  </MachineTemplate>
</Collection>

  

  

Retrieve a single Machine Template
Example request:
GET /cimi/machine_templates/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: 607
ETag: 8f720ffacb6439a6920a5f5b0ec7bbfc
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 15:06:14 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineTemplate xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineTemplate">
  <id>http://localhost:3001/cimi/machine_templates/2</id>
  <name>my_template_2</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small" />
  <machineImage href="http://localhost:3001/cimi/machine_images/img1" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/2" />
</MachineTemplate>

  

  

Create a new Machine Template
Example request:
POST /cimi/machine_templates 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: 334

<MachineTemplateCreate>
  <name>myXmlTestMachineTemplate1</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge"/>
  <machineImage href="http://localhost:3001/cimi/machine_images/img3"/>
</MachineTemplateCreate>


Server response:
HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machine_templates/1
CIMI-Specification-Version: 1.0.1
Content-Length: 620
ETag: e848e33fa0886e6c3d2df3cb674485d7
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 14:48:03 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineTemplate xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/MachineTemplate">
  <id>http://localhost:3001/cimi/machine_templates/1</id>
  <name>myXmlTestMachineTemplate1</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge" />
  <machineImage href="http://localhost:3001/cimi/machine_images/img3" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete" href="http://localhost:3001/cimi/machine_templates/1" />
</MachineTemplate>


  

  

Delete a Machine Template
Example request:
DELETE /cimi/machine_templates/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
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: Thu, 03 Jan 2013 15:06:38 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

  


      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"0!



  

Machine Template


A Machine Template represents the set of metadata and instructions used in the creation of a Machine.

A Machine Template Collection resource represents the collection of Machine Template resources within
a Provider.




The CIMI specification follows a distinctive pattern with respect to creation of new resources - the machine template is a good example of this:


machineConfiguration + machineImage = machineTemplate ===> machine



A CIMI client (a consumer in CIMI terminology) uses a Machine Template to  create a new Machine; a Machine Template consists of (amongst other attributes) a Machine Configuration and a Machine Image. Generally speaking - many CIMI resources require use of a template for their creation and a template will typically consist of an image plus a configuration resource.


  
  


  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
      Machine
      Volume
    
  
  
  
    Machine Resources
  
  
    Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  



  




  Retrieve the Machine Template Collection
  Retrieve a single Machine Template
  Create a new Machine Template
  Delete a Machine Template





  

Retrieve the Machine Template Collection
Example request:
GET /cimi/machine_templates 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: 1275
ETag: fba471ae32eca2b58fa02644b81b73aa
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 15:04:26 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/MachineTemplateCollection">
  <id>http://localhost:3001/cimi/machine_templates</id>
  <count>2</count>
  <MachineTemplate>
    <id>http://localhost:3001/cimi/machine_templates/1</id>
    <name>myXmlTestMachineTemplate1</name>
    <description>Description of my MachineTemplate</description>
    <property key="test">value</property>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge" />
    <machineImage href="http://localhost:3001/cimi/machine_images/img3" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/1" />
  </MachineTemplate>
  <MachineTemplate>
    <id>http://localhost:3001/cimi/machine_templates/2</id>
    <name>my_template_2</name>
    <description>Description of my MachineTemplate</description>
    <property key="test">value</property>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small" />
    <machineImage href="http://localhost:3001/cimi/machine_images/img1" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/2" />
  </MachineTemplate>
</Collection>

  

  

Retrieve a single Machine Template
Example request:
GET /cimi/machine_templates/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: 607
ETag: 8f720ffacb6439a6920a5f5b0ec7bbfc
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 15:06:14 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineTemplate xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineTemplate">
  <id>http://localhost:3001/cimi/machine_templates/2</id>
  <name>my_template_2</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small" />
  <machineImage href="http://localhost:3001/cimi/machine_images/img1" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/2" />
</MachineTemplate>

  

  

Create a new Machine Template
Example request:
POST /cimi/machine_templates 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: 334

<MachineTemplateCreate>
  <name>myXmlTestMachineTemplate1</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge"/>
  <machineImage href="http://localhost:3001/cimi/machine_images/img3"/>
</MachineTemplateCreate>


Server response:
HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machine_templates/1
CIMI-Specification-Version: 1.0.1
Content-Length: 620
ETag: e848e33fa0886e6c3d2df3cb674485d7
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 14:48:03 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineTemplate xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/MachineTemplate">
  <id>http://localhost:3001/cimi/machine_templates/1</id>
  <name>myXmlTestMachineTemplate1</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge" />
  <machineImage href="http://localhost:3001/cimi/machine_images/img3" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete" href="http://localhost:3001/cimi/machine_templates/1" />
</MachineTemplate>


  

  

Delete a Machine Template
Example request:
DELETE /cimi/machine_templates/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
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: Thu, 03 Jan 2013 15:06:38 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

  
;T;
I"!



  

Machine Template


A Machine Template represents the set of metadata and instructions used in the creation of a Machine.

A Machine Template Collection resource represents the collection of Machine Template resources within
a Provider.




The CIMI specification follows a distinctive pattern with respect to creation of new resources - the machine template is a good example of this:


machineConfiguration + machineImage = machineTemplate ===> machine



A CIMI client (a consumer in CIMI terminology) uses a Machine Template to  create a new Machine; a Machine Template consists of (amongst other attributes) a Machine Configuration and a Machine Image. Generally speaking - many CIMI resources require use of a template for their creation and a template will typically consist of an image plus a configuration resource.


  
  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
Machine
      Volume
    

  

    Machine Resources
  
  
Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  






Retrieve the Machine Template Collection
  Retrieve a single Machine Template
  Create a new Machine Template
  Delete a Machine Template

  

Retrieve the Machine Template Collection
Example request:
GET /cimi/machine_templates 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: 1275
ETag: fba471ae32eca2b58fa02644b81b73aa
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 15:04:26 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/MachineTemplateCollection">
  <id>http://localhost:3001/cimi/machine_templates</id>
  <count>2</count>
  <MachineTemplate>
    <id>http://localhost:3001/cimi/machine_templates/1</id>
    <name>myXmlTestMachineTemplate1</name>
    <description>Description of my MachineTemplate</description>
    <property key="test">value</property>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge" />
    <machineImage href="http://localhost:3001/cimi/machine_images/img3" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/1" />
  </MachineTemplate>
  <MachineTemplate>
    <id>http://localhost:3001/cimi/machine_templates/2</id>
    <name>my_template_2</name>
    <description>Description of my MachineTemplate</description>
    <property key="test">value</property>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small" />
    <machineImage href="http://localhost:3001/cimi/machine_images/img1" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/2" />
  </MachineTemplate>
</Collection>

  

  

Retrieve a single Machine Template
Example request:
GET /cimi/machine_templates/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: 607
ETag: 8f720ffacb6439a6920a5f5b0ec7bbfc
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 15:06:14 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineTemplate xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineTemplate">
  <id>http://localhost:3001/cimi/machine_templates/2</id>
  <name>my_template_2</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small" />
  <machineImage href="http://localhost:3001/cimi/machine_images/img1" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/2" />
</MachineTemplate>

  

  

Create a new Machine Template
Example request:
POST /cimi/machine_templates 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: 334

<MachineTemplateCreate>
  <name>myXmlTestMachineTemplate1</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge"/>
  <machineImage href="http://localhost:3001/cimi/machine_images/img3"/>
</MachineTemplateCreate>


Server response:
HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machine_templates/1
CIMI-Specification-Version: 1.0.1
Content-Length: 620
ETag: e848e33fa0886e6c3d2df3cb674485d7
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 14:48:03 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineTemplate xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/MachineTemplate">
  <id>http://localhost:3001/cimi/machine_templates/1</id>
  <name>myXmlTestMachineTemplate1</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge" />
  <machineImage href="http://localhost:3001/cimi/machine_images/img3" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete" href="http://localhost:3001/cimi/machine_templates/1" />
</MachineTemplate>


  

  

Delete a Machine Template
Example request:
DELETE /cimi/machine_templates/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
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: Thu, 03 Jan 2013 15:06:38 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

  
;T;@I"*/cimi-rest/cimi-rest-machine-configs/;T{;{	;I",

  
    
    CIMI Resource Collections - Machine Configuration
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

Machine Configuration


The Machine Configuration resource represents the set of configuration values that define the (virtual)
hardware resources of a to-be-realized Machine Instance. Machine Configurations are created by
Providers and may, at the Providers discretion, be created by Consumers.

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



  
  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Machine Resources
  
  
Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  






Retrieve the Machine Configuration Collection
  Retrieve a single Machine Configuration

  

Retrieve the Machine Configuration Collection

Example request:
GET /cimi/machine_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: 1504
ETag: 69348a8afa58a1c35b6cfad7c4066a9e
Cache-Control: max-age=0, private, must-revalidate
Date: Wed, 02 Jan 2013 14:12:23 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/MachineConfigurationCollection">
  <id>http://localhost:3001/cimi/machine_configurations</id>
  <count>3</count>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-small</id>
    <name>m1-small</name>
    <description>Machine Configuration with 1782579 KiB of memory and 1 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>1</cpu>
    <memory>1782579</memory>
    <disk>
      <capacity>167772160</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-large</id>
    <name>m1-large</name>
    <description>Machine Configuration with 10485760 KiB of memory and 1 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>1</cpu>
    <memory>10485760</memory>
    <disk>
      <capacity>891289600</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-xlarge</id>
    <name>m1-xlarge</name>
    <description>Machine Configuration with 12582912 KiB of memory and 4 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>4</cpu>
    <memory>12582912</memory>
    <disk>
      <capacity>1073741824</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
</Collection>

  


  

Retrieve a single Machine Configuration

Example request:
GET /cimi/machine_configurations/m1-large 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: 508
ETag: 33c094bbcec51437860280fd053f1023
Cache-Control: max-age=0, private, must-revalidate
Date: Wed, 02 Jan 2013 14:20:52 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineConfiguration xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineConfiguration">
  <id>http://localhost:3001/cimi/machine_configurations/m1-large</id>
  <name>m1-large</name>
  <description>Machine Configuration with 10485760 KiB of memory and 1 CPU</description>
  <created>2013-01-02T16:20:52+02:00</created>
  <cpu>1</cpu>
  <memory>10485760</memory>
  <disk>
    <capacity>891289600</capacity>
    <format>unknown</format>
  </disk>
</MachineConfiguration>



  


      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"�



  

Machine Configuration


The Machine Configuration resource represents the set of configuration values that define the (virtual)
hardware resources of a to-be-realized Machine Instance. Machine Configurations are created by
Providers and may, at the Providers discretion, be created by Consumers.

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



  
  


  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
      ResourceMetadata
      Machine
      Volume
    
  
  
  
    Machine Resources
  
  
    Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  



  




  Retrieve the Machine Configuration Collection
  Retrieve a single Machine Configuration





  

Retrieve the Machine Configuration Collection

Example request:
GET /cimi/machine_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: 1504
ETag: 69348a8afa58a1c35b6cfad7c4066a9e
Cache-Control: max-age=0, private, must-revalidate
Date: Wed, 02 Jan 2013 14:12:23 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/MachineConfigurationCollection">
  <id>http://localhost:3001/cimi/machine_configurations</id>
  <count>3</count>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-small</id>
    <name>m1-small</name>
    <description>Machine Configuration with 1782579 KiB of memory and 1 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>1</cpu>
    <memory>1782579</memory>
    <disk>
      <capacity>167772160</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-large</id>
    <name>m1-large</name>
    <description>Machine Configuration with 10485760 KiB of memory and 1 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>1</cpu>
    <memory>10485760</memory>
    <disk>
      <capacity>891289600</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-xlarge</id>
    <name>m1-xlarge</name>
    <description>Machine Configuration with 12582912 KiB of memory and 4 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>4</cpu>
    <memory>12582912</memory>
    <disk>
      <capacity>1073741824</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
</Collection>

  


  

Retrieve a single Machine Configuration

Example request:
GET /cimi/machine_configurations/m1-large 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: 508
ETag: 33c094bbcec51437860280fd053f1023
Cache-Control: max-age=0, private, must-revalidate
Date: Wed, 02 Jan 2013 14:20:52 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineConfiguration xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineConfiguration">
  <id>http://localhost:3001/cimi/machine_configurations/m1-large</id>
  <name>m1-large</name>
  <description>Machine Configuration with 10485760 KiB of memory and 1 CPU</description>
  <created>2013-01-02T16:20:52+02:00</created>
  <cpu>1</cpu>
  <memory>10485760</memory>
  <disk>
    <capacity>891289600</capacity>
    <format>unknown</format>
  </disk>
</MachineConfiguration>



  
;T;
I"w



  

Machine Configuration


The Machine Configuration resource represents the set of configuration values that define the (virtual)
hardware resources of a to-be-realized Machine Instance. Machine Configurations are created by
Providers and may, at the Providers discretion, be created by Consumers.

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



  
  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Machine Resources
  
  
Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  






Retrieve the Machine Configuration Collection
  Retrieve a single Machine Configuration

  

Retrieve the Machine Configuration Collection

Example request:
GET /cimi/machine_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: 1504
ETag: 69348a8afa58a1c35b6cfad7c4066a9e
Cache-Control: max-age=0, private, must-revalidate
Date: Wed, 02 Jan 2013 14:12:23 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/MachineConfigurationCollection">
  <id>http://localhost:3001/cimi/machine_configurations</id>
  <count>3</count>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-small</id>
    <name>m1-small</name>
    <description>Machine Configuration with 1782579 KiB of memory and 1 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>1</cpu>
    <memory>1782579</memory>
    <disk>
      <capacity>167772160</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-large</id>
    <name>m1-large</name>
    <description>Machine Configuration with 10485760 KiB of memory and 1 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>1</cpu>
    <memory>10485760</memory>
    <disk>
      <capacity>891289600</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
  <MachineConfiguration>
    <id>http://localhost:3001/cimi/machine_configurations/m1-xlarge</id>
    <name>m1-xlarge</name>
    <description>Machine Configuration with 12582912 KiB of memory and 4 CPU</description>
    <created>2013-01-02T16:12:23+02:00</created>
    <cpu>4</cpu>
    <memory>12582912</memory>
    <disk>
      <capacity>1073741824</capacity>
      <format>unknown</format>
    </disk>
  </MachineConfiguration>
</Collection>

  


  

Retrieve a single Machine Configuration

Example request:
GET /cimi/machine_configurations/m1-large 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: 508
ETag: 33c094bbcec51437860280fd053f1023
Cache-Control: max-age=0, private, must-revalidate
Date: Wed, 02 Jan 2013 14:20:52 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineConfiguration xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineConfiguration">
  <id>http://localhost:3001/cimi/machine_configurations/m1-large</id>
  <name>m1-large</name>
  <description>Machine Configuration with 10485760 KiB of memory and 1 CPU</description>
  <created>2013-01-02T16:20:52+02:00</created>
  <cpu>1</cpu>
  <memory>10485760</memory>
  <disk>
    <capacity>891289600</capacity>
    <format>unknown</format>
  </disk>
</MachineConfiguration>



  
;T;@I")/cimi-rest/cimi-rest-machine-images/;T{;{	;I"�6

  
    
    CIMI Resource Collections - Machine Image
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

Machine Image


This resource represents the information necessary for hardware virtualized resources to create a Machine Instance; it contains configuration data such as startup instructions, including possible combinations of the following items, depending on the 'type' of Machine Image created: the software image, installation software, both a disk image and a set of software and parameters. 


A Machine Image Collection resource represents the collection of Machine Image resources within a Provider.



  
  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Machine Resources
  
  
Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  






Retrieve the Machine Image Collection
  Retrieve a single Machine Image
  Create or Delete a Machine Image

  

Retrieve the Machine Image Collection


Note the 'add' URI of the Machine Image Collection resource in the example response below. This is the URI that is used for creating a new Machine Image (adding to the Machine Image Collection). This URI is also returned when dereferencing a Machine resource, as the href attribute of the 'capture' operation (when this is possible for the given Machine on the particular Cloud Provider).


Example request:
GET /cimi/machine_images 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: 1195
ETag: e2f73ed48eb2abeae77322eea56dfc5d
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 14:23:35 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/MachineImageCollection">
  <id>http://localhost:3001/cimi/machine_images</id>
  <count>3</count>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img1</id>
    <name>img1</name>
    <description>Fedora 10</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img1</imageLocation>
  </MachineImage>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img2</id>
    <name>img2</name>
    <description>Fedora 10</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img2</imageLocation>
  </MachineImage>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img3</id>
    <name>img3</name>
    <description>JBoss</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img3</imageLocation>
  </MachineImage>
  <operation rel="add" href="http://localhost:3001/cimi/machine_images" />
</Collection>


  
  

Retrieve a single Machine Image

Example request:

GET /cimi/machine_images/img1 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: 385
ETag: 130f8e9592138afc544d65d73039e540
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 14:55:42 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineImage xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineImage">
  <id>http://localhost:3001/cimi/machine_images/img1</id>
  <name>img1</name>
  <description>Fedora 10</description>
  <created>2012-12-28T16:55:42+02:00</created>
  <state>AVAILABLE</state>
  <type>IMAGE</type>
  <imageLocation>mock://img1</imageLocation>
</MachineImage>


  

  


Create a new Machine Image


The example below shows the creation of a new Machine Image resource from an existing Machine resource. When supported by the Machine and the given Cloud Provider, the href attribute of the serialized Machine resource's 'capture' operation provides the URI to which the request body should be sent with HTTP POST in order to create the new Machine Image. The message body is the representation of the to be created Machine Image resource, with the 'imageLocation' attribute referring to the Machine resource from which the Machine Image is to be created, as shown in the example below:


Example request:

POST /cimi/machine_images 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: 188
<MachineImage>
  <name>some_name</name>
  <description>my new machine_image</description>
  <type>IMAGE</type>
  <imageLocation>http://localhost:3001/cimi/machines/inst1</imageLocation>
</MachineImage>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machine_images/some_name
CIMI-Specification-Version: 1.0.1
Content-Length: 411
ETag: c929191a65da6564f9f69301d38eb6fc
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 15:10:12 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineImage xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineImage">
  <id>http://localhost:3001/cimi/machine_images/some_name</id>
  <name>some_name</name>
  <description>my new machine image</description>
  <created>2012-12-28T17:10:12+02:00</created>
  <state>AVAILABLE</state>
  <type>IMAGE</type>
  <imageLocation>mock://some_name</imageLocation>
</MachineImage>




Delete a Machine Image

Example request:

DELETE /cimi/machine_images/some_name 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, 28 Dec 2012 15:21:14 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife


  


      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"�!



  

Machine Image


This resource represents the information necessary for hardware virtualized resources to create a Machine Instance; it contains configuration data such as startup instructions, including possible combinations of the following items, depending on the 'type' of Machine Image created: the software image, installation software, both a disk image and a set of software and parameters. 
 

A Machine Image Collection resource represents the collection of Machine Image resources within a Provider.



  
  



  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
      ResourceMetadata
      Machine
      Volume
    
  
  
  
    Machine Resources
  
  
    Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  



  




  Retrieve the Machine Image Collection
  Retrieve a single Machine Image
  Create or Delete a Machine Image





  

Retrieve the Machine Image Collection


Note the 'add' URI of the Machine Image Collection resource in the example response below. This is the URI that is used for creating a new Machine Image (adding to the Machine Image Collection). This URI is also returned when dereferencing a Machine resource, as the href attribute of the 'capture' operation (when this is possible for the given Machine on the particular Cloud Provider).


Example request:
GET /cimi/machine_images 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: 1195
ETag: e2f73ed48eb2abeae77322eea56dfc5d
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 14:23:35 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/MachineImageCollection">
  <id>http://localhost:3001/cimi/machine_images</id>
  <count>3</count>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img1</id>
    <name>img1</name>
    <description>Fedora 10</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img1</imageLocation>
  </MachineImage>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img2</id>
    <name>img2</name>
    <description>Fedora 10</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img2</imageLocation>
  </MachineImage>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img3</id>
    <name>img3</name>
    <description>JBoss</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img3</imageLocation>
  </MachineImage>
  <operation rel="add" href="http://localhost:3001/cimi/machine_images" />
</Collection>


  
  

Retrieve a single Machine Image

Example request:

GET /cimi/machine_images/img1 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: 385
ETag: 130f8e9592138afc544d65d73039e540
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 14:55:42 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineImage xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineImage">
  <id>http://localhost:3001/cimi/machine_images/img1</id>
  <name>img1</name>
  <description>Fedora 10</description>
  <created>2012-12-28T16:55:42+02:00</created>
  <state>AVAILABLE</state>
  <type>IMAGE</type>
  <imageLocation>mock://img1</imageLocation>
</MachineImage>


  

  


Create a new Machine Image


The example below shows the creation of a new Machine Image resource from an existing Machine resource. When supported by the Machine and the given Cloud Provider, the href attribute of the serialized Machine resource's 'capture' operation provides the URI to which the request body should be sent with HTTP POST in order to create the new Machine Image. The message body is the representation of the to be created Machine Image resource, with the 'imageLocation' attribute referring to the Machine resource from which the Machine Image is to be created, as shown in the example below:


Example request:

POST /cimi/machine_images 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: 188
<MachineImage>
  <name>some_name</name>
  <description>my new machine_image</description>
  <type>IMAGE</type>
  <imageLocation>http://localhost:3001/cimi/machines/inst1</imageLocation>
</MachineImage>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machine_images/some_name
CIMI-Specification-Version: 1.0.1
Content-Length: 411
ETag: c929191a65da6564f9f69301d38eb6fc
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 15:10:12 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineImage xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineImage">
  <id>http://localhost:3001/cimi/machine_images/some_name</id>
  <name>some_name</name>
  <description>my new machine image</description>
  <created>2012-12-28T17:10:12+02:00</created>
  <state>AVAILABLE</state>
  <type>IMAGE</type>
  <imageLocation>mock://some_name</imageLocation>
</MachineImage>






Delete a Machine Image

Example request:

DELETE /cimi/machine_images/some_name 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, 28 Dec 2012 15:21:14 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife


  
;T;
I""!



  

Machine Image


This resource represents the information necessary for hardware virtualized resources to create a Machine Instance; it contains configuration data such as startup instructions, including possible combinations of the following items, depending on the 'type' of Machine Image created: the software image, installation software, both a disk image and a set of software and parameters. 


A Machine Image Collection resource represents the collection of Machine Image resources within a Provider.



  
  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Machine Resources
  
  
Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  






Retrieve the Machine Image Collection
  Retrieve a single Machine Image
  Create or Delete a Machine Image

  

Retrieve the Machine Image Collection


Note the 'add' URI of the Machine Image Collection resource in the example response below. This is the URI that is used for creating a new Machine Image (adding to the Machine Image Collection). This URI is also returned when dereferencing a Machine resource, as the href attribute of the 'capture' operation (when this is possible for the given Machine on the particular Cloud Provider).


Example request:
GET /cimi/machine_images 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: 1195
ETag: e2f73ed48eb2abeae77322eea56dfc5d
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 14:23:35 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/MachineImageCollection">
  <id>http://localhost:3001/cimi/machine_images</id>
  <count>3</count>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img1</id>
    <name>img1</name>
    <description>Fedora 10</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img1</imageLocation>
  </MachineImage>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img2</id>
    <name>img2</name>
    <description>Fedora 10</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img2</imageLocation>
  </MachineImage>
  <MachineImage>
    <id>http://localhost:3001/cimi/machine_images/img3</id>
    <name>img3</name>
    <description>JBoss</description>
    <created>2012-12-28T16:23:35+02:00</created>
    <state>AVAILABLE</state>
    <type>IMAGE</type>
    <imageLocation>mock://img3</imageLocation>
  </MachineImage>
  <operation rel="add" href="http://localhost:3001/cimi/machine_images" />
</Collection>


  
  

Retrieve a single Machine Image

Example request:

GET /cimi/machine_images/img1 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: 385
ETag: 130f8e9592138afc544d65d73039e540
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 14:55:42 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineImage xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineImage">
  <id>http://localhost:3001/cimi/machine_images/img1</id>
  <name>img1</name>
  <description>Fedora 10</description>
  <created>2012-12-28T16:55:42+02:00</created>
  <state>AVAILABLE</state>
  <type>IMAGE</type>
  <imageLocation>mock://img1</imageLocation>
</MachineImage>


  

  


Create a new Machine Image


The example below shows the creation of a new Machine Image resource from an existing Machine resource. When supported by the Machine and the given Cloud Provider, the href attribute of the serialized Machine resource's 'capture' operation provides the URI to which the request body should be sent with HTTP POST in order to create the new Machine Image. The message body is the representation of the to be created Machine Image resource, with the 'imageLocation' attribute referring to the Machine resource from which the Machine Image is to be created, as shown in the example below:


Example request:

POST /cimi/machine_images 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: 188
<MachineImage>
  <name>some_name</name>
  <description>my new machine_image</description>
  <type>IMAGE</type>
  <imageLocation>http://localhost:3001/cimi/machines/inst1</imageLocation>
</MachineImage>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machine_images/some_name
CIMI-Specification-Version: 1.0.1
Content-Length: 411
ETag: c929191a65da6564f9f69301d38eb6fc
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 15:10:12 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineImage xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineImage">
  <id>http://localhost:3001/cimi/machine_images/some_name</id>
  <name>some_name</name>
  <description>my new machine image</description>
  <created>2012-12-28T17:10:12+02:00</created>
  <state>AVAILABLE</state>
  <type>IMAGE</type>
  <imageLocation>mock://some_name</imageLocation>
</MachineImage>




Delete a Machine Image

Example request:

DELETE /cimi/machine_images/some_name 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, 28 Dec 2012 15:21:14 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife


  
;T;@$I"&/cimi-rest/cimi-rest-entry-point/;T{;{	;I"�$

  
    
    CIMI Cloud Entry Point
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

The CIMI Cloud Entry Point


The Cloud Entry Point represents the entry point into the cloud defined by the CIMI Model. The Cloud
Entry Point implements a catalog of resources, such as Systems, System Templates, Machines, Machine
Templates, etc., that can be queried and browsed by the Consumer.


A deltacloud server exposes the CIMI Cloud Entry Point at /cimi/cloudEntryPoint. When dereferencing this URI, the resources listed in the response include only those that are supported by the current deltacloud driver - whether the 'default' driver the server was started with, or that specified with the X-Deltacloud-Driver header.


 

  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    








Example request:

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



Example response:


HTTP/1.1 200 OK
Content-Type: application/xml
CIMI-Specification-Version: 1.0.1
Content-Length: 1754
ETag: 503bc06f24d1a51eddc62b33b870c70f
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 27 Dec 2012 15:23:23 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<CloudEntryPoint xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/CloudEntryPoint">
  <id>http://localhost:3001/cimi/cloudEntryPoint</id>
  <name>mock</name>
  <description>Cloud Entry Point for the Deltacloud mock driver</description>
  <created>2012-12-27T17:23:23+02:00</created>
  <baseURI>http://localhost:3001/cimi/</baseURI>
  <resourceMetadata href="http://localhost:3001/cimi/resource_metadata" />
  <machines href="http://localhost:3001/cimi/machines" />
  <machineTemplates href="http://localhost:3001/cimi/machine_templates" />
  <machineImages href="http://localhost:3001/cimi/machine_images" />
  <credentials href="http://localhost:3001/cimi/credentials" />
  <volumes href="http://localhost:3001/cimi/volumes" />
  <volumeImages href="http://localhost:3001/cimi/volume_images" />
  <networks href="http://localhost:3001/cimi/networks" />
  <networkTemplates href="http://localhost:3001/cimi/network_templates" />
  <networkPorts href="http://localhost:3001/cimi/network_ports" />
  <networkPortTemplates href="http://localhost:3001/cimi/network_port_templates" />
  <addresses href="http://localhost:3001/cimi/addresses" />
  <addressTemplates href="http://localhost:3001/cimi/address_templates" />
  <forwardingGroups href="http://localhost:3001/cimi/forwarding_groups" />
  <forwardingGroupTemplates href="http://localhost:3001/cimi/forwarding_group_templates" />
  <volumeConfigs href="http://localhost:3001/cimi/volume_configurations" />
  <machineConfigs href="http://localhost:3001/cimi/machine_configurations" />
  <networkConfigs href="http://localhost:3001/cimi/network_configurations" />
  <networkPortConfigs href="http://localhost:3001/cimi/network_port_configurations" />
</CloudEntryPoint>


      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"�



  

The CIMI Cloud Entry Point


The Cloud Entry Point represents the entry point into the cloud defined by the CIMI Model. The Cloud
Entry Point implements a catalog of resources, such as Systems, System Templates, Machines, Machine
Templates, etc., that can be queried and browsed by the Consumer.


A deltacloud server exposes the CIMI Cloud Entry Point at /cimi/cloudEntryPoint. When dereferencing this URI, the resources listed in the response include only those that are supported by the current deltacloud driver - whether the 'default' driver the server was started with, or that specified with the X-Deltacloud-Driver header.


 

  


  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
      ResourceMetadata
      Machine
      Volume
    
  



  




Example request:

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



Example response:


HTTP/1.1 200 OK
Content-Type: application/xml
CIMI-Specification-Version: 1.0.1
Content-Length: 1754
ETag: 503bc06f24d1a51eddc62b33b870c70f
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 27 Dec 2012 15:23:23 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<CloudEntryPoint xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/CloudEntryPoint">
  <id>http://localhost:3001/cimi/cloudEntryPoint</id>
  <name>mock</name>
  <description>Cloud Entry Point for the Deltacloud mock driver</description>
  <created>2012-12-27T17:23:23+02:00</created>
  <baseURI>http://localhost:3001/cimi/</baseURI>
  <resourceMetadata href="http://localhost:3001/cimi/resource_metadata" />
  <machines href="http://localhost:3001/cimi/machines" />
  <machineTemplates href="http://localhost:3001/cimi/machine_templates" />
  <machineImages href="http://localhost:3001/cimi/machine_images" />
  <credentials href="http://localhost:3001/cimi/credentials" />
  <volumes href="http://localhost:3001/cimi/volumes" />
  <volumeImages href="http://localhost:3001/cimi/volume_images" />
  <networks href="http://localhost:3001/cimi/networks" />
  <networkTemplates href="http://localhost:3001/cimi/network_templates" />
  <networkPorts href="http://localhost:3001/cimi/network_ports" />
  <networkPortTemplates href="http://localhost:3001/cimi/network_port_templates" />
  <addresses href="http://localhost:3001/cimi/addresses" />
  <addressTemplates href="http://localhost:3001/cimi/address_templates" />
  <forwardingGroups href="http://localhost:3001/cimi/forwarding_groups" />
  <forwardingGroupTemplates href="http://localhost:3001/cimi/forwarding_group_templates" />
  <volumeConfigs href="http://localhost:3001/cimi/volume_configurations" />
  <machineConfigs href="http://localhost:3001/cimi/machine_configurations" />
  <networkConfigs href="http://localhost:3001/cimi/network_configurations" />
  <networkPortConfigs href="http://localhost:3001/cimi/network_port_configurations" />
</CloudEntryPoint>
;T;
I"f



  

The CIMI Cloud Entry Point


The Cloud Entry Point represents the entry point into the cloud defined by the CIMI Model. The Cloud
Entry Point implements a catalog of resources, such as Systems, System Templates, Machines, Machine
Templates, etc., that can be queried and browsed by the Consumer.


A deltacloud server exposes the CIMI Cloud Entry Point at /cimi/cloudEntryPoint. When dereferencing this URI, the resources listed in the response include only those that are supported by the current deltacloud driver - whether the 'default' driver the server was started with, or that specified with the X-Deltacloud-Driver header.


 

  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    








Example request:

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



Example response:


HTTP/1.1 200 OK
Content-Type: application/xml
CIMI-Specification-Version: 1.0.1
Content-Length: 1754
ETag: 503bc06f24d1a51eddc62b33b870c70f
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 27 Dec 2012 15:23:23 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<CloudEntryPoint xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/CloudEntryPoint">
  <id>http://localhost:3001/cimi/cloudEntryPoint</id>
  <name>mock</name>
  <description>Cloud Entry Point for the Deltacloud mock driver</description>
  <created>2012-12-27T17:23:23+02:00</created>
  <baseURI>http://localhost:3001/cimi/</baseURI>
  <resourceMetadata href="http://localhost:3001/cimi/resource_metadata" />
  <machines href="http://localhost:3001/cimi/machines" />
  <machineTemplates href="http://localhost:3001/cimi/machine_templates" />
  <machineImages href="http://localhost:3001/cimi/machine_images" />
  <credentials href="http://localhost:3001/cimi/credentials" />
  <volumes href="http://localhost:3001/cimi/volumes" />
  <volumeImages href="http://localhost:3001/cimi/volume_images" />
  <networks href="http://localhost:3001/cimi/networks" />
  <networkTemplates href="http://localhost:3001/cimi/network_templates" />
  <networkPorts href="http://localhost:3001/cimi/network_ports" />
  <networkPortTemplates href="http://localhost:3001/cimi/network_port_templates" />
  <addresses href="http://localhost:3001/cimi/addresses" />
  <addressTemplates href="http://localhost:3001/cimi/address_templates" />
  <forwardingGroups href="http://localhost:3001/cimi/forwarding_groups" />
  <forwardingGroupTemplates href="http://localhost:3001/cimi/forwarding_group_templates" />
  <volumeConfigs href="http://localhost:3001/cimi/volume_configurations" />
  <machineConfigs href="http://localhost:3001/cimi/machine_configurations" />
  <networkConfigs href="http://localhost:3001/cimi/network_configurations" />
  <networkPortConfigs href="http://localhost:3001/cimi/network_port_configurations" />
</CloudEntryPoint>
;T;@*I"&/cimi-rest/cimi-rest-collections/;T{;{	;I"?S

  
    
    CIMI Resource Collections - Machine
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

CIMI Resources and Collections

 We are continually improving CIMI support in Deltacloud. If you come across any inconsistencies or errors in the Deltacloud CIMI implementation we'll be very glad to hear about them.


In the following sections, the textual definitions following the title of each resource (e.g. "Machine") that are rendered in bold and italic type are taken from the CIMI 1.0.1 specification, available from the DMTF Cloud Management Initiative (DSP0263).





Machine


An instantiated compute resource that encapsulates both CPU and Memory.
A Machine Collection resource represents the collection of Machine resources within a Provider



 

 



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Machine Resources
  
  
Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  






Retrieve the Machine Collection
  Retrieve a single Machine
  Create a new Machine
  Perform a Machine Operation
  Work with Machine Volumes

  

Retrieve the Machine Collection

Note the 'add' URI of the Machine Collection resource in the example response below. This is the URI that is used for creating a new Machine (adding to the Machine Collection).


Example request:

GET /cimi/machines 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: 2293
ETag: 5c6dc8cfbceeb1f3c610765a4aa600dd
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:08:27 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/MachineCollection">
  <id>http://localhost:3001/cimi/machines</id>
  <count>2</count>
  <Machine>
    <id>http://localhost:3001/cimi/machines/inst0</id>
    <name>Mock Instance With Profile Change</name>
    <description>No description set for Machine Mock Instance With Profile Change</description>
    <created>2012-12-28T13:08:27+02:00</created>
    <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
    <property key="credential">http://localhost:3001/cimi/credentials</property>
    <state>STARTED</state>
    <cpu>1</cpu>
    <memory>12582912</memory>
    <disks href="http://localhost:3001/cimi/machines/inst0/disks" />
    <volumes href="http://localhost:3001/cimi/machines/inst0/volumes" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
        href="http://localhost:3001/cimi/machines/inst0/restart" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
        href="http://localhost:3001/cimi/machines/inst0/stop" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
        href="http://localhost:3001/cimi/machine_images" />
  </Machine>
  <Machine>
    <id>http://localhost:3001/cimi/machines/inst1</id>
    <name>MockUserInstance</name>
    <description>No description set for Machine MockUserInstance</description>
    <created>2012-12-28T13:08:27+02:00</created>
    <property key="machine_image">http://localhost:3001/cimi/machine_images/img3</property>
    <property key="credential">http://localhost:3001/cimi/credentials</property>
    <state>STARTED</state>
    <cpu>1</cpu>
    <memory>1782579</memory>
    <disks href="http://localhost:3001/cimi/machines/inst1/disks" />
    <volumes href="http://localhost:3001/cimi/machines/inst1/volumes" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
        href="http://localhost:3001/cimi/machines/inst1/restart" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
        href="http://localhost:3001/cimi/machines/inst1/stop" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
        href="http://localhost:3001/cimi/machine_images" />
  </Machine>
  <operation rel="add" href="http://localhost:3001/cimi/machines" />
</Collection>




  
  

Retrieve a single Machine

Example request:

GET /cimi/machines/inst0 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: 1092
ETag: 2d57aa01f1a50b2d13c04f0c51f08ab9
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:20:28 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Machine xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/Machine">
  <id>http://localhost:3001/cimi/machines/inst0</id>
  <name>Mock Instance With Profile Change</name>
  <description>No description set for Machine Mock Instance With Profile Change</description>
  <created>2012-12-28T13:20:28+02:00</created>
  <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
  <property key="credential">http://localhost:3001/cimi/credentials</property>
  <state>STARTED</state>
  <cpu>1</cpu>
  <memory>12582912</memory>
  <disks href="http://localhost:3001/cimi/machines/inst0/disks" />
  <volumes href="http://localhost:3001/cimi/machines/inst0/volumes" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
          href="http://localhost:3001/cimi/machines/inst0/restart" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
          href="http://localhost:3001/cimi/machines/inst0/stop" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
          href="http://localhost:3001/cimi/machine_images" />
</Machine>




  

  

Create a new Machine


The 'add' URI of the Machine Collection is used to create a new Machine. This is returned when retrieving the Machine Collection resource.


Example request:

POST /cimi/machines 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: 370

<MachineCreate xmlns="http://schemas.dmtf.org/cimi/1">
  <name> myMachine1 </name>
  <description> my machine description </description>
  <machineTemplate>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small">
    </machineConfig>
    <machineImage href="http://localhost:3001/cimi/machine_images/img1">
    </machineImage>
  </machineTemplate>
</MachineCreate>



Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machines/inst3
CIMI-Specification-Version: 1.0.1
Content-Length: 1030
ETag: 360992481f1450f9d475f439e5105f9d
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:47:58 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Machine xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Machine">
  <id>http://localhost:3001/cimi/machines/inst3</id>
  <name> myMachine1 </name>
  <description> my machine description </description>
  <created>2012-12-28T13:47:58+02:00</created>
  <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
  <property key="credential">http://localhost:3001/cimi/credentials</property>
  <state>STARTED</state>
  <cpu>1</cpu>
  <memory>1782579</memory>
  <disks href="http://localhost:3001/cimi/machines/inst3/disks" />
  <volumes href="http://localhost:3001/cimi/machines/inst3/volumes" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
          href="http://localhost:3001/cimi/machines/inst3/restart" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
          href="http://localhost:3001/cimi/machines/inst3/stop" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
          href="http://localhost:3001/cimi/machine_images" />
</Machine>





  


  

Perform a Machine Operation


The list of Machine operations is returned when the URI of a specific Machine resource is dereferenced. Examples of operations are 'stop', 'restart' and 'capture'. An 'Action' resource is used in the POST message body corresponding to the operation to be executed. The example below shows the 'stop' action.


Example request:
POST /cimi/machines/inst3/stop 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: 125

<Action xmlns="http://schemas.dmtf.org/cimi/1">
  <action> http://http://schemas.dmtf.org/cimi/1/action/stop </action>
</Action>


Server response:
HTTP/1.1 202 Accepted
CIMI-Specification-Version: 1.0.1
Content-Length: 0
Date: Fri, 28 Dec 2012 14:01:43 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife



  

  

  Work with Machine Volumes

  Retrieve the MachineVolume Collection 

  Example request:

  GET /cimi/machines/inst1/volumes 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: 747
ETag: 8e2d333a3747634c04942b7d219a8d59
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 18 Jan 2013 14:50:26 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/MachineVolumeCollection">
  <id>http://localhost:3001/cimi/machines/inst1/volumes</id>
  <count>1</count>
  <MachineVolume>
    <id>http://localhost:3001/cimi/machines/inst1/volumes/vol3</id>
    <name>vol3</name>
    <description>MachineVolume vol3 for Machine inst1</description>
    <created>2009-07-30T14:35:11Z</created>
    <initialLocation>/dev/sda1</initialLocation>
    <volume href="http://localhost:3001/cimi/volumes/vol3" />
    <operation rel="delete" href="http://localhost:3001/cimi/machines/inst1/volumes/vol3" />
  </MachineVolume>
  <operation rel="add" href="http://localhost:3001/cimi/machines/inst1/volume_attach" />
</Collection>
  



Attach a Volume to a Machine - aka add a new MachineVolume to the MachineVolumeCollection of a specific Machine resource 

  Example request:
  
POST /cimi/machines/inst1/volume_attach 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: 186

<MachineVolume xmlns="http://schemas.dmtf.org/cimi/1/MachineVolume">
  <initialLocation> /dev/sdf </initialLocation>
  <volume href="http://localhost:3001/cimi/volumes/vol3"/>
</MachineVolume>
  

  Server response:
  
HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machines/inst1/volumes/vol3
CIMI-Specification-Version: 1.0.1
Content-Length: 522
ETag: cba6ca3186fa1ca3b7caf6b19e857139
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 18 Jan 2013 14:56:52 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineVolume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/MachineVolume">
  <id>http://localhost:3001/cimi/machines/inst1/volumes/vol3</id>
  <name>vol3</name>
  <description>MachineVolume vol3 for Machine inst1</description>
  <created>2009-07-30T14:35:11Z</created>
  <initialLocation>/dev/sdf</initialLocation>
  <volume href="http://localhost:3001/cimi/volumes/vol3" />
  <operation rel="delete" href="http://localhost:3001/cimi/machines/inst1/volumes/vol3" />
</MachineVolume>

  




Detach a Volume from a Machine - aka remove a MachineVolume from the MachineVolumeCollection of a specific Machine resource 

  Example request:
  DELETE /cimi/machines/inst1/volumes/vol3 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: 304
ETag: 011fb5daa52162644aeb170c86dc08ce
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 18 Jan 2013 17:11:02 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/MachineVolumeCollection">
  <id>http://localhost:3001/cimi/machines/inst1/volumes</id>
  <count>0</count>
  <operation rel="add" href="http://localhost:3001/cimi/machines/inst1/volume_attach" />
</Collection>

  
  



      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"+>



  

CIMI Resources and Collections

 We are continually improving CIMI support in Deltacloud. If you come across any inconsistencies or errors in the Deltacloud CIMI implementation we'll be very glad to hear about them.


In the following sections, the textual definitions following the title of each resource (e.g. "Machine") that are rendered in bold and italic type are taken from the CIMI 1.0.1 specification, available from the DMTF Cloud Management Initiative (DSP0263).









Machine


An instantiated compute resource that encapsulates both CPU and Memory.
A Machine Collection resource represents the collection of Machine resources within a Provider



 

 


  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
      ResourceMetadata
      Machine
      Volume
    
  
  
  
    Machine Resources
  
  
    Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  



  




  Retrieve the Machine Collection
  Retrieve a single Machine
  Create a new Machine
  Perform a Machine Operation
  Work with Machine Volumes





  

Retrieve the Machine Collection

Note the 'add' URI of the Machine Collection resource in the example response below. This is the URI that is used for creating a new Machine (adding to the Machine Collection).





Example request:

GET /cimi/machines 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: 2293
ETag: 5c6dc8cfbceeb1f3c610765a4aa600dd
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:08:27 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/MachineCollection">
  <id>http://localhost:3001/cimi/machines</id>
  <count>2</count>
  <Machine>
    <id>http://localhost:3001/cimi/machines/inst0</id>
    <name>Mock Instance With Profile Change</name>
    <description>No description set for Machine Mock Instance With Profile Change</description>
    <created>2012-12-28T13:08:27+02:00</created>
    <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
    <property key="credential">http://localhost:3001/cimi/credentials</property>
    <state>STARTED</state>
    <cpu>1</cpu>
    <memory>12582912</memory>
    <disks href="http://localhost:3001/cimi/machines/inst0/disks" />
    <volumes href="http://localhost:3001/cimi/machines/inst0/volumes" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
        href="http://localhost:3001/cimi/machines/inst0/restart" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
        href="http://localhost:3001/cimi/machines/inst0/stop" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
        href="http://localhost:3001/cimi/machine_images" />
  </Machine>
  <Machine>
    <id>http://localhost:3001/cimi/machines/inst1</id>
    <name>MockUserInstance</name>
    <description>No description set for Machine MockUserInstance</description>
    <created>2012-12-28T13:08:27+02:00</created>
    <property key="machine_image">http://localhost:3001/cimi/machine_images/img3</property>
    <property key="credential">http://localhost:3001/cimi/credentials</property>
    <state>STARTED</state>
    <cpu>1</cpu>
    <memory>1782579</memory>
    <disks href="http://localhost:3001/cimi/machines/inst1/disks" />
    <volumes href="http://localhost:3001/cimi/machines/inst1/volumes" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
        href="http://localhost:3001/cimi/machines/inst1/restart" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
        href="http://localhost:3001/cimi/machines/inst1/stop" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
        href="http://localhost:3001/cimi/machine_images" />
  </Machine>
  <operation rel="add" href="http://localhost:3001/cimi/machines" />
</Collection>




  
  

Retrieve a single Machine

Example request:

GET /cimi/machines/inst0 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: 1092
ETag: 2d57aa01f1a50b2d13c04f0c51f08ab9
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:20:28 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Machine xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/Machine">
  <id>http://localhost:3001/cimi/machines/inst0</id>
  <name>Mock Instance With Profile Change</name>
  <description>No description set for Machine Mock Instance With Profile Change</description>
  <created>2012-12-28T13:20:28+02:00</created>
  <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
  <property key="credential">http://localhost:3001/cimi/credentials</property>
  <state>STARTED</state>
  <cpu>1</cpu>
  <memory>12582912</memory>
  <disks href="http://localhost:3001/cimi/machines/inst0/disks" />
  <volumes href="http://localhost:3001/cimi/machines/inst0/volumes" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
          href="http://localhost:3001/cimi/machines/inst0/restart" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
          href="http://localhost:3001/cimi/machines/inst0/stop" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
          href="http://localhost:3001/cimi/machine_images" />
</Machine>




  

  

Create a new Machine


The 'add' URI of the Machine Collection is used to create a new Machine. This is returned when retrieving the Machine Collection resource.


Example request:

POST /cimi/machines 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: 370

<MachineCreate xmlns="http://schemas.dmtf.org/cimi/1">
  <name> myMachine1 </name>
  <description> my machine description </description>
  <machineTemplate>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small">
    </machineConfig>
    <machineImage href="http://localhost:3001/cimi/machine_images/img1">
    </machineImage>
  </machineTemplate>
</MachineCreate>



Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machines/inst3
CIMI-Specification-Version: 1.0.1
Content-Length: 1030
ETag: 360992481f1450f9d475f439e5105f9d
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:47:58 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Machine xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Machine">
  <id>http://localhost:3001/cimi/machines/inst3</id>
  <name> myMachine1 </name>
  <description> my machine description </description>
  <created>2012-12-28T13:47:58+02:00</created>
  <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
  <property key="credential">http://localhost:3001/cimi/credentials</property>
  <state>STARTED</state>
  <cpu>1</cpu>
  <memory>1782579</memory>
  <disks href="http://localhost:3001/cimi/machines/inst3/disks" />
  <volumes href="http://localhost:3001/cimi/machines/inst3/volumes" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
          href="http://localhost:3001/cimi/machines/inst3/restart" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
          href="http://localhost:3001/cimi/machines/inst3/stop" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
          href="http://localhost:3001/cimi/machine_images" />
</Machine>





  


  

Perform a Machine Operation


The list of Machine operations is returned when the URI of a specific Machine resource is dereferenced. Examples of operations are 'stop', 'restart' and 'capture'. An 'Action' resource is used in the POST message body corresponding to the operation to be executed. The example below shows the 'stop' action.


Example request:
POST /cimi/machines/inst3/stop 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: 125

<Action xmlns="http://schemas.dmtf.org/cimi/1">
  <action> http://http://schemas.dmtf.org/cimi/1/action/stop </action>
</Action>


Server response:
HTTP/1.1 202 Accepted
CIMI-Specification-Version: 1.0.1
Content-Length: 0
Date: Fri, 28 Dec 2012 14:01:43 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife



  

  

  Work with Machine Volumes

  Retrieve the MachineVolume Collection 

  Example request:

  GET /cimi/machines/inst1/volumes 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: 747
ETag: 8e2d333a3747634c04942b7d219a8d59
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 18 Jan 2013 14:50:26 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/MachineVolumeCollection">
  <id>http://localhost:3001/cimi/machines/inst1/volumes</id>
  <count>1</count>
  <MachineVolume>
    <id>http://localhost:3001/cimi/machines/inst1/volumes/vol3</id>
    <name>vol3</name>
    <description>MachineVolume vol3 for Machine inst1</description>
    <created>2009-07-30T14:35:11Z</created>
    <initialLocation>/dev/sda1</initialLocation>
    <volume href="http://localhost:3001/cimi/volumes/vol3" />
    <operation rel="delete" href="http://localhost:3001/cimi/machines/inst1/volumes/vol3" />
  </MachineVolume>
  <operation rel="add" href="http://localhost:3001/cimi/machines/inst1/volume_attach" />
</Collection>
  





  Attach a Volume to a Machine - aka add a new MachineVolume to the MachineVolumeCollection of a specific Machine resource 

  Example request:
  
POST /cimi/machines/inst1/volume_attach 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: 186

<MachineVolume xmlns="http://schemas.dmtf.org/cimi/1/MachineVolume">
  <initialLocation> /dev/sdf </initialLocation>
  <volume href="http://localhost:3001/cimi/volumes/vol3"/>
</MachineVolume>
  

  Server response:
  
HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machines/inst1/volumes/vol3
CIMI-Specification-Version: 1.0.1
Content-Length: 522
ETag: cba6ca3186fa1ca3b7caf6b19e857139
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 18 Jan 2013 14:56:52 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineVolume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/MachineVolume">
  <id>http://localhost:3001/cimi/machines/inst1/volumes/vol3</id>
  <name>vol3</name>
  <description>MachineVolume vol3 for Machine inst1</description>
  <created>2009-07-30T14:35:11Z</created>
  <initialLocation>/dev/sdf</initialLocation>
  <volume href="http://localhost:3001/cimi/volumes/vol3" />
  <operation rel="delete" href="http://localhost:3001/cimi/machines/inst1/volumes/vol3" />
</MachineVolume>

  






  Detach a Volume from a Machine - aka remove a MachineVolume from the MachineVolumeCollection of a specific Machine resource 

  Example request:
  DELETE /cimi/machines/inst1/volumes/vol3 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: 304
ETag: 011fb5daa52162644aeb170c86dc08ce
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 18 Jan 2013 17:11:02 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/MachineVolumeCollection">
  <id>http://localhost:3001/cimi/machines/inst1/volumes</id>
  <count>0</count>
  <operation rel="add" href="http://localhost:3001/cimi/machines/inst1/volume_attach" />
</Collection>

  
  

;T;
I"�=



  

CIMI Resources and Collections

 We are continually improving CIMI support in Deltacloud. If you come across any inconsistencies or errors in the Deltacloud CIMI implementation we'll be very glad to hear about them.


In the following sections, the textual definitions following the title of each resource (e.g. "Machine") that are rendered in bold and italic type are taken from the CIMI 1.0.1 specification, available from the DMTF Cloud Management Initiative (DSP0263).





Machine


An instantiated compute resource that encapsulates both CPU and Memory.
A Machine Collection resource represents the collection of Machine resources within a Provider



 

 



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Machine Resources
  
  
Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  






Retrieve the Machine Collection
  Retrieve a single Machine
  Create a new Machine
  Perform a Machine Operation
  Work with Machine Volumes

  

Retrieve the Machine Collection

Note the 'add' URI of the Machine Collection resource in the example response below. This is the URI that is used for creating a new Machine (adding to the Machine Collection).


Example request:

GET /cimi/machines 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: 2293
ETag: 5c6dc8cfbceeb1f3c610765a4aa600dd
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:08:27 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/MachineCollection">
  <id>http://localhost:3001/cimi/machines</id>
  <count>2</count>
  <Machine>
    <id>http://localhost:3001/cimi/machines/inst0</id>
    <name>Mock Instance With Profile Change</name>
    <description>No description set for Machine Mock Instance With Profile Change</description>
    <created>2012-12-28T13:08:27+02:00</created>
    <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
    <property key="credential">http://localhost:3001/cimi/credentials</property>
    <state>STARTED</state>
    <cpu>1</cpu>
    <memory>12582912</memory>
    <disks href="http://localhost:3001/cimi/machines/inst0/disks" />
    <volumes href="http://localhost:3001/cimi/machines/inst0/volumes" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
        href="http://localhost:3001/cimi/machines/inst0/restart" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
        href="http://localhost:3001/cimi/machines/inst0/stop" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
        href="http://localhost:3001/cimi/machine_images" />
  </Machine>
  <Machine>
    <id>http://localhost:3001/cimi/machines/inst1</id>
    <name>MockUserInstance</name>
    <description>No description set for Machine MockUserInstance</description>
    <created>2012-12-28T13:08:27+02:00</created>
    <property key="machine_image">http://localhost:3001/cimi/machine_images/img3</property>
    <property key="credential">http://localhost:3001/cimi/credentials</property>
    <state>STARTED</state>
    <cpu>1</cpu>
    <memory>1782579</memory>
    <disks href="http://localhost:3001/cimi/machines/inst1/disks" />
    <volumes href="http://localhost:3001/cimi/machines/inst1/volumes" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
        href="http://localhost:3001/cimi/machines/inst1/restart" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
        href="http://localhost:3001/cimi/machines/inst1/stop" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
        href="http://localhost:3001/cimi/machine_images" />
  </Machine>
  <operation rel="add" href="http://localhost:3001/cimi/machines" />
</Collection>




  
  

Retrieve a single Machine

Example request:

GET /cimi/machines/inst0 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: 1092
ETag: 2d57aa01f1a50b2d13c04f0c51f08ab9
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:20:28 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Machine xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/Machine">
  <id>http://localhost:3001/cimi/machines/inst0</id>
  <name>Mock Instance With Profile Change</name>
  <description>No description set for Machine Mock Instance With Profile Change</description>
  <created>2012-12-28T13:20:28+02:00</created>
  <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
  <property key="credential">http://localhost:3001/cimi/credentials</property>
  <state>STARTED</state>
  <cpu>1</cpu>
  <memory>12582912</memory>
  <disks href="http://localhost:3001/cimi/machines/inst0/disks" />
  <volumes href="http://localhost:3001/cimi/machines/inst0/volumes" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
          href="http://localhost:3001/cimi/machines/inst0/restart" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
          href="http://localhost:3001/cimi/machines/inst0/stop" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
          href="http://localhost:3001/cimi/machine_images" />
</Machine>




  

  

Create a new Machine


The 'add' URI of the Machine Collection is used to create a new Machine. This is returned when retrieving the Machine Collection resource.


Example request:

POST /cimi/machines 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: 370

<MachineCreate xmlns="http://schemas.dmtf.org/cimi/1">
  <name> myMachine1 </name>
  <description> my machine description </description>
  <machineTemplate>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small">
    </machineConfig>
    <machineImage href="http://localhost:3001/cimi/machine_images/img1">
    </machineImage>
  </machineTemplate>
</MachineCreate>



Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machines/inst3
CIMI-Specification-Version: 1.0.1
Content-Length: 1030
ETag: 360992481f1450f9d475f439e5105f9d
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 28 Dec 2012 11:47:58 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Machine xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Machine">
  <id>http://localhost:3001/cimi/machines/inst3</id>
  <name> myMachine1 </name>
  <description> my machine description </description>
  <created>2012-12-28T13:47:58+02:00</created>
  <property key="machine_image">http://localhost:3001/cimi/machine_images/img1</property>
  <property key="credential">http://localhost:3001/cimi/credentials</property>
  <state>STARTED</state>
  <cpu>1</cpu>
  <memory>1782579</memory>
  <disks href="http://localhost:3001/cimi/machines/inst3/disks" />
  <volumes href="http://localhost:3001/cimi/machines/inst3/volumes" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/restart"
          href="http://localhost:3001/cimi/machines/inst3/restart" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/stop"
          href="http://localhost:3001/cimi/machines/inst3/stop" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/capture"
          href="http://localhost:3001/cimi/machine_images" />
</Machine>





  


  

Perform a Machine Operation


The list of Machine operations is returned when the URI of a specific Machine resource is dereferenced. Examples of operations are 'stop', 'restart' and 'capture'. An 'Action' resource is used in the POST message body corresponding to the operation to be executed. The example below shows the 'stop' action.


Example request:
POST /cimi/machines/inst3/stop 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: 125

<Action xmlns="http://schemas.dmtf.org/cimi/1">
  <action> http://http://schemas.dmtf.org/cimi/1/action/stop </action>
</Action>


Server response:
HTTP/1.1 202 Accepted
CIMI-Specification-Version: 1.0.1
Content-Length: 0
Date: Fri, 28 Dec 2012 14:01:43 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife



  

  

  Work with Machine Volumes

  Retrieve the MachineVolume Collection 

  Example request:

  GET /cimi/machines/inst1/volumes 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: 747
ETag: 8e2d333a3747634c04942b7d219a8d59
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 18 Jan 2013 14:50:26 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/MachineVolumeCollection">
  <id>http://localhost:3001/cimi/machines/inst1/volumes</id>
  <count>1</count>
  <MachineVolume>
    <id>http://localhost:3001/cimi/machines/inst1/volumes/vol3</id>
    <name>vol3</name>
    <description>MachineVolume vol3 for Machine inst1</description>
    <created>2009-07-30T14:35:11Z</created>
    <initialLocation>/dev/sda1</initialLocation>
    <volume href="http://localhost:3001/cimi/volumes/vol3" />
    <operation rel="delete" href="http://localhost:3001/cimi/machines/inst1/volumes/vol3" />
  </MachineVolume>
  <operation rel="add" href="http://localhost:3001/cimi/machines/inst1/volume_attach" />
</Collection>
  



Attach a Volume to a Machine - aka add a new MachineVolume to the MachineVolumeCollection of a specific Machine resource 

  Example request:
  
POST /cimi/machines/inst1/volume_attach 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: 186

<MachineVolume xmlns="http://schemas.dmtf.org/cimi/1/MachineVolume">
  <initialLocation> /dev/sdf </initialLocation>
  <volume href="http://localhost:3001/cimi/volumes/vol3"/>
</MachineVolume>
  

  Server response:
  
HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machines/inst1/volumes/vol3
CIMI-Specification-Version: 1.0.1
Content-Length: 522
ETag: cba6ca3186fa1ca3b7caf6b19e857139
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 18 Jan 2013 14:56:52 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineVolume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/MachineVolume">
  <id>http://localhost:3001/cimi/machines/inst1/volumes/vol3</id>
  <name>vol3</name>
  <description>MachineVolume vol3 for Machine inst1</description>
  <created>2009-07-30T14:35:11Z</created>
  <initialLocation>/dev/sdf</initialLocation>
  <volume href="http://localhost:3001/cimi/volumes/vol3" />
  <operation rel="delete" href="http://localhost:3001/cimi/machines/inst1/volumes/vol3" />
</MachineVolume>

  




Detach a Volume from a Machine - aka remove a MachineVolume from the MachineVolumeCollection of a specific Machine resource 

  Example request:
  DELETE /cimi/machines/inst1/volumes/vol3 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: 304
ETag: 011fb5daa52162644aeb170c86dc08ce
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 18 Jan 2013 17:11:02 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/MachineVolumeCollection">
  <id>http://localhost:3001/cimi/machines/inst1/volumes</id>
  <count>0</count>
  <operation rel="add" href="http://localhost:3001/cimi/machines/inst1/volume_attach" />
</Collection>

  
  

;T;@0I",/cimi-rest/cimi-rest-machine-templates/;T{;{	;I"7

  
    
    CIMI Resource Collections - Machine Template
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

Machine Template


A Machine Template represents the set of metadata and instructions used in the creation of a Machine.

A Machine Template Collection resource represents the collection of Machine Template resources within
a Provider.




The CIMI specification follows a distinctive pattern with respect to creation of new resources - the machine template is a good example of this:


machineConfiguration + machineImage = machineTemplate ===> machine



A CIMI client (a consumer in CIMI terminology) uses a Machine Template to  create a new Machine; a Machine Template consists of (amongst other attributes) a Machine Configuration and a Machine Image. Generally speaking - many CIMI resources require the use of a template for their creation and a template will typically consist of an image plus a configuration resource.


  
  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Machine Resources
  
  
Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  






Retrieve the Machine Template Collection
  Retrieve a single Machine Template
  Create a new Machine Template
  Delete a Machine Template

  

Retrieve the Machine Template Collection
Example request:
GET /cimi/machine_templates 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: 1275
ETag: fba471ae32eca2b58fa02644b81b73aa
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 15:04:26 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/MachineTemplateCollection">
  <id>http://localhost:3001/cimi/machine_templates</id>
  <count>2</count>
  <MachineTemplate>
    <id>http://localhost:3001/cimi/machine_templates/1</id>
    <name>myXmlTestMachineTemplate1</name>
    <description>Description of my MachineTemplate</description>
    <property key="test">value</property>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge" />
    <machineImage href="http://localhost:3001/cimi/machine_images/img3" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/1" />
  </MachineTemplate>
  <MachineTemplate>
    <id>http://localhost:3001/cimi/machine_templates/2</id>
    <name>my_template_2</name>
    <description>Description of my MachineTemplate</description>
    <property key="test">value</property>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small" />
    <machineImage href="http://localhost:3001/cimi/machine_images/img1" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/2" />
  </MachineTemplate>
</Collection>

  

  

Retrieve a single Machine Template
Example request:
GET /cimi/machine_templates/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: 607
ETag: 8f720ffacb6439a6920a5f5b0ec7bbfc
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 15:06:14 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineTemplate xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineTemplate">
  <id>http://localhost:3001/cimi/machine_templates/2</id>
  <name>my_template_2</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small" />
  <machineImage href="http://localhost:3001/cimi/machine_images/img1" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/2" />
</MachineTemplate>

  

  

Create a new Machine Template
Example request:
POST /cimi/machine_templates 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: 334

<MachineTemplateCreate>
  <name>myXmlTestMachineTemplate1</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge"/>
  <machineImage href="http://localhost:3001/cimi/machine_images/img3"/>
</MachineTemplateCreate>


Server response:
HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machine_templates/1
CIMI-Specification-Version: 1.0.1
Content-Length: 620
ETag: e848e33fa0886e6c3d2df3cb674485d7
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 14:48:03 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineTemplate xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/MachineTemplate">
  <id>http://localhost:3001/cimi/machine_templates/1</id>
  <name>myXmlTestMachineTemplate1</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge" />
  <machineImage href="http://localhost:3001/cimi/machine_images/img3" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete" href="http://localhost:3001/cimi/machine_templates/1" />
</MachineTemplate>


  

  

Delete a Machine Template
Example request:
DELETE /cimi/machine_templates/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
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: Thu, 03 Jan 2013 15:06:38 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

  


      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"�!



  

Machine Template


A Machine Template represents the set of metadata and instructions used in the creation of a Machine.

A Machine Template Collection resource represents the collection of Machine Template resources within
a Provider.




The CIMI specification follows a distinctive pattern with respect to creation of new resources - the machine template is a good example of this:


machineConfiguration + machineImage = machineTemplate ===> machine



A CIMI client (a consumer in CIMI terminology) uses a Machine Template to  create a new Machine; a Machine Template consists of (amongst other attributes) a Machine Configuration and a Machine Image. Generally speaking - many CIMI resources require the use of a template for their creation and a template will typically consist of an image plus a configuration resource.


  
  


  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
      ResourceMetadata
      Machine
      Volume
    
  
  
  
    Machine Resources
  
  
    Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  



  




  Retrieve the Machine Template Collection
  Retrieve a single Machine Template
  Create a new Machine Template
  Delete a Machine Template





  

Retrieve the Machine Template Collection
Example request:
GET /cimi/machine_templates 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: 1275
ETag: fba471ae32eca2b58fa02644b81b73aa
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 15:04:26 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/MachineTemplateCollection">
  <id>http://localhost:3001/cimi/machine_templates</id>
  <count>2</count>
  <MachineTemplate>
    <id>http://localhost:3001/cimi/machine_templates/1</id>
    <name>myXmlTestMachineTemplate1</name>
    <description>Description of my MachineTemplate</description>
    <property key="test">value</property>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge" />
    <machineImage href="http://localhost:3001/cimi/machine_images/img3" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/1" />
  </MachineTemplate>
  <MachineTemplate>
    <id>http://localhost:3001/cimi/machine_templates/2</id>
    <name>my_template_2</name>
    <description>Description of my MachineTemplate</description>
    <property key="test">value</property>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small" />
    <machineImage href="http://localhost:3001/cimi/machine_images/img1" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/2" />
  </MachineTemplate>
</Collection>

  

  

Retrieve a single Machine Template
Example request:
GET /cimi/machine_templates/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: 607
ETag: 8f720ffacb6439a6920a5f5b0ec7bbfc
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 15:06:14 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineTemplate xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineTemplate">
  <id>http://localhost:3001/cimi/machine_templates/2</id>
  <name>my_template_2</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small" />
  <machineImage href="http://localhost:3001/cimi/machine_images/img1" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/2" />
</MachineTemplate>

  

  

Create a new Machine Template
Example request:
POST /cimi/machine_templates 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: 334

<MachineTemplateCreate>
  <name>myXmlTestMachineTemplate1</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge"/>
  <machineImage href="http://localhost:3001/cimi/machine_images/img3"/>
</MachineTemplateCreate>


Server response:
HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machine_templates/1
CIMI-Specification-Version: 1.0.1
Content-Length: 620
ETag: e848e33fa0886e6c3d2df3cb674485d7
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 14:48:03 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineTemplate xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/MachineTemplate">
  <id>http://localhost:3001/cimi/machine_templates/1</id>
  <name>myXmlTestMachineTemplate1</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge" />
  <machineImage href="http://localhost:3001/cimi/machine_images/img3" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete" href="http://localhost:3001/cimi/machine_templates/1" />
</MachineTemplate>


  

  

Delete a Machine Template
Example request:
DELETE /cimi/machine_templates/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
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: Thu, 03 Jan 2013 15:06:38 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

  
;T;
I"p!



  

Machine Template


A Machine Template represents the set of metadata and instructions used in the creation of a Machine.

A Machine Template Collection resource represents the collection of Machine Template resources within
a Provider.




The CIMI specification follows a distinctive pattern with respect to creation of new resources - the machine template is a good example of this:


machineConfiguration + machineImage = machineTemplate ===> machine



A CIMI client (a consumer in CIMI terminology) uses a Machine Template to  create a new Machine; a Machine Template consists of (amongst other attributes) a Machine Configuration and a Machine Image. Generally speaking - many CIMI resources require the use of a template for their creation and a template will typically consist of an image plus a configuration resource.


  
  



    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Machine Resources
  
  
Machine
    MachineImage
    MachineConfiguration
    MachineTemplate
  






Retrieve the Machine Template Collection
  Retrieve a single Machine Template
  Create a new Machine Template
  Delete a Machine Template

  

Retrieve the Machine Template Collection
Example request:
GET /cimi/machine_templates 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: 1275
ETag: fba471ae32eca2b58fa02644b81b73aa
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 15:04:26 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/MachineTemplateCollection">
  <id>http://localhost:3001/cimi/machine_templates</id>
  <count>2</count>
  <MachineTemplate>
    <id>http://localhost:3001/cimi/machine_templates/1</id>
    <name>myXmlTestMachineTemplate1</name>
    <description>Description of my MachineTemplate</description>
    <property key="test">value</property>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge" />
    <machineImage href="http://localhost:3001/cimi/machine_images/img3" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/1" />
  </MachineTemplate>
  <MachineTemplate>
    <id>http://localhost:3001/cimi/machine_templates/2</id>
    <name>my_template_2</name>
    <description>Description of my MachineTemplate</description>
    <property key="test">value</property>
    <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small" />
    <machineImage href="http://localhost:3001/cimi/machine_images/img1" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/2" />
  </MachineTemplate>
</Collection>

  

  

Retrieve a single Machine Template
Example request:
GET /cimi/machine_templates/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: 607
ETag: 8f720ffacb6439a6920a5f5b0ec7bbfc
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 15:06:14 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineTemplate xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/MachineTemplate">
  <id>http://localhost:3001/cimi/machine_templates/2</id>
  <name>my_template_2</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small" />
  <machineImage href="http://localhost:3001/cimi/machine_images/img1" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/machine_templates/2" />
</MachineTemplate>

  

  

Create a new Machine Template
Example request:
POST /cimi/machine_templates 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: 334

<MachineTemplateCreate>
  <name>myXmlTestMachineTemplate1</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge"/>
  <machineImage href="http://localhost:3001/cimi/machine_images/img3"/>
</MachineTemplateCreate>


Server response:
HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/machine_templates/1
CIMI-Specification-Version: 1.0.1
Content-Length: 620
ETag: e848e33fa0886e6c3d2df3cb674485d7
Cache-Control: max-age=0, private, must-revalidate
Date: Thu, 03 Jan 2013 14:48:03 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<MachineTemplate xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/MachineTemplate">
  <id>http://localhost:3001/cimi/machine_templates/1</id>
  <name>myXmlTestMachineTemplate1</name>
  <description>Description of my MachineTemplate</description>
  <property key="test">value</property>
  <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge" />
  <machineImage href="http://localhost:3001/cimi/machine_images/img3" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete" href="http://localhost:3001/cimi/machine_templates/1" />
</MachineTemplate>


  

  

Delete a Machine Template
Example request:
DELETE /cimi/machine_templates/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
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: Thu, 03 Jan 2013 15:06:38 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

  
;T;@6I""/cimi-rest/cimi-rest-volumes/;T{;{	;I"%<

  
    
    CIMI Resource Collections - Volume
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

Volume


A Volume represents storage at either the block or the file-system level. Volumes can be connected to
Machines. Once connected, Volumes can be accessed by processes on that Machine.


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



  
  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Volume Resources
  
  
Volume
    VolumeImage
    VolumeConfiguration
    VolumeTemplate
  






Retrieve the Volume Collection
  Retrieve a single Volume
  Create a Volume
  Delete a Volume

  

Retrieve the Volume Collection

Example request:
GET /cimi/volumes 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: 1521
ETag: 5e589664c1b03a34ad42ffe606bd61f1
Cache-Control: max-age=0, private, must-revalidate
 Date: Fri, 04 Jan 2013 16:43:27 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/VolumeCollection">
  <id>http://localhost:3001/cimi/volumes</id>
  <count>3</count>
  <Volume>
    <id>http://localhost:3001/cimi/volumes/vol3</id>
    <name>vol3</name>
    <description>Description of Volume</description>
    <created>2009-07-30T14:35:11Z</created>
    <state>IN-USE</state>
    <type>http://schemas.dmtf.org/cimi/1/mapped</type>
    <capacity>1048576</capacity>
    <bootable>false</bootable>
    <operation rel="delete" href="http://localhost:3001/cimi/volumes/vol3" />
  </Volume>
  <Volume>
    <id>http://localhost:3001/cimi/volumes/vol2</id>
    <name>vol2</name>
    <description>Description of Volume</description>
    <created>2009-07-30T14:35:11Z</created>
    <state>AVAILABLE</state>
    <type>http://schemas.dmtf.org/cimi/1/mapped</type>
    <capacity>1048576</capacity>
    <bootable>false</bootable>
    <operation rel="delete" href="http://localhost:3001/cimi/volumes/vol2" />
  </Volume>
  <Volume>
    <id>http://localhost:3001/cimi/volumes/vol1</id>
    <name>vol1</name>
    <description>Description of Volume</description>
    <created>2009-07-30T14:35:11Z</created>
    <state>AVAILABLE</state>
    <type>http://schemas.dmtf.org/cimi/1/mapped</type>
    <capacity>1048576</capacity>
    <bootable>false</bootable>
    <operation rel="delete" href="http://localhost:3001/cimi/volumes/vol1" />
  </Volume>
  <operation rel="add" href="http://localhost:3001/cimi/volumes" />
</Collection>


  

  

Retrieve a single Volume

Example request:
GET /cimi/volumes/vol1 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: 490
ETag: a4be42f0743b1a6efbd2ed431667e7d4
Cache-Control: max-age=0, private, must-revalidate
Date: Mon, 07 Jan 2013 13:57:46 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Volume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Volume">
  <id>http://localhost:3001/cimi/volumes/vol1</id>
  <name>vol1</name>
  <description>Description of Volume</description>
  <created>2009-07-30T14:35:11Z</created>
  <state>AVAILABLE</state>
  <type>http://schemas.dmtf.org/cimi/1/mapped</type>
  <capacity>1048576</capacity>
  <bootable>false</bootable>
  <operation rel="delete" href="http://localhost:3001/cimi/volumes/vol1" />
</Volume>




  


  

Create a Volume

Using VolumeTemplate with VolumeConfiguration by reference - Example request:
POST //cimi/volumes 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: 224

<VolumeCreate>
  <name> marios_new_volume </name>
  <description> a new volume </description>
  <volumeTemplate>
    <volumeConfig
      href="http://localhost:3001/cimi/volume_configurations/2">
    </volumeConfig>
  </volumeTemplate>
</VolumeCreate>


Server response:
HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/volumes/Volume1357567397
CIMI-Specification-Version: 1.0.1
Content-Length: 523
ETag: 56c05e34776373022cefda3c3c4467cb
Cache-Control: max-age=0, private, must-revalidate
Date: Mon, 07 Jan 2013 14:03:17 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Volume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Volume">
  <id>http://localhost:3001/cimi/volumes/Volume1357567397</id>
  <name>marios_new_volume</name>
  <description>a new volume</description>
  <created>2013-01-07T16:03:17+02:00</created>
  <state>AVAILABLE</state>
  <type>http://schemas.dmtf.org/cimi/1/mapped</type>
  <capacity>2097152</capacity>
  <bootable>false</bootable>
  <operation rel="delete" href="http://localhost:3001/cimi/volumes/Volume1357567397" />
</Volume>



Using VolumeTemplate with VolumeConfiguration by value - Example request:
POST /cimi/volumes HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
Host: localhost:3001
Accept:application/xml
Content-Type: application/xml
Content-Length: 239

<VolumeCreate>
  <name> marios_volume </name>
  <description> a new volume </description>
  <volumeTemplate>
    <volumeConfig>
      <type>http://schemas.dmtf.org/cimi/1/mapped</type>
      <capacity> 1024 </capacity>
    </volumeConfig>
  </volumeTemplate>
</VolumeCreate>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/volumes/Volume1357567628
CIMI-Specification-Version: 1.0.1
Content-Length: 516
ETag: d82624fda83c895cbeaebb08fff005c6
Cache-Control: max-age=0, private, must-revalidate
Date: Mon, 07 Jan 2013 14:07:08 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Volume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Volume">
  <id>http://localhost:3001/cimi/volumes/Volume1357567628</id>
  <name>marios_volume</name>
  <description>a new volume</description>
  <created>2013-01-07T16:07:08+02:00</created>
  <state>AVAILABLE</state>
  <type>http://schemas.dmtf.org/cimi/1/mapped</type>
  <capacity>1024</capacity>
  <bootable>false</bootable>
  <operation rel="delete" href="http://localhost:3001/cimi/volumes/Volume1357567628" />
</Volume>


  

  

Retrieve the Volume Collection

Example request:
DELETE /cimi/volumes/Volume1357567628 HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
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: Mon, 07 Jan 2013 14:16:21 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife



  



      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"�&



  

Volume


A Volume represents storage at either the block or the file-system level. Volumes can be connected to
Machines. Once connected, Volumes can be accessed by processes on that Machine.


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



  
  



  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
      ResourceMetadata
      Machine
      Volume
    
  
  
  
    Volume Resources
  
  
    Volume
    VolumeImage
    VolumeConfiguration
    VolumeTemplate
  



  




  Retrieve the Volume Collection
  Retrieve a single Volume
  Create a Volume
  Delete a Volume





  

Retrieve the Volume Collection

Example request:
GET /cimi/volumes 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: 1521
ETag: 5e589664c1b03a34ad42ffe606bd61f1
Cache-Control: max-age=0, private, must-revalidate
 Date: Fri, 04 Jan 2013 16:43:27 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/VolumeCollection">
  <id>http://localhost:3001/cimi/volumes</id>
  <count>3</count>
  <Volume>
    <id>http://localhost:3001/cimi/volumes/vol3</id>
    <name>vol3</name>
    <description>Description of Volume</description>
    <created>2009-07-30T14:35:11Z</created>
    <state>IN-USE</state>
    <type>http://schemas.dmtf.org/cimi/1/mapped</type>
    <capacity>1048576</capacity>
    <bootable>false</bootable>
    <operation rel="delete" href="http://localhost:3001/cimi/volumes/vol3" />
  </Volume>
  <Volume>
    <id>http://localhost:3001/cimi/volumes/vol2</id>
    <name>vol2</name>
    <description>Description of Volume</description>
    <created>2009-07-30T14:35:11Z</created>
    <state>AVAILABLE</state>
    <type>http://schemas.dmtf.org/cimi/1/mapped</type>
    <capacity>1048576</capacity>
    <bootable>false</bootable>
    <operation rel="delete" href="http://localhost:3001/cimi/volumes/vol2" />
  </Volume>
  <Volume>
    <id>http://localhost:3001/cimi/volumes/vol1</id>
    <name>vol1</name>
    <description>Description of Volume</description>
    <created>2009-07-30T14:35:11Z</created>
    <state>AVAILABLE</state>
    <type>http://schemas.dmtf.org/cimi/1/mapped</type>
    <capacity>1048576</capacity>
    <bootable>false</bootable>
    <operation rel="delete" href="http://localhost:3001/cimi/volumes/vol1" />
  </Volume>
  <operation rel="add" href="http://localhost:3001/cimi/volumes" />
</Collection>


  

  

Retrieve a single Volume

Example request:
GET /cimi/volumes/vol1 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: 490
ETag: a4be42f0743b1a6efbd2ed431667e7d4
Cache-Control: max-age=0, private, must-revalidate
Date: Mon, 07 Jan 2013 13:57:46 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Volume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Volume">
  <id>http://localhost:3001/cimi/volumes/vol1</id>
  <name>vol1</name>
  <description>Description of Volume</description>
  <created>2009-07-30T14:35:11Z</created>
  <state>AVAILABLE</state>
  <type>http://schemas.dmtf.org/cimi/1/mapped</type>
  <capacity>1048576</capacity>
  <bootable>false</bootable>
  <operation rel="delete" href="http://localhost:3001/cimi/volumes/vol1" />
</Volume>




  


  

Create a Volume

Using VolumeTemplate with VolumeConfiguration by reference - Example request:
POST //cimi/volumes 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: 224

<VolumeCreate>
  <name> marios_new_volume </name>
  <description> a new volume </description>
  <volumeTemplate>
    <volumeConfig
      href="http://localhost:3001/cimi/volume_configurations/2">
    </volumeConfig>
  </volumeTemplate>
</VolumeCreate>


Server response:
HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/volumes/Volume1357567397
CIMI-Specification-Version: 1.0.1
Content-Length: 523
ETag: 56c05e34776373022cefda3c3c4467cb
Cache-Control: max-age=0, private, must-revalidate
Date: Mon, 07 Jan 2013 14:03:17 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Volume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Volume">
  <id>http://localhost:3001/cimi/volumes/Volume1357567397</id>
  <name>marios_new_volume</name>
  <description>a new volume</description>
  <created>2013-01-07T16:03:17+02:00</created>
  <state>AVAILABLE</state>
  <type>http://schemas.dmtf.org/cimi/1/mapped</type>
  <capacity>2097152</capacity>
  <bootable>false</bootable>
  <operation rel="delete" href="http://localhost:3001/cimi/volumes/Volume1357567397" />
</Volume>




Using VolumeTemplate with VolumeConfiguration by value - Example request:
POST /cimi/volumes HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
Host: localhost:3001
Accept:application/xml
Content-Type: application/xml
Content-Length: 239

<VolumeCreate>
  <name> marios_volume </name>
  <description> a new volume </description>
  <volumeTemplate>
    <volumeConfig>
      <type>http://schemas.dmtf.org/cimi/1/mapped</type>
      <capacity> 1024 </capacity>
    </volumeConfig>
  </volumeTemplate>
</VolumeCreate>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/volumes/Volume1357567628
CIMI-Specification-Version: 1.0.1
Content-Length: 516
ETag: d82624fda83c895cbeaebb08fff005c6
Cache-Control: max-age=0, private, must-revalidate
Date: Mon, 07 Jan 2013 14:07:08 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Volume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Volume">
  <id>http://localhost:3001/cimi/volumes/Volume1357567628</id>
  <name>marios_volume</name>
  <description>a new volume</description>
  <created>2013-01-07T16:07:08+02:00</created>
  <state>AVAILABLE</state>
  <type>http://schemas.dmtf.org/cimi/1/mapped</type>
  <capacity>1024</capacity>
  <bootable>false</bootable>
  <operation rel="delete" href="http://localhost:3001/cimi/volumes/Volume1357567628" />
</Volume>


  

  

Retrieve the Volume Collection

Example request:
DELETE /cimi/volumes/Volume1357567628 HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
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: Mon, 07 Jan 2013 14:16:21 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife



  

;T;
I"�&



  

Volume


A Volume represents storage at either the block or the file-system level. Volumes can be connected to
Machines. Once connected, Volumes can be accessed by processes on that Machine.


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



  
  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Volume Resources
  
  
Volume
    VolumeImage
    VolumeConfiguration
    VolumeTemplate
  






Retrieve the Volume Collection
  Retrieve a single Volume
  Create a Volume
  Delete a Volume

  

Retrieve the Volume Collection

Example request:
GET /cimi/volumes 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: 1521
ETag: 5e589664c1b03a34ad42ffe606bd61f1
Cache-Control: max-age=0, private, must-revalidate
 Date: Fri, 04 Jan 2013 16:43:27 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/VolumeCollection">
  <id>http://localhost:3001/cimi/volumes</id>
  <count>3</count>
  <Volume>
    <id>http://localhost:3001/cimi/volumes/vol3</id>
    <name>vol3</name>
    <description>Description of Volume</description>
    <created>2009-07-30T14:35:11Z</created>
    <state>IN-USE</state>
    <type>http://schemas.dmtf.org/cimi/1/mapped</type>
    <capacity>1048576</capacity>
    <bootable>false</bootable>
    <operation rel="delete" href="http://localhost:3001/cimi/volumes/vol3" />
  </Volume>
  <Volume>
    <id>http://localhost:3001/cimi/volumes/vol2</id>
    <name>vol2</name>
    <description>Description of Volume</description>
    <created>2009-07-30T14:35:11Z</created>
    <state>AVAILABLE</state>
    <type>http://schemas.dmtf.org/cimi/1/mapped</type>
    <capacity>1048576</capacity>
    <bootable>false</bootable>
    <operation rel="delete" href="http://localhost:3001/cimi/volumes/vol2" />
  </Volume>
  <Volume>
    <id>http://localhost:3001/cimi/volumes/vol1</id>
    <name>vol1</name>
    <description>Description of Volume</description>
    <created>2009-07-30T14:35:11Z</created>
    <state>AVAILABLE</state>
    <type>http://schemas.dmtf.org/cimi/1/mapped</type>
    <capacity>1048576</capacity>
    <bootable>false</bootable>
    <operation rel="delete" href="http://localhost:3001/cimi/volumes/vol1" />
  </Volume>
  <operation rel="add" href="http://localhost:3001/cimi/volumes" />
</Collection>


  

  

Retrieve a single Volume

Example request:
GET /cimi/volumes/vol1 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: 490
ETag: a4be42f0743b1a6efbd2ed431667e7d4
Cache-Control: max-age=0, private, must-revalidate
Date: Mon, 07 Jan 2013 13:57:46 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Volume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Volume">
  <id>http://localhost:3001/cimi/volumes/vol1</id>
  <name>vol1</name>
  <description>Description of Volume</description>
  <created>2009-07-30T14:35:11Z</created>
  <state>AVAILABLE</state>
  <type>http://schemas.dmtf.org/cimi/1/mapped</type>
  <capacity>1048576</capacity>
  <bootable>false</bootable>
  <operation rel="delete" href="http://localhost:3001/cimi/volumes/vol1" />
</Volume>




  


  

Create a Volume

Using VolumeTemplate with VolumeConfiguration by reference - Example request:
POST //cimi/volumes 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: 224

<VolumeCreate>
  <name> marios_new_volume </name>
  <description> a new volume </description>
  <volumeTemplate>
    <volumeConfig
      href="http://localhost:3001/cimi/volume_configurations/2">
    </volumeConfig>
  </volumeTemplate>
</VolumeCreate>


Server response:
HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/volumes/Volume1357567397
CIMI-Specification-Version: 1.0.1
Content-Length: 523
ETag: 56c05e34776373022cefda3c3c4467cb
Cache-Control: max-age=0, private, must-revalidate
Date: Mon, 07 Jan 2013 14:03:17 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Volume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Volume">
  <id>http://localhost:3001/cimi/volumes/Volume1357567397</id>
  <name>marios_new_volume</name>
  <description>a new volume</description>
  <created>2013-01-07T16:03:17+02:00</created>
  <state>AVAILABLE</state>
  <type>http://schemas.dmtf.org/cimi/1/mapped</type>
  <capacity>2097152</capacity>
  <bootable>false</bootable>
  <operation rel="delete" href="http://localhost:3001/cimi/volumes/Volume1357567397" />
</Volume>



Using VolumeTemplate with VolumeConfiguration by value - Example request:
POST /cimi/volumes HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
Host: localhost:3001
Accept:application/xml
Content-Type: application/xml
Content-Length: 239

<VolumeCreate>
  <name> marios_volume </name>
  <description> a new volume </description>
  <volumeTemplate>
    <volumeConfig>
      <type>http://schemas.dmtf.org/cimi/1/mapped</type>
      <capacity> 1024 </capacity>
    </volumeConfig>
  </volumeTemplate>
</VolumeCreate>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/volumes/Volume1357567628
CIMI-Specification-Version: 1.0.1
Content-Length: 516
ETag: d82624fda83c895cbeaebb08fff005c6
Cache-Control: max-age=0, private, must-revalidate
Date: Mon, 07 Jan 2013 14:07:08 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<Volume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Volume">
  <id>http://localhost:3001/cimi/volumes/Volume1357567628</id>
  <name>marios_volume</name>
  <description>a new volume</description>
  <created>2013-01-07T16:07:08+02:00</created>
  <state>AVAILABLE</state>
  <type>http://schemas.dmtf.org/cimi/1/mapped</type>
  <capacity>1024</capacity>
  <bootable>false</bootable>
  <operation rel="delete" href="http://localhost:3001/cimi/volumes/Volume1357567628" />
</Volume>


  

  

Retrieve the Volume Collection

Example request:
DELETE /cimi/volumes/Volume1357567628 HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
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: Mon, 07 Jan 2013 14:16:21 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife



  

;T;@

  
    
    CIMI Resource Collections - Volume Image
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

Volume Image


This resource represents an image that could be placed on a pre-loaded volume.



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



  
  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Volume Resources
  
  
Volume
    VolumeImage
    VolumeConfiguration
    VolumeTemplate
  






Retrieve the Volume Image Collection
  Retrieve a single Volume Image
  Create a Volume Image
  Delete a Volume Image


  

Retrieve the Volume Image Collection

Example request:

GET /cimi/volume_images 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: 1095
ETag: ae3be87f858bb7c9b1000e5409c497f9
Cache-Control: max-age=0, private, must-revalidate
Date: Mon, 07 Jan 2013 15:18:00 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/VolumeImageCollection">
  <id>http://localhost:3001/cimi/volume_images</id>
  <count>3</count>
  <VolumeImage>
    <id>http://localhost:3001/cimi/volume_images/snap1</id>
    <name>snap1</name>
    <description>snap1</description>
    <created>2009-07-29T18:15:24Z</created>
    <imageLocation href="http://localhost:3001/cimi/volumes/vol1" />
    <bootable>false</bootable>
  </VolumeImage>
  <VolumeImage>
    <id>http://localhost:3001/cimi/volume_images/snap3</id>
    <name>snap3</name>
    <description>snap3</description>
    <created>2009-07-29T18:15:24Z</created>
    <imageLocation href="http://localhost:3001/cimi/volumes/vol2" />
    <bootable>false</bootable>
  </VolumeImage>
  <VolumeImage>
    <id>http://localhost:3001/cimi/volume_images/snap2</id>
    <name>snap2</name>
    <description>snap2</description>
    <created>2009-07-29T18:15:24Z</created>
    <imageLocation href="http://localhost:3001/cimi/volumes/vol2" />
    <bootable>false</bootable>
  </VolumeImage>
</Collection>


  


  

Retrieve a single Volume Image

Example request:

GET /cimi/volume_images/snap2 HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
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: 377
ETag: 134b5cae11297fd59b2a783a0ee430ed
Cache-Control: max-age=0, private, must-revalidate
Date: Tue, 08 Jan 2013 13:40:54 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeImage xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/VolumeImage">
  <id>http://localhost:3001/cimi/volume_images/snap1</id>
  <name>snap1</name>
  <description>snap1</description>
  <created>2009-07-29T18:15:24Z</created>
  <imageLocation href="http://localhost:3001/cimi/volumes/vol1" />
  <bootable>false</bootable>
</VolumeImage>


  

  

Create a Volume Image

A new Volume Image can be created from an existing Volume, by referencing the Volume
resource with the imageLocation attribute in the message body. This is illustrated in
the example below.

Example request:

POST /cimi/volume_images HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
Host: localhost:3001
Content-Type: application/xml
Accept: application/xml
Content-Length: 210

<VolumeImage xmlns="http://schemas.dmtf.org/cimi/1">
  <name> my_vol_image </name>
  <description> marios first volume image </description>
  <imageLocation href="http://localhost:3001/cimi/volumes/vol1"/>
</VolumeImage>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/volume_images/store_snapshot_1357663577
CIMI-Specification-Version: 1.0.1
Content-Length: 429
ETag: 5d4bdca8ed98295d1c463012bb8ff427
Cache-Control: max-age=0, private, must-revalidate
Date: Tue, 08 Jan 2013 16:46:17 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeImage xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/VolumeImage">
  <id>http://localhost:3001/cimi/volume_images/store_snapshot_1357663577</id>
  <name>my_vol_image</name>
  <description>marios first volume image</description>
  <created>2013-01-08T18:46:17+02:00</created>
  <imageLocation href="http://localhost:3001/cimi/volumes/vol1" />
  <bootable>false</bootable>
</VolumeImage>


  

  

Delete a Volume Image

Example request:

DELETE /cimi/volume_images/snap1 HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
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: Wed, 09 Jan 2013 15:45:32 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife


  



      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"�



  

Volume Image


This resource represents an image that could be placed on a pre-loaded volume.




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



  
  



  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
      ResourceMetadata
      Machine
      Volume
    
  
  
  
    Volume Resources
  
  
    Volume
    VolumeImage
    VolumeConfiguration
    VolumeTemplate
  



  




  Retrieve the Volume Image Collection
  Retrieve a single Volume Image
  Create a Volume Image
  Delete a Volume Image






  

Retrieve the Volume Image Collection

Example request:

GET /cimi/volume_images 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: 1095
ETag: ae3be87f858bb7c9b1000e5409c497f9
Cache-Control: max-age=0, private, must-revalidate
Date: Mon, 07 Jan 2013 15:18:00 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/VolumeImageCollection">
  <id>http://localhost:3001/cimi/volume_images</id>
  <count>3</count>
  <VolumeImage>
    <id>http://localhost:3001/cimi/volume_images/snap1</id>
    <name>snap1</name>
    <description>snap1</description>
    <created>2009-07-29T18:15:24Z</created>
    <imageLocation href="http://localhost:3001/cimi/volumes/vol1" />
    <bootable>false</bootable>
  </VolumeImage>
  <VolumeImage>
    <id>http://localhost:3001/cimi/volume_images/snap3</id>
    <name>snap3</name>
    <description>snap3</description>
    <created>2009-07-29T18:15:24Z</created>
    <imageLocation href="http://localhost:3001/cimi/volumes/vol2" />
    <bootable>false</bootable>
  </VolumeImage>
  <VolumeImage>
    <id>http://localhost:3001/cimi/volume_images/snap2</id>
    <name>snap2</name>
    <description>snap2</description>
    <created>2009-07-29T18:15:24Z</created>
    <imageLocation href="http://localhost:3001/cimi/volumes/vol2" />
    <bootable>false</bootable>
  </VolumeImage>
</Collection>


  


  

Retrieve a single Volume Image

Example request:

GET /cimi/volume_images/snap2 HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
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: 377
ETag: 134b5cae11297fd59b2a783a0ee430ed
Cache-Control: max-age=0, private, must-revalidate
Date: Tue, 08 Jan 2013 13:40:54 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeImage xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/VolumeImage">
  <id>http://localhost:3001/cimi/volume_images/snap1</id>
  <name>snap1</name>
  <description>snap1</description>
  <created>2009-07-29T18:15:24Z</created>
  <imageLocation href="http://localhost:3001/cimi/volumes/vol1" />
  <bootable>false</bootable>
</VolumeImage>


  

  

Create a Volume Image

A new Volume Image can be created from an existing Volume, by referencing the Volume
resource with the imageLocation attribute in the message body. This is illustrated in
the example below.

Example request:

POST /cimi/volume_images HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
Host: localhost:3001
Content-Type: application/xml
Accept: application/xml
Content-Length: 210

<VolumeImage xmlns="http://schemas.dmtf.org/cimi/1">
  <name> my_vol_image </name>
  <description> marios first volume image </description>
  <imageLocation href="http://localhost:3001/cimi/volumes/vol1"/>
</VolumeImage>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/volume_images/store_snapshot_1357663577
CIMI-Specification-Version: 1.0.1
Content-Length: 429
ETag: 5d4bdca8ed98295d1c463012bb8ff427
Cache-Control: max-age=0, private, must-revalidate
Date: Tue, 08 Jan 2013 16:46:17 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeImage xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/VolumeImage">
  <id>http://localhost:3001/cimi/volume_images/store_snapshot_1357663577</id>
  <name>my_vol_image</name>
  <description>marios first volume image</description>
  <created>2013-01-08T18:46:17+02:00</created>
  <imageLocation href="http://localhost:3001/cimi/volumes/vol1" />
  <bootable>false</bootable>
</VolumeImage>


  

  

Delete a Volume Image

Example request:

DELETE /cimi/volume_images/snap1 HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
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: Wed, 09 Jan 2013 15:45:32 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife


  

;T;
I"w



  

Volume Image


This resource represents an image that could be placed on a pre-loaded volume.



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



  
  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Volume Resources
  
  
Volume
    VolumeImage
    VolumeConfiguration
    VolumeTemplate
  






Retrieve the Volume Image Collection
  Retrieve a single Volume Image
  Create a Volume Image
  Delete a Volume Image


  

Retrieve the Volume Image Collection

Example request:

GET /cimi/volume_images 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: 1095
ETag: ae3be87f858bb7c9b1000e5409c497f9
Cache-Control: max-age=0, private, must-revalidate
Date: Mon, 07 Jan 2013 15:18:00 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/VolumeImageCollection">
  <id>http://localhost:3001/cimi/volume_images</id>
  <count>3</count>
  <VolumeImage>
    <id>http://localhost:3001/cimi/volume_images/snap1</id>
    <name>snap1</name>
    <description>snap1</description>
    <created>2009-07-29T18:15:24Z</created>
    <imageLocation href="http://localhost:3001/cimi/volumes/vol1" />
    <bootable>false</bootable>
  </VolumeImage>
  <VolumeImage>
    <id>http://localhost:3001/cimi/volume_images/snap3</id>
    <name>snap3</name>
    <description>snap3</description>
    <created>2009-07-29T18:15:24Z</created>
    <imageLocation href="http://localhost:3001/cimi/volumes/vol2" />
    <bootable>false</bootable>
  </VolumeImage>
  <VolumeImage>
    <id>http://localhost:3001/cimi/volume_images/snap2</id>
    <name>snap2</name>
    <description>snap2</description>
    <created>2009-07-29T18:15:24Z</created>
    <imageLocation href="http://localhost:3001/cimi/volumes/vol2" />
    <bootable>false</bootable>
  </VolumeImage>
</Collection>


  


  

Retrieve a single Volume Image

Example request:

GET /cimi/volume_images/snap2 HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
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: 377
ETag: 134b5cae11297fd59b2a783a0ee430ed
Cache-Control: max-age=0, private, must-revalidate
Date: Tue, 08 Jan 2013 13:40:54 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeImage xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/VolumeImage">
  <id>http://localhost:3001/cimi/volume_images/snap1</id>
  <name>snap1</name>
  <description>snap1</description>
  <created>2009-07-29T18:15:24Z</created>
  <imageLocation href="http://localhost:3001/cimi/volumes/vol1" />
  <bootable>false</bootable>
</VolumeImage>


  

  

Create a Volume Image

A new Volume Image can be created from an existing Volume, by referencing the Volume
resource with the imageLocation attribute in the message body. This is illustrated in
the example below.

Example request:

POST /cimi/volume_images HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
Host: localhost:3001
Content-Type: application/xml
Accept: application/xml
Content-Length: 210

<VolumeImage xmlns="http://schemas.dmtf.org/cimi/1">
  <name> my_vol_image </name>
  <description> marios first volume image </description>
  <imageLocation href="http://localhost:3001/cimi/volumes/vol1"/>
</VolumeImage>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/volume_images/store_snapshot_1357663577
CIMI-Specification-Version: 1.0.1
Content-Length: 429
ETag: 5d4bdca8ed98295d1c463012bb8ff427
Cache-Control: max-age=0, private, must-revalidate
Date: Tue, 08 Jan 2013 16:46:17 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeImage xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/VolumeImage">
  <id>http://localhost:3001/cimi/volume_images/store_snapshot_1357663577</id>
  <name>my_vol_image</name>
  <description>marios first volume image</description>
  <created>2013-01-08T18:46:17+02:00</created>
  <imageLocation href="http://localhost:3001/cimi/volumes/vol1" />
  <bootable>false</bootable>
</VolumeImage>


  

  

Delete a Volume Image

Example request:

DELETE /cimi/volume_images/snap1 HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
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: Wed, 09 Jan 2013 15:45:32 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife


  

;T;@BI")/cimi-rest/cimi-rest-volume-configs/;T{;{	;I"�2

  
    
    CIMI Resource Collections - Volume Configuration
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

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.



  
  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
Resource Metadata
      Machine
      Volume
    

  

    Volume Resources
  
  
Volume
    VolumeImage
    VolumeConfiguration
    VolumeTemplate
  






Retrieve the Volume Configuration Collection
  Retrieve a single Volume Configuration
  Create a Volume Configuration
  Delete a Volume Configuration


  

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

  



      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"i



  

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.



  
  



  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
      Resource Metadata
      Machine
      Volume
    
  
  
  
    Volume Resources
  
  
    Volume
    VolumeImage
    VolumeConfiguration
    VolumeTemplate
  



  





  Retrieve the Volume Configuration Collection
  Retrieve a single Volume Configuration
  Create a Volume Configuration
  Delete a Volume Configuration






  

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

  

;T;
I"�



  

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.



  
  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
Resource Metadata
      Machine
      Volume
    

  

    Volume Resources
  
  
Volume
    VolumeImage
    VolumeConfiguration
    VolumeTemplate
  






Retrieve the Volume Configuration Collection
  Retrieve a single Volume Configuration
  Create a Volume Configuration
  Delete a Volume Configuration


  

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

  

;T;@HI"+/cimi-rest/cimi-rest-volume-templates/;T{;{	;I"A3

  
    
    CIMI Resource Collections - Volume Template
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

Volume Template


This resource captures the configuration values for realizing a Volume. A Volume Template may be used
to create multiple Volumes.



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



The Volume Template in another example of the template pattern used by CIMI, as explained in the introduction of the Machine Template resource. That is, in general, CIMI a resource is instantiated with the use of a template and a template itself usually consists of an image and a configuration.
  
  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Volume Resources
  
  
Volume
    VolumeImage
    VolumeConfiguration
    VolumeTemplate
  






Retrieve the Volume Template Collection
  Retrieve a single Volume Template
  Create a Volume Template
  Delete a Volume Template



  

Retrieve the Volume Template Collection

Example request:

GET /cimi/volume_templates 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: 1045
ETag: 3ca6eecb1450ebe3a9fa6714bff542c1
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 11 Jan 2013 13:02:47 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/VolumeTemplateCollection">
  <id>http://localhost:3001/cimi/volume_templates</id>
  <count>2</count>
  <VolumeTemplate>
    <id>http://localhost:3001/cimi/volume_templates/3</id>
    <name>marios_vol_template</name>
    <description>my first volume template</description>
    <volumeConfig href="http://localhost:3001/cimi/volume_configs/1" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_templates/3" />
  </VolumeTemplate>
  <VolumeTemplate>
    <id>http://localhost:3001/cimi/volume_templates/4</id>
    <name>YAVT</name>
    <description>yet another volume template</description>
    <volumeConfig href="http://localhost:3001/cimi/volume_configs/6" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_templates/4" />
  </VolumeTemplate>
  <operation rel="add" href="http://localhost:3001/cimi/volume_templates" />
</Collection>


  

  

Retrieve a single Volume Template

Example request:

GET /cimi/volume_templates/3 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: 470
ETag: a527b1170f798affc88a0ea0fa4ede7a
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 11 Jan 2013 13:05:42 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeTemplate">
  <id>http://localhost:3001/cimi/volume_templates/3</id>
  <name>marios_vol_template</name>
  <description>my first volume template</description>
  <volumeConfig href="http://localhost:3001/cimi/volume_configs/1" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_templates/3" />
</VolumeTemplate>


  
  

Create a Volume Template

Example request:

POST /cimi/volume_templates 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: 232

<VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1">
  <name> YAVT </name>
  <description> yet another volume template </description>
  <volumeConfig href="http://localhost:3001/cimi/volume_configs/6"> </volumeConfig>
</VolumeTemplate>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/volume_templates/5
CIMI-Specification-Version: 1.0.1
Content-Length: 458
ETag: 66d7d08c49a5e81923ac124d71af50ad
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 11 Jan 2013 13:07:00 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeTemplate">
  <id>http://localhost:3001/cimi/volume_templates/5</id>
  <name>YAVT</name>
  <description>yet another volume template</description>
  <volumeConfig href="http://localhost:3001/cimi/volume_configs/6" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_templates/5" />
</VolumeTemplate>


  
  

Delete a Volume Template

Example request:

DELETE /cimi/volume_templates/5 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:07:34 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife


  


      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"



  

Volume Template


This resource captures the configuration values for realizing a Volume. A Volume Template may be used
to create multiple Volumes.




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



The Volume Template in another example of the template pattern used by CIMI, as explained in the introduction of the Machine Template resource. That is, in general, CIMI a resource is instantiated with the use of a template and a template itself usually consists of an image and a configuration.
  
  



  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
      ResourceMetadata
      Machine
      Volume
    
  
  
  
    Volume Resources
  
  
    Volume
    VolumeImage
    VolumeConfiguration
    VolumeTemplate
  



  




  Retrieve the Volume Template Collection
  Retrieve a single Volume Template
  Create a Volume Template
  Delete a Volume Template







  

Retrieve the Volume Template Collection

Example request:

GET /cimi/volume_templates 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: 1045
ETag: 3ca6eecb1450ebe3a9fa6714bff542c1
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 11 Jan 2013 13:02:47 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/VolumeTemplateCollection">
  <id>http://localhost:3001/cimi/volume_templates</id>
  <count>2</count>
  <VolumeTemplate>
    <id>http://localhost:3001/cimi/volume_templates/3</id>
    <name>marios_vol_template</name>
    <description>my first volume template</description>
    <volumeConfig href="http://localhost:3001/cimi/volume_configs/1" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_templates/3" />
  </VolumeTemplate>
  <VolumeTemplate>
    <id>http://localhost:3001/cimi/volume_templates/4</id>
    <name>YAVT</name>
    <description>yet another volume template</description>
    <volumeConfig href="http://localhost:3001/cimi/volume_configs/6" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_templates/4" />
  </VolumeTemplate>
  <operation rel="add" href="http://localhost:3001/cimi/volume_templates" />
</Collection>


  

  

Retrieve a single Volume Template

Example request:

GET /cimi/volume_templates/3 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: 470
ETag: a527b1170f798affc88a0ea0fa4ede7a
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 11 Jan 2013 13:05:42 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeTemplate">
  <id>http://localhost:3001/cimi/volume_templates/3</id>
  <name>marios_vol_template</name>
  <description>my first volume template</description>
  <volumeConfig href="http://localhost:3001/cimi/volume_configs/1" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_templates/3" />
</VolumeTemplate>


  
  

Create a Volume Template

Example request:

POST /cimi/volume_templates 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: 232

<VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1">
  <name> YAVT </name>
  <description> yet another volume template </description>
  <volumeConfig href="http://localhost:3001/cimi/volume_configs/6"> </volumeConfig>
</VolumeTemplate>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/volume_templates/5
CIMI-Specification-Version: 1.0.1
Content-Length: 458
ETag: 66d7d08c49a5e81923ac124d71af50ad
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 11 Jan 2013 13:07:00 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeTemplate">
  <id>http://localhost:3001/cimi/volume_templates/5</id>
  <name>YAVT</name>
  <description>yet another volume template</description>
  <volumeConfig href="http://localhost:3001/cimi/volume_configs/6" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_templates/5" />
</VolumeTemplate>


  
  

Delete a Volume Template

Example request:

DELETE /cimi/volume_templates/5 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:07:34 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife


  
;T;
I"�



  

Volume Template


This resource captures the configuration values for realizing a Volume. A Volume Template may be used
to create multiple Volumes.



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



The Volume Template in another example of the template pattern used by CIMI, as explained in the introduction of the Machine Template resource. That is, in general, CIMI a resource is instantiated with the use of a template and a template itself usually consists of an image and a configuration.
  
  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Volume Resources
  
  
Volume
    VolumeImage
    VolumeConfiguration
    VolumeTemplate
  






Retrieve the Volume Template Collection
  Retrieve a single Volume Template
  Create a Volume Template
  Delete a Volume Template



  

Retrieve the Volume Template Collection

Example request:

GET /cimi/volume_templates 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: 1045
ETag: 3ca6eecb1450ebe3a9fa6714bff542c1
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 11 Jan 2013 13:02:47 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/VolumeTemplateCollection">
  <id>http://localhost:3001/cimi/volume_templates</id>
  <count>2</count>
  <VolumeTemplate>
    <id>http://localhost:3001/cimi/volume_templates/3</id>
    <name>marios_vol_template</name>
    <description>my first volume template</description>
    <volumeConfig href="http://localhost:3001/cimi/volume_configs/1" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_templates/3" />
  </VolumeTemplate>
  <VolumeTemplate>
    <id>http://localhost:3001/cimi/volume_templates/4</id>
    <name>YAVT</name>
    <description>yet another volume template</description>
    <volumeConfig href="http://localhost:3001/cimi/volume_configs/6" />
    <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_templates/4" />
  </VolumeTemplate>
  <operation rel="add" href="http://localhost:3001/cimi/volume_templates" />
</Collection>


  

  

Retrieve a single Volume Template

Example request:

GET /cimi/volume_templates/3 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: 470
ETag: a527b1170f798affc88a0ea0fa4ede7a
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 11 Jan 2013 13:05:42 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeTemplate">
  <id>http://localhost:3001/cimi/volume_templates/3</id>
  <name>marios_vol_template</name>
  <description>my first volume template</description>
  <volumeConfig href="http://localhost:3001/cimi/volume_configs/1" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_templates/3" />
</VolumeTemplate>


  
  

Create a Volume Template

Example request:

POST /cimi/volume_templates 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: 232

<VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1">
  <name> YAVT </name>
  <description> yet another volume template </description>
  <volumeConfig href="http://localhost:3001/cimi/volume_configs/6"> </volumeConfig>
</VolumeTemplate>


Server response:

HTTP/1.1 201 Created
Content-Type: application/xml
Location: http://localhost:3001/cimi/volume_templates/5
CIMI-Specification-Version: 1.0.1
Content-Length: 458
ETag: 66d7d08c49a5e81923ac124d71af50ad
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 11 Jan 2013 13:07:00 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife

<VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1"
          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeTemplate">
  <id>http://localhost:3001/cimi/volume_templates/5</id>
  <name>YAVT</name>
  <description>yet another volume template</description>
  <volumeConfig href="http://localhost:3001/cimi/volume_configs/6" />
  <operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
          href="http://localhost:3001/cimi/volume_templates/5" />
</VolumeTemplate>


  
  

Delete a Volume Template

Example request:

DELETE /cimi/volume_templates/5 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:07:34 GMT
Connection: keep-alive
Server: thin 1.5.0 codename Knife


  
;T;@NI",/cimi-rest/cimi-rest-resource-metadata/;T{;{	;I"�I

  
    
    CIMI Resource Collections - Resource Metadata
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      



  

Resource Metadata


ResourceMetadata may be used to:

Express constraints on the existing CIMI defined resource attributes (e.g., express a maximum for
the 'cpu' attribute of the MachineConfiguration resource) 
 Introduce new attributes for CIMI defined resources together with any constraints governing these
(e.g., a new 'location' attribute for the Volume resource that takes values from a defined set of strings)
 Introduce new operations for any of the CIMI defined resources (e.g., define a new 'compress'
operation for the Volume resource)
 Express any Provider specific capabilities or features (e.g., the length of time that a Job resource
will be retained after Job completion and before this is deleted)


Implementations of this specification should allow for Consumers to discover the metadata associated
with each supported resource. Doing so allows for the discovery of Provider defined constraints on the
CIMI defined attributes as well as discovery of any new extension attributes or operations that the
Provider may have defined. ResourceMetadata can also be used to express any Provider specific
capabilities or features. The mechanism by which this metadata is made available will be protocol
specific.



  
  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Resource Metadata
  







Retrieve the ResourceMetadata Collection
  ResourceMetadata Capabilities

  

Retrieve the ResourceMetadata Collection

Example request:

GET /cimi/resource_metadata HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
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: 1675
ETag: 97a131617573093b156505f77202bf57
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 11 Jan 2013 15:29:14 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/ResourceMetadataCollection">
  <id>http://localhost:3001/cimi/resource_metadata</id>
  <count>2</count>
  <ResourceMetadata>
    <id>http://localhost:3001/cimi/resource_metadata/cloud_entry_point</id>
    <name>CloudEntryPoint</name>
    <typeUri>http://schemas.dmtf.org/cimi/1/CloudEntryPoint</typeUri>
    <attribute name="driver" namespace="http://deltacloud.org/cimi/CloudEntryPoint/driver"
          type="text" required="true" />
    <attribute name="provider" namespace="http://deltacloud.org/cimi/CloudEntryPoint/provider"
          type="text" required="true" />
  </ResourceMetadata>
  <ResourceMetadata>
    <id>http://localhost:3001/cimi/resource_metadata/machine</id>
    <name>Machine</name>
    <typeUri>http://schemas.dmtf.org/cimi/1/Machine</typeUri>
    <attribute name="realm" namespace="http://deltacloud.org/cimi/Machine/realm"
           type="text" required="false">
      <constraint>
        <value>us</value>
      </constraint>
      <constraint>
        <value>eu</value>
      </constraint>
    </attribute>
    <attribute name="machine_image"
          namespace="http://deltacloud.org/cimi/Machine/machine_image" type="URI"
          required="false" />
    <capability name="DefaultInitialState"
          uri="http://schemas.dmtf.org/cimi/1/capability/Machine/DefaultInitialState"
          description="Indicates what the default initial state of a new Machine ">
          STARTED
    </capability>
    <capability name="InitialStates"
          uri="http://schemas.dmtf.org/cimi/1/capability/Machine/InitialStates"
          description="Indicates the list of allowable initial states">
          STARTED,STOPPED
    </capability>
  </ResourceMetadata>
</Collection>


  

  

ResourceMetadata Capabilities



The following table describes the capability URIs defined by this specification. Providers may define new
URIs and it is recommended that these URIs be dereferencable such that Consumers can discover the
details of the new capability. The "Resource Name" column contains the name of the resource that may
contain the specified capability within its ResourceMetadata. The "Capability Name" column contains the
name of the specified capability and shall be unique within the scope of the corresponding resource. Each
capability's URI shall be constructed by appending the "Resource Name", a slash(/), and the "Capability
Name" to "http://schemas.dmtf.org/cimi/1/capability/". For example, the Machine's "InitialState" capability
would have a URI of:

 http://schemas.dmtf.org/cimi/1/capability/Machine/InitialState 


Note that capabilities that apply to the Provider in general, and are not specific to any one resource, are
associated with the Cloud Entry Point resource (in case a capability would apply only to the
CloudEntryPoint resource itself, its definition would say so).






        Resource Name
      
      
        Capability Name
      
      
        Description
      
    


CloudEntryPoint  
      ExpandParameter  
       Indicated whether the $expand query parameter is
supported by the Provider.

    

CloudEntryPoint
 
      FilterParameter
 
      Indicates whether the $filter query parameter is
supported by the Provider.
 
    

CloudEntryPoint
 
      firstParameter
 
      Indicates whether the $first and $last query parameters
are supported by the Provider. Note that either both
shall be supported or neither shall be supported.
 
    

CloudEntryPoint
 
      SelectParameter
 
      Indicated whether the $select query parameter is
supported by the Provider.
 
    

System
 
      SystemComponentTemplateByValue
 
      Indicates that the Provider supports specifying
Component Templates by-value in SystemTemplates.
 
    

Machine
 
      DefaultInitialState
 
      Indicates what the default initial state of a new Machine
will be unless explicitly set by the "initialState" attribute
 
    

Machine
 
      InitialStates
 
      Indicates the list of allowable initial states that
Consumer may choose from when creating a new
Machine.
 
    

Machine
 
      MachineConfigByValue
 
      Indicates that the Provider supports specifying Machine
Configurations by-value in Machine create operations. If
true the MachineTemplateByValue capability shall also
be specified with a value of true.
 
    

Machine
 
      MachineCredentialByValue
 
      Indicates that the Provider supports specifying
Credential by-value in Machine create operations. If true
the MachineTemplateByValue capability shall also be
specified with a value of true.
 
    

Machine
 
      MachineImageByValue
 
      Indicates that the Provider supports specifying Machine
Images by-value in Machine create operations. If true
the MachineTemplateByValue capability shall also be
specified with a value of true.
 
    

Machine
 
      MachineVolumeTemplatesByValue
 
      Indicates that the Provider supports specifying
VolumeTemplates by-value in Machine create
operations. If true the MachineTemplateByValue
capability shall also be specified with a value of true.
 
    

Machine
 
      MachineStopForce
 
      Indicates that the Provider supports specifying the
"force" option on the stop and restart operations.
 
    

Machine
 
      MachineStopForceDefault
 
      Indicates the default way in which the Provider will
stop/restart a Machine. When set to "true", the Provider
will forcefully stop the Machine, as opposed to a value
of "false," which indicates that the Provider will attempt
to gracefully stop the Machine.
 
    

Machine
 
      RestoreFromImage
 
      Indicates that the Provider supports restoring Machines
from Machine Images that are not SNAPSHOT Machine
Images.
 
    

Machine
 
      UserData
 
      Indicates which userData injection method will be used.
See 5.14.1 for more information.
 
    

Credential
 
      CredentialTemplateByValue
 
      Indicates that the Provider supports specifying
Credential Templates by-value in Credential create
operations.
 
    

Volume
 
      SharedVolumeSupport
 
      Indicates that the Provider supports the sharing of
volume resources across Machines. The value specified
is of type "boolean."
 
    

Volume
 
      VolumeConfigByValue
 
      Indicates that the Provider supports specifying Volume
Configurations by-value in the Volume create operation.
If true, the VolumeTemplateByValue capability shall
also be specified with a value of true.
 
    

Volume
 
      VolumeImageByValue
 
      Indicates that the Provider supports specifying Volume
Images by-value in the Volume create operation. If true
the VolumeTemplateByValue capability shall also be
specified with a value of true.
 
    

Volume
 
      VolumeSnapshot
 
      Indicates that the Provider supports creating a new
VolumeImage by referencing an existing Volume.
 
    

Volume
 
      VolumeTemplateByValue
 
      Indicates that the Provider supports specifying Volume
Templates by-value in Volume create operations.
 
    

Network
 
      NetworkConfigByValue
 
      Indicates that the Provider supports specifying Network
Configurations by-value in the Network create
operation.
 
    

Network
 
      NetworkTemplateByValue
 
      Indicates that the Provider supports specifying Network
Templates by-value in the Network create operation.
 
    

NetworkPort
 
      NetworkPortConfigByValue
 
      Indicates that the Provider supports specifying
NetworkPort Configurations by-value in the NetworkPort
create operation.
 
    

NetworkPort
 
      NetworkPortTemplateByValue
 
      Indicates that the Provider supports specifying
NetworkPort Templates by-value in the NetworkPort
create operation.
 
    

ForwardingGroup
 
      MixedNetwork
 
      Indicates whether ForwardingGroups can support both
private and public connection at the same time.
 
    

Job
 
      JobRetention
 
      If the Provider supports Job resources as specified in
this document, this capability indicates in minutes how
long a job will live in the system before its deleted. In
this case, the value attribute provides the number of
minutes (e.g., 30 min). The value specified is of type
"integer."
 
    

Meter
 
      MeterConfigByValue
 
      Indicates that the Provider supports specifying
MeterConfigurations by-value in the Meter create
operation.
 
    

Meter
 
      MeterTemplateByValue
 
      Indicates that the Provider supports specifying Meter
Templates by-value in the Meter create operation.
 
    

EventLog
 
      Linked
 
      Indicates that the Provider shall delete EventLogs that
are associated with resources when the resource is
deleted.
 
    





      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"�5



  

Resource Metadata


ResourceMetadata may be used to:

Express constraints on the existing CIMI defined resource attributes (e.g., express a maximum for
the 'cpu' attribute of the MachineConfiguration resource) 
 Introduce new attributes for CIMI defined resources together with any constraints governing these
(e.g., a new 'location' attribute for the Volume resource that takes values from a defined set of strings)
 Introduce new operations for any of the CIMI defined resources (e.g., define a new 'compress'
operation for the Volume resource)
 Express any Provider specific capabilities or features (e.g., the length of time that a Job resource
will be retained after Job completion and before this is deleted)


Implementations of this specification should allow for Consumers to discover the metadata associated
with each supported resource. Doing so allows for the discovery of Provider defined constraints on the
CIMI defined attributes as well as discovery of any new extension attributes or operations that the
Provider may have defined. ResourceMetadata can also be used to express any Provider specific
capabilities or features. The mechanism by which this metadata is made available will be protocol
specific.



  
  



  
    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
      ResourceMetadata
      Machine
      Volume
    
  
  
  
    Resource Metadata
  



  





  Retrieve the ResourceMetadata Collection
  ResourceMetadata Capabilities




  

Retrieve the ResourceMetadata Collection

Example request:

GET /cimi/resource_metadata HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
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: 1675
ETag: 97a131617573093b156505f77202bf57
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 11 Jan 2013 15:29:14 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/ResourceMetadataCollection">
  <id>http://localhost:3001/cimi/resource_metadata</id>
  <count>2</count>
  <ResourceMetadata>
    <id>http://localhost:3001/cimi/resource_metadata/cloud_entry_point</id>
    <name>CloudEntryPoint</name>
    <typeUri>http://schemas.dmtf.org/cimi/1/CloudEntryPoint</typeUri>
    <attribute name="driver" namespace="http://deltacloud.org/cimi/CloudEntryPoint/driver"
          type="text" required="true" />
    <attribute name="provider" namespace="http://deltacloud.org/cimi/CloudEntryPoint/provider"
          type="text" required="true" />
  </ResourceMetadata>
  <ResourceMetadata>
    <id>http://localhost:3001/cimi/resource_metadata/machine</id>
    <name>Machine</name>
    <typeUri>http://schemas.dmtf.org/cimi/1/Machine</typeUri>
    <attribute name="realm" namespace="http://deltacloud.org/cimi/Machine/realm"
           type="text" required="false">
      <constraint>
        <value>us</value>
      </constraint>
      <constraint>
        <value>eu</value>
      </constraint>
    </attribute>
    <attribute name="machine_image"
          namespace="http://deltacloud.org/cimi/Machine/machine_image" type="URI"
          required="false" />
    <capability name="DefaultInitialState"
          uri="http://schemas.dmtf.org/cimi/1/capability/Machine/DefaultInitialState"
          description="Indicates what the default initial state of a new Machine ">
          STARTED
    </capability>
    <capability name="InitialStates"
          uri="http://schemas.dmtf.org/cimi/1/capability/Machine/InitialStates"
          description="Indicates the list of allowable initial states">
          STARTED,STOPPED
    </capability>
  </ResourceMetadata>
</Collection>


  

  

ResourceMetadata Capabilities




The following table describes the capability URIs defined by this specification. Providers may define new
URIs and it is recommended that these URIs be dereferencable such that Consumers can discover the
details of the new capability. The "Resource Name" column contains the name of the resource that may
contain the specified capability within its ResourceMetadata. The "Capability Name" column contains the
name of the specified capability and shall be unique within the scope of the corresponding resource. Each
capability's URI shall be constructed by appending the "Resource Name", a slash(/), and the "Capability
Name" to "http://schemas.dmtf.org/cimi/1/capability/". For example, the Machine's "InitialState" capability
would have a URI of:

 http://schemas.dmtf.org/cimi/1/capability/Machine/InitialState 


Note that capabilities that apply to the Provider in general, and are not specific to any one resource, are
associated with the Cloud Entry Point resource (in case a capability would apply only to the
CloudEntryPoint resource itself, its definition would say so).






  
    
      
        Resource Name
      
      
        Capability Name
      
      
        Description
      
    
  
  
    
      CloudEntryPoint  
      ExpandParameter  
       Indicated whether the $expand query parameter is
supported by the Provider.

    
    
      CloudEntryPoint
 
      FilterParameter
 
      Indicates whether the $filter query parameter is
supported by the Provider.
 
    
    
      CloudEntryPoint
 
      firstParameter
 
      Indicates whether the $first and $last query parameters
are supported by the Provider. Note that either both
shall be supported or neither shall be supported.
 
    
    
      CloudEntryPoint
 
      SelectParameter
 
      Indicated whether the $select query parameter is
supported by the Provider.
 
    
    
      System
 
      SystemComponentTemplateByValue
 
      Indicates that the Provider supports specifying
Component Templates by-value in SystemTemplates.
 
    
    
      Machine
 
      DefaultInitialState
 
      Indicates what the default initial state of a new Machine
will be unless explicitly set by the "initialState" attribute
 
    
    
      Machine
 
      InitialStates
 
      Indicates the list of allowable initial states that
Consumer may choose from when creating a new
Machine.
 
    
    
      Machine
 
      MachineConfigByValue
 
      Indicates that the Provider supports specifying Machine
Configurations by-value in Machine create operations. If
true the MachineTemplateByValue capability shall also
be specified with a value of true.
 
    
    
      Machine
 
      MachineCredentialByValue
 
      Indicates that the Provider supports specifying
Credential by-value in Machine create operations. If true
the MachineTemplateByValue capability shall also be
specified with a value of true.
 
    
    
      Machine
 
      MachineImageByValue
 
      Indicates that the Provider supports specifying Machine
Images by-value in Machine create operations. If true
the MachineTemplateByValue capability shall also be
specified with a value of true.
 
    
    
      Machine
 
      MachineVolumeTemplatesByValue
 
      Indicates that the Provider supports specifying
VolumeTemplates by-value in Machine create
operations. If true the MachineTemplateByValue
capability shall also be specified with a value of true.
 
    
    
      Machine
 
      MachineStopForce
 
      Indicates that the Provider supports specifying the
"force" option on the stop and restart operations.
 
    
    
      Machine
 
      MachineStopForceDefault
 
      Indicates the default way in which the Provider will
stop/restart a Machine. When set to "true", the Provider
will forcefully stop the Machine, as opposed to a value
of "false," which indicates that the Provider will attempt
to gracefully stop the Machine.
 
    
    
      Machine
 
      RestoreFromImage
 
      Indicates that the Provider supports restoring Machines
from Machine Images that are not SNAPSHOT Machine
Images.
 
    
    
      Machine
 
      UserData
 
      Indicates which userData injection method will be used.
See 5.14.1 for more information.
 
    
    
      Credential
 
      CredentialTemplateByValue
 
      Indicates that the Provider supports specifying
Credential Templates by-value in Credential create
operations.
 
    
    
      Volume
 
      SharedVolumeSupport
 
      Indicates that the Provider supports the sharing of
volume resources across Machines. The value specified
is of type "boolean."
 
    
    
      Volume
 
      VolumeConfigByValue
 
      Indicates that the Provider supports specifying Volume
Configurations by-value in the Volume create operation.
If true, the VolumeTemplateByValue capability shall
also be specified with a value of true.
 
    
    
      Volume
 
      VolumeImageByValue
 
      Indicates that the Provider supports specifying Volume
Images by-value in the Volume create operation. If true
the VolumeTemplateByValue capability shall also be
specified with a value of true.
 
    
    
      Volume
 
      VolumeSnapshot
 
      Indicates that the Provider supports creating a new
VolumeImage by referencing an existing Volume.
 
    
    
      Volume
 
      VolumeTemplateByValue
 
      Indicates that the Provider supports specifying Volume
Templates by-value in Volume create operations.
 
    
    
      Network
 
      NetworkConfigByValue
 
      Indicates that the Provider supports specifying Network
Configurations by-value in the Network create
operation.
 
    
    
      Network
 
      NetworkTemplateByValue
 
      Indicates that the Provider supports specifying Network
Templates by-value in the Network create operation.
 
    
    
      NetworkPort
 
      NetworkPortConfigByValue
 
      Indicates that the Provider supports specifying
NetworkPort Configurations by-value in the NetworkPort
create operation.
 
    
    
      NetworkPort
 
      NetworkPortTemplateByValue
 
      Indicates that the Provider supports specifying
NetworkPort Templates by-value in the NetworkPort
create operation.
 
    
    
      ForwardingGroup
 
      MixedNetwork
 
      Indicates whether ForwardingGroups can support both
private and public connection at the same time.
 
    
    
      Job
 
      JobRetention
 
      If the Provider supports Job resources as specified in
this document, this capability indicates in minutes how
long a job will live in the system before its deleted. In
this case, the value attribute provides the number of
minutes (e.g., 30 min). The value specified is of type
"integer."
 
    
    
      Meter
 
      MeterConfigByValue
 
      Indicates that the Provider supports specifying
MeterConfigurations by-value in the Meter create
operation.
 
    
    
      Meter
 
      MeterTemplateByValue
 
      Indicates that the Provider supports specifying Meter
Templates by-value in the Meter create operation.
 
    
    
      EventLog
 
      Linked
 
      Indicates that the Provider shall delete EventLogs that
are associated with resources when the resource is
deleted.
 
    
  


  
;T;
I"@4



  

Resource Metadata


ResourceMetadata may be used to:

Express constraints on the existing CIMI defined resource attributes (e.g., express a maximum for
the 'cpu' attribute of the MachineConfiguration resource) 
 Introduce new attributes for CIMI defined resources together with any constraints governing these
(e.g., a new 'location' attribute for the Volume resource that takes values from a defined set of strings)
 Introduce new operations for any of the CIMI defined resources (e.g., define a new 'compress'
operation for the Volume resource)
 Express any Provider specific capabilities or features (e.g., the length of time that a Job resource
will be retained after Job completion and before this is deleted)


Implementations of this specification should allow for Consumers to discover the metadata associated
with each supported resource. Doing so allows for the discovery of Provider defined constraints on the
CIMI defined attributes as well as discovery of any new extension attributes or operations that the
Provider may have defined. ResourceMetadata can also be used to express any Provider specific
capabilities or features. The mechanism by which this metadata is made available will be protocol
specific.



  
  




    CIMI REST API
  
  Introduction
  Cloud Entry Point
  
    
      CIMI Resources
      
    
    
ResourceMetadata
      Machine
      Volume
    

  

    Resource Metadata
  







Retrieve the ResourceMetadata Collection
  ResourceMetadata Capabilities

  

Retrieve the ResourceMetadata Collection

Example request:

GET /cimi/resource_metadata HTTP/1.1
Authorization: Basic bW9ja3VzZXI6bW9ja3Bhc3N3b3Jk
User-Agent: curl/7.24.0 (i686-redhat-linux-gnu) libcurl/7.24.0 NSS/3.13.5.0 zlib/1.2.5 libidn/1.24 libssh2/1.4.1
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: 1675
ETag: 97a131617573093b156505f77202bf57
Cache-Control: max-age=0, private, must-revalidate
Date: Fri, 11 Jan 2013 15:29:14 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/ResourceMetadataCollection">
  <id>http://localhost:3001/cimi/resource_metadata</id>
  <count>2</count>
  <ResourceMetadata>
    <id>http://localhost:3001/cimi/resource_metadata/cloud_entry_point</id>
    <name>CloudEntryPoint</name>
    <typeUri>http://schemas.dmtf.org/cimi/1/CloudEntryPoint</typeUri>
    <attribute name="driver" namespace="http://deltacloud.org/cimi/CloudEntryPoint/driver"
          type="text" required="true" />
    <attribute name="provider" namespace="http://deltacloud.org/cimi/CloudEntryPoint/provider"
          type="text" required="true" />
  </ResourceMetadata>
  <ResourceMetadata>
    <id>http://localhost:3001/cimi/resource_metadata/machine</id>
    <name>Machine</name>
    <typeUri>http://schemas.dmtf.org/cimi/1/Machine</typeUri>
    <attribute name="realm" namespace="http://deltacloud.org/cimi/Machine/realm"
           type="text" required="false">
      <constraint>
        <value>us</value>
      </constraint>
      <constraint>
        <value>eu</value>
      </constraint>
    </attribute>
    <attribute name="machine_image"
          namespace="http://deltacloud.org/cimi/Machine/machine_image" type="URI"
          required="false" />
    <capability name="DefaultInitialState"
          uri="http://schemas.dmtf.org/cimi/1/capability/Machine/DefaultInitialState"
          description="Indicates what the default initial state of a new Machine ">
          STARTED
    </capability>
    <capability name="InitialStates"
          uri="http://schemas.dmtf.org/cimi/1/capability/Machine/InitialStates"
          description="Indicates the list of allowable initial states">
          STARTED,STOPPED
    </capability>
  </ResourceMetadata>
</Collection>


  

  

ResourceMetadata Capabilities



The following table describes the capability URIs defined by this specification. Providers may define new
URIs and it is recommended that these URIs be dereferencable such that Consumers can discover the
details of the new capability. The "Resource Name" column contains the name of the resource that may
contain the specified capability within its ResourceMetadata. The "Capability Name" column contains the
name of the specified capability and shall be unique within the scope of the corresponding resource. Each
capability's URI shall be constructed by appending the "Resource Name", a slash(/), and the "Capability
Name" to "http://schemas.dmtf.org/cimi/1/capability/". For example, the Machine's "InitialState" capability
would have a URI of:

 http://schemas.dmtf.org/cimi/1/capability/Machine/InitialState 


Note that capabilities that apply to the Provider in general, and are not specific to any one resource, are
associated with the Cloud Entry Point resource (in case a capability would apply only to the
CloudEntryPoint resource itself, its definition would say so).






        Resource Name
      
      
        Capability Name
      
      
        Description
      
    


CloudEntryPoint  
      ExpandParameter  
       Indicated whether the $expand query parameter is
supported by the Provider.

    

CloudEntryPoint
 
      FilterParameter
 
      Indicates whether the $filter query parameter is
supported by the Provider.
 
    

CloudEntryPoint
 
      firstParameter
 
      Indicates whether the $first and $last query parameters
are supported by the Provider. Note that either both
shall be supported or neither shall be supported.
 
    

CloudEntryPoint
 
      SelectParameter
 
      Indicated whether the $select query parameter is
supported by the Provider.
 
    

System
 
      SystemComponentTemplateByValue
 
      Indicates that the Provider supports specifying
Component Templates by-value in SystemTemplates.
 
    

Machine
 
      DefaultInitialState
 
      Indicates what the default initial state of a new Machine
will be unless explicitly set by the "initialState" attribute
 
    

Machine
 
      InitialStates
 
      Indicates the list of allowable initial states that
Consumer may choose from when creating a new
Machine.
 
    

Machine
 
      MachineConfigByValue
 
      Indicates that the Provider supports specifying Machine
Configurations by-value in Machine create operations. If
true the MachineTemplateByValue capability shall also
be specified with a value of true.
 
    

Machine
 
      MachineCredentialByValue
 
      Indicates that the Provider supports specifying
Credential by-value in Machine create operations. If true
the MachineTemplateByValue capability shall also be
specified with a value of true.
 
    

Machine
 
      MachineImageByValue
 
      Indicates that the Provider supports specifying Machine
Images by-value in Machine create operations. If true
the MachineTemplateByValue capability shall also be
specified with a value of true.
 
    

Machine
 
      MachineVolumeTemplatesByValue
 
      Indicates that the Provider supports specifying
VolumeTemplates by-value in Machine create
operations. If true the MachineTemplateByValue
capability shall also be specified with a value of true.
 
    

Machine
 
      MachineStopForce
 
      Indicates that the Provider supports specifying the
"force" option on the stop and restart operations.
 
    

Machine
 
      MachineStopForceDefault
 
      Indicates the default way in which the Provider will
stop/restart a Machine. When set to "true", the Provider
will forcefully stop the Machine, as opposed to a value
of "false," which indicates that the Provider will attempt
to gracefully stop the Machine.
 
    

Machine
 
      RestoreFromImage
 
      Indicates that the Provider supports restoring Machines
from Machine Images that are not SNAPSHOT Machine
Images.
 
    

Machine
 
      UserData
 
      Indicates which userData injection method will be used.
See 5.14.1 for more information.
 
    

Credential
 
      CredentialTemplateByValue
 
      Indicates that the Provider supports specifying
Credential Templates by-value in Credential create
operations.
 
    

Volume
 
      SharedVolumeSupport
 
      Indicates that the Provider supports the sharing of
volume resources across Machines. The value specified
is of type "boolean."
 
    

Volume
 
      VolumeConfigByValue
 
      Indicates that the Provider supports specifying Volume
Configurations by-value in the Volume create operation.
If true, the VolumeTemplateByValue capability shall
also be specified with a value of true.
 
    

Volume
 
      VolumeImageByValue
 
      Indicates that the Provider supports specifying Volume
Images by-value in the Volume create operation. If true
the VolumeTemplateByValue capability shall also be
specified with a value of true.
 
    

Volume
 
      VolumeSnapshot
 
      Indicates that the Provider supports creating a new
VolumeImage by referencing an existing Volume.
 
    

Volume
 
      VolumeTemplateByValue
 
      Indicates that the Provider supports specifying Volume
Templates by-value in Volume create operations.
 
    

Network
 
      NetworkConfigByValue
 
      Indicates that the Provider supports specifying Network
Configurations by-value in the Network create
operation.
 
    

Network
 
      NetworkTemplateByValue
 
      Indicates that the Provider supports specifying Network
Templates by-value in the Network create operation.
 
    

NetworkPort
 
      NetworkPortConfigByValue
 
      Indicates that the Provider supports specifying
NetworkPort Configurations by-value in the NetworkPort
create operation.
 
    

NetworkPort
 
      NetworkPortTemplateByValue
 
      Indicates that the Provider supports specifying
NetworkPort Templates by-value in the NetworkPort
create operation.
 
    

ForwardingGroup
 
      MixedNetwork
 
      Indicates whether ForwardingGroups can support both
private and public connection at the same time.
 
    

Job
 
      JobRetention
 
      If the Provider supports Job resources as specified in
this document, this capability indicates in minutes how
long a job will live in the system before its deleted. In
this case, the value attribute provides the number of
minutes (e.g., 30 min). The value specified is of type
"integer."
 
    

Meter
 
      MeterConfigByValue
 
      Indicates that the Provider supports specifying
MeterConfigurations by-value in the Meter create
operation.
 
    

Meter
 
      MeterTemplateByValue
 
      Indicates that the Provider supports specifying Meter
Templates by-value in the Meter create operation.
 
    

EventLog
 
      Linked
 
      Indicates that the Provider shall delete EventLogs that
are associated with resources when the resource is
deleted.
 
    



;T;@TI"#/cimi-curl/cimi-curl-machines/;T{;{	;I"�5

  
    
    CIMI cURL Examples - Machine Resources
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      




  

    cURL examples for CIMI Machine resources


Working with Machines
  Working with MachineImages
  Working with MachineConfigurations
  Working with MachineTemplates
  Working with Machine Volumes



  



    curl for CIMI Resources
  
  
Machine
    Volume
    ResourceMetadata
  









  


Working with Machines

Retrieve the Machine Collection in json format:

 curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machines 

Create a new Machine with the message body in XML format:

curl -v --user "mockuser:mockpassword" -X POST -H "Content-Type: application/xml" -H "Accept: application/xml" -d '<MachineCreate xmlns="http://schemas.dmtf.org/cimi/1"> <name> myMachine1 </name> <description> my machine description </description> <machineTemplate> <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small"> </machineConfig> <machineImage href="http://localhost:3001/cimi/machine_images/img1"> </machineImage> </machineTemplate> </MachineCreate>'


Alternatively, specifying the message body in JSON:
 curl -v --user "user:password" -X POST -H "Content-Type: application/json" -H "Accept: application/xml" -d '{ "resourceURI": "http://schemas.dmtf.org/cimi/1/MachineCreate", "name": "myMachine3", "description": "My very first json machine", "machineTemplate": { "machineConfig": { "href": "http://localhost:3001/cimi/machine_configurations/m1.small" }, "machineImage": { "href": "http://localhost:3001/cimi/machine_images/ami-48aa4921" } } }' http://localhost:3001/cimi/machines


Perform a Machine operation - stop - with the message body in XML format:

curl -v -X POST --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -d '<Action xmlns="http://schemas.dmtf.org/cimi/1"><action> http://http://schemas.dmtf.org/cimi/1/action/stop </action> </Action>'  http://localhost:3001/cimi/machines/inst3/stop


Alternatively, specifying the message body in JSON:
 curl -v -X POST --user "user:password" -H "Accept: application/json" -H "Content-Type: application/json" -d '{"resourceURI": "http://www.dmtf.org/cimi/1/Action", "action":"http://www.dmtf.org/cimi/action/stop"}' http://localhost:3001/cimi/machines/i-5feb7c20/stop








Working with Machine Images

Retrieve the Machine Image Collection:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_images


Create a new Machine Image from an existing Machine, with message body in JSON:

curl --user "mockuser:mockpassword" -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"resourceURI":"http://schemas.dmtf.org/cimi/1/MachineImage", "name":"new_image","description":"my new machine image","type":"IMAGE", "imageLocation":"http://localhost:3001/cimi/machines/inst1"}' http://localhost:3001/cimi/machine_images



Alternatively, specifying the message body in XML:

curl -v --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d "<MachineImage><name>some_name</name><description>my new machine image</description><type>IMAGE</type><imageLocation>http://localhost:3001/cimi/machines/inst1</imageLocation></MachineImage>" http://localhost:3001/cimi/machine_images


Delete a Machine Image:

curl -X DELETE --user "user:pass" http://localhost:3001/cimi/machine_images/my_image 







Working with Machine Configurations

Retrieve the Machine Configuration Collection:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_configurations


Retrieve a specific Machine Configuration:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_configurations/m1-large






Working with Machine Templates
Retrieve the Machine Template Collection:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_templates


Retrieve a specific Machine Template:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_templates/m1-large


 Create a Machine Template with XML body: 

curl -v --user "mockuser:mockpassword" -X POST -d '<MachineTemplateCreate><name>myXmlTestMachineTemplate1</name><description>Description of my MachineTemplate</description><property key="test">value</property><machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge"/><machineImage href="http://localhost:3001/cimi/machine_images/img3"/></MachineTemplateCreate>' -H "Content-Type: application/xml"  -H "Accept: application/xml" http://localhost:3001/cimi/machine_templates


 Create a Machine Template with JSON body: 

curl -v --user "mockuser:mockpassword" -X POST -d '{"resourceURI": "http://schemas.dmtf.org/cimi/1/MachineTemplateCreate","name": "myMachineDemoTemplate","description": "My very loved machine template","machineConfig": { "href": "http://localhost:3001/cimi/machine_configurations/m1-xlarge" },"machineImage": { "href": "http://localhost:3001/cimi/machine_images/img3" },"properties": { "foo": "bar","life": "is life"}}' -H "Content-Type: application/json"  -H "Accept: application/json" http://localhost:3001/cimi/machine_templates


 Delete a Machine Template: 

curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" -X DELETE http://localhost:3001/cimi/machine_templates/2






Working with Machine Volumes 
Retrieve the Machine Volume Collection of a given Machine resource:

curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" http://localhost:3001/cimi/machines/inst1/volumes


Attach a Volume to a Machine, with XML body:

curl -v --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d ' /dev/sdf '  http://localhost:3001/cimi/machines/inst1/volume_attach


Attach a Volume to a Machine, with JSON body:

curl -v --user "mockuser:mockpassword" -H "Content-Type: application/json" -H "Accept: application/xml" -X POST -d '{"resourceURI":"http://schemas.dmtf.org/cimi/1/MachineVolume", "initialLocation": "/dev/sdf", "volume": {"href":"http://localhost:3001/cimi/volumes/vol2"}}' http://localhost:3001/cimi/machines/inst1/volume_attach


Detach a Volume from a Machine:

curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" -X DELETE http://localhost:3001/cimi/machines/inst1/volumes/vol2





      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"J 




  

    cURL examples for CIMI Machine resources


  Working with Machines
  Working with MachineImages
  Working with MachineConfigurations
  Working with MachineTemplates
  Working with Machine Volumes



  

  


  
    curl for CIMI Resources
  
  
    Machine
    Volume
    ResourceMetadata
  
  



  





  



Working with Machines

Retrieve the Machine Collection in json format:

 curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machines 

Create a new Machine with the message body in XML format:

curl -v --user "mockuser:mockpassword" -X POST -H "Content-Type: application/xml" -H "Accept: application/xml" -d '<MachineCreate xmlns="http://schemas.dmtf.org/cimi/1"> <name> myMachine1 </name> <description> my machine description </description> <machineTemplate> <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small"> </machineConfig> <machineImage href="http://localhost:3001/cimi/machine_images/img1"> </machineImage> </machineTemplate> </MachineCreate>'


Alternatively, specifying the message body in JSON:
 curl -v --user "user:password" -X POST -H "Content-Type: application/json" -H "Accept: application/xml" -d '{ "resourceURI": "http://schemas.dmtf.org/cimi/1/MachineCreate", "name": "myMachine3", "description": "My very first json machine", "machineTemplate": { "machineConfig": { "href": "http://localhost:3001/cimi/machine_configurations/m1.small" }, "machineImage": { "href": "http://localhost:3001/cimi/machine_images/ami-48aa4921" } } }' http://localhost:3001/cimi/machines


Perform a Machine operation - stop - with the message body in XML format:

curl -v -X POST --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -d '<Action xmlns="http://schemas.dmtf.org/cimi/1"><action> http://http://schemas.dmtf.org/cimi/1/action/stop </action> </Action>'  http://localhost:3001/cimi/machines/inst3/stop


Alternatively, specifying the message body in JSON:
 curl -v -X POST --user "user:password" -H "Accept: application/json" -H "Content-Type: application/json" -d '{"resourceURI": "http://www.dmtf.org/cimi/1/Action", "action":"http://www.dmtf.org/cimi/action/stop"}' http://localhost:3001/cimi/machines/i-5feb7c20/stop











Working with Machine Images

Retrieve the Machine Image Collection:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_images


Create a new Machine Image from an existing Machine, with message body in JSON:

curl --user "mockuser:mockpassword" -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"resourceURI":"http://schemas.dmtf.org/cimi/1/MachineImage", "name":"new_image","description":"my new machine image","type":"IMAGE", "imageLocation":"http://localhost:3001/cimi/machines/inst1"}' http://localhost:3001/cimi/machine_images



Alternatively, specifying the message body in XML:

curl -v --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d "<MachineImage><name>some_name</name><description>my new machine image</description><type>IMAGE</type><imageLocation>http://localhost:3001/cimi/machines/inst1</imageLocation></MachineImage>" http://localhost:3001/cimi/machine_images


Delete a Machine Image:

curl -X DELETE --user "user:pass" http://localhost:3001/cimi/machine_images/my_image 










Working with Machine Configurations

Retrieve the Machine Configuration Collection:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_configurations


Retrieve a specific Machine Configuration:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_configurations/m1-large






Working with Machine Templates
Retrieve the Machine Template Collection:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_templates


Retrieve a specific Machine Template:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_templates/m1-large


 Create a Machine Template with XML body: 

curl -v --user "mockuser:mockpassword" -X POST -d '<MachineTemplateCreate><name>myXmlTestMachineTemplate1</name><description>Description of my MachineTemplate</description><property key="test">value</property><machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge"/><machineImage href="http://localhost:3001/cimi/machine_images/img3"/></MachineTemplateCreate>' -H "Content-Type: application/xml"  -H "Accept: application/xml" http://localhost:3001/cimi/machine_templates


 Create a Machine Template with JSON body: 

curl -v --user "mockuser:mockpassword" -X POST -d '{"resourceURI": "http://schemas.dmtf.org/cimi/1/MachineTemplateCreate","name": "myMachineDemoTemplate","description": "My very loved machine template","machineConfig": { "href": "http://localhost:3001/cimi/machine_configurations/m1-xlarge" },"machineImage": { "href": "http://localhost:3001/cimi/machine_images/img3" },"properties": { "foo": "bar","life": "is life"}}' -H "Content-Type: application/json"  -H "Accept: application/json" http://localhost:3001/cimi/machine_templates


 Delete a Machine Template: 

curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" -X DELETE http://localhost:3001/cimi/machine_templates/2






Working with Machine Volumes 
Retrieve the Machine Volume Collection of a given Machine resource:

curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" http://localhost:3001/cimi/machines/inst1/volumes


Attach a Volume to a Machine, with XML body:

curl -v --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d ' /dev/sdf  '  http://localhost:3001/cimi/machines/inst1/volume_attach


Attach a Volume to a Machine, with JSON body:

curl -v --user "mockuser:mockpassword" -H "Content-Type: application/json" -H "Accept: application/xml" -X POST -d '{"resourceURI":"http://schemas.dmtf.org/cimi/1/MachineVolume", "initialLocation": "/dev/sdf", "volume": {"href":"http://localhost:3001/cimi/volumes/vol2"}}' http://localhost:3001/cimi/machines/inst1/volume_attach


Detach a Volume from a Machine:

curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" -X DELETE http://localhost:3001/cimi/machines/inst1/volumes/vol2


;T;
I"! 




  

    cURL examples for CIMI Machine resources


Working with Machines
  Working with MachineImages
  Working with MachineConfigurations
  Working with MachineTemplates
  Working with Machine Volumes



  



    curl for CIMI Resources
  
  
Machine
    Volume
    ResourceMetadata
  









  


Working with Machines

Retrieve the Machine Collection in json format:

 curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machines 

Create a new Machine with the message body in XML format:

curl -v --user "mockuser:mockpassword" -X POST -H "Content-Type: application/xml" -H "Accept: application/xml" -d '<MachineCreate xmlns="http://schemas.dmtf.org/cimi/1"> <name> myMachine1 </name> <description> my machine description </description> <machineTemplate> <machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-small"> </machineConfig> <machineImage href="http://localhost:3001/cimi/machine_images/img1"> </machineImage> </machineTemplate> </MachineCreate>'


Alternatively, specifying the message body in JSON:
 curl -v --user "user:password" -X POST -H "Content-Type: application/json" -H "Accept: application/xml" -d '{ "resourceURI": "http://schemas.dmtf.org/cimi/1/MachineCreate", "name": "myMachine3", "description": "My very first json machine", "machineTemplate": { "machineConfig": { "href": "http://localhost:3001/cimi/machine_configurations/m1.small" }, "machineImage": { "href": "http://localhost:3001/cimi/machine_images/ami-48aa4921" } } }' http://localhost:3001/cimi/machines


Perform a Machine operation - stop - with the message body in XML format:

curl -v -X POST --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -d '<Action xmlns="http://schemas.dmtf.org/cimi/1"><action> http://http://schemas.dmtf.org/cimi/1/action/stop </action> </Action>'  http://localhost:3001/cimi/machines/inst3/stop


Alternatively, specifying the message body in JSON:
 curl -v -X POST --user "user:password" -H "Accept: application/json" -H "Content-Type: application/json" -d '{"resourceURI": "http://www.dmtf.org/cimi/1/Action", "action":"http://www.dmtf.org/cimi/action/stop"}' http://localhost:3001/cimi/machines/i-5feb7c20/stop








Working with Machine Images

Retrieve the Machine Image Collection:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_images


Create a new Machine Image from an existing Machine, with message body in JSON:

curl --user "mockuser:mockpassword" -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d '{"resourceURI":"http://schemas.dmtf.org/cimi/1/MachineImage", "name":"new_image","description":"my new machine image","type":"IMAGE", "imageLocation":"http://localhost:3001/cimi/machines/inst1"}' http://localhost:3001/cimi/machine_images



Alternatively, specifying the message body in XML:

curl -v --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d "<MachineImage><name>some_name</name><description>my new machine image</description><type>IMAGE</type><imageLocation>http://localhost:3001/cimi/machines/inst1</imageLocation></MachineImage>" http://localhost:3001/cimi/machine_images


Delete a Machine Image:

curl -X DELETE --user "user:pass" http://localhost:3001/cimi/machine_images/my_image 







Working with Machine Configurations

Retrieve the Machine Configuration Collection:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_configurations


Retrieve a specific Machine Configuration:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_configurations/m1-large






Working with Machine Templates
Retrieve the Machine Template Collection:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_templates


Retrieve a specific Machine Template:

curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/machine_templates/m1-large


 Create a Machine Template with XML body: 

curl -v --user "mockuser:mockpassword" -X POST -d '<MachineTemplateCreate><name>myXmlTestMachineTemplate1</name><description>Description of my MachineTemplate</description><property key="test">value</property><machineConfig href="http://localhost:3001/cimi/machine_configurations/m1-xlarge"/><machineImage href="http://localhost:3001/cimi/machine_images/img3"/></MachineTemplateCreate>' -H "Content-Type: application/xml"  -H "Accept: application/xml" http://localhost:3001/cimi/machine_templates


 Create a Machine Template with JSON body: 

curl -v --user "mockuser:mockpassword" -X POST -d '{"resourceURI": "http://schemas.dmtf.org/cimi/1/MachineTemplateCreate","name": "myMachineDemoTemplate","description": "My very loved machine template","machineConfig": { "href": "http://localhost:3001/cimi/machine_configurations/m1-xlarge" },"machineImage": { "href": "http://localhost:3001/cimi/machine_images/img3" },"properties": { "foo": "bar","life": "is life"}}' -H "Content-Type: application/json"  -H "Accept: application/json" http://localhost:3001/cimi/machine_templates


 Delete a Machine Template: 

curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" -X DELETE http://localhost:3001/cimi/machine_templates/2






Working with Machine Volumes 
Retrieve the Machine Volume Collection of a given Machine resource:

curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" http://localhost:3001/cimi/machines/inst1/volumes


Attach a Volume to a Machine, with XML body:

curl -v --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d ' /dev/sdf '  http://localhost:3001/cimi/machines/inst1/volume_attach


Attach a Volume to a Machine, with JSON body:

curl -v --user "mockuser:mockpassword" -H "Content-Type: application/json" -H "Accept: application/xml" -X POST -d '{"resourceURI":"http://schemas.dmtf.org/cimi/1/MachineVolume", "initialLocation": "/dev/sdf", "volume": {"href":"http://localhost:3001/cimi/volumes/vol2"}}' http://localhost:3001/cimi/machines/inst1/volume_attach


Detach a Volume from a Machine:

curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" -X DELETE http://localhost:3001/cimi/machines/inst1/volumes/vol2



;T;@ZI""/cimi-curl/cimi-curl-volumes/;T{;{	;I"�5

  
    
    CIMI cURL Examples - Volume Resources
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      




  

    cURL examples for CIMI Volume resources


Working with Volumes
  Working with VolumeImages
  Working with VolumeConfigurations
  Working with VolumeTemplates



  



    curl for CIMI Resources
  
  
Machine
    Volume
    ResourceMetadata
  









  

    
Working with Volumes

    Retrieve the Volume Collection in json format:

     curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/volumes 

    Retrieve a specific Volume in xml format: 

     curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/cimi/volumes/volume1 

    Create Volume - with VolumeConfiguration by reference, XML body:

    curl -v --user "mockuser:mockpassword" -H "Accept:application/xml" -X POST -d '<VolumeCreate><name> marios_new_volume </name> <description> a new volume </description><volumeTemplate><volumeConfig href="http://localhost:3001/cimi/volume_configurations/2"> </volumeConfig></volumeTemplate></VolumeCreate>' http://localhost:3001//cimi/volumes
     

    Create Volume - with VolumeConfiguration by reference, JSON body:

    curl -v --user "mockuser:mockpassword" -H "Accept:application/xml" -X POST -d '{"name": "marios_new_volume", "description": "a new volume", "volumeTemplate": { "volumeConfig": {"href":"http://localhost:3001/cimi/volume_configurations/2" }}}' http://localhost:3001//cimi/volumes
    

    Create Volume - with VolumeConfiguration by value, XML body:

    curl -v --user "mockuser:mockpassword" -H "Accept:application/xml" -X POST -d '<VolumeCreate><name> marios_volume </name><description> a new volume </description> <volumeTemplate><volumeConfig><type>http://schemas.dmtf.org/cimi/1/mapped</type><capacity> 1024 </capacity></volumeConfig></volumeTemplate> </VolumeCreate>' http://localhost:3001//cimi/volumes
    

    Create Volume - with VolumeConfiguration by value, JSON body:

    curl -v --user "mockuser:mockpassword" -H "Accept:application/xml"  -X POST -d '{"name": "marios_new_volume", "description": "a new volume", "volumeTemplate": { "volumeConfig": {"type":"http://schemas.dmtf.org/cimi/1/mapped", "capacity": 1024 }}}'   http://localhost:3001/cimi/volumes
    

    Delete a Volume

    curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" -X DELETE http://localhost:3001/cimi/volumes/volume94275
    

  

  

    
Working with Volume Images

    Retrieve the Volume Image Collection in xml format:

     curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/cimi/volume_images

    Retrieve a specific Volume Image in json format:

     curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/volume_images/vol_image1 

    Create a Volume Image from an existing Volume, XML body:

    curl -v --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d '<VolumeImage xmlns="http://schemas.dmtf.org/cimi/1"><name> my_vol_image </name><description> marios first volume image </description><imageLocation href="http://localhost:3001/cimi/volumes/vol1"/></VolumeImage>' http://localhost:3001/cimi/volume_images
    

    Create a Volume Image from an existing Volume, JSON body:

    curl -v --user "mockuser:mockpassword" -H "Content-Type: application/json" -H "Accept: application/xml" -X POST -d  '{ "resourceURI": "http://schemas.dmtf.org/cimi/1/VolumeImage","name": "some_name", "description": "marios first volume image", "imageLocation": { "href": "http://localhost:3001/cimi/volumes/vol1"}}' http://localhost:3001/cimi/volume_images

    Delete a Volume Image:

    curl -v -X DELETE --user "mockuser:mockpassword" http://localhost:3001/cimi/volume_images/store_snapshot_1358516615

  


  

    
Working with Volume Configurations

    Retrieve the Volume Configuration Collection in json format:

     curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/volume_configurations 

    Retrieve a specific Volume Configuration in xml format:

     curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/cimi/volume_configurations/volume_config1 

    Create a new Volume Configuration with XML body:

    curl -v --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d '<VolumeConfigurationCreate><name>marios_volume_config</name><description>a volume configuration</description><format>qcow2</format><type>http://schemas.dmtf.org/cimi/1/mapped</type> <capacity>10</capacity></VolumeConfigurationCreate>' http://localhost:3001/cimi/volume_configurations
    

    Create a new Volume Configuration with JSON body:

   curl -v --user "mockuser:mockpassword" -H "Content-Type: application/json" -H "Accept: application/xml" -X POST -d '{ "resourceURI": "http://schemas.dmtf.org/cimi/1/VolumeConfiguration","name": "marios_volume_config", "description": "a volume configuration", "type": "http://schemas.dmtf.org/cimi/1/mapped", "format": "ext3", "capacity": 11}' http://localhost:3001/cimi/volume_configurations

    Delete a Volume Configuration:

    curl -v -X DELETE --user "mockuser:mockpassword" http://localhost:3001/cimi/volume_configurations/4 

  


  

    
Working with Volume Templates

    Retrieve the Volume Template Collection in json format:

     curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/volume_templates 

    Retrieve a specific Volume Template in xml format:

     curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/cimi/volume_templates/vol_template123

    Create a Volume Template with XML body:

    curl --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d '<VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1"> <name> marios_vol_template </name> <description> my first volume template </description> <volumeConfig href="http://localhost:3001/cimi/volume_configs/1"> </volumeConfig> </VolumeTemplate>' http://localhost:3001/cimi/volume_templates

    Create a Volume Template with JSON body:

    curl -v --user "mockuser:mockpassword" -H "Content-Type: application/json" -H "Accept: application/xml" -X POST -d '{ "resourceURI": "http://schemas.dmtf.org/cimi/1/VolumeTemplate","name": "marios_vol_template", "description": "my first volume template", "volumeConfig": { "href": "http://localhost:3001/cimi/volume_configs/1"} }' http://localhost:3001/cimi/volume_templates 

    Delete a Volume Template:

    curl -v -X DELETE --user "mockuser:mockpassword" http://localhost:3001/cimi/volume_templates/vol_template123

  


      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"h 




  

    cURL examples for CIMI Volume resources


  Working with Volumes
  Working with VolumeImages
  Working with VolumeConfigurations
  Working with VolumeTemplates



  

  


  
    curl for CIMI Resources
  
  
    Machine
    Volume
    ResourceMetadata
  
  



  





  

    

    Working with Volumes

    Retrieve the Volume Collection in json format:

     curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/volumes 

    Retrieve a specific Volume in xml format: 

     curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/cimi/volumes/volume1 

    Create Volume - with VolumeConfiguration by reference, XML body:

    curl -v --user "mockuser:mockpassword" -H "Accept:application/xml" -X POST -d '<VolumeCreate><name> marios_new_volume </name> <description> a new volume </description><volumeTemplate><volumeConfig href="http://localhost:3001/cimi/volume_configurations/2"> </volumeConfig></volumeTemplate></VolumeCreate>' http://localhost:3001//cimi/volumes
     

    Create Volume - with VolumeConfiguration by reference, JSON body:

    curl -v --user "mockuser:mockpassword" -H "Accept:application/xml" -X POST -d '{"name": "marios_new_volume", "description": "a new volume", "volumeTemplate": { "volumeConfig": {"href":"http://localhost:3001/cimi/volume_configurations/2" }}}' http://localhost:3001//cimi/volumes
    

    Create Volume - with VolumeConfiguration by value, XML body:

    curl -v --user "mockuser:mockpassword" -H "Accept:application/xml" -X POST -d '<VolumeCreate><name> marios_volume </name><description> a new volume </description> <volumeTemplate><volumeConfig><type>http://schemas.dmtf.org/cimi/1/mapped</type><capacity> 1024 </capacity></volumeConfig></volumeTemplate> </VolumeCreate>' http://localhost:3001//cimi/volumes
    

    Create Volume - with VolumeConfiguration by value, JSON body:

    curl -v --user "mockuser:mockpassword" -H "Accept:application/xml"  -X POST -d '{"name": "marios_new_volume", "description": "a new volume", "volumeTemplate": { "volumeConfig": {"type":"http://schemas.dmtf.org/cimi/1/mapped", "capacity": 1024 }}}'   http://localhost:3001/cimi/volumes
    

    Delete a Volume

    curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" -X DELETE http://localhost:3001/cimi/volumes/volume94275
    

  

  

    

    Working with Volume Images

    Retrieve the Volume Image Collection in xml format:

     curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/cimi/volume_images

    Retrieve a specific Volume Image in json format:

     curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/volume_images/vol_image1 

    Create a Volume Image from an existing Volume, XML body:

    curl -v --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d '<VolumeImage xmlns="http://schemas.dmtf.org/cimi/1"><name> my_vol_image </name><description> marios first volume image </description><imageLocation href="http://localhost:3001/cimi/volumes/vol1"/></VolumeImage>' http://localhost:3001/cimi/volume_images
    

    Create a Volume Image from an existing Volume, JSON body:

    curl -v --user "mockuser:mockpassword" -H "Content-Type: application/json" -H "Accept: application/xml" -X POST -d  '{ "resourceURI": "http://schemas.dmtf.org/cimi/1/VolumeImage","name": "some_name", "description": "marios first volume image", "imageLocation": { "href": "http://localhost:3001/cimi/volumes/vol1"}}' http://localhost:3001/cimi/volume_images

    Delete a Volume Image:

    curl -v -X DELETE --user "mockuser:mockpassword" http://localhost:3001/cimi/volume_images/store_snapshot_1358516615

  


  

    

    Working with Volume Configurations

    Retrieve the Volume Configuration Collection in json format:

     curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/volume_configurations 

    Retrieve a specific Volume Configuration in xml format:

     curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/cimi/volume_configurations/volume_config1 

    Create a new Volume Configuration with XML body:

    curl -v --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d '<VolumeConfigurationCreate><name>marios_volume_config</name><description>a volume configuration</description><format>qcow2</format><type>http://schemas.dmtf.org/cimi/1/mapped</type> <capacity>10</capacity></VolumeConfigurationCreate>' http://localhost:3001/cimi/volume_configurations
    

    Create a new Volume Configuration with JSON body:

   curl -v --user "mockuser:mockpassword" -H "Content-Type: application/json" -H "Accept: application/xml" -X POST -d '{ "resourceURI": "http://schemas.dmtf.org/cimi/1/VolumeConfiguration","name": "marios_volume_config", "description": "a volume configuration", "type": "http://schemas.dmtf.org/cimi/1/mapped", "format": "ext3", "capacity": 11}' http://localhost:3001/cimi/volume_configurations

    Delete a Volume Configuration:

    curl -v -X DELETE --user "mockuser:mockpassword" http://localhost:3001/cimi/volume_configurations/4 

  


  

    

    Working with Volume Templates

    Retrieve the Volume Template Collection in json format:

     curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/volume_templates 

    Retrieve a specific Volume Template in xml format:

     curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/cimi/volume_templates/vol_template123

    Create a Volume Template with XML body:

    curl --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d '<VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1"> <name> marios_vol_template </name> <description> my first volume template </description> <volumeConfig href="http://localhost:3001/cimi/volume_configs/1"> </volumeConfig> </VolumeTemplate>' http://localhost:3001/cimi/volume_templates

    Create a Volume Template with JSON body:

    curl -v --user "mockuser:mockpassword" -H "Content-Type: application/json" -H "Accept: application/xml" -X POST -d '{ "resourceURI": "http://schemas.dmtf.org/cimi/1/VolumeTemplate","name": "marios_vol_template", "description": "my first volume template", "volumeConfig": { "href": "http://localhost:3001/cimi/volume_configs/1"} }' http://localhost:3001/cimi/volume_templates 

    Delete a Volume Template:

    curl -v -X DELETE --user "mockuser:mockpassword" http://localhost:3001/cimi/volume_templates/vol_template123

  
;T;
I"% 




  

    cURL examples for CIMI Volume resources


Working with Volumes
  Working with VolumeImages
  Working with VolumeConfigurations
  Working with VolumeTemplates



  



    curl for CIMI Resources
  
  
Machine
    Volume
    ResourceMetadata
  









  

    
Working with Volumes

    Retrieve the Volume Collection in json format:

     curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/volumes 

    Retrieve a specific Volume in xml format: 

     curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/cimi/volumes/volume1 

    Create Volume - with VolumeConfiguration by reference, XML body:

    curl -v --user "mockuser:mockpassword" -H "Accept:application/xml" -X POST -d '<VolumeCreate><name> marios_new_volume </name> <description> a new volume </description><volumeTemplate><volumeConfig href="http://localhost:3001/cimi/volume_configurations/2"> </volumeConfig></volumeTemplate></VolumeCreate>' http://localhost:3001//cimi/volumes
     

    Create Volume - with VolumeConfiguration by reference, JSON body:

    curl -v --user "mockuser:mockpassword" -H "Accept:application/xml" -X POST -d '{"name": "marios_new_volume", "description": "a new volume", "volumeTemplate": { "volumeConfig": {"href":"http://localhost:3001/cimi/volume_configurations/2" }}}' http://localhost:3001//cimi/volumes
    

    Create Volume - with VolumeConfiguration by value, XML body:

    curl -v --user "mockuser:mockpassword" -H "Accept:application/xml" -X POST -d '<VolumeCreate><name> marios_volume </name><description> a new volume </description> <volumeTemplate><volumeConfig><type>http://schemas.dmtf.org/cimi/1/mapped</type><capacity> 1024 </capacity></volumeConfig></volumeTemplate> </VolumeCreate>' http://localhost:3001//cimi/volumes
    

    Create Volume - with VolumeConfiguration by value, JSON body:

    curl -v --user "mockuser:mockpassword" -H "Accept:application/xml"  -X POST -d '{"name": "marios_new_volume", "description": "a new volume", "volumeTemplate": { "volumeConfig": {"type":"http://schemas.dmtf.org/cimi/1/mapped", "capacity": 1024 }}}'   http://localhost:3001/cimi/volumes
    

    Delete a Volume

    curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" -X DELETE http://localhost:3001/cimi/volumes/volume94275
    

  

  

    
Working with Volume Images

    Retrieve the Volume Image Collection in xml format:

     curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/cimi/volume_images

    Retrieve a specific Volume Image in json format:

     curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/volume_images/vol_image1 

    Create a Volume Image from an existing Volume, XML body:

    curl -v --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d '<VolumeImage xmlns="http://schemas.dmtf.org/cimi/1"><name> my_vol_image </name><description> marios first volume image </description><imageLocation href="http://localhost:3001/cimi/volumes/vol1"/></VolumeImage>' http://localhost:3001/cimi/volume_images
    

    Create a Volume Image from an existing Volume, JSON body:

    curl -v --user "mockuser:mockpassword" -H "Content-Type: application/json" -H "Accept: application/xml" -X POST -d  '{ "resourceURI": "http://schemas.dmtf.org/cimi/1/VolumeImage","name": "some_name", "description": "marios first volume image", "imageLocation": { "href": "http://localhost:3001/cimi/volumes/vol1"}}' http://localhost:3001/cimi/volume_images

    Delete a Volume Image:

    curl -v -X DELETE --user "mockuser:mockpassword" http://localhost:3001/cimi/volume_images/store_snapshot_1358516615

  


  

    
Working with Volume Configurations

    Retrieve the Volume Configuration Collection in json format:

     curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/volume_configurations 

    Retrieve a specific Volume Configuration in xml format:

     curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/cimi/volume_configurations/volume_config1 

    Create a new Volume Configuration with XML body:

    curl -v --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d '<VolumeConfigurationCreate><name>marios_volume_config</name><description>a volume configuration</description><format>qcow2</format><type>http://schemas.dmtf.org/cimi/1/mapped</type> <capacity>10</capacity></VolumeConfigurationCreate>' http://localhost:3001/cimi/volume_configurations
    

    Create a new Volume Configuration with JSON body:

   curl -v --user "mockuser:mockpassword" -H "Content-Type: application/json" -H "Accept: application/xml" -X POST -d '{ "resourceURI": "http://schemas.dmtf.org/cimi/1/VolumeConfiguration","name": "marios_volume_config", "description": "a volume configuration", "type": "http://schemas.dmtf.org/cimi/1/mapped", "format": "ext3", "capacity": 11}' http://localhost:3001/cimi/volume_configurations

    Delete a Volume Configuration:

    curl -v -X DELETE --user "mockuser:mockpassword" http://localhost:3001/cimi/volume_configurations/4 

  


  

    
Working with Volume Templates

    Retrieve the Volume Template Collection in json format:

     curl --user "user:pass" -H "Accept: application/json" http://localhost:3001/cimi/volume_templates 

    Retrieve a specific Volume Template in xml format:

     curl --user "user:pass" -H "Accept: application/xml" http://localhost:3001/cimi/volume_templates/vol_template123

    Create a Volume Template with XML body:

    curl --user "mockuser:mockpassword" -H "Content-Type: application/xml" -H "Accept: application/xml" -X POST -d '<VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1"> <name> marios_vol_template </name> <description> my first volume template </description> <volumeConfig href="http://localhost:3001/cimi/volume_configs/1"> </volumeConfig> </VolumeTemplate>' http://localhost:3001/cimi/volume_templates

    Create a Volume Template with JSON body:

    curl -v --user "mockuser:mockpassword" -H "Content-Type: application/json" -H "Accept: application/xml" -X POST -d '{ "resourceURI": "http://schemas.dmtf.org/cimi/1/VolumeTemplate","name": "marios_vol_template", "description": "my first volume template", "volumeConfig": { "href": "http://localhost:3001/cimi/volume_configs/1"} }' http://localhost:3001/cimi/volume_templates 

    Delete a Volume Template:

    curl -v -X DELETE --user "mockuser:mockpassword" http://localhost:3001/cimi/volume_templates/vol_template123

  
;T;@`I",/cimi-curl/cimi-curl-resource_metadata/;T{;{	;I"�

  
    
    CIMI cURL Examples - Resource Metadata Resources
    
    

    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    

    
    
    
    
  

  

    
      
        
          
          
  Home
  
    About
    
      What is Deltacloud?
      Supported Providers
    
  
  Download
  
    Installation
    
      Install Deltacloud
      Run the Deltacloud Server
    
  
  
    Usage
    
      Using API
      Client Libraries
      Command Line Tools
    
  
  
    Contribute
    
      Getting Sources
      How Can I Contribute?
    
  
  
    API
    
      Deltacloud REST API
      Deltacloud API cURL examples
      Drivers API
    
  
  
    CIMI
    
      CIMI REST API
      CIMI cURL Examples
    
  
  Contact


        
      

    

    

      




  

    cURL examples for CIMI Resource Metadata resources

  

  



    curl for CIMI Resources
  
  
Machine
    Volume
    ResourceMetadata
  







 Retrieve the Resource Metadata collection in xml format:


  
curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" http://localhost:3001/cimi/resource_metadata

   Retrieve the Resource Metadata as it corresponding to the Cloud Entry Point resource, in json format:

  curl -v --user "mockuser:mockpassword" -H "Accept: application/json" http://localhost:3001/cimi/resource_metadata/cloud_entry_point 

   Retrieve the Resource Metadata as it corresponding to the Machine resource, in xml format:

  curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" http://localhost:3001/cimi/resource_metadata/machine 

      
         Back to top
        
          
            
          
          
            Apache Deltacloud is a top-level project at the Apache Software Foundation,
            having graduated from the ASF Incubator in October
            2011. Through a collaborative and meritocratic development process, Apache
            projects deliver enterprise-grade, freely available software products that
            attract large communities of users. 
          
        
      

    
 





  

;T;	I"




  

    cURL examples for CIMI Resource Metadata resources

  

  


  
    curl for CIMI Resources
  
  
    Machine
    Volume
    ResourceMetadata
  
  



  




   Retrieve the Resource Metadata collection in xml format:


  
curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" http://localhost:3001/cimi/resource_metadata

   Retrieve the Resource Metadata as it corresponding to the Cloud Entry Point resource, in json format:

  curl -v --user "mockuser:mockpassword" -H "Accept: application/json" http://localhost:3001/cimi/resource_metadata/cloud_entry_point 

   Retrieve the Resource Metadata as it corresponding to the Machine resource, in xml format:

  curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" http://localhost:3001/cimi/resource_metadata/machine ;T;
I"�




  

    cURL examples for CIMI Resource Metadata resources

  

  



    curl for CIMI Resources
  
  
Machine
    Volume
    ResourceMetadata
  







 Retrieve the Resource Metadata collection in xml format:


  
curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" http://localhost:3001/cimi/resource_metadata

   Retrieve the Resource Metadata as it corresponding to the Cloud Entry Point resource, in json format:

  curl -v --user "mockuser:mockpassword" -H "Accept: application/json" http://localhost:3001/cimi/resource_metadata/cloud_entry_point 

   Retrieve the Resource Metadata as it corresponding to the Machine resource, in xml format:

  curl -v --user "mockuser:mockpassword" -H "Accept: application/xml" http://localhost:3001/cimi/resource_metadata/machine 
;T;@fI"/assets/img/API_Diagram/;T{;{:versioni

Resource Name	Capability Name	Description
CloudEntryPoint	ExpandParameter	Indicated whether the $expand query parameter is supported by the Provider.
CloudEntryPoint	FilterParameter	Indicates whether the $filter query parameter is supported by the Provider.
CloudEntryPoint	firstParameter	Indicates whether the $first and $last query parameters are supported by the Provider. Note that either both shall be supported or neither shall be supported.
CloudEntryPoint	SelectParameter	Indicated whether the $select query parameter is supported by the Provider.
System	SystemComponentTemplateByValue	Indicates that the Provider supports specifying Component Templates by-value in SystemTemplates.
Machine	DefaultInitialState	Indicates what the default initial state of a new Machine will be unless explicitly set by the "initialState" attribute
Machine	InitialStates	Indicates the list of allowable initial states that Consumer may choose from when creating a new Machine.
Machine	MachineConfigByValue	Indicates that the Provider supports specifying Machine Configurations by-value in Machine create operations. If true the MachineTemplateByValue capability shall also be specified with a value of true.
Machine	MachineCredentialByValue	Indicates that the Provider supports specifying Credential by-value in Machine create operations. If true the MachineTemplateByValue capability shall also be specified with a value of true.
Machine	MachineImageByValue	Indicates that the Provider supports specifying Machine Images by-value in Machine create operations. If true the MachineTemplateByValue capability shall also be specified with a value of true.
Machine	MachineVolumeTemplatesByValue	Indicates that the Provider supports specifying VolumeTemplates by-value in Machine create operations. If true the MachineTemplateByValue capability shall also be specified with a value of true.
Machine	MachineStopForce	Indicates that the Provider supports specifying the "force" option on the stop and restart operations.
Machine	MachineStopForceDefault	Indicates the default way in which the Provider will stop/restart a Machine. When set to "true", the Provider will forcefully stop the Machine, as opposed to a value of "false," which indicates that the Provider will attempt to gracefully stop the Machine.
Machine	RestoreFromImage	Indicates that the Provider supports restoring Machines from Machine Images that are not SNAPSHOT Machine Images.
Machine	UserData	Indicates which userData injection method will be used. See 5.14.1 for more information.
Credential	CredentialTemplateByValue	Indicates that the Provider supports specifying Credential Templates by-value in Credential create operations.
Volume	SharedVolumeSupport	Indicates that the Provider supports the sharing of volume resources across Machines. The value specified is of type "boolean."
Volume	VolumeConfigByValue	Indicates that the Provider supports specifying Volume Configurations by-value in the Volume create operation. If true, the VolumeTemplateByValue capability shall also be specified with a value of true.
Volume	VolumeImageByValue	Indicates that the Provider supports specifying Volume Images by-value in the Volume create operation. If true the VolumeTemplateByValue capability shall also be specified with a value of true.
Volume	VolumeSnapshot	Indicates that the Provider supports creating a new VolumeImage by referencing an existing Volume.
Volume	VolumeTemplateByValue	Indicates that the Provider supports specifying Volume Templates by-value in Volume create operations.
Network	NetworkConfigByValue	Indicates that the Provider supports specifying Network Configurations by-value in the Network create operation.
Network	NetworkTemplateByValue	Indicates that the Provider supports specifying Network Templates by-value in the Network create operation.
NetworkPort	NetworkPortConfigByValue	Indicates that the Provider supports specifying NetworkPort Configurations by-value in the NetworkPort create operation.
NetworkPort	NetworkPortTemplateByValue	Indicates that the Provider supports specifying NetworkPort Templates by-value in the NetworkPort create operation.
ForwardingGroup	MixedNetwork	Indicates whether ForwardingGroups can support both private and public connection at the same time.
Job	JobRetention	If the Provider supports Job resources as specified in this document, this capability indicates in minutes how long a job will live in the system before its deleted. In this case, the value attribute provides the number of minutes (e.g., 30 min). The value specified is of type "integer."
Meter	MeterConfigByValue	Indicates that the Provider supports specifying MeterConfigurations by-value in the Meter create operation.
Meter	MeterTemplateByValue	Indicates that the Provider supports specifying Meter Templates by-value in the Meter create operation.
EventLog	Linked	Indicates that the Provider shall delete EventLogs that are associated with resources when the resource is deleted.