This operation retires a client.
You can retire a client (for example, a server or a laptop) in the Command Center and CommCell Console. Retiring a client with no backup data releases the license of the client, uninstalls the Commvault software on the client computer, and then deletes the client from the Commvault system.
Note: If you perform the retire operation on a client with backup data, the operation releases the license, uninstalls the Commvault software, and retains the client. Overall, the client moves to the deconfigured state and the data is still available for data restore operation until the retention parameters of the data are met.
Caution: After you retire a client, you cannot undo the retirement. To add the client to the Commvault system again, you must add it as a new client.
Host: <host name>
Authtoken: <authentication token>
where <webservice> is the root path used to route the API requests to the Web Server.
For more information, see Available Web Services for REST API.
The ID of the client. If the ID is not known, use the GET Client API to retrieve it.
The host name of the Web Server or Web Console used in the API request.
The format of the response. Valid values are: application/xml or application/json.
The authentication token received after successfully logging on. For details on receiving an authentication token, see Authentication.
The ID of the job, which will retire the client.
The message for each error code. Every error code has a different error message.
The possible error codes.
Valid values are:
Authtoken: QSDK 3c633bc300b7cbdcf31f918d4ce4934722d620774b81e87e543c517177302b23a0742c0b7e74bd7dc43731ca2b83fe44a43b5fcb24633fab54842eaeb8ddaa6d85674a17692ea6cd559b1d70a4f589552e59c10fc79701debf79d85cda
"errorString": "Client will be retired by jobid",