com.vmware.vcenter.vcha

Class ClusterStub

java.lang.Object

com.vmware.vapi.internal.bindings.Stub

com.vmware.vcenter.vcha.ClusterStub

All Implemented Interfaces:

Service, Cluster, ClusterTypes

public class ClusterStub
extends com.vmware.vapi.internal.bindings.Stub
implements Cluster

Remote stub implementation of the Cluster API service.

WARNING: Internal class, subject to change in future versions.

Nested Class Summary

Nested classes/interfaces inherited from interface com.vmware.vcenter.vcha.ClusterTypes

ClusterTypes._VAPI_OPERATIONS, ClusterTypes.ActiveSpec, ClusterTypes.ClusterMode, ClusterTypes.ClusterState, ClusterTypes.ConfigState, ClusterTypes.DeploySpec, ClusterTypes.ErrorCondition, ClusterTypes.Info, ClusterTypes.IpFamily, ClusterTypes.IpInfo, ClusterTypes.Ipv4Info, ClusterTypes.Ipv6Info, ClusterTypes.NodeInfo, ClusterTypes.NodeRole, ClusterTypes.NodeRuntimeInfo, ClusterTypes.NodeState, ClusterTypes.NodeVmInfo, ClusterTypes.PassiveSpec, ClusterTypes.Type, ClusterTypes.UndeploySpec, ClusterTypes.VmInfo, ClusterTypes.WitnessInfo, ClusterTypes.WitnessSpec

Field Summary

Fields inherited from class com.vmware.vapi.internal.bindings.Stub

apiProvider, converter, ifaceId, retryPolicy, securityContext

Fields inherited from interface com.vmware.vcenter.vcha.ClusterTypes

_VAPI_SERVICE_ID

Constructor Summary

Constructors

Constructor and Description
ClusterStub(ApiProvider apiProvider, StubConfigurationBase config)
ClusterStub(ApiProvider apiProvider, com.vmware.vapi.internal.bindings.TypeConverter typeConverter, StubConfigurationBase config)

Method Summary

Modifier and Type	Method and Description
java.lang.String	deploy_Task(ClusterTypes.DeploySpec spec) Prepares, clones, and configures a VCHA cluster.
void	deploy_Task(ClusterTypes.DeploySpec spec, AsyncCallback<java.lang.String> asyncCallback) Prepares, clones, and configures a VCHA cluster.
void	deploy_Task(ClusterTypes.DeploySpec spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Prepares, clones, and configures a VCHA cluster.
java.lang.String	deploy_Task(ClusterTypes.DeploySpec spec, InvocationConfig invocationConfig) Prepares, clones, and configures a VCHA cluster.
java.lang.String	failover_Task(boolean planned) Initiates failover from the active vCenter node to the passive node.
void	failover_Task(boolean planned, AsyncCallback<java.lang.String> asyncCallback) Initiates failover from the active vCenter node to the passive node.
void	failover_Task(boolean planned, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Initiates failover from the active vCenter node to the passive node.
java.lang.String	failover_Task(boolean planned, InvocationConfig invocationConfig) Initiates failover from the active vCenter node to the passive node.
ClusterTypes.Info	get(CredentialsSpec vcSpec, java.lang.Boolean partial) Retrieves the status of a VCHA cluster.
void	get(CredentialsSpec vcSpec, java.lang.Boolean partial, AsyncCallback<ClusterTypes.Info> asyncCallback) Retrieves the status of a VCHA cluster.
void	get(CredentialsSpec vcSpec, java.lang.Boolean partial, AsyncCallback<ClusterTypes.Info> asyncCallback, InvocationConfig invocationConfig) Retrieves the status of a VCHA cluster.
ClusterTypes.Info	get(CredentialsSpec vcSpec, java.lang.Boolean partial, InvocationConfig invocationConfig) Retrieves the status of a VCHA cluster.
java.lang.String	undeploy_Task(ClusterTypes.UndeploySpec spec) Destroys the VCHA cluster and removes all VCHA specific information from the VCVA appliance.
void	undeploy_Task(ClusterTypes.UndeploySpec spec, AsyncCallback<java.lang.String> asyncCallback) Destroys the VCHA cluster and removes all VCHA specific information from the VCVA appliance.
void	undeploy_Task(ClusterTypes.UndeploySpec spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Destroys the VCHA cluster and removes all VCHA specific information from the VCVA appliance.
java.lang.String	undeploy_Task(ClusterTypes.UndeploySpec spec, InvocationConfig invocationConfig) Destroys the VCHA cluster and removes all VCHA specific information from the VCVA appliance.

Methods inherited from class com.vmware.vapi.internal.bindings.Stub

invokeMethod, invokeMethodAsync, invokeStreamMethod, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

ClusterStub

public ClusterStub(ApiProvider apiProvider,
                   com.vmware.vapi.internal.bindings.TypeConverter typeConverter,
                   StubConfigurationBase config)

ClusterStub

public ClusterStub(ApiProvider apiProvider,
                   StubConfigurationBase config)

Method Detail

deploy_Task

public java.lang.String deploy_Task(ClusterTypes.DeploySpec spec)

Description copied from interface: Cluster

Prepares, clones, and configures a VCHA cluster. This method was added in vSphere API 6.7.1.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method.

Specified by:

deploy_Task in interface Cluster

Parameters:

spec - Contains the deploy specification for all three nodes of a VCHA cluster.

Returns:

identifier for the task created by this API invocation

deploy_Task

public java.lang.String deploy_Task(ClusterTypes.DeploySpec spec,
                                    InvocationConfig invocationConfig)

Description copied from interface: Cluster

Prepares, clones, and configures a VCHA cluster. This method was added in vSphere API 6.7.1.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

deploy_Task in interface Cluster

Parameters:

spec - Contains the deploy specification for all three nodes of a VCHA cluster.

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

deploy_Task

public void deploy_Task(ClusterTypes.DeploySpec spec,
                        AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: Cluster

Prepares, clones, and configures a VCHA cluster. This method was added in vSphere API 6.7.1.

Asynchronous method overload. Result of the invocation which is a task identifier will be reported via the specified asyncCallback.

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
InvalidArgument - If the credentials provided for authenticating with the active node's management vCenter server are invalid.
Unauthorized - If the user has insufficient privilege to perform the operation. Operation execution requires the Global.VCServer privilege.
UnverifiedPeer - If the SSL certificate of the management vCenter server cannot be validated.
The value of the data property of Error will be a class that contains all the properties defined in CertificateInfo.
Error - If any other error occurs.

Specified by:

deploy_Task in interface Cluster

Parameters:

spec - Contains the deploy specification for all three nodes of a VCHA cluster.

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

deploy_Task

public void deploy_Task(ClusterTypes.DeploySpec spec,
                        AsyncCallback<java.lang.String> asyncCallback,
                        InvocationConfig invocationConfig)

Description copied from interface: Cluster

Prepares, clones, and configures a VCHA cluster. This method was added in vSphere API 6.7.1.

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

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
InvalidArgument - If the credentials provided for authenticating with the active node's management vCenter server are invalid.
Unauthorized - If the user has insufficient privilege to perform the operation. Operation execution requires the Global.VCServer privilege.
UnverifiedPeer - If the SSL certificate of the management vCenter server cannot be validated.
The value of the data property of Error will be a class that contains all the properties defined in CertificateInfo.
Error - If any other error occurs.

Specified by:

deploy_Task in interface Cluster

Parameters:

spec - Contains the deploy specification for all three nodes of a VCHA cluster.

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

invocationConfig - Configuration for the method invocation.

failover_Task

public java.lang.String failover_Task(boolean planned)

Description copied from interface: Cluster

Initiates failover from the active vCenter node to the passive node.

For forced failover, Active node immediately initiates a failover. This may result into a data loss after failover.

For planned failover, Active node flushes all the state to the Passive node, waits for the flush to complete before causing a failover. After the failover, Passive node starts without any data loss.

A failover is allowed only in the following cases:

1. Cluster's mode is enabled and all cluster members are present.
2. Cluster's mode is maintenance and all cluster members are present.

. This method was added in vSphere API 6.7.1.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method.

Specified by:

failover_Task in interface Cluster

Parameters:

planned - If false, a failover is initiated immediately and may result in data loss.
If true, a failover is initated after the Active node flushes its state to Passive and there is no data loss.

Returns:

identifier for the task created by this API invocation

failover_Task

public java.lang.String failover_Task(boolean planned,
                                      InvocationConfig invocationConfig)

Description copied from interface: Cluster

Initiates failover from the active vCenter node to the passive node.

For forced failover, Active node immediately initiates a failover. This may result into a data loss after failover.

For planned failover, Active node flushes all the state to the Passive node, waits for the flush to complete before causing a failover. After the failover, Passive node starts without any data loss.

A failover is allowed only in the following cases:

1. Cluster's mode is enabled and all cluster members are present.
2. Cluster's mode is maintenance and all cluster members are present.

. This method was added in vSphere API 6.7.1.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

failover_Task in interface Cluster

Parameters:

planned - If false, a failover is initiated immediately and may result in data loss.
If true, a failover is initated after the Active node flushes its state to Passive and there is no data loss.

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

failover_Task

public void failover_Task(boolean planned,
                          AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: Cluster

Initiates failover from the active vCenter node to the passive node.

For forced failover, Active node immediately initiates a failover. This may result into a data loss after failover.

For planned failover, Active node flushes all the state to the Passive node, waits for the flush to complete before causing a failover. After the failover, Passive node starts without any data loss.

A failover is allowed only in the following cases:

1. Cluster's mode is enabled and all cluster members are present.
2. Cluster's mode is maintenance and all cluster members are present.

. This method was added in vSphere API 6.7.1.

Asynchronous method overload. Result of the invocation which is a task identifier will be reported via the specified asyncCallback.

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
Unauthorized - If the user has insufficient privilege to perform the operation. Operation execution requires the Global.VCServer privilege.
Error - If any other error occurs.

Specified by:

failover_Task in interface Cluster

Parameters:

planned - If false, a failover is initiated immediately and may result in data loss.
If true, a failover is initated after the Active node flushes its state to Passive and there is no data loss.

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

failover_Task

public void failover_Task(boolean planned,
                          AsyncCallback<java.lang.String> asyncCallback,
                          InvocationConfig invocationConfig)

Description copied from interface: Cluster

Initiates failover from the active vCenter node to the passive node.

For forced failover, Active node immediately initiates a failover. This may result into a data loss after failover.

For planned failover, Active node flushes all the state to the Passive node, waits for the flush to complete before causing a failover. After the failover, Passive node starts without any data loss.

A failover is allowed only in the following cases:

1. Cluster's mode is enabled and all cluster members are present.
2. Cluster's mode is maintenance and all cluster members are present.

. This method was added in vSphere API 6.7.1.

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

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
Unauthorized - If the user has insufficient privilege to perform the operation. Operation execution requires the Global.VCServer privilege.
Error - If any other error occurs.

Specified by:

failover_Task in interface Cluster

Parameters:

planned - If false, a failover is initiated immediately and may result in data loss.
If true, a failover is initated after the Active node flushes its state to Passive and there is no data loss.

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

invocationConfig - Configuration for the method invocation.

get

public ClusterTypes.Info get(CredentialsSpec vcSpec,
                             java.lang.Boolean partial)

Description copied from interface: Cluster

Retrieves the status of a VCHA cluster. This method was added in vSphere API 6.7.1.

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

Specified by:

get in interface Cluster

Parameters:

vcSpec - Contains active node's management vCenter server credentials. If null, then the active vCenter Server instance is assumed to be either self-managed or else in enhanced linked mode and managed by a linked vCenter Server instance.

partial - If true, then return only the information that does not require connecting to the Active vCenter Server.
If false or unset, then return all the information. If null, then return all the information.

Returns:

Info structure containing the VCHA configuration and health information.

get

public ClusterTypes.Info get(CredentialsSpec vcSpec,
                             java.lang.Boolean partial,
                             InvocationConfig invocationConfig)

Description copied from interface: Cluster

Retrieves the status of a VCHA cluster. This method was added in vSphere API 6.7.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.

Specified by:

get in interface Cluster

Parameters:

vcSpec - Contains active node's management vCenter server credentials. If null, then the active vCenter Server instance is assumed to be either self-managed or else in enhanced linked mode and managed by a linked vCenter Server instance.

partial - If true, then return only the information that does not require connecting to the Active vCenter Server.
If false or unset, then return all the information. If null, then return all the information.

invocationConfig - Configuration for the method invocation.

Returns:

Info structure containing the VCHA configuration and health information.

get

public void get(CredentialsSpec vcSpec,
                java.lang.Boolean partial,
                AsyncCallback<ClusterTypes.Info> asyncCallback)

Description copied from interface: Cluster

Retrieves the status of a VCHA cluster. This method was added in vSphere API 6.7.1.

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

Invocation Result:
Info structure containing the VCHA configuration and health information.

Operation Errors:
InvalidArgument - If the credentials provided for authenticating with the active node's management vCenter server are invalid.
Unauthorized - If the user has insufficient privilege to perform the operation.

• If partial is false or unset, then the operation execution requires the Global.VCServer privilege.
• If partial is true, then the operation execution requires the System.Read privilege.

UnverifiedPeer - If the SSL certificate of the management vCenter server cannot be validated.
The value of the data property of Error will be a class that contains all the properties defined in CertificateInfo.
Error - If any other error occurs.

Specified by:

get in interface Cluster

Parameters:

vcSpec - Contains active node's management vCenter server credentials. If null, then the active vCenter Server instance is assumed to be either self-managed or else in enhanced linked mode and managed by a linked vCenter Server instance.

partial - If true, then return only the information that does not require connecting to the Active vCenter Server.
If false or unset, then return all the information. If null, then return all the information.

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

get

public void get(CredentialsSpec vcSpec,
                java.lang.Boolean partial,
                AsyncCallback<ClusterTypes.Info> asyncCallback,
                InvocationConfig invocationConfig)

Description copied from interface: Cluster

Retrieves the status of a VCHA cluster. This method was added in vSphere API 6.7.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:
Info structure containing the VCHA configuration and health information.

Operation Errors:
InvalidArgument - If the credentials provided for authenticating with the active node's management vCenter server are invalid.
Unauthorized - If the user has insufficient privilege to perform the operation.

• If partial is false or unset, then the operation execution requires the Global.VCServer privilege.
• If partial is true, then the operation execution requires the System.Read privilege.

UnverifiedPeer - If the SSL certificate of the management vCenter server cannot be validated.
The value of the data property of Error will be a class that contains all the properties defined in CertificateInfo.
Error - If any other error occurs.

Specified by:

get in interface Cluster

Parameters:

vcSpec - Contains active node's management vCenter server credentials. If null, then the active vCenter Server instance is assumed to be either self-managed or else in enhanced linked mode and managed by a linked vCenter Server instance.

partial - If true, then return only the information that does not require connecting to the Active vCenter Server.
If false or unset, then return all the information. If null, then return all the information.

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

invocationConfig - Configuration for the method invocation.

undeploy_Task

public java.lang.String undeploy_Task(ClusterTypes.UndeploySpec spec)

Description copied from interface: Cluster

Destroys the VCHA cluster and removes all VCHA specific information from the VCVA appliance. Optionally, the passive and witness node virtual machines will be deleted only if VCHA was deployed using automatic deployment. The active node in the cluster continues to run as a standalone VCVA appliance after the destroy operation has been performed.

If the VCHA cluster is in a transition state and not configured, then the VCHA cluster specific information is removed.

. This method was added in vSphere API 6.7.1.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method.

Specified by:

undeploy_Task in interface Cluster

Parameters:

spec - Contains the undeploy specification for a VCHA cluster.

Returns:

identifier for the task created by this API invocation

undeploy_Task

public java.lang.String undeploy_Task(ClusterTypes.UndeploySpec spec,
                                      InvocationConfig invocationConfig)

Description copied from interface: Cluster

Destroys the VCHA cluster and removes all VCHA specific information from the VCVA appliance. Optionally, the passive and witness node virtual machines will be deleted only if VCHA was deployed using automatic deployment. The active node in the cluster continues to run as a standalone VCVA appliance after the destroy operation has been performed.

If the VCHA cluster is in a transition state and not configured, then the VCHA cluster specific information is removed.

. This method was added in vSphere API 6.7.1.

Synchronous method overload. Result of the invocation is a task identifier which will be returned by this method. Use invocationConfig to specify configuration for this particular invocation.

Specified by:

undeploy_Task in interface Cluster

Parameters:

spec - Contains the undeploy specification for a VCHA cluster.

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

undeploy_Task

public void undeploy_Task(ClusterTypes.UndeploySpec spec,
                          AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: Cluster

Destroys the VCHA cluster and removes all VCHA specific information from the VCVA appliance. Optionally, the passive and witness node virtual machines will be deleted only if VCHA was deployed using automatic deployment. The active node in the cluster continues to run as a standalone VCVA appliance after the destroy operation has been performed.

If the VCHA cluster is in a transition state and not configured, then the VCHA cluster specific information is removed.

. This method was added in vSphere API 6.7.1.

Asynchronous method overload. Result of the invocation which is a task identifier will be reported via the specified asyncCallback.

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
InvalidArgument - If the credentials provided for authenticating with the active node's management vCenter server are invalid.
NotFound - If the passive virtual machine is not managed by the specified vCenter server.
NotFound - If the witness virtual machine is not managed by the specified vCenter server.
Unauthorized - If the user has insufficient privilege to perform the operation. Operation execution requires the Global.VCServer privilege.
UnverifiedPeer - If the SSL certificate of the management vCenter server cannot be validated.
The value of the data property of Error will be a class that contains all the properties defined in CertificateInfo.
Error - If any other error occurs.

Specified by:

undeploy_Task in interface Cluster

Parameters:

spec - Contains the undeploy specification for a VCHA cluster.

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

undeploy_Task

public void undeploy_Task(ClusterTypes.UndeploySpec spec,
                          AsyncCallback<java.lang.String> asyncCallback,
                          InvocationConfig invocationConfig)

Description copied from interface: Cluster

Destroys the VCHA cluster and removes all VCHA specific information from the VCVA appliance. Optionally, the passive and witness node virtual machines will be deleted only if VCHA was deployed using automatic deployment. The active node in the cluster continues to run as a standalone VCVA appliance after the destroy operation has been performed.

If the VCHA cluster is in a transition state and not configured, then the VCHA cluster specific information is removed.

. This method was added in vSphere API 6.7.1.

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

Invocation Result:
identifier for the task created by this API invocation

Operation Errors:
InvalidArgument - If the credentials provided for authenticating with the active node's management vCenter server are invalid.
NotFound - If the passive virtual machine is not managed by the specified vCenter server.
NotFound - If the witness virtual machine is not managed by the specified vCenter server.
Unauthorized - If the user has insufficient privilege to perform the operation. Operation execution requires the Global.VCServer privilege.
UnverifiedPeer - If the SSL certificate of the management vCenter server cannot be validated.
The value of the data property of Error will be a class that contains all the properties defined in CertificateInfo.
Error - If any other error occurs.

Specified by:

undeploy_Task in interface Cluster

Parameters:

spec - Contains the undeploy specification for a VCHA cluster.

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

invocationConfig - Configuration for the method invocation.