You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@deltacloud.apache.org by ma...@apache.org on 2013/01/21 17:15:22 UTC

[1/5] SITE: CIMI Docs (REST API) and cURL examples

http://git-wip-us.apache.org/repos/asf/deltacloud/blob/d3b146f1/site/output/cimi-rest/cimi-rest-resource-metadata.html
----------------------------------------------------------------------
diff --git a/site/output/cimi-rest/cimi-rest-resource-metadata.html b/site/output/cimi-rest/cimi-rest-resource-metadata.html
new file mode 100644
index 0000000..2595db8
--- /dev/null
+++ b/site/output/cimi-rest/cimi-rest-resource-metadata.html
@@ -0,0 +1,602 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>CIMI Resource Collections - Resource Metadata</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+    <script src="/assets/js/jquery.tweet.js" type="text/javascript"></script>
+    <script src="/assets/js/application.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-transition.js"></script>
+    <script src="/assets/js/bootstrap-alert.js"></script>
+    <script src="/assets/js/bootstrap-modal.js"></script>
+    <script src="/assets/js/bootstrap-scrollspy.js"></script>
+    <script src="/assets/js/bootstrap-tab.js"></script>
+    <script src="/assets/js/bootstrap-tooltip.js"></script>
+    <script src="/assets/js/bootstrap-popover.js"></script>
+    <script src="/assets/js/bootstrap-button.js"></script>
+    <script src="/assets/js/bootstrap-collapse.js"></script>
+    <script src="/assets/js/bootstrap-carousel.js"></script>
+    <script src="/assets/js/bootstrap-typeahead.js"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
+  </head>
+
+  <body>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about.html">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers.html">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li><a href="/download.html">Download</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Installation<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud.html">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server.html">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="/usage.html" class="dropdown-toggle" data-toggle="dropdown">Usage<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/usage.html#usingapi">Using API</a></li>
+      <li><a href="/usage.html#clients">Client Libraries</a></li>
+      <li><a href="/command-tools.html">Command Line Tools</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/getting-sources.html">Getting Sources</a></li>
+      <li><a href="/how-to-contribute.html">How Can I Contribute?</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api.html">REST API</a></li>
+      <li><a href="/drivers.html">Drivers API</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">CIMI<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/cimi-rest.html">CIMI REST API</a></li>
+      <li><a href="/cimi-curl.html">CIMI cURL Examples</a></li>
+    </ul>
+  </li>
+  <li><a href="/contact.html">Contact</a></li>
+</ul>
+
+        </div>
+      </div>
+
+    </div>
+
+    <div class="container content">
+
+      <p><br></p>
+
+<div class="row">
+  <div class="span9">
+
+<h3 id="cimi-resource-metadata">Resource Metadata</h3>
+<p>
+<strong><em>
+ResourceMetadata may be used to:
+<ul>
+<li>Express constraints on the existing CIMI defined resource attributes (e.g., express a maximum for
+the 'cpu' attribute of the MachineConfiguration resource) </li>
+<li> 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)</li>
+<li> Introduce new operations for any of the CIMI defined resources (e.g., define a new 'compress'
+operation for the Volume resource)</li>
+<li> 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)</li>
+</ul>
+
+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.
+</em></strong>
+</p>
+
+  </div>
+  <div class="span3">
+
+
+<ul class="nav nav-list well">
+<li class="nav-header">
+    CIMI REST API
+  </li>
+  <li><a href="../cimi-rest.html">Introduction</a></li>
+  <li><a href="cimi-rest-entry-point.html">Cloud Entry Point</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">
+      CIMI Resources
+      <b class="caret"></b>
+    </a>
+    <ul class="dropdown-menu">
+<li><a href="cimi-rest-resource-metadata.html">ResourceMetadata</a></li>
+      <li><a href="cimi-rest-collections.html">Machine</a></li>
+      <li><a href="cimi-rest-volumes.html">Volume</a></li>
+    </ul>
+</li>
+  <hr>
+<li class="nav-header">
+    Resource Metadata
+  </li>
+
+</ul>
+</div>
+
+</div>
+
+<ul class="nav nav-pills">
+<li class="active"><a href="#resource-metadata" data-toggle="tab">Retrieve the ResourceMetadata Collection</a></li>
+  <li><a href="#resource-metadata-capabilities" data-toggle="tab">ResourceMetadata Capabilities</a></li>
+</ul><div class="tab-content">
+  <div class="tab-pane active" id="resource-metadata">
+
+<h4>Retrieve the ResourceMetadata Collection</h4>
+
+<p>Example request:</p>
+
+<pre>
+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
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+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
+
+&lt;Collection xmlns="http://schemas.dmtf.org/cimi/1"
+          resourceURI="http://schemas.dmtf.org/cimi/1/ResourceMetadataCollection"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/resource_metadata&lt;/id&gt;
+  &lt;count&gt;2&lt;/count&gt;
+  &lt;ResourceMetadata&gt;
+    &lt;id&gt;http://localhost:3001/cimi/resource_metadata/cloud_entry_point&lt;/id&gt;
+    &lt;name&gt;CloudEntryPoint&lt;/name&gt;
+    &lt;typeUri&gt;http://schemas.dmtf.org/cimi/1/CloudEntryPoint&lt;/typeUri&gt;
+    &lt;attribute name="driver" namespace="http://deltacloud.org/cimi/CloudEntryPoint/driver"
+          type="text" required="true" /&gt;
+    &lt;attribute name="provider" namespace="http://deltacloud.org/cimi/CloudEntryPoint/provider"
+          type="text" required="true" /&gt;
+  &lt;/ResourceMetadata&gt;
+  &lt;ResourceMetadata&gt;
+    &lt;id&gt;http://localhost:3001/cimi/resource_metadata/machine&lt;/id&gt;
+    &lt;name&gt;Machine&lt;/name&gt;
+    &lt;typeUri&gt;http://schemas.dmtf.org/cimi/1/Machine&lt;/typeUri&gt;
+    &lt;attribute name="realm" namespace="http://deltacloud.org/cimi/Machine/realm"
+           type="text" required="false"&gt;
+      &lt;constraint&gt;
+        &lt;value&gt;us&lt;/value&gt;
+      &lt;/constraint&gt;
+      &lt;constraint&gt;
+        &lt;value&gt;eu&lt;/value&gt;
+      &lt;/constraint&gt;
+    &lt;/attribute&gt;
+    &lt;attribute name="machine_image"
+          namespace="http://deltacloud.org/cimi/Machine/machine_image" type="URI"
+          required="false" /&gt;
+    &lt;capability name="DefaultInitialState"
+          uri="http://schemas.dmtf.org/cimi/1/capability/Machine/DefaultInitialState"
+          description="Indicates what the default initial state of a new Machine "&gt;
+          STARTED
+    &lt;/capability&gt;
+    &lt;capability name="InitialStates"
+          uri="http://schemas.dmtf.org/cimi/1/capability/Machine/InitialStates"
+          description="Indicates the list of allowable initial states"&gt;
+          STARTED,STOPPED
+    &lt;/capability&gt;
+  &lt;/ResourceMetadata&gt;
+&lt;/Collection&gt;
+</pre>
+
+  </div>
+
+  <div class="tab-pane" id="resource-metadata-capabilities">
+
+<h4>ResourceMetadata Capabilities</h4>
+<br><p>
+<strong><em>
+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:
+
+<pre> http://schemas.dmtf.org/cimi/1/capability/Machine/InitialState </pre>
+
+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).
+</em></strong>
+</p>
+<br><table class="table-bordered table-striped table-condensed">
+<thead><tr>
+<th>
+        Resource Name
+      </th>
+      <th>
+        Capability Name
+      </th>
+      <th>
+        Description
+      </th>
+    </tr></thead>
+<tbody>
+<tr>
+<td>CloudEntryPoint  </td>
+      <td>ExpandParameter  </td>
+      <td> Indicated whether the $expand query parameter is
+supported by the Provider.
+</td>
+    </tr>
+<tr>
+<td>CloudEntryPoint
+ </td>
+      <td>FilterParameter
+ </td>
+      <td>Indicates whether the $filter query parameter is
+supported by the Provider.
+ </td>
+    </tr>
+<tr>
+<td>CloudEntryPoint
+ </td>
+      <td>firstParameter
+ </td>
+      <td>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.
+ </td>
+    </tr>
+<tr>
+<td>CloudEntryPoint
+ </td>
+      <td>SelectParameter
+ </td>
+      <td>Indicated whether the $select query parameter is
+supported by the Provider.
+ </td>
+    </tr>
+<tr>
+<td>System
+ </td>
+      <td>SystemComponentTemplateByValue
+ </td>
+      <td>Indicates that the Provider supports specifying
+Component Templates by-value in SystemTemplates.
+ </td>
+    </tr>
+<tr>
+<td>Machine
+ </td>
+      <td>DefaultInitialState
+ </td>
+      <td>Indicates what the default initial state of a new Machine
+will be unless explicitly set by the "initialState" attribute
+ </td>
+    </tr>
+<tr>
+<td>Machine
+ </td>
+      <td>InitialStates
+ </td>
+      <td>Indicates the list of allowable initial states that
+Consumer may choose from when creating a new
+Machine.
+ </td>
+    </tr>
+<tr>
+<td>Machine
+ </td>
+      <td>MachineConfigByValue
+ </td>
+      <td>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.
+ </td>
+    </tr>
+<tr>
+<td>Machine
+ </td>
+      <td>MachineCredentialByValue
+ </td>
+      <td>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.
+ </td>
+    </tr>
+<tr>
+<td>Machine
+ </td>
+      <td>MachineImageByValue
+ </td>
+      <td>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.
+ </td>
+    </tr>
+<tr>
+<td>Machine
+ </td>
+      <td>MachineVolumeTemplatesByValue
+ </td>
+      <td>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.
+ </td>
+    </tr>
+<tr>
+<td>Machine
+ </td>
+      <td>MachineStopForce
+ </td>
+      <td>Indicates that the Provider supports specifying the
+"force" option on the stop and restart operations.
+ </td>
+    </tr>
+<tr>
+<td>Machine
+ </td>
+      <td>MachineStopForceDefault
+ </td>
+      <td>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.
+ </td>
+    </tr>
+<tr>
+<td>Machine
+ </td>
+      <td>RestoreFromImage
+ </td>
+      <td>Indicates that the Provider supports restoring Machines
+from Machine Images that are not SNAPSHOT Machine
+Images.
+ </td>
+    </tr>
+<tr>
+<td>Machine
+ </td>
+      <td>UserData
+ </td>
+      <td>Indicates which userData injection method will be used.
+See 5.14.1 for more information.
+ </td>
+    </tr>
+<tr>
+<td>Credential
+ </td>
+      <td>CredentialTemplateByValue
+ </td>
+      <td>Indicates that the Provider supports specifying
+Credential Templates by-value in Credential create
+operations.
+ </td>
+    </tr>
+<tr>
+<td>Volume
+ </td>
+      <td>SharedVolumeSupport
+ </td>
+      <td>Indicates that the Provider supports the sharing of
+volume resources across Machines. The value specified
+is of type "boolean."
+ </td>
+    </tr>
+<tr>
+<td>Volume
+ </td>
+      <td>VolumeConfigByValue
+ </td>
+      <td>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.
+ </td>
+    </tr>
+<tr>
+<td>Volume
+ </td>
+      <td>VolumeImageByValue
+ </td>
+      <td>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.
+ </td>
+    </tr>
+<tr>
+<td>Volume
+ </td>
+      <td>VolumeSnapshot
+ </td>
+      <td>Indicates that the Provider supports creating a new
+VolumeImage by referencing an existing Volume.
+ </td>
+    </tr>
+<tr>
+<td>Volume
+ </td>
+      <td>VolumeTemplateByValue
+ </td>
+      <td>Indicates that the Provider supports specifying Volume
+Templates by-value in Volume create operations.
+ </td>
+    </tr>
+<tr>
+<td>Network
+ </td>
+      <td>NetworkConfigByValue
+ </td>
+      <td>Indicates that the Provider supports specifying Network
+Configurations by-value in the Network create
+operation.
+ </td>
+    </tr>
+<tr>
+<td>Network
+ </td>
+      <td>NetworkTemplateByValue
+ </td>
+      <td>Indicates that the Provider supports specifying Network
+Templates by-value in the Network create operation.
+ </td>
+    </tr>
+<tr>
+<td>NetworkPort
+ </td>
+      <td>NetworkPortConfigByValue
+ </td>
+      <td>Indicates that the Provider supports specifying
+NetworkPort Configurations by-value in the NetworkPort
+create operation.
+ </td>
+    </tr>
+<tr>
+<td>NetworkPort
+ </td>
+      <td>NetworkPortTemplateByValue
+ </td>
+      <td>Indicates that the Provider supports specifying
+NetworkPort Templates by-value in the NetworkPort
+create operation.
+ </td>
+    </tr>
+<tr>
+<td>ForwardingGroup
+ </td>
+      <td>MixedNetwork
+ </td>
+      <td>Indicates whether ForwardingGroups can support both
+private and public connection at the same time.
+ </td>
+    </tr>
+<tr>
+<td>Job
+ </td>
+      <td>JobRetention
+ </td>
+      <td>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."
+ </td>
+    </tr>
+<tr>
+<td>Meter
+ </td>
+      <td>MeterConfigByValue
+ </td>
+      <td>Indicates that the Provider supports specifying
+MeterConfigurations by-value in the Meter create
+operation.
+ </td>
+    </tr>
+<tr>
+<td>Meter
+ </td>
+      <td>MeterTemplateByValue
+ </td>
+      <td>Indicates that the Provider supports specifying Meter
+Templates by-value in the Meter create operation.
+ </td>
+    </tr>
+<tr>
+<td>EventLog
+ </td>
+      <td>Linked
+ </td>
+      <td>Indicates that the Provider shall delete EventLogs that
+are associated with resources when the resource is
+deleted.
+ </td>
+    </tr>
+</tbody>
+</table>
+</div>
+</div>
+
+      <footer class="footer">
+        <p class="pull-right"><span class='icon-circle-arrow-up'>&nbsp;</span><a href="#">Back to top</a></p>
+        <div class='row'>
+          <div class='span3'>
+            <img src="/assets/img/asf.png" alt="Apache Software Foundation"/>
+          </div>
+          <div class='span9'>
+            <strong>Apache Deltacloud</strong> is a top-level project at the <a
+              href="http://www.apache.org">Apache Software Foundation</a>,
+            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. 
+          </div>
+        </div>
+      </footer>
+
+    </div> <!-- /container -->
+
+<!-- Piwik -->
+<script type="text/javascript">
+var pkBaseURL = (("https:" == document.location.protocol) ? "https://stats.salasaga.org/aeolus/piwik/" : "http://stats.salasaga.org/aeolus/piwik/");
+document.write(unescape("%3Cscript src='" + pkBaseURL + "piwik.js' type='text/javascript'%3E%3C/script%3E"));
+</script><script type="text/javascript">
+try {
+var piwikTracker = Piwik.getTracker(pkBaseURL + "piwik.php", 2);
+piwikTracker.trackPageView();
+piwikTracker.enableLinkTracking();
+} catch( err ) {}
+</script><noscript><p><img src="http://stats.salasaga.org/aeolus/piwik/piwik.php?idsite=2" style="border:0" alt="" /></p></noscript>
+<!-- End Piwik Tracking Code -->
+
+  </body>
+</html>

http://git-wip-us.apache.org/repos/asf/deltacloud/blob/d3b146f1/site/output/cimi-rest/cimi-rest-volume-configs.html
----------------------------------------------------------------------
diff --git a/site/output/cimi-rest/cimi-rest-volume-configs.html b/site/output/cimi-rest/cimi-rest-volume-configs.html
new file mode 100644
index 0000000..35f657a
--- /dev/null
+++ b/site/output/cimi-rest/cimi-rest-volume-configs.html
@@ -0,0 +1,366 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>CIMI Resource Collections - Volume Configuration</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+    <script src="/assets/js/jquery.tweet.js" type="text/javascript"></script>
+    <script src="/assets/js/application.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-transition.js"></script>
+    <script src="/assets/js/bootstrap-alert.js"></script>
+    <script src="/assets/js/bootstrap-modal.js"></script>
+    <script src="/assets/js/bootstrap-scrollspy.js"></script>
+    <script src="/assets/js/bootstrap-tab.js"></script>
+    <script src="/assets/js/bootstrap-tooltip.js"></script>
+    <script src="/assets/js/bootstrap-popover.js"></script>
+    <script src="/assets/js/bootstrap-button.js"></script>
+    <script src="/assets/js/bootstrap-collapse.js"></script>
+    <script src="/assets/js/bootstrap-carousel.js"></script>
+    <script src="/assets/js/bootstrap-typeahead.js"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
+  </head>
+
+  <body>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about.html">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers.html">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li><a href="/download.html">Download</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Installation<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud.html">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server.html">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="/usage.html" class="dropdown-toggle" data-toggle="dropdown">Usage<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/usage.html#usingapi">Using API</a></li>
+      <li><a href="/usage.html#clients">Client Libraries</a></li>
+      <li><a href="/command-tools.html">Command Line Tools</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/getting-sources.html">Getting Sources</a></li>
+      <li><a href="/how-to-contribute.html">How Can I Contribute?</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api.html">REST API</a></li>
+      <li><a href="/drivers.html">Drivers API</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">CIMI<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/cimi-rest.html">CIMI REST API</a></li>
+      <li><a href="/cimi-curl.html">CIMI cURL Examples</a></li>
+    </ul>
+  </li>
+  <li><a href="/contact.html">Contact</a></li>
+</ul>
+
+        </div>
+      </div>
+
+    </div>
+
+    <div class="container content">
+
+      <p><br></p>
+
+<div class="row">
+  <div class="span9">
+
+<h3 id="cimi-volume-config">Volume Configuration</h3>
+<p>
+<strong><em>
+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.
+<br><br>
+A Volume Configuration Collection resource represents the collection of Volume Configuration resources
+within a Provider.
+</em></strong>
+</p>
+
+  </div>
+  <div class="span3">
+
+
+<ul class="nav nav-list well">
+<li class="nav-header">
+    CIMI REST API
+  </li>
+  <li><a href="../cimi-rest.html">Introduction</a></li>
+  <li><a href="cimi-rest-entry-point.html">Cloud Entry Point</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">
+      CIMI Resources
+      <b class="caret"></b>
+    </a>
+    <ul class="dropdown-menu">
+<li><a href="cimi-rest-resource-metadata.html">Resource Metadata</a></li>
+      <li><a href="cimi-rest-collections.html">Machine</a></li>
+      <li><a href="cimi-rest-volumes.html">Volume</a></li>
+    </ul>
+</li>
+  <hr>
+<li class="nav-header">
+    Volume Resources
+  </li>
+  <ul class="nav nav-list">
+<li><a href="cimi-rest-volumes.html">Volume</a></li>
+    <li><a href="cimi-rest-volume-images.html">VolumeImage</a></li>
+    <li class="active"><a href="cimi-rest-volume-configs.html">VolumeConfiguration</a></li>
+    <li><a href="cimi-rest-volume-templates.html">VolumeTemplate</a></li>
+  </ul>
+</ul>
+</div>
+
+</div>
+
+<ul class="nav nav-pills">
+<li class="active"><a href="#volume-config-collection" data-toggle="tab">Retrieve the Volume Configuration Collection</a></li>
+  <li><a href="#single-volume-config" data-toggle="tab">Retrieve a single Volume Configuration</a></li>
+  <li><a href="#create-volume-config" data-toggle="tab">Create a Volume Configuration</a></li>
+  <li><a href="#delete-volume-config" data-toggle="tab">Delete a Volume Configuration</a></li>
+</ul><hr><div class="tab-content">
+
+  <div class="tab-pane active" id="volume-config-collection">
+
+<h4>Retrieve the Volume Configuration Collection</h4>
+
+<p>Example request:</p>
+
+<pre>
+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
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+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
+
+&lt;Collection xmlns="http://schemas.dmtf.org/cimi/1"
+          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeConfigurationCollection"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/volume_configurations&lt;/id&gt;
+  &lt;count&gt;2&lt;/count&gt;
+  &lt;VolumeConfiguration&gt;
+    &lt;id&gt;http://localhost:3001/cimi/volume_configurations/6&lt;/id&gt;
+    &lt;name&gt;marios_volume_config&lt;/name&gt;
+    &lt;description&gt;a volume configuration&lt;/description&gt;
+    &lt;format&gt;qcow2&lt;/format&gt;
+    &lt;capacity&gt;10485760&lt;/capacity&gt;
+    &lt;operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
+          href="http://localhost:3001/cimi/volume_configurations/6" /&gt;
+  &lt;/VolumeConfiguration&gt;
+  &lt;VolumeConfiguration&gt;
+    &lt;id&gt;http://localhost:3001/cimi/volume_configurations/7&lt;/id&gt;
+    &lt;name&gt;YAVC&lt;/name&gt;
+    &lt;description&gt; yet another volume configuration&lt;/description&gt;
+    &lt;format&gt;ext3&lt;/format&gt;
+    &lt;capacity&gt;1073741824&lt;/capacity&gt;
+    &lt;operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
+          href="http://localhost:3001/cimi/volume_configurations/7" /&gt;
+  &lt;/VolumeConfiguration&gt;
+  &lt;operation rel="add" href="http://localhost:3001/cimi/volume_configurations" /&gt;
+&lt;/Collection&gt;
+</pre>
+
+  </div>
+
+  <div class="tab-pane" id="single-volume-config">
+
+<h4>Retrieve a single Volume Configuration</h4>
+
+<p>Example request:</p>
+
+<pre>
+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
+</pre>
+
+
+<p>Server response:</p>
+
+<pre>
+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
+
+&lt;VolumeConfiguration xmlns="http://schemas.dmtf.org/cimi/1"
+          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeConfiguration"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/volume_configurations/2&lt;/id&gt;
+  &lt;name&gt;volume-2&lt;/name&gt;
+  &lt;description&gt;Volume configuration with 2097152 kibibytes&lt;/description&gt;
+  &lt;created&gt;2013-01-10T10:51:03+02:00&lt;/created&gt;
+  &lt;capacity&gt;2097152&lt;/capacity&gt;
+&lt;/VolumeConfiguration&gt;
+</pre>
+
+  </div>
+  <div class="tab-pane" id="create-volume-config">
+
+<h4>Create a Volume Configuration</h4>
+
+<p>Example request:</p>
+<pre>
+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
+
+&lt;VolumeConfigurationCreate&gt;
+  &lt;name&gt;marios_volume_config&lt;/name&gt;
+  &lt;description&gt;a volume configuration&lt;/description&gt;
+  &lt;format&gt;qcow2&lt;/format&gt;
+  &lt;capacity&gt;10&lt;/capacity&gt;
+&lt;/VolumeConfigurationCreate&gt;
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+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
+
+&lt;VolumeConfiguration xmlns="http://schemas.dmtf.org/cimi/1"
+          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeConfiguration"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/volume_configurations/6&lt;/id&gt;
+  &lt;name&gt;marios_volume_config&lt;/name&gt;
+  &lt;description&gt;a volume configuration&lt;/description&gt;
+  &lt;format&gt;qcow2&lt;/format&gt;
+  &lt;capacity&gt;10485760&lt;/capacity&gt;
+  &lt;operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
+          href="http://localhost:3001/cimi/volume_configurations/6" /&gt;
+&lt;/VolumeConfiguration&gt;
+</pre>
+
+  </div>
+
+  <div class="tab-pane" id="delete-volume-config">
+
+<h4>Delete a Volume Configuration</h4>
+
+<p>Example request:</p>
+
+<pre>
+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
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+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
+</pre>
+  </div>
+
+</div>
+
+      <footer class="footer">
+        <p class="pull-right"><span class='icon-circle-arrow-up'>&nbsp;</span><a href="#">Back to top</a></p>
+        <div class='row'>
+          <div class='span3'>
+            <img src="/assets/img/asf.png" alt="Apache Software Foundation"/>
+          </div>
+          <div class='span9'>
+            <strong>Apache Deltacloud</strong> is a top-level project at the <a
+              href="http://www.apache.org">Apache Software Foundation</a>,
+            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. 
+          </div>
+        </div>
+      </footer>
+
+    </div> <!-- /container -->
+
+<!-- Piwik -->
+<script type="text/javascript">
+var pkBaseURL = (("https:" == document.location.protocol) ? "https://stats.salasaga.org/aeolus/piwik/" : "http://stats.salasaga.org/aeolus/piwik/");
+document.write(unescape("%3Cscript src='" + pkBaseURL + "piwik.js' type='text/javascript'%3E%3C/script%3E"));
+</script><script type="text/javascript">
+try {
+var piwikTracker = Piwik.getTracker(pkBaseURL + "piwik.php", 2);
+piwikTracker.trackPageView();
+piwikTracker.enableLinkTracking();
+} catch( err ) {}
+</script><noscript><p><img src="http://stats.salasaga.org/aeolus/piwik/piwik.php?idsite=2" style="border:0" alt="" /></p></noscript>
+<!-- End Piwik Tracking Code -->
+
+  </body>
+</html>

http://git-wip-us.apache.org/repos/asf/deltacloud/blob/d3b146f1/site/output/cimi-rest/cimi-rest-volume-images.html
----------------------------------------------------------------------
diff --git a/site/output/cimi-rest/cimi-rest-volume-images.html b/site/output/cimi-rest/cimi-rest-volume-images.html
new file mode 100644
index 0000000..5c12740
--- /dev/null
+++ b/site/output/cimi-rest/cimi-rest-volume-images.html
@@ -0,0 +1,375 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>CIMI Resource Collections - Volume Image</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+    <script src="/assets/js/jquery.tweet.js" type="text/javascript"></script>
+    <script src="/assets/js/application.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-transition.js"></script>
+    <script src="/assets/js/bootstrap-alert.js"></script>
+    <script src="/assets/js/bootstrap-modal.js"></script>
+    <script src="/assets/js/bootstrap-scrollspy.js"></script>
+    <script src="/assets/js/bootstrap-tab.js"></script>
+    <script src="/assets/js/bootstrap-tooltip.js"></script>
+    <script src="/assets/js/bootstrap-popover.js"></script>
+    <script src="/assets/js/bootstrap-button.js"></script>
+    <script src="/assets/js/bootstrap-collapse.js"></script>
+    <script src="/assets/js/bootstrap-carousel.js"></script>
+    <script src="/assets/js/bootstrap-typeahead.js"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
+  </head>
+
+  <body>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about.html">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers.html">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li><a href="/download.html">Download</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Installation<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud.html">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server.html">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="/usage.html" class="dropdown-toggle" data-toggle="dropdown">Usage<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/usage.html#usingapi">Using API</a></li>
+      <li><a href="/usage.html#clients">Client Libraries</a></li>
+      <li><a href="/command-tools.html">Command Line Tools</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/getting-sources.html">Getting Sources</a></li>
+      <li><a href="/how-to-contribute.html">How Can I Contribute?</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api.html">REST API</a></li>
+      <li><a href="/drivers.html">Drivers API</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">CIMI<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/cimi-rest.html">CIMI REST API</a></li>
+      <li><a href="/cimi-curl.html">CIMI cURL Examples</a></li>
+    </ul>
+  </li>
+  <li><a href="/contact.html">Contact</a></li>
+</ul>
+
+        </div>
+      </div>
+
+    </div>
+
+    <div class="container content">
+
+      <p><br></p>
+
+<div class="row">
+  <div class="span9">
+
+<h3 id="cimi-volume-image">Volume Image</h3>
+<p>
+<strong><em>
+This resource represents an image that could be placed on a pre-loaded volume.
+<br><br>
+A Volume Image Collection resource represents the collection of Volume Image resources within a
+Provider.
+</em></strong>
+</p>
+
+  </div>
+  <div class="span3">
+
+
+<ul class="nav nav-list well">
+<li class="nav-header">
+    CIMI REST API
+  </li>
+  <li><a href="../cimi-rest.html">Introduction</a></li>
+  <li><a href="cimi-rest-entry-point.html">Cloud Entry Point</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">
+      CIMI Resources
+      <b class="caret"></b>
+    </a>
+    <ul class="dropdown-menu">
+<li><a href="cimi-rest-resource-metadata.html">ResourceMetadata</a></li>
+      <li><a href="cimi-rest-collections.html">Machine</a></li>
+      <li><a href="cimi-rest-volumes.html">Volume</a></li>
+    </ul>
+</li>
+  <hr>
+<li class="nav-header">
+    Volume Resources
+  </li>
+  <ul class="nav nav-list">
+<li><a href="cimi-rest-volumes.html">Volume</a></li>
+    <li class="active"><a href="cimi-rest-volume-images.html">VolumeImage</a></li>
+    <li><a href="cimi-rest-volume-configs.html">VolumeConfiguration</a></li>
+    <li><a href="cimi-rest-volume-templates.html">VolumeTemplate</a></li>
+  </ul>
+</ul>
+</div>
+
+</div>
+
+<ul class="nav nav-pills">
+<li class="active"><a href="#volume-image-collection" data-toggle="tab">Retrieve the Volume Image Collection</a></li>
+  <li><a href="#single-volume-image" data-toggle="tab">Retrieve a single Volume Image</a></li>
+  <li><a href="#create-volume-image" data-toggle="tab">Create a Volume Image</a></li>
+  <li><a href="#delete-volume-image" data-toggle="tab">Delete a Volume Image</a></li>
+</ul><hr><div class="tab-content">
+
+  <div class="tab-pane active" id="volume-image-collection">
+
+<h4>Retrieve the Volume Image Collection</h4>
+
+<p>Example request:</p>
+
+<pre>
+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
+</pre>
+
+
+<p>Server response:</p>
+
+<pre>
+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
+
+&lt;Collection xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/VolumeImageCollection"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/volume_images&lt;/id&gt;
+  &lt;count&gt;3&lt;/count&gt;
+  &lt;VolumeImage&gt;
+    &lt;id&gt;http://localhost:3001/cimi/volume_images/snap1&lt;/id&gt;
+    &lt;name&gt;snap1&lt;/name&gt;
+    &lt;description&gt;snap1&lt;/description&gt;
+    &lt;created&gt;2009-07-29T18:15:24Z&lt;/created&gt;
+    &lt;imageLocation href="http://localhost:3001/cimi/volumes/vol1" /&gt;
+    &lt;bootable&gt;false&lt;/bootable&gt;
+  &lt;/VolumeImage&gt;
+  &lt;VolumeImage&gt;
+    &lt;id&gt;http://localhost:3001/cimi/volume_images/snap3&lt;/id&gt;
+    &lt;name&gt;snap3&lt;/name&gt;
+    &lt;description&gt;snap3&lt;/description&gt;
+    &lt;created&gt;2009-07-29T18:15:24Z&lt;/created&gt;
+    &lt;imageLocation href="http://localhost:3001/cimi/volumes/vol2" /&gt;
+    &lt;bootable&gt;false&lt;/bootable&gt;
+  &lt;/VolumeImage&gt;
+  &lt;VolumeImage&gt;
+    &lt;id&gt;http://localhost:3001/cimi/volume_images/snap2&lt;/id&gt;
+    &lt;name&gt;snap2&lt;/name&gt;
+    &lt;description&gt;snap2&lt;/description&gt;
+    &lt;created&gt;2009-07-29T18:15:24Z&lt;/created&gt;
+    &lt;imageLocation href="http://localhost:3001/cimi/volumes/vol2" /&gt;
+    &lt;bootable&gt;false&lt;/bootable&gt;
+  &lt;/VolumeImage&gt;
+&lt;/Collection&gt;
+</pre>
+
+  </div>
+
+
+  <div class="tab-pane active" id="single-volume-image">
+
+<h4>Retrieve a single Volume Image</h4>
+
+<p>Example request:</p>
+
+<pre>
+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
+</pre>
+
+
+<p>Server response:</p>
+
+<pre>
+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
+
+&lt;VolumeImage xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/VolumeImage"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/volume_images/snap1&lt;/id&gt;
+  &lt;name&gt;snap1&lt;/name&gt;
+  &lt;description&gt;snap1&lt;/description&gt;
+  &lt;created&gt;2009-07-29T18:15:24Z&lt;/created&gt;
+  &lt;imageLocation href="http://localhost:3001/cimi/volumes/vol1" /&gt;
+  &lt;bootable&gt;false&lt;/bootable&gt;
+&lt;/VolumeImage&gt;
+</pre>
+
+  </div>
+
+  <div class="tab-pane active" id="create-volume-image">
+
+<h4>Create a Volume Image</h4>
+
+<p>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.</p>
+
+<p>Example request:</p>
+
+<pre>
+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
+
+&lt;VolumeImage xmlns="http://schemas.dmtf.org/cimi/1"&gt;
+  &lt;name&gt; my_vol_image &lt;/name&gt;
+  &lt;description&gt; marios first volume image &lt;/description&gt;
+  &lt;imageLocation href="http://localhost:3001/cimi/volumes/vol1"/&gt;
+&lt;/VolumeImage&gt;
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+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
+
+&lt;VolumeImage xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/VolumeImage"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/volume_images/store_snapshot_1357663577&lt;/id&gt;
+  &lt;name&gt;my_vol_image&lt;/name&gt;
+  &lt;description&gt;marios first volume image&lt;/description&gt;
+  &lt;created&gt;2013-01-08T18:46:17+02:00&lt;/created&gt;
+  &lt;imageLocation href="http://localhost:3001/cimi/volumes/vol1" /&gt;
+  &lt;bootable&gt;false&lt;/bootable&gt;
+&lt;/VolumeImage&gt;
+</pre>
+
+  </div>
+
+  <div class="tab-pane active" id="delete-volume-image">
+
+<h4>Delete a Volume Image</h4>
+
+<p>Example request:</p>
+
+<pre>
+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
+</pre>
+
+
+<p>Server response:</p>
+
+<pre>
+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
+</pre>
+
+  </div>
+
+</div>
+
+      <footer class="footer">
+        <p class="pull-right"><span class='icon-circle-arrow-up'>&nbsp;</span><a href="#">Back to top</a></p>
+        <div class='row'>
+          <div class='span3'>
+            <img src="/assets/img/asf.png" alt="Apache Software Foundation"/>
+          </div>
+          <div class='span9'>
+            <strong>Apache Deltacloud</strong> is a top-level project at the <a
+              href="http://www.apache.org">Apache Software Foundation</a>,
+            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. 
+          </div>
+        </div>
+      </footer>
+
+    </div> <!-- /container -->
+
+<!-- Piwik -->
+<script type="text/javascript">
+var pkBaseURL = (("https:" == document.location.protocol) ? "https://stats.salasaga.org/aeolus/piwik/" : "http://stats.salasaga.org/aeolus/piwik/");
+document.write(unescape("%3Cscript src='" + pkBaseURL + "piwik.js' type='text/javascript'%3E%3C/script%3E"));
+</script><script type="text/javascript">
+try {
+var piwikTracker = Piwik.getTracker(pkBaseURL + "piwik.php", 2);
+piwikTracker.trackPageView();
+piwikTracker.enableLinkTracking();
+} catch( err ) {}
+</script><noscript><p><img src="http://stats.salasaga.org/aeolus/piwik/piwik.php?idsite=2" style="border:0" alt="" /></p></noscript>
+<!-- End Piwik Tracking Code -->
+
+  </body>
+</html>

http://git-wip-us.apache.org/repos/asf/deltacloud/blob/d3b146f1/site/output/cimi-rest/cimi-rest-volume-templates.html
----------------------------------------------------------------------
diff --git a/site/output/cimi-rest/cimi-rest-volume-templates.html b/site/output/cimi-rest/cimi-rest-volume-templates.html
new file mode 100644
index 0000000..fee9fbb
--- /dev/null
+++ b/site/output/cimi-rest/cimi-rest-volume-templates.html
@@ -0,0 +1,363 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>CIMI Resource Collections - Volume Template</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+    <script src="/assets/js/jquery.tweet.js" type="text/javascript"></script>
+    <script src="/assets/js/application.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-transition.js"></script>
+    <script src="/assets/js/bootstrap-alert.js"></script>
+    <script src="/assets/js/bootstrap-modal.js"></script>
+    <script src="/assets/js/bootstrap-scrollspy.js"></script>
+    <script src="/assets/js/bootstrap-tab.js"></script>
+    <script src="/assets/js/bootstrap-tooltip.js"></script>
+    <script src="/assets/js/bootstrap-popover.js"></script>
+    <script src="/assets/js/bootstrap-button.js"></script>
+    <script src="/assets/js/bootstrap-collapse.js"></script>
+    <script src="/assets/js/bootstrap-carousel.js"></script>
+    <script src="/assets/js/bootstrap-typeahead.js"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
+  </head>
+
+  <body>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about.html">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers.html">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li><a href="/download.html">Download</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Installation<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud.html">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server.html">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="/usage.html" class="dropdown-toggle" data-toggle="dropdown">Usage<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/usage.html#usingapi">Using API</a></li>
+      <li><a href="/usage.html#clients">Client Libraries</a></li>
+      <li><a href="/command-tools.html">Command Line Tools</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/getting-sources.html">Getting Sources</a></li>
+      <li><a href="/how-to-contribute.html">How Can I Contribute?</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api.html">REST API</a></li>
+      <li><a href="/drivers.html">Drivers API</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">CIMI<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/cimi-rest.html">CIMI REST API</a></li>
+      <li><a href="/cimi-curl.html">CIMI cURL Examples</a></li>
+    </ul>
+  </li>
+  <li><a href="/contact.html">Contact</a></li>
+</ul>
+
+        </div>
+      </div>
+
+    </div>
+
+    <div class="container content">
+
+      <p><br></p>
+
+<div class="row">
+  <div class="span9">
+
+<h3 id="cimi-volume-template">Volume Template</h3>
+<p>
+<strong><em>
+This resource captures the configuration values for realizing a Volume. A Volume Template may be used
+to create multiple Volumes.
+<br><br>
+A Volume Template Collection resource represents the collection of VolumeTemplate resources within a
+Provider.
+</em></strong>
+</p>
+
+<p>The Volume Template in another example of the template pattern used by CIMI, as explained in the introduction of the <a href="cimi-rest-machine-templates.html">Machine Template</a> 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.</p>
+  </div>
+  <div class="span3">
+
+
+<ul class="nav nav-list well">
+<li class="nav-header">
+    CIMI REST API
+  </li>
+  <li><a href="../cimi-rest.html">Introduction</a></li>
+  <li><a href="cimi-rest-entry-point.html">Cloud Entry Point</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">
+      CIMI Resources
+      <b class="caret"></b>
+    </a>
+    <ul class="dropdown-menu">
+<li><a href="cimi-rest-resource-metadata.html">ResourceMetadata</a></li>
+      <li><a href="cimi-rest-collections.html">Machine</a></li>
+      <li><a href="cimi-rest-volumes.html">Volume</a></li>
+    </ul>
+</li>
+  <hr>
+<li class="nav-header">
+    Volume Resources
+  </li>
+  <ul class="nav nav-list">
+<li><a href="cimi-rest-volumes.html">Volume</a></li>
+    <li><a href="cimi-rest-volume-images.html">VolumeImage</a></li>
+    <li><a href="cimi-rest-volume-configs.html">VolumeConfiguration</a></li>
+    <li class="active"><a href="cimi-rest-volume-templates.html">VolumeTemplate</a></li>
+  </ul>
+</ul>
+</div>
+
+</div>
+
+<ul class="nav nav-pills">
+<li class="active"><a href="#volume-template-collection" data-toggle="tab">Retrieve the Volume Template Collection</a></li>
+  <li><a href="#single-volume-template" data-toggle="tab">Retrieve a single Volume Template</a></li>
+  <li><a href="#create-volume-template" data-toggle="tab">Create a Volume Template</a></li>
+  <li><a href="#delete-volume-template" data-toggle="tab">Delete a Volume Template</a></li>
+
+</ul><hr><div class="tab-content">
+
+  <div class="tab-pane active" id="volume-template-collection">
+
+<h4>Retrieve the Volume Template Collection</h4>
+
+<p>Example request:</p>
+
+<pre>
+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
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+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
+
+&lt;Collection xmlns="http://schemas.dmtf.org/cimi/1"
+          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeTemplateCollection"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/volume_templates&lt;/id&gt;
+  &lt;count&gt;2&lt;/count&gt;
+  &lt;VolumeTemplate&gt;
+    &lt;id&gt;http://localhost:3001/cimi/volume_templates/3&lt;/id&gt;
+    &lt;name&gt;marios_vol_template&lt;/name&gt;
+    &lt;description&gt;my first volume template&lt;/description&gt;
+    &lt;volumeConfig href="http://localhost:3001/cimi/volume_configs/1" /&gt;
+    &lt;operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
+          href="http://localhost:3001/cimi/volume_templates/3" /&gt;
+  &lt;/VolumeTemplate&gt;
+  &lt;VolumeTemplate&gt;
+    &lt;id&gt;http://localhost:3001/cimi/volume_templates/4&lt;/id&gt;
+    &lt;name&gt;YAVT&lt;/name&gt;
+    &lt;description&gt;yet another volume template&lt;/description&gt;
+    &lt;volumeConfig href="http://localhost:3001/cimi/volume_configs/6" /&gt;
+    &lt;operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
+          href="http://localhost:3001/cimi/volume_templates/4" /&gt;
+  &lt;/VolumeTemplate&gt;
+  &lt;operation rel="add" href="http://localhost:3001/cimi/volume_templates" /&gt;
+&lt;/Collection&gt;
+</pre>
+
+  </div>
+
+  <div class="tab-pane" id="single-volume-template">
+
+<h4>Retrieve a single Volume Template</h4>
+
+<p>Example request:</p>
+
+<pre>
+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
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+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
+
+&lt;VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1"
+          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeTemplate"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/volume_templates/3&lt;/id&gt;
+  &lt;name&gt;marios_vol_template&lt;/name&gt;
+  &lt;description&gt;my first volume template&lt;/description&gt;
+  &lt;volumeConfig href="http://localhost:3001/cimi/volume_configs/1" /&gt;
+  &lt;operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
+          href="http://localhost:3001/cimi/volume_templates/3" /&gt;
+&lt;/VolumeTemplate&gt;
+</pre>
+
+  </div>
+  <div class="tab-pane" id="create-volume-template">
+
+<h4>Create a Volume Template</h4>
+
+<p>Example request:</p>
+
+<pre>
+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
+
+&lt;VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1"&gt;
+  &lt;name&gt; YAVT &lt;/name&gt;
+  &lt;description&gt; yet another volume template &lt;/description&gt;
+  &lt;volumeConfig href="http://localhost:3001/cimi/volume_configs/6"&gt; &lt;/volumeConfig&gt;
+&lt;/VolumeTemplate&gt;
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+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
+
+&lt;VolumeTemplate xmlns="http://schemas.dmtf.org/cimi/1"
+          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeTemplate"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/volume_templates/5&lt;/id&gt;
+  &lt;name&gt;YAVT&lt;/name&gt;
+  &lt;description&gt;yet another volume template&lt;/description&gt;
+  &lt;volumeConfig href="http://localhost:3001/cimi/volume_configs/6" /&gt;
+  &lt;operation rel="http://schemas.dmtf.org/cimi/1/action/delete"
+          href="http://localhost:3001/cimi/volume_templates/5" /&gt;
+&lt;/VolumeTemplate&gt;
+</pre>
+
+  </div>
+  <div class="tab-pane" id="delete-volume-template">
+
+<h4>Delete a Volume Template</h4>
+
+<p>Example request:</p>
+
+<pre>
+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
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+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
+</pre>
+
+  </div>
+</div>
+
+      <footer class="footer">
+        <p class="pull-right"><span class='icon-circle-arrow-up'>&nbsp;</span><a href="#">Back to top</a></p>
+        <div class='row'>
+          <div class='span3'>
+            <img src="/assets/img/asf.png" alt="Apache Software Foundation"/>
+          </div>
+          <div class='span9'>
+            <strong>Apache Deltacloud</strong> is a top-level project at the <a
+              href="http://www.apache.org">Apache Software Foundation</a>,
+            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. 
+          </div>
+        </div>
+      </footer>
+
+    </div> <!-- /container -->
+
+<!-- Piwik -->
+<script type="text/javascript">
+var pkBaseURL = (("https:" == document.location.protocol) ? "https://stats.salasaga.org/aeolus/piwik/" : "http://stats.salasaga.org/aeolus/piwik/");
+document.write(unescape("%3Cscript src='" + pkBaseURL + "piwik.js' type='text/javascript'%3E%3C/script%3E"));
+</script><script type="text/javascript">
+try {
+var piwikTracker = Piwik.getTracker(pkBaseURL + "piwik.php", 2);
+piwikTracker.trackPageView();
+piwikTracker.enableLinkTracking();
+} catch( err ) {}
+</script><noscript><p><img src="http://stats.salasaga.org/aeolus/piwik/piwik.php?idsite=2" style="border:0" alt="" /></p></noscript>
+<!-- End Piwik Tracking Code -->
+
+  </body>
+</html>

http://git-wip-us.apache.org/repos/asf/deltacloud/blob/d3b146f1/site/output/cimi-rest/cimi-rest-volumes.html
----------------------------------------------------------------------
diff --git a/site/output/cimi-rest/cimi-rest-volumes.html b/site/output/cimi-rest/cimi-rest-volumes.html
new file mode 100644
index 0000000..6f8943d
--- /dev/null
+++ b/site/output/cimi-rest/cimi-rest-volumes.html
@@ -0,0 +1,433 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>CIMI Resource Collections - Volume</title>
+    <!-- Le HTML5 shim, for IE6-8 support of HTML elements -->
+    <!--[if lt IE 9]>
+    <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+
+    <!-- Le JavaScript -->
+    <script src="/assets/js/jquery-1.7.1.min.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-dropdown.js" type="text/javascript"></script>
+    <script src="/assets/js/jquery.tweet.js" type="text/javascript"></script>
+    <script src="/assets/js/application.js" type="text/javascript"></script>
+    <script src="/assets/js/bootstrap-transition.js"></script>
+    <script src="/assets/js/bootstrap-alert.js"></script>
+    <script src="/assets/js/bootstrap-modal.js"></script>
+    <script src="/assets/js/bootstrap-scrollspy.js"></script>
+    <script src="/assets/js/bootstrap-tab.js"></script>
+    <script src="/assets/js/bootstrap-tooltip.js"></script>
+    <script src="/assets/js/bootstrap-popover.js"></script>
+    <script src="/assets/js/bootstrap-button.js"></script>
+    <script src="/assets/js/bootstrap-collapse.js"></script>
+    <script src="/assets/js/bootstrap-carousel.js"></script>
+    <script src="/assets/js/bootstrap-typeahead.js"></script>
+
+    <!-- Le styles -->
+    <link href="/assets/css/bootstrap.css" rel="stylesheet">
+    <link href="/assets/css/application.css" rel="stylesheet">
+    <link rel="shortcut icon" href="/assets/img/favicon.ico">
+  </head>
+
+  <body>
+
+    <div class="navbar navbar-fixed-top">
+      <div class="navbar-inner">
+        <div class="container">
+          <a class="brand" href="/"><img src="/assets/img/logo.png" width="152"
+            alt="Deltacloud API"/></a>
+          <ul class="nav top-nav">
+  <li><a href="/">Home</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">About<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/about.html">What is Deltacloud?</a></li>
+      <li><a href="/supported-providers.html">Supported Providers</a></li>
+    </ul>
+  </li>
+  <li><a href="/download.html">Download</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Installation<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/install-deltacloud.html">Install Deltacloud</a></li>
+      <li><a href="/run-deltacloud-server.html">Run the Deltacloud Server</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="/usage.html" class="dropdown-toggle" data-toggle="dropdown">Usage<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/usage.html#usingapi">Using API</a></li>
+      <li><a href="/usage.html#clients">Client Libraries</a></li>
+      <li><a href="/command-tools.html">Command Line Tools</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">Contribute<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/getting-sources.html">Getting Sources</a></li>
+      <li><a href="/how-to-contribute.html">How Can I Contribute?</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">API<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/rest-api.html">REST API</a></li>
+      <li><a href="/drivers.html">Drivers API</a></li>
+    </ul>
+  </li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">CIMI<b class="caret"></b></a>
+    <ul class="dropdown-menu">
+      <li><a href="/cimi-rest.html">CIMI REST API</a></li>
+      <li><a href="/cimi-curl.html">CIMI cURL Examples</a></li>
+    </ul>
+  </li>
+  <li><a href="/contact.html">Contact</a></li>
+</ul>
+
+        </div>
+      </div>
+
+    </div>
+
+    <div class="container content">
+
+      <p><br></p>
+
+<div class="row">
+  <div class="span9">
+
+<h3 id="cimi-machine-image">Volume</h3>
+<p>
+<strong><em>
+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.
+<br>
+A Volume Collection resource represents the collection of Volumes within a Provider.
+</em></strong>
+</p>
+
+  </div>
+  <div class="span3">
+
+
+<ul class="nav nav-list well">
+<li class="nav-header">
+    CIMI REST API
+  </li>
+  <li><a href="../cimi-rest.html">Introduction</a></li>
+  <li><a href="cimi-rest-entry-point.html">Cloud Entry Point</a></li>
+  <li class="dropdown">
+    <a href="#" class="dropdown-toggle" data-toggle="dropdown">
+      CIMI Resources
+      <b class="caret"></b>
+    </a>
+    <ul class="dropdown-menu">
+<li><a href="cimi-rest-resource-metadata.html">ResourceMetadata</a></li>
+      <li><a href="cimi-rest-collections.html">Machine</a></li>
+      <li><a href="cimi-rest-volumes.html">Volume</a></li>
+    </ul>
+</li>
+  <hr>
+<li class="nav-header">
+    Volume Resources
+  </li>
+  <ul class="nav nav-list">
+<li class="active"><a href="cimi-rest-volumes.html">Volume</a></li>
+    <li><a href="cimi-rest-volume-images.html">VolumeImage</a></li>
+    <li><a href="cimi-rest-volume-configs.html">VolumeConfiguration</a></li>
+    <li><a href="cimi-rest-volume-templates.html">VolumeTemplate</a></li>
+  </ul>
+</ul>
+</div>
+
+</div>
+
+<ul class="nav nav-pills">
+<li class="active"><a href="#volume-collection" data-toggle="tab">Retrieve the Volume Collection</a></li>
+  <li><a href="#single-volume" data-toggle="tab">Retrieve a single Volume</a></li>
+  <li><a href="#create-volume" data-toggle="tab">Create a Volume</a></li>
+  <li><a href="#delete-volume" data-toggle="tab">Delete a Volume</a></li>
+</ul><hr><div class="tab-content">
+  <div class="tab-pane active" id="volume-collection">
+
+<h4>Retrieve the Volume Collection</h4>
+
+<p>Example request:</p>
+<pre>
+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
+</pre>
+
+<p>Server response:</p>
+<pre>
+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
+
+&lt;Collection xmlns="http://schemas.dmtf.org/cimi/1"
+          resourceURI="http://schemas.dmtf.org/cimi/1/VolumeCollection"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/volumes&lt;/id&gt;
+  &lt;count&gt;3&lt;/count&gt;
+  &lt;Volume&gt;
+    &lt;id&gt;http://localhost:3001/cimi/volumes/vol3&lt;/id&gt;
+    &lt;name&gt;vol3&lt;/name&gt;
+    &lt;description&gt;Description of Volume&lt;/description&gt;
+    &lt;created&gt;2009-07-30T14:35:11Z&lt;/created&gt;
+    &lt;state&gt;IN-USE&lt;/state&gt;
+    &lt;type&gt;http://schemas.dmtf.org/cimi/1/mapped&lt;/type&gt;
+    &lt;capacity&gt;1048576&lt;/capacity&gt;
+    &lt;bootable&gt;false&lt;/bootable&gt;
+    &lt;operation rel="delete" href="http://localhost:3001/cimi/volumes/vol3" /&gt;
+  &lt;/Volume&gt;
+  &lt;Volume&gt;
+    &lt;id&gt;http://localhost:3001/cimi/volumes/vol2&lt;/id&gt;
+    &lt;name&gt;vol2&lt;/name&gt;
+    &lt;description&gt;Description of Volume&lt;/description&gt;
+    &lt;created&gt;2009-07-30T14:35:11Z&lt;/created&gt;
+    &lt;state&gt;AVAILABLE&lt;/state&gt;
+    &lt;type&gt;http://schemas.dmtf.org/cimi/1/mapped&lt;/type&gt;
+    &lt;capacity&gt;1048576&lt;/capacity&gt;
+    &lt;bootable&gt;false&lt;/bootable&gt;
+    &lt;operation rel="delete" href="http://localhost:3001/cimi/volumes/vol2" /&gt;
+  &lt;/Volume&gt;
+  &lt;Volume&gt;
+    &lt;id&gt;http://localhost:3001/cimi/volumes/vol1&lt;/id&gt;
+    &lt;name&gt;vol1&lt;/name&gt;
+    &lt;description&gt;Description of Volume&lt;/description&gt;
+    &lt;created&gt;2009-07-30T14:35:11Z&lt;/created&gt;
+    &lt;state&gt;AVAILABLE&lt;/state&gt;
+    &lt;type&gt;http://schemas.dmtf.org/cimi/1/mapped&lt;/type&gt;
+    &lt;capacity&gt;1048576&lt;/capacity&gt;
+    &lt;bootable&gt;false&lt;/bootable&gt;
+    &lt;operation rel="delete" href="http://localhost:3001/cimi/volumes/vol1" /&gt;
+  &lt;/Volume&gt;
+  &lt;operation rel="add" href="http://localhost:3001/cimi/volumes" /&gt;
+&lt;/Collection&gt;
+</pre>
+
+  </div>
+
+  <div class="tab-pane active" id="single-volume">
+
+<h4>Retrieve a single Volume</h4>
+
+<p>Example request:</p>
+<pre>
+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
+</pre>
+
+<p>Server response:</p>
+<pre>
+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
+
+&lt;Volume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Volume"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/volumes/vol1&lt;/id&gt;
+  &lt;name&gt;vol1&lt;/name&gt;
+  &lt;description&gt;Description of Volume&lt;/description&gt;
+  &lt;created&gt;2009-07-30T14:35:11Z&lt;/created&gt;
+  &lt;state&gt;AVAILABLE&lt;/state&gt;
+  &lt;type&gt;http://schemas.dmtf.org/cimi/1/mapped&lt;/type&gt;
+  &lt;capacity&gt;1048576&lt;/capacity&gt;
+  &lt;bootable&gt;false&lt;/bootable&gt;
+  &lt;operation rel="delete" href="http://localhost:3001/cimi/volumes/vol1" /&gt;
+&lt;/Volume&gt;
+
+
+</pre>
+
+  </div>
+
+
+  <div class="tab-pane active" id="create-volume">
+
+<h4>Create a Volume</h4>
+
+<p>Using VolumeTemplate with VolumeConfiguration by reference - Example request:</p>
+<pre>
+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
+
+&lt;VolumeCreate&gt;
+  &lt;name&gt; marios_new_volume &lt;/name&gt;
+  &lt;description&gt; a new volume &lt;/description&gt;
+  &lt;volumeTemplate&gt;
+    &lt;volumeConfig
+      href="http://localhost:3001/cimi/volume_configurations/2"&gt;
+    &lt;/volumeConfig&gt;
+  &lt;/volumeTemplate&gt;
+&lt;/VolumeCreate&gt;
+</pre>
+
+<p>Server response:</p>
+<pre>
+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
+
+&lt;Volume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Volume"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/volumes/Volume1357567397&lt;/id&gt;
+  &lt;name&gt;marios_new_volume&lt;/name&gt;
+  &lt;description&gt;a new volume&lt;/description&gt;
+  &lt;created&gt;2013-01-07T16:03:17+02:00&lt;/created&gt;
+  &lt;state&gt;AVAILABLE&lt;/state&gt;
+  &lt;type&gt;http://schemas.dmtf.org/cimi/1/mapped&lt;/type&gt;
+  &lt;capacity&gt;2097152&lt;/capacity&gt;
+  &lt;bootable&gt;false&lt;/bootable&gt;
+  &lt;operation rel="delete" href="http://localhost:3001/cimi/volumes/Volume1357567397" /&gt;
+&lt;/Volume&gt;
+</pre>
+
+<br><p>Using VolumeTemplate with VolumeConfiguration by value - Example request:</p>
+<pre>
+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
+
+&lt;VolumeCreate&gt;
+  &lt;name&gt; marios_volume &lt;/name&gt;
+  &lt;description&gt; a new volume &lt;/description&gt;
+  &lt;volumeTemplate&gt;
+    &lt;volumeConfig&gt;
+      &lt;type&gt;http://schemas.dmtf.org/cimi/1/mapped&lt;/type&gt;
+      &lt;capacity&gt; 1024 &lt;/capacity&gt;
+    &lt;/volumeConfig&gt;
+  &lt;/volumeTemplate&gt;
+&lt;/VolumeCreate&gt;
+</pre>
+
+<p>Server response:</p>
+
+<pre>
+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
+
+&lt;Volume xmlns="http://schemas.dmtf.org/cimi/1" resourceURI="http://schemas.dmtf.org/cimi/1/Volume"&gt;
+  &lt;id&gt;http://localhost:3001/cimi/volumes/Volume1357567628&lt;/id&gt;
+  &lt;name&gt;marios_volume&lt;/name&gt;
+  &lt;description&gt;a new volume&lt;/description&gt;
+  &lt;created&gt;2013-01-07T16:07:08+02:00&lt;/created&gt;
+  &lt;state&gt;AVAILABLE&lt;/state&gt;
+  &lt;type&gt;http://schemas.dmtf.org/cimi/1/mapped&lt;/type&gt;
+  &lt;capacity&gt;1024&lt;/capacity&gt;
+  &lt;bootable&gt;false&lt;/bootable&gt;
+  &lt;operation rel="delete" href="http://localhost:3001/cimi/volumes/Volume1357567628" /&gt;
+&lt;/Volume&gt;
+</pre>
+
+  </div>
+
+  <div class="tab-pane active" id="delete-volume">
+
+<h4>Retrieve the Volume Collection</h4>
+
+<p>Example request:</p>
+<pre>
+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
+
+</pre>
+
+<p>Server response:</p>
+<pre>
+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
+
+</pre>
+
+  </div>
+
+</div>
+
+      <footer class="footer">
+        <p class="pull-right"><span class='icon-circle-arrow-up'>&nbsp;</span><a href="#">Back to top</a></p>
+        <div class='row'>
+          <div class='span3'>
+            <img src="/assets/img/asf.png" alt="Apache Software Foundation"/>
+          </div>
+          <div class='span9'>
+            <strong>Apache Deltacloud</strong> is a top-level project at the <a
+              href="http://www.apache.org">Apache Software Foundation</a>,
+            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. 
+          </div>
+        </div>
+      </footer>
+
+    </div> <!-- /container -->
+
+<!-- Piwik -->
+<script type="text/javascript">
+var pkBaseURL = (("https:" == document.location.protocol) ? "https://stats.salasaga.org/aeolus/piwik/" : "http://stats.salasaga.org/aeolus/piwik/");
+document.write(unescape("%3Cscript src='" + pkBaseURL + "piwik.js' type='text/javascript'%3E%3C/script%3E"));
+</script><script type="text/javascript">
+try {
+var piwikTracker = Piwik.getTracker(pkBaseURL + "piwik.php", 2);
+piwikTracker.trackPageView();
+piwikTracker.enableLinkTracking();
+} catch( err ) {}
+</script><noscript><p><img src="http://stats.salasaga.org/aeolus/piwik/piwik.php?idsite=2" style="border:0" alt="" /></p></noscript>
+<!-- End Piwik Tracking Code -->
+
+  </body>
+</html>