Esx. Settings. Hardware Support. Managers. Packages. Versions Get

Esx. Settings. Hardware Support. Managers. Packages. Versions Get

Returns the detailed information for a specific version of an available Hardware Support Packages (HSPs) as specified by the Hardware Support Manager (HSM)

This operation was added in vSphere API 7.0.0.0.

Returns an authorization error if you do not have all of the privileges described as follows:

  • Operation execution requires VcIntegrity.lifecycleSettings.Read.
Request
URI
GET
https://{api_host}/esx/settings/hardware-support/managers/{manager}/packages/{pkg}/versions/{version}
COPY
Path Parameters
string
manager
Required

Identifier for the Hardware Support Manager (HSM).

The parameter must be an identifier for the resource type: com.vmware.esx.setting.hardware_support.manager.

string
pkg
Required

The name of the Hardware Support Package (HSP)

The parameter must be an identifier for the resource type: com.vmware.esx.setting.hardware_support.package.

string
version
Required

The version of the Hardware Support Package (HSP)

Query Parameters
filter
Optional

Specification of detailed information to be returned

If missing or null, the behavior is equivalent to a Esx.Settings.HardwareSupport.Managers.Packages.Versions.FilterSpec with all properties missing or null, which means all releases supported are returned but no component information for any particular release is included.


Authentication
This operation uses the following authentication methods.
Responses
200

detailed information on Hardware Support Packages (HSPs)

Returns Esx.Settings.HardwareSupport.Managers.Packages.Versions.PackageInfo of type(s) application/json
"Esx.Settings.HardwareSupport.Managers.Packages.Versions.PackageInfo Object"

400

If any of the specified parameters are Invalid (e.g. if the release version specified in the query parameter is not, in fact, among those supported by the Hardware Support Package (HSP).

Returns Vapi.Std.Errors.InvalidArgument of type(s) application/json
"Vapi.Std.Errors.InvalidArgument Object"

401

if the caller is not authenticated. named manager in the system.

Returns Vapi.Std.Errors.Unauthenticated of type(s) application/json
"Vapi.Std.Errors.Unauthenticated Object"

403

if the user does not have the required privilege to perform the operation.

Returns Vapi.Std.Errors.Unauthorized of type(s) application/json
"Vapi.Std.Errors.Unauthorized Object"

404

If there is no Hardware Support Manager (HSM) with the specified name, or no Hardware Support Package (HSP) with the specified name and version.

Returns Vapi.Std.Errors.NotFound of type(s) application/json
"Vapi.Std.Errors.NotFound Object"

500

If there is some unknown internal error. The accompanying error message will give more details about the failure.

Returns Vapi.Std.Errors.Error of type(s) application/json
"Vapi.Std.Errors.Error Object"

503

If the service is not available.

Returns Vapi.Std.Errors.ServiceUnavailable of type(s) application/json
"Vapi.Std.Errors.ServiceUnavailable Object"

Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/esx/settings/hardware-support/managers/{manager}/packages/{pkg}/versions/{version}