DRAFT -  DRAFT -  DRAFT -  DRAFT -  DRAFT -  DRAFT -  DRAFT -  DRAFT - 

4.3.1. Change Password

Verb URI Description
POST /servers/id/action Change a server's password

Normal Response Code(s): 202

Error Response Code(s): computeFault (400, 500, …), serviceUnavailable (503), unauthorized (401), forbidden (403), badRequest (400), badMethod (405), overLimit (413), itemNotFound (404), badMediaType (415), buildInProgress (409)

Status Transition: ACTIVE PASSWORD ACTIVE
ACTIVE PASSWORD ERROR (on error)
ERROR PASSWORD ACTIVE (password reset after error)

This operation changes the server's administrator password. The specified password must meet the complexity requirements set by your OpenStack Compute provider. The server may enter an ERROR state if the complexity requirements are not met. In this case, a client may reissue the change password action.

Example 4.25. Server Update Request: XML

<?xml version="1.0" encoding="UTF-8"?>
<changePassword
    xmlns="http://docs.openstack.org/compute/api/v1.1"
    adminPass="ss1293837$%^"/>

Example 4.26. Server Update Request: JSON

{
    "changePassword" : {
        "adminPass" : "ss1293837$%^"
    }
}

This operation does not contain a response body.

Legal notices