<?xml version="1.0" encoding="UTF-8"?>
<page>
  <created-at type="datetime">2009-03-11T05:39:42Z</created-at>
  <description>Correct JSON syntax error in Get Cloud response example.</description>
  <id type="integer">1048</id>
  <name>CloudAPICloudRequests</name>
  <number type="integer">4</number>
  <person-id type="integer">11</person-id>
  <text>&lt;h1&gt;Cloud API Specification - Requests to Cloud Resources&lt;/h1&gt;

The requests documented in this section are directed to ''Cloud'' resources, which allows a client to enumerate the cloud resources accessible to the user performing this request.

__TOC__

= Get Cloud =

Retrieve information about accessible resources.

'''Synopsis:''' GET {Well Known URI of the Service}

'''Request Headers:''' Accept, Authorization, X-Cloud-Client-Specification-Version.

'''Request Message Body:''' N/A.

'''Response Headers:''' Content-Length, Content-Type.

'''Response Message Body:''' Cloud.

'''Response Status:''' 200, 400, 401, 403, 404.

'''Example Request:'''  Retrieve information about cloud resources for this user.

 GET /
 Host: example.com
 Authorization: Basic xxxxxxxxxxxxxxxxxxx
 Accept: application/vnd.com.sun.cloud.Cloud+json
 X-Cloud-Client-Specification-Version: 0.1

'''Example Response:'''

 HTTP/1.1 200 OK
 Content-Type: application/vnd.com.sun.cloud.Cloud+json
 Content-Length: nnn
 
 {
   &quot;uri&quot; : &quot;http://example.com/&quot;,
   &quot;vdcs&quot; : [
      { &quot;name&quot; : &quot;First VDC&quot;, &quot;uri&quot; : &quot;http://example.com/vdcs/123&quot; },
      { &quot;name&quot; : &quot;Second VDC&quot;, &quot;uri&quot; : &quot;http://example.com/vdcs/987&quot; }
   ],
   { &quot;specification_version&quot; :  [  &quot;0.8&quot;  ]  },
   { &quot;implementation_version&quot; : &quot;3.8RC2&quot; }
 }

Copyright &amp;copy; Sun Microsystems, 2009.  This work is licensed under [http://creativecommons.org/licenses/by/3.0/ Creative Commons Attribution 3.0 Unported License]
</text>
  <text-as-html>&lt;p&gt;&lt;h1&gt;Cloud API Specification - Requests to Cloud Resources&lt;/h1&gt;

&lt;/p&gt;&lt;p&gt;The requests documented in this section are directed to &lt;i&gt;Cloud&lt;/i&gt; resources, which allows a client to enumerate the cloud resources accessible to the user performing this request.

&lt;/p&gt;&lt;div id='toc' class='toc'&gt;
           &lt;div id='toctitle' class='toc-title'&gt;
             &lt;span&gt;Contents&lt;/span&gt;
           &lt;/div&gt;
           &lt;div id='toccontents' class='toc-contents'&gt;&lt;ul&gt;&lt;li&gt;1 &lt;a href='#Get_Cloud'&gt; Get Cloud &lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;&lt;/div&gt;
         &lt;/div&gt;&lt;p&gt;&lt;br /&gt;

&lt;/p&gt;&lt;h1&gt;&lt;a name='Get_Cloud'&gt;&lt;/a&gt; Get Cloud &lt;/h1&gt;
&lt;p&gt;
Retrieve information about accessible resources.

&lt;/p&gt;&lt;p&gt;&lt;b&gt;Synopsis:&lt;/b&gt; GET {Well Known URI of the Service}

&lt;/p&gt;&lt;p&gt;&lt;b&gt;Request Headers:&lt;/b&gt; Accept, Authorization, X-Cloud-Client-Specification-Version.

&lt;/p&gt;&lt;p&gt;&lt;b&gt;Request Message Body:&lt;/b&gt; N/A.

&lt;/p&gt;&lt;p&gt;&lt;b&gt;Response Headers:&lt;/b&gt; Content-Length, Content-Type.

&lt;/p&gt;&lt;p&gt;&lt;b&gt;Response Message Body:&lt;/b&gt; Cloud.

&lt;/p&gt;&lt;p&gt;&lt;b&gt;Response Status:&lt;/b&gt; 200, 400, 401, 403, 404.

&lt;/p&gt;&lt;p&gt;&lt;b&gt;Example Request:&lt;/b&gt;  Retrieve information about cloud resources for this user.

&lt;/p&gt;&lt;pre&gt; GET /
 Host: example.com
 Authorization: Basic xxxxxxxxxxxxxxxxxxx
 Accept: application/vnd.com.sun.cloud.Cloud+json
 X-Cloud-Client-Specification-Version: 0.1
&lt;/pre&gt;&lt;p&gt;&lt;b&gt;Example Response:&lt;/b&gt;

&lt;/p&gt;&lt;pre&gt; HTTP/1.1 200 OK
 Content-Type: application/vnd.com.sun.cloud.Cloud+json
 Content-Length: nnn
 
 {
   &amp;quot;uri&amp;quot; : &amp;quot;&lt;a class='external' href=&quot;http://example.com/&quot;&gt;http://example.com/&lt;/a&gt;&amp;quot;,
   &amp;quot;vdcs&amp;quot; : [
      { &amp;quot;name&amp;quot; : &amp;quot;First VDC&amp;quot;, &amp;quot;uri&amp;quot; : &amp;quot;&lt;a class='external' href=&quot;http://example.com/vdcs/123&quot;&gt;http://example.com/vdcs/123&lt;/a&gt;&amp;quot; },
      { &amp;quot;name&amp;quot; : &amp;quot;Second VDC&amp;quot;, &amp;quot;uri&amp;quot; : &amp;quot;&lt;a class='external' href=&quot;http://example.com/vdcs/987&quot;&gt;http://example.com/vdcs/987&lt;/a&gt;&amp;quot; }
   ],
   { &amp;quot;specification_version&amp;quot; :  [  &amp;quot;0.8&amp;quot;  ]  },
   { &amp;quot;implementation_version&amp;quot; : &amp;quot;3.8RC2&amp;quot; }
 }
&lt;/pre&gt;&lt;p&gt;
Copyright &amp;copy; Sun Microsystems, 2009.  This work is licensed under &lt;a class='external' href=&quot;http://creativecommons.org/licenses/by/3.0/&quot;&gt;Creative Commons Attribution 3.0 Unported License&lt;/a&gt;&lt;/p&gt;</text-as-html>
  <updated-at type="datetime">2009-10-14T04:16:33Z</updated-at>
  <wiki-id type="integer">3636</wiki-id>
</page>
