Skip to main content

DELETE /osdeployment/hostSettings/{uuid}

Use this method to delete all network and storage settings for a specific server.

Authentication

Authentication with username and password is required.

Request URL

DELETE https://{management_server_IP}/osdeployment/hostSettings/{uuid}

where {uuid} is the UUID of the server. To obtain the UUID, use the GET /nodes method.

Query parameters

None

Request body

None

Response codes

CodeDescriptionComments
200OKThe request completed successfully.
401UnauthorizedThe user cannot be authenticated. Authentication has not been provided or has failed. A descriptive error message is returned in the response body.
403ForbiddenThe orchestrator server was prevented from fulfilling the request. A descriptive error message is returned in the response body. Ensure that you have privileges to perform the request.

For XClarity Administrator advanced functions, ensure that you have active licenses for each managed server that supports the advanced functions.

409ConflictThere is a conflict with the current state of the resource. A descriptive error message is returned in the response body.
412Precondition failedSpecified data is invalid because of missing values. A descriptive error message is returned in the response body.
500Internal Server ErrorAn internal error occurred. A descriptive error message is returned in the response body.

Response body

AttributesTypeDescription
resultStringResult of the request. This can be one of the following values.
  • Success. The request was successful.
  • Failed. The request failed.
messagesArrayInformation about the message that is related to the result of the request
 explanationStringAdditional information to clarify the reason for the message
 idStringMessage identifier of a returned message
 messageStringMessage text associated with the message identifier
 recoveryArrayRecovery information
  textStringUser actions that can be taken to recover from the event
  URLStringLink to the help system for more information, if available
The following example is returned if the request is successful.
{
"result": "success",
"messages": []
}