REST API - set

esx settings hosts software drafts software components: set

Set the component version for a given component in the software draft. This will overwrite any existing version for the given component. 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

PUT https://{server}/api/esx/settings/hosts/{host}/software/drafts/{draft}/software/components/{component}
"string"

Path Parameters

Name Type Description
Required
host string Identifier of the host.
draft string Identifier of the working copy document.
component string Identifier of the component.

Body Parameters:

Name Type Description
bold = required
- string Optional. Component version.

Response:

HTTP Status Code: 204

Headers:

None

Type:

None

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.
404 not_found If there is no host associated with host or no draft associated with draft 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.