Esx. Settings. Clusters. Software. Commits Get

Esx. Settings. Clusters. Software. Commits Get

Returns the information about a specific commit.

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.lifecycleSoftwareSpecification.Read.
Request
URI
GET
https://{api_host}/esx/settings/clusters/{cluster}/software/commits/{commit}
COPY
Path Parameters
string
cluster
Required

Identifier of the cluster.

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

string
commit
Required

Identifier of the specific commit.

The parameter must be an identifier for the resource type: com.vmware.esx.settings.commit.


Authentication
This operation uses the following authentication methods.
Responses
200

Information about the commit.

Returns Esx.Settings.Clusters.Software.Commits.Info of type(s) application/json
"Esx.Settings.Clusters.Software.Commits.Info 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 cluster associated with cluster in the system or if desired specification commit is not found.

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

500

If there is 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/clusters/{cluster}/software/commits/{commit}