site/output/storage-snapshots.html - deltacloud - Git at Google

 <!DOCTYPE html>
 <html lang="en">
   <head>
     <meta charset="utf-8">
     <title>Storage snapshots</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 style="background: red"><h1>2015/07/20 - Apache Deltacloud has been retired. </h1><h2>For more information, please explore the <a href="http://attic.apache.org/">Attic</a>. </h2></div>

     <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="/drivers.html#drivers">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">Deltacloud REST API</a></li>
       <li><a href="/curl-examples.html">Deltacloud API cURL examples</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="snapshots">Storage snapshots</h3>

 <p>
 A storage snapshot captures the state of a storage volume at the exact moment in time. Each snapshot has
 </p>

 <ul>
   <li>a <strong>created timestamp</strong>; and</li>
   <li>a <strong>storage volume </strong>attribute referring to the volume from which the snapshot was made.</li>
 </ul>

 <br>
 <br>

 <ul class="nav nav-pills">
   <li class="active"><a href="#tab1" data-toggle="tab">Get a list of all snapshots</a></li>
   <li><a href="#tab2" data-toggle="tab">Get the details of a snapshot</a></li>
   <li><a href="#tab3" data-toggle="tab">Create/delete a snapshot</a></li>
 </ul>

 <hr>

   </div>
   <div class="span3">

 <ul class="nav nav-list well">
   <li class="nav-header">
     REST API
   </li>
   <li><a href="rest-api.html">Introduction</a></li>
   <li><a href="api-entry-point.html">API entry point</a></li>
   <li><a href="compute-resources.html">Compute resources</a></li>
   <li><a href="storage-resources.html">Storage resources</a></li>
   <ul class="nav nav-list">
     <li><a href="storage-resources.html#volumes">Storage volumes</a></li>
     <li class="active"><a href="#snapshots">Storage snapshots</a></li>
     <li><a href="blob-storage.html">Blob storage</a></li>
   </ul>
 </ul>

   </div>
 </div>

 <div class="tab-content">
   <div class="tab-pane active" id="tab1">

 <h4>Get a list of all storage snapshots</h4>

 <p>
 To list all available storage snapshots use call <strong>GET /api/storage_snapshots</strong>. 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:
 </p>

 <p>
 Example request:
 </p>

 <pre>
 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: */*
 </pre>

 <p>Server response:</p>

 <pre>
 HTTP/1.1 200 OK
 Content-Type: application/xml
 Date: Thu, 28 Jul 2011 22:08:36 GMT
 Content-Length: 156897

 &lt;?xml version='1.0' encoding='utf-8' ?&gt;
 &lt;storage_snapshots&gt;
   &lt;storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-45b8d024' id='snap-45b8d024'&gt;
     &lt;created&gt;Thu Jul 28 21:54:19 UTC 2011&lt;/created&gt;
     &lt;storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'&gt;&lt;/storage_volume&gt;
   &lt;/storage_snapshot&gt;
   &lt;storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-d5a1c9b4' id='snap-d5a1c9b4'&gt;
     &lt;created&gt;Thu Jul 28 21:46:12 UTC 2011&lt;/created&gt;
     &lt;storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'&gt;&lt;/storage_volume&gt;
   &lt;/storage_snapshot&gt;
   &lt;storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-dda6cebc' id='snap-dda6cebc'&gt;
     &lt;created&gt;Thu Jul 28 21:51:55 UTC 2011&lt;/created&gt;
     &lt;storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'&gt;&lt;/storage_volume&gt;
   &lt;/storage_snapshot&gt;
   &lt;storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-d010f6b9' id='snap-d010f6b9'&gt;
     &lt;created&gt;Mon Oct 20 18:23:59 UTC 2008&lt;/created&gt;
     &lt;storage_volume href='http://localhost:3001/api/storage_volumes/vol-351efb5c' id='vol-351efb5c'&gt;&lt;/storage_volume&gt;
   &lt;/storage_snapshot&gt;
   &lt;storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-a310f6ca' id='snap-a310f6ca'&gt;
     &lt;created&gt;Mon Oct 20 18:25:53 UTC 2008&lt;/created&gt;
     &lt;storage_volume href='http://localhost:3001/api/storage_volumes/vol-001efb69' id='vol-001efb69'&gt;&lt;/storage_volume&gt;
   &lt;/storage_snapshot&gt;
   (...)
 &lt;/storage_snapshots&gt;
 </pre>

   </div>
   <div class="tab-pane" id="tab2">

 <h4>Get the details of a storage snaphsot</h4>

 <p>
 To get all details for a specified storage snapshot, as shown below, use call <strong>GET /api/storage_snapshots/:id</strong>.
 </p>

 <p>Example request:</p>

 <pre>
 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: */*
 </pre>

 <p>Server response:</p>

 <pre>
 HTTP/1.1 200 OK
 Content-Type: application/xml
 Date: Thu, 28 Jul 2011 22:08:36 GMT
 Content-Length: 329

 &lt;?xml version='1.0' encoding='utf-8' ?&gt;
 &lt;storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-45b8d024' id='snap-45b8d024'&gt;
   &lt;created&gt;Thu Jul 28 21:54:19 UTC 2011&lt;/created&gt;
   &lt;storage_volume href='http://localhost:3001/api/storage_volumes/vol-0bc0de60' id='vol-0bc0de60'&gt;&lt;/storage_volume&gt;
 &lt;/storage_snapshot&gt;
 </pre>

   </div>
   <div class="tab-pane" id="tab3">

 <h4>Create a new storage snapshot</h4>

 <p>
 To create a new storage snapshot use call <strong>POST /api/storage_snapshots</strong>. Clients must specify the storage volume, which the snapshot is created from, by supplying the <strong>volume_id</strong> parameter. The Deltacloud server responds with <strong>HTTP 201 Created</strong> 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:
 </p>

 <p>Example request:</p>

 <pre>
 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
 </pre>

 <p>Server response:</p>

 <pre>
 HTTP/1.1 201 Created
 Date: Thu, 28 Jul 2011 21:46:48 GMT
 Content-Length: 329

 &lt;?xml version='1.0' encoding='utf-8' ?&gt;
 &lt;storage_snapshot href='http://localhost:3001/api/storage_snapshots/snap-d5a1c9b4' id='snap-d5a1c9b4'&gt;
   &lt;created&gt;Thu Jul 28 21:46:12 UTC 2011&lt;/created&gt;
   &lt;storage_volume href='http://localhost:3001/api/storage_volumes/vol-99fbe5f2' id='vol-99fbe5f2'&gt;&lt;/storage_volume&gt;
 &lt;/storage_snapshot&gt;
 </pre>

 <h4>Delete a storage snapshot</h4>

 <p>
 To delete the specified storagesnapshot use call <strong>DELETE /api/storage_snapshots/:id</strong>. The operation returns a <strong>HTTP 204 No Content</strong> after a succesful operation:
 </p>

 <p>Example request:</p>

 <pre>
 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: */*
 </pre>

 <p>Server response:</p>

 <pre>
 HTTP/1.1 204 No Content
 Date: Thu, 28 Jul 2011 22:26:07 GMT
 </pre>

   </div>
 </div>

 <p><a class="btn btn-inverse btn-large" style="float: right" href="blob-storage.html">Blob storage <i class="icon-arrow-right icon-white" style="vertical-align:baseline"> </i></a></p>

 <p><br></p>


       <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>
	<!DOCTYPE html>
	<html lang="en">
	<head>
	<meta charset="utf-8">
	<title>Storage snapshots</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 style="background: red"><h1>2015/07/20 - Apache Deltacloud has been retired. </h1><h2>For more information, please explore the <a href="http://attic.apache.org/">Attic</a>. </h2></div>

	<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="/drivers.html#drivers">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">Deltacloud REST API</a></li>
	<li><a href="/curl-examples.html">Deltacloud API cURL examples</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="snapshots">Storage snapshots</h3>

	<p>
	A storage snapshot captures the state of a storage volume at the exact moment in time. Each snapshot has
	</p>

	<ul>
	<li>a <strong>created timestamp</strong>; and</li>
	<li>a <strong>storage volume </strong>attribute referring to the volume from which the snapshot was made.</li>
	</ul>

	<br>
	<br>

	<ul class="nav nav-pills">
	<li class="active"><a href="#tab1" data-toggle="tab">Get a list of all snapshots</a></li>
	<li><a href="#tab2" data-toggle="tab">Get the details of a snapshot</a></li>
	<li><a href="#tab3" data-toggle="tab">Create/delete a snapshot</a></li>
	</ul>

	<hr>

	</div>
	<div class="span3">

	<ul class="nav nav-list well">
	<li class="nav-header">
	REST API
	</li>
	<li><a href="rest-api.html">Introduction</a></li>
	<li><a href="api-entry-point.html">API entry point</a></li>
	<li><a href="compute-resources.html">Compute resources</a></li>
	<li><a href="storage-resources.html">Storage resources</a></li>
	<ul class="nav nav-list">
	<li><a href="storage-resources.html#volumes">Storage volumes</a></li>
	<li class="active"><a href="#snapshots">Storage snapshots</a></li>
	<li><a href="blob-storage.html">Blob storage</a></li>
	</ul>
	</ul>

	</div>
	</div>

	<div class="tab-content">
	<div class="tab-pane active" id="tab1">

	<h4>Get a list of all storage snapshots</h4>

	<p>
	To list all available storage snapshots use call <strong>GET /api/storage_snapshots</strong>. 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:
	</p>

	<p>
	Example request:
	</p>

	<pre>
	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: /
	</pre>

	<p>Server response:</p>

	<pre>
	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>
	</pre>

	</div>
	<div class="tab-pane" id="tab2">

	<h4>Get the details of a storage snaphsot</h4>

	<p>
	To get all details for a specified storage snapshot, as shown below, use call <strong>GET /api/storage_snapshots/:id</strong>.
	</p>

	<p>Example request:</p>

	<pre>
	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: /
	</pre>

	<p>Server response:</p>

	<pre>
	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>
	</pre>

	</div>
	<div class="tab-pane" id="tab3">

	<h4>Create a new storage snapshot</h4>

	<p>
	To create a new storage snapshot use call <strong>POST /api/storage_snapshots</strong>. Clients must specify the storage volume, which the snapshot is created from, by supplying the <strong>volume_id</strong> parameter. The Deltacloud server responds with <strong>HTTP 201 Created</strong> 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:
	</p>

	<p>Example request:</p>

	<pre>
	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
	</pre>

	<p>Server response:</p>

	<pre>
	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>
	</pre>

	<h4>Delete a storage snapshot</h4>

	<p>
	To delete the specified storagesnapshot use call <strong>DELETE /api/storage_snapshots/:id</strong>. The operation returns a <strong>HTTP 204 No Content</strong> after a succesful operation:
	</p>

	<p>Example request:</p>

	<pre>
	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: /
	</pre>

	<p>Server response:</p>

	<pre>
	HTTP/1.1 204 No Content
	Date: Thu, 28 Jul 2011 22:26:07 GMT
	</pre>

	</div>
	</div>

	<p><a class="btn btn-inverse btn-large" style="float: right" href="blob-storage.html">Blob storage <i class="icon-arrow-right icon-white" style="vertical-align:baseline"> </i></a></p>

	<p><br></p>


	<footer class="footer">
	<p class="pull-right"><span class='icon-circle-arrow-up'> </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>