HostRebuild

Rebuild a host with the currently selected profile and profile version.

The user must be authorized to rebuild the host. The host must also not be in any of the states which prohibit rebuilding, such as Immutable, Powercycle, Rebuild, or Rebuilding, or this method will fail.

The host must also indicate that it is rebuildable (e.g., not an EC2 host), or this method will fail.

URL

/cubit_api/1/rebuild

Authentication

This method requires authentication using an API key.

Parameters

host ( Required, once ): Fully qualified hostname to rebuild.; Type: String
sig ( Required, once ): API authentication hash signature.; Type: String
userid ( Required, once ): The login name of the user initiating the request.; Type: String

Example Response

        
    Successful initiation of rebuild:
    <?xml version='1.0'?>
    <cubit version='1'>
        <status>OK</status>
    </cubit>

    If the user is unauthorized, or the host does not exist:
    <?xml version='1.0'?>
    <cubit version='1'>
        <error>You are not authorized to rebuild this host.</error>
    </cubit>

Response Codes

200 - ok
400 - Login failed / Insufficient permissions