Rebuild Server

Verb URI Description
POST /servers/id/action Rebuild the specified server

Normal Response Code(s): 202

Error Response Code(s): cloudServersFault (400, 500), serviceUnavailable (503), unauthorized (401), badRequest (400), badMediaType(415), itemNotFound (404), buildInProgress (409), serverCapacityUnavailable (503), overLimit (413)

Status Transition: ACTIVE REBUILD ACTIVE
ACTIVE REBUILD ERROR (on error)

The rebuild function removes all data on the server and replaces it with the specified image. serverId and IP addresses will remain the same.

Example 4.21. Action Rebuild: XML 

<?xml version="1.0" encoding="UTF-8"?>

<rebuild xmlns="http://docs.rackspacecloud.com/servers/api/v1.0" 
	 imageId="2"/>

Example 4.22. Action Rebuild: JSON

{
    "rebuild" : {
        "imageId" : 2
    }
}

This operation does not return a response body.

Legal notices