2009-02-26T18:47:17Z

Flesh out VM backup semantics 943 Home 12

<h1>The Sun Cloud API</h1> <h3>Introduction</h3> This wiki specifies a RESTful API for creating and managing cloud resources, including compute, storage, and networking components. Usage of the API is via the HTTP protocol. The GET, POST, PUT, and DELETE requests are all used, although most tasks can be accomplished with GET and POST. Resource representations are in JSON. The API presupposes no particular structure in the URI space. The starting point is a URI, supplied by the cloud service provider, which identifies the cloud itself. The cloud's representation contains URIs for the other resources in the cloud, and also for operations which may be performed upon them (for example deploying and starting virtual machines). The specification of the Sun Cloud API includes: * Common behaviors that apply across all requests and responses. * Resource models, which describe the JSON data structures used in requests and responses. * The requests that may be sent to cloud resources, and the responses expected. This API operates on the following primary resource types: * Cloud: A top-level construct which groups all the Virtual Data Centers to which an API user has access. * Virtual Data Center (VDC): An isolated container which is populated with Clusters, Private Virtual Networks, Public Addresses, Storage Volumes, Volume Snapshots. * Cluster: An administrative grouping of Virtual Machines, useful for access control, copying or cloning, geographic isolation, and scripting automation. * Virtual Machine (VM): A server. * Private Virtual Network (VNet): A subnet, not connected to the Internet, which may be used to connect Virtual Machines within a VDC. * Public Address: A connection to the Internet. * Storage Volume: A storage resource which may be accessed via WebDAV and other storage protocols. * Volume Snapshot: A snapshot of the state of a Storage Volume. The API additionally operates on secondary resources such as VM Backups and Network Interfaces. [[HelloCloud|"Hello, Cloud": An illustrative walk-through of the Sun Cloud API]] is designed to serve as the starting-point for learning this API. <h3>Specifications</h3> * [[Common Behaviors]] * [[CloudAPISpecificationResourceModels|Resource Models]] * [[CloudAPIBackupRequests|Requests to Backup Resources]] * [[CloudAPICloudRequests|Requests to Cloud Resources]] * [[CloudAPIClusterRequests|Requests to Cluster Resources]] * [[CloudAPIPublicAddressRequests|Requests to Public Address Resources]] * [[CloudAPISnapshotRequests|Requests to Snapshot Resources]] * [[CloudAPIVDCRequests|Requests to VDC Resources]] * [[CloudAPIVMRequests|Requests to VM Resources]] * [[CloudAPIVNetRequests|Requests to VNet Resources]] * [[CloudAPIVolumeRequests|Requests to Volume Resources]] A [[CloudCommandClient|command line client]] for communicating with implementations of this API is also available. (Work in progress): [[CLIExample1|a simple example using the CLI]] Copyright © Sun Microsystems, 2009. This work is licensed under [http://creativecommons.org/licenses/by/3.0/ Creative Commons Attribution 3.0 Unported License]

<p><h1>The Sun Cloud API</h1> </p><p><h3>Introduction</h3> </p><p>This wiki specifies a RESTful API for creating and managing cloud resources, including compute, storage, and networking components. </p><p>Usage of the API is via the HTTP protocol. The GET, POST, PUT, and DELETE requests are all used, although most tasks can be accomplished with GET and POST. Resource representations are in JSON. </p><p>The API presupposes no particular structure in the URI space. The starting point is a URI, supplied by the cloud service provider, which identifies the cloud itself. The cloud's representation contains URIs for the other resources in the cloud, and also for operations which may be performed upon them (for example deploying and starting virtual machines). </p><p>The specification of the Sun Cloud API includes: </p><ul><li> Common behaviors that apply across all requests and responses. </li><li> Resource models, which describe the JSON data structures used in requests and responses. </li><li> The requests that may be sent to cloud resources, and the responses expected. </li></ul><p> This API operates on the following primary resource types: </p><ul><li> Cloud: A top-level construct which groups all the Virtual Data Centers to which an API user has access. </li><li> Virtual Data Center (VDC): An isolated container which is populated with Clusters, Private Virtual Networks, Public Addresses, Storage Volumes, Volume Snapshots. </li><li> Cluster: An administrative grouping of Virtual Machines, useful for access control, copying or cloning, geographic isolation, and scripting automation. </li><li> Virtual Machine (VM): A server. </li><li> Private Virtual Network (VNet): A subnet, not connected to the Internet, which may be used to connect Virtual Machines within a VDC. </li><li> Public Address: A connection to the Internet. </li><li> Storage Volume: A storage resource which may be accessed via WebDAV and other storage protocols. </li><li> Volume Snapshot: A snapshot of the state of a Storage Volume. </li></ul><p>The API additionally operates on secondary resources such as VM Backups and Network Interfaces. </p><p><a href='<?url_for_page HelloCloud?>' class='internal'>"Hello, Cloud": An illustrative walk-through of the Sun Cloud API</a> is designed to serve as the starting-point for learning this API. </p><p><h3>Specifications</h3> </p><ul><li> <a href='<?url_for_page Common Behaviors?>' class='internal'>Common Behaviors</a></li><li> <a href='<?url_for_page CloudAPISpecificationResourceModels?>' class='internal'>Resource Models</a></li><li> <a href='<?url_for_page CloudAPIBackupRequests?>' class='internal'>Requests to Backup Resources</a></li><li> <a href='<?url_for_page CloudAPICloudRequests?>' class='internal'>Requests to Cloud Resources</a></li><li> <a href='<?url_for_page CloudAPIClusterRequests?>' class='internal'>Requests to Cluster Resources</a></li><li> <a href='<?url_for_page CloudAPIPublicAddressRequests?>' class='internal'>Requests to Public Address Resources</a></li><li> <a href='<?url_for_page CloudAPISnapshotRequests?>' class='internal'>Requests to Snapshot Resources</a></li><li> <a href='<?url_for_page CloudAPIVDCRequests?>' class='internal'>Requests to VDC Resources</a></li><li> <a href='<?url_for_page CloudAPIVMRequests?>' class='internal'>Requests to VM Resources</a></li><li> <a href='<?url_for_page CloudAPIVNetRequests?>' class='internal'>Requests to VNet Resources</a></li><li> <a href='<?url_for_page CloudAPIVolumeRequests?>' class='internal'>Requests to Volume Resources</a></li></ul><p> A <a href='<?url_for_page CloudCommandClient?>' class='internal'>command line client</a> for communicating with implementations of this API is also available. </p><p>(Work in progress): <a href='<?url_for_page CLIExample1?>' class='internal'>a simple example using the CLI</a> </p><p>Copyright © Sun Microsystems, 2009. This work is licensed under <a class='external' href="http://creativecommons.org/licenses/by/3.0/">Creative Commons Attribution 3.0 Unported License</a> </p><p><br /> </p>

2009-09-24T20:39:13Z

3636