DEPRECATED -  DEPRECATED -  DEPRECATED -  DEPRECATED -  DEPRECATED -  DEPRECATED -  DEPRECATED -  DEPRECATED - 

 3.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]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"/>



loading table of contents...