REST API - get

esx settings hosts software components: get

Returns the component version for the given component in the desired software specification. 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

GET https://{server}/api/esx/settings/hosts/{host}/software/components/{component}

Path Parameters

Name	Type	Description
Required
host	string	Identifier of the host.
component	string	Identifier of the component.

Response:

HTTP Status Code: 200

Response Body Structure:

{
    "details" : {
        "vendor" : "string",
        "display_version" : "string",
        "display_name" : "string"
    },
    "version" : "string"
}

Headers:

None

Type:

Name	Type	Description
bold = required
-	component_info	Optional. Details about the component version.
-.version	string	Version of the component. Optional. unset if version is not specified.
-.details	component_details	Details about the component. Optional. unset if component is not present in the depot.
-.details.display_name	string	Display name of the component.
-.details.vendor	string	Vendor of the component.
-.details.display_version	string	Human readable version of the component. Optional. unset if no version is provided for the component.

Errors:

HTTP Status Code	Type	Description
500	error	If there is 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` in the system or or no component associated with `component` 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 host.