Cloud API Specification - Requests to Cloud Resources

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.

Contents

1 Get Cloud

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
 
 {
   "uri" : "http://example.com/",
   "vdcs" : [
      { "name" : "First VDC", "uri" : "http://example.com/vdcs/123" },
      { "name" : "Second VDC", "uri" : "http://example.com/vdcs/987" }
   ],
   { "specification_version" :  [  "0.8"  ]  },
   { "implementation_version" : "3.8RC2" }
 }