com.vmware.vcenter.vcha.cluster

Interface Passive

All Superinterfaces:

PassiveTypes, Service

All Known Implementing Classes:

PassiveStub

public interface Passive
extends Service, PassiveTypes

The Passive interface provides methods to validate a passive's placement configuration and redeploy the passive node in a vCenter High Availability (VCHA) cluster. This interface was added in vSphere API 6.7.1.

Nested Class Summary

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

PassiveTypes._VAPI_OPERATIONS, PassiveTypes.CheckResult, PassiveTypes.CheckSpec, PassiveTypes.RedeploySpec

Field Summary

Fields inherited from interface com.vmware.vcenter.vcha.cluster.PassiveTypes

_VAPI_SERVICE_ID

Method Summary

Modifier and Type	Method and Description
PassiveTypes.CheckResult	check(PassiveTypes.CheckSpec spec) Validates the specified passive node's placement configuration.
void	check(PassiveTypes.CheckSpec spec, AsyncCallback<PassiveTypes.CheckResult> asyncCallback) Validates the specified passive node's placement configuration.
void	check(PassiveTypes.CheckSpec spec, AsyncCallback<PassiveTypes.CheckResult> asyncCallback, InvocationConfig invocationConfig) Validates the specified passive node's placement configuration.
PassiveTypes.CheckResult	check(PassiveTypes.CheckSpec spec, InvocationConfig invocationConfig) Validates the specified passive node's placement configuration.
java.lang.String	redeploy_Task(PassiveTypes.RedeploySpec spec) Creates the passive node in a degraded cluster with node location information and pre-existing VCHA cluster configuration from the active node.
void	redeploy_Task(PassiveTypes.RedeploySpec spec, AsyncCallback<java.lang.String> asyncCallback) Creates the passive node in a degraded cluster with node location information and pre-existing VCHA cluster configuration from the active node.
void	redeploy_Task(PassiveTypes.RedeploySpec spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Creates the passive node in a degraded cluster with node location information and pre-existing VCHA cluster configuration from the active node.
java.lang.String	redeploy_Task(PassiveTypes.RedeploySpec spec, InvocationConfig invocationConfig) Creates the passive node in a degraded cluster with node location information and pre-existing VCHA cluster configuration from the active node.

Method Detail

check

PassiveTypes.CheckResult check(PassiveTypes.CheckSpec spec)

Validates the specified passive node's placement configuration. 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.

Parameters:

spec - Contains the passive node's placement specification.

Returns:

CheckResult structure containing errors and warnings.

Throws:

InvalidArgument - If the credentials provided for authentincating with the active node's management vCenter server are invalid.

InvalidArgument - If the specified resource spec is deemed invalid for the clone operation.

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.

NotFound - If the active virtual machine is not managed by the specified vCenter server for the active node.

InvalidElementConfiguration - If the active node is on more than one datastore.

NotAllowedInCurrentState - If the clone operation is not allowed in the current state of the system.

Unauthorized - If the user has insufficient privilege to perform the operation. Operation execution requires the Global.VCServer privilege.

Error - If any other error occurs.

check

PassiveTypes.CheckResult check(PassiveTypes.CheckSpec spec,
                               InvocationConfig invocationConfig)

Validates the specified passive node's placement configuration. 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.

Parameters:

spec - Contains the passive node's placement specification.

invocationConfig - Configuration for the method invocation.

Returns:

CheckResult structure containing errors and warnings.

Throws:

InvalidArgument - If the credentials provided for authentincating with the active node's management vCenter server are invalid.

InvalidArgument - If the specified resource spec is deemed invalid for the clone operation.

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.

NotFound - If the active virtual machine is not managed by the specified vCenter server for the active node.

InvalidElementConfiguration - If the active node is on more than one datastore.

NotAllowedInCurrentState - If the clone operation is not allowed in the current state of the system.

Unauthorized - If the user has insufficient privilege to perform the operation. Operation execution requires the Global.VCServer privilege.

Error - If any other error occurs.

check

void check(PassiveTypes.CheckSpec spec,
           AsyncCallback<PassiveTypes.CheckResult> asyncCallback)

Validates the specified passive node's placement configuration. 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:
CheckResult structure containing errors and warnings.

Operation Errors:
InvalidArgument - If the credentials provided for authentincating with the active node's management vCenter server are invalid.
InvalidArgument - If the specified resource spec is deemed invalid for the clone operation.
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.
NotFound - If the active virtual machine is not managed by the specified vCenter server for the active node.
InvalidElementConfiguration - If the active node is on more than one datastore.
NotAllowedInCurrentState - If the clone operation is not allowed in the current state of the system.
Unauthorized - If the user has insufficient privilege to perform the operation. Operation execution requires the Global.VCServer privilege.
Error - If any other error occurs.

Parameters:

spec - Contains the passive node's placement specification.

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

check

void check(PassiveTypes.CheckSpec spec,
           AsyncCallback<PassiveTypes.CheckResult> asyncCallback,
           InvocationConfig invocationConfig)

Validates the specified passive node's placement configuration. 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:
CheckResult structure containing errors and warnings.

Operation Errors:
InvalidArgument - If the credentials provided for authentincating with the active node's management vCenter server are invalid.
InvalidArgument - If the specified resource spec is deemed invalid for the clone operation.
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.
NotFound - If the active virtual machine is not managed by the specified vCenter server for the active node.
InvalidElementConfiguration - If the active node is on more than one datastore.
NotAllowedInCurrentState - If the clone operation is not allowed in the current state of the system.
Unauthorized - If the user has insufficient privilege to perform the operation. Operation execution requires the Global.VCServer privilege.
Error - If any other error occurs.

Parameters:

spec - Contains the passive node's placement specification.

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

invocationConfig - Configuration for the method invocation.

redeploy_Task

java.lang.String redeploy_Task(PassiveTypes.RedeploySpec spec)

Creates the passive node in a degraded cluster with node location information and pre-existing VCHA cluster configuration from the active node. 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.

Parameters:

spec - Contains the passive node's redeploy specification.

Returns:

identifier for the task created by this API invocation

Throws:

InvalidArgument - If the credentials provided for authentincating 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.

redeploy_Task

java.lang.String redeploy_Task(PassiveTypes.RedeploySpec spec,
                               InvocationConfig invocationConfig)

Creates the passive node in a degraded cluster with node location information and pre-existing VCHA cluster configuration from the active node. 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.

Parameters:

spec - Contains the passive node's redeploy specification.

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

Throws:

InvalidArgument - If the credentials provided for authentincating 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.

redeploy_Task

void redeploy_Task(PassiveTypes.RedeploySpec spec,
                   AsyncCallback<java.lang.String> asyncCallback)

Creates the passive node in a degraded cluster with node location information and pre-existing VCHA cluster configuration from the active node. 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 authentincating 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.

Parameters:

spec - Contains the passive node's redeploy specification.

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

redeploy_Task

void redeploy_Task(PassiveTypes.RedeploySpec spec,
                   AsyncCallback<java.lang.String> asyncCallback,
                   InvocationConfig invocationConfig)

Creates the passive node in a degraded cluster with node location information and pre-existing VCHA cluster configuration from the active node. 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 authentincating 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.

Parameters:

spec - Contains the passive node's redeploy specification.

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

invocationConfig - Configuration for the method invocation.