Esx. Settings. Clusters. Software. Reports. Apply Impact Get
Returns a summary of how hosts within the cluster will be impacted during an apply operation. The impact is generated from the compliance information obtained from GET /esx/settings/clusters/{cluster}/software/compliance
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.lifecycleSoftwareRemediation.Read.
- The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.lifecycleSoftwareRemediation.Read.
The cluster identifier.
The parameter must be an identifier for the resource type: ClusterComputeResource.
The specific hosts for which an impact is to be generated.
This property was added in vSphere API 7.0.0.0.
if missing or null or empty impact is generated for all hosts within the cluster.
When clients pass a value of this schema as a parameter, the property must contain identifiers for the resource type: HostSystem. When operations return a value of this schema as a response, the property will contain identifiers for the resource type: HostSystem.
Summary of how hosts will be impacted during an apply operation
"Esx.Settings.Clusters.Software.Reports.ApplyImpact.ClusterImpact Object"if the caller is not authenticated.
"Vapi.Std.Errors.Unauthenticated Object"If there is no cluster associated with cluster in the system.
"Vapi.Std.Errors.NotFound Object"If there is an unknown internal error. The accompanying error message will give more details about the failure.
"Vapi.Std.Errors.Error Object"If the service is not available.
"Vapi.Std.Errors.ServiceUnavailable Object" curl -H 'Authorization: <value>' https://{api_host}/esx/settings/clusters/{cluster}/software/reports/apply-impact