Login | Join Now
  • CUBiT API: HostRebuild

    Product:
    CUBiT

    Component:
    CUBiT Web Services

    Summary:

    Rebuild a host with the currently selected profile and profile version



     

    1.1. Description

    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 following states: Immutable , Powercycle , Rebuild , or Rebuilding , or this method will fail.

    1.2. URL

    /cubit_api/1/rebuild

    1.3. Authentication

    This method requires authentication using an API key.

    1.4. 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
    

    1.5. 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>
    

    1.6. Response Codes

    • 200 - ok
    • 400 - Login failed / Insufficient permissions