Esx. Settings. Hosts. Software. Reports. Apply Impact Get

Esx. Settings. Hosts. Software. Reports. Apply Impact Get

Returns a summary of how a standalone ESXi host will be impacted during an apply operation. The impact is generated from the compliance information obtained from GET /esx/settings/hosts/{host}/software/compliance

This operation was added in vSphere API 8.0.0.1.

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

  • Operation execution requires VcIntegrity.lifecycleSoftwareRemediation.Read.
  • The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareRemediation.Read.
Request
URI
GET
https://{api_host}/esx/settings/hosts/{host}/software/reports/apply-impact
COPY
Path Parameters
string
host
Required

The host identifier.

The parameter must be an identifier for the resource type: HostSystem.

Authentication
This operation uses the following authentication methods.
Responses
200

Summary of how hosts will be impacted during an apply operation

Returns Esx.Settings.Hosts.Software.Reports.ApplyImpact.HostImpact of type(s) application/json 
"Esx.Settings.Hosts.Software.Reports.ApplyImpact.HostImpact Object"

400

If the host is not a vLCM managed standalone host.

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

401

if the caller is not authenticated.

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

404

If there is no host associated with host in the system.

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

500

If there is an 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/hosts/{host}/software/reports/apply-impact
On This Page
Esx.settings.hosts.software.reports.apply Impact Operations
GET
Esx. Settings. Hosts. Software. Reports. Apply Impact Get