Resize Server

Verb URI Description
POST /servers/id/action Resize 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), resizeNotAllowed (403)

Status Transition: ACTIVE QUEUE_RESIZE PREP_RESIZE RESIZE VERIFY_RESIZE
ACTIVE QUEUE_RESIZE ACTIVE (on error)

The resize function converts an existing server to a different flavor, in essence, scaling the server up or down. The original server is saved for a period of time to allow rollback if there is a problem. All resizes should be tested and explicitly confirmed, at which time the original server is removed. All resizes are automatically confirmed after 24 hours if they are not explicitly confirmed or reverted.

Example 4.23. Action Resize: XML

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

<resize xmlns="http://docs.rackspacecloud.com/servers/api/v1.0" 
	flavorId="3"/>

Example 4.24. Action Resize: JSON

{
    "resize" : {
        "flavorId" : 3 
    }
}

This operation does not return a response body.

Legal notices