esx settings hosts software solutions: delete-task
Deletes the given solution from the desired software specification. The deletion will be validated along with the entire software specification before it is committed as new desired spec. The result of this operation can be queried by calling the cis/tasks/{task-id} where the task-id is the response of this operation. Warning: This operation is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.
Request:
HTTP request
DELETE https://{server}/api/esx/settings/hosts/{host}/software/solutions/{solution}
?vmw-task=true
?vmw-task=true
Path Parameters
Name | Type | Description |
---|---|---|
Required | ||
host | string | Identifier of the host. |
solution | string | Identifier of the solution. |
Response:
HTTP Status Code: 202
Response Body Structure:
"obj-103"
Headers:
NoneType:
Name | Type | Description |
---|---|---|
bold = required | ||
- | string | ID of the newly created commit. |
Errors:
HTTP Status Code | Type | Description |
---|---|---|
500 | error | If there is some unknown internal error. The accompanying error message will give more details about the failure. |
400 | invalid_argument | if validation of the software document fails. The value of the data field of vapi.std.errors.error will be a structure that contains all the fields defined in ValidateResult. |
404 | not_found | If there is no host associated with host or solution associated with solution in the system. |
503 | service_unavailable | If the service is not available. |
401 | unauthenticated | if the caller is not authenticated. |
400 | unsupported | If the host is not a standlone host, but instead part of a cluster. |