5.2. Create Image

Verb	URI		Description
POST	/images		Creates a new image.

Normal Response Code: 202

Error Response Codes: cloudServersFault (400, 500), serviceUnavailable (503), unauthorized (401), badMediaType(415), itemNotFound (404), badRequest (400), serverCapacityUnavailable (503), buildInProgress (409), resizeNotAllowed (403), backupOrResizeInProgress (409), overLimit (413)

Status Transition:	`QUEUED` `PREPARING` `SAVING` `ACTIVE`
	`QUEUED` `PREPARING` `SAVING` `FAILED` (on error)

This operation creates a new image for the given server ID. Once complete, a new image will be available that can be used to rebuild or create servers. The image creation status can be queried by performing a GET on /images/id and examining the status and progress attributes.

	Note
	At present, image creation is an asynchronous operation, so coordinating the creation with data quiescence, etc. is currently not possible.

Example 3.37. Create Image: JSON Request

{
      "image" : {
          "serverId" : 12,
          "name" : "Just in case"
      }
}

Example 3.38. Create Image: JSON Response

{
      "image" : {
          "id" : 22,
          "serverId" : 12,
          "name" : "Just in case",
          "created" : "2010-10-10T12:00:00Z",
          "status" : "SAVING",
          "progress" : 0
      }
}

Example 3.39. Create Image: XML Request

<?xml version="1.0" encoding="UTF-8"?>
<image 
    xmlns="http://docs.rackspacecloud.com/servers/api/v1.0"
    name="Just in case" 
    serverId="12"/>

Example 3.40. Create Image: XML Response

<?xml version="1.0" encoding="UTF-8"?>
<image 
    xmlns="http://docs.rackspacecloud.com/servers/api/v1.0"
    id="22" 
    name="Just in case"
    created="2010-10-10T12:00:00Z"
    status="SAVING" 
    progress="0" 
    serverId="12"/>

Legal notices