com.vmware.esx.settings.hosts.software

Interface Commits

All Superinterfaces:

CommitsTypes, Service

All Known Implementing Classes:

CommitsStub

public interface Commits
extends Service, CommitsTypes

The Commits interface provides methods to manage committed changes to desired software document. This interface was added in vSphere API 8.0.0.1.

Nested Class Summary

Nested classes/interfaces inherited from interface com.vmware.esx.settings.hosts.software.CommitsTypes

CommitsTypes.ApplyStatusType, CommitsTypes.Info

Field Summary

Fields inherited from interface com.vmware.esx.settings.hosts.software.CommitsTypes

_VAPI_SERVICE_ID, RESOURCE_TYPE

Method Summary

Modifier and Type	Method and Description
CommitsTypes.Info	get(java.lang.String host, java.lang.String commit) Returns the information about a specific commit.
void	get(java.lang.String host, java.lang.String commit, AsyncCallback<CommitsTypes.Info> asyncCallback) Returns the information about a specific commit.
void	get(java.lang.String host, java.lang.String commit, AsyncCallback<CommitsTypes.Info> asyncCallback, InvocationConfig invocationConfig) Returns the information about a specific commit.
CommitsTypes.Info	get(java.lang.String host, java.lang.String commit, InvocationConfig invocationConfig) Returns the information about a specific commit.

Method Detail

get

CommitsTypes.Info get(java.lang.String host,
                      java.lang.String commit)

Returns the information about a specific commit. This method was added in vSphere API 8.0.0.1.

Synchronous method overload. Result of the invocation will be reported as a method return value.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

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

Returns:

Information about the commit.

Throws:

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

NotFound - If there is no host associated with host in the system or if working copy of the software document is not found.

ServiceUnavailable - If the service is not available.

Unauthenticated - if the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Read.

get

CommitsTypes.Info get(java.lang.String host,
                      java.lang.String commit,
                      InvocationConfig invocationConfig)

Returns the information about a specific commit. This method was added in vSphere API 8.0.0.1.

Synchronous method overload. Result of the invocation will be reported as a method return value. Use invocationConfig to specify configuration for this particular invocation.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

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

invocationConfig - Configuration for the method invocation.

Returns:

Information about the commit.

Throws:

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

NotFound - If there is no host associated with host in the system or if working copy of the software document is not found.

ServiceUnavailable - If the service is not available.

Unauthenticated - if the caller is not authenticated.

Unsupported - If the host is not a vLCM managed standlone host.

Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Read.

get

void get(java.lang.String host,
         java.lang.String commit,
         AsyncCallback<CommitsTypes.Info> asyncCallback)

Returns the information about a specific commit. This method was added in vSphere API 8.0.0.1.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback.

Invocation Result:
Information about the commit.

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host in the system or if working copy of the software document is not found.
ServiceUnavailable - If the service is not available.
Unauthenticated - if the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Read.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

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

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

get

void get(java.lang.String host,
         java.lang.String commit,
         AsyncCallback<CommitsTypes.Info> asyncCallback,
         InvocationConfig invocationConfig)

Returns the information about a specific commit. This method was added in vSphere API 8.0.0.1.

Asynchronous method overload. Result of the invocation will be reported via the specified asyncCallback. Use invocationConfig to specify configuration for this particular invocation.

Invocation Result:
Information about the commit.

Operation Errors:
Error - If there is unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If there is no host associated with host in the system or if working copy of the software document is not found.
ServiceUnavailable - If the service is not available.
Unauthenticated - if the caller is not authenticated.
Unsupported - If the host is not a vLCM managed standlone host.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.lifecycleSoftwareSpecification.Read.
• The resource HostSystem referenced by the parameter host requires VcIntegrity.lifecycleSoftwareSpecification.Read.

Parameters:

host - Identifier of the host. The parameter must be an identifier for the resource type: HostSystem.

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

asyncCallback - Receives the status (progress, result or error) of the operation invocation.

invocationConfig - Configuration for the method invocation.