com.vmware.esx.settings.clusters

Class ConfigurationStub

java.lang.Object

com.vmware.vapi.internal.bindings.Stub

com.vmware.esx.settings.clusters.ConfigurationStub

All Implemented Interfaces:

Configuration, ConfigurationTypes, Service

public class ConfigurationStub
extends com.vmware.vapi.internal.bindings.Stub
implements Configuration

Remote stub implementation of the Configuration API service.

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

Nested Class Summary

Nested classes/interfaces inherited from interface com.vmware.esx.settings.clusters.ConfigurationTypes

ConfigurationTypes._VAPI_OPERATIONS, ConfigurationTypes.ApplyResult, ConfigurationTypes.ApplySpec, ConfigurationTypes.ImportSpec, ConfigurationTypes.Info, ConfigurationTypes.Metadata

Field Summary

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

apiProvider, converter, ifaceId, retryPolicy, securityContext

Fields inherited from interface com.vmware.esx.settings.clusters.ConfigurationTypes

_VAPI_SERVICE_ID

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
java.lang.String	apply_Task(java.lang.String cluster, ConfigurationTypes.ApplySpec spec) Synchronous method overload.
void	apply_Task(java.lang.String cluster, ConfigurationTypes.ApplySpec spec, AsyncCallback<java.lang.String> asyncCallback) Asynchronous method overload.
void	apply_Task(java.lang.String cluster, ConfigurationTypes.ApplySpec spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Asynchronous method overload.
java.lang.String	apply_Task(java.lang.String cluster, ConfigurationTypes.ApplySpec spec, InvocationConfig invocationConfig) Synchronous method overload.
java.lang.String	checkCompliance_Task(java.lang.String cluster) Check all the hosts in the cluster for compliance with the desired document.
void	checkCompliance_Task(java.lang.String cluster, AsyncCallback<java.lang.String> asyncCallback) Check all the hosts in the cluster for compliance with the desired document.
void	checkCompliance_Task(java.lang.String cluster, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Check all the hosts in the cluster for compliance with the desired document.
java.lang.String	checkCompliance_Task(java.lang.String cluster, InvocationConfig invocationConfig) Check all the hosts in the cluster for compliance with the desired document.
ExportResult	exportConfig(java.lang.String cluster) This API will export the configuration associated with the cluster.
void	exportConfig(java.lang.String cluster, AsyncCallback<ExportResult> asyncCallback) This API will export the configuration associated with the cluster.
void	exportConfig(java.lang.String cluster, AsyncCallback<ExportResult> asyncCallback, InvocationConfig invocationConfig) This API will export the configuration associated with the cluster.
ExportResult	exportConfig(java.lang.String cluster, InvocationConfig invocationConfig) This API will export the configuration associated with the cluster.
ConfigurationTypes.Info	get(java.lang.String cluster, java.lang.String commit, DocumentStructure docStructure) Get the cluster configuration and related metadata.
void	get(java.lang.String cluster, java.lang.String commit, DocumentStructure docStructure, AsyncCallback<ConfigurationTypes.Info> asyncCallback) Get the cluster configuration and related metadata.
void	get(java.lang.String cluster, java.lang.String commit, DocumentStructure docStructure, AsyncCallback<ConfigurationTypes.Info> asyncCallback, InvocationConfig invocationConfig) Get the cluster configuration and related metadata.
ConfigurationTypes.Info	get(java.lang.String cluster, java.lang.String commit, DocumentStructure docStructure, InvocationConfig invocationConfig) Get the cluster configuration and related metadata.
java.lang.String	importConfig_Task(java.lang.String cluster, ConfigurationTypes.ImportSpec spec) This API replaces the existing desired configuration of the cluster with the configuration provided in the input parameter document.
void	importConfig_Task(java.lang.String cluster, ConfigurationTypes.ImportSpec spec, AsyncCallback<java.lang.String> asyncCallback) This API replaces the existing desired configuration of the cluster with the configuration provided in the input parameter document.
void	importConfig_Task(java.lang.String cluster, ConfigurationTypes.ImportSpec spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) This API replaces the existing desired configuration of the cluster with the configuration provided in the input parameter document.
java.lang.String	importConfig_Task(java.lang.String cluster, ConfigurationTypes.ImportSpec spec, InvocationConfig invocationConfig) This API replaces the existing desired configuration of the cluster with the configuration provided in the input parameter document.
java.lang.String	precheck_Task(java.lang.String cluster) This API will perform precheck of the desired cluster configuration on each of the hosts in the cluster.
void	precheck_Task(java.lang.String cluster, AsyncCallback<java.lang.String> asyncCallback) This API will perform precheck of the desired cluster configuration on each of the hosts in the cluster.
void	precheck_Task(java.lang.String cluster, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) This API will perform precheck of the desired cluster configuration on each of the hosts in the cluster.
java.lang.String	precheck_Task(java.lang.String cluster, InvocationConfig invocationConfig) This API will perform precheck of the desired cluster configuration on each of the hosts in the cluster.
java.lang.String	validate_Task(java.lang.String cluster) Synchronous method overload.
void	validate_Task(java.lang.String cluster, AsyncCallback<java.lang.String> asyncCallback) Asynchronous method overload.
void	validate_Task(java.lang.String cluster, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Asynchronous method overload.
java.lang.String	validate_Task(java.lang.String cluster, InvocationConfig invocationConfig) Synchronous method overload.

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

ConfigurationStub

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

ConfigurationStub

public ConfigurationStub(ApiProvider apiProvider,
                         StubConfigurationBase config)

Method Detail

get

public ConfigurationTypes.Info get(java.lang.String cluster,
                                   java.lang.String commit,
                                   DocumentStructure docStructure)

Description copied from interface: Configuration

Get the cluster configuration and related metadata. The configuration returned by this API only contains the user-visible configuration properties available for a the cluster. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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

Specified by:

get in interface Configuration

Parameters:

cluster - Identifier of the cluster The parameter must be an identifier for the resource type: ClusterComputeResource.

commit - Identifier of the commit to get. The parameter must be an identifier for the resource type: ClusterComputeResource.

get

public ConfigurationTypes.Info get(java.lang.String cluster,
                                   java.lang.String commit,
                                   DocumentStructure docStructure,
                                   InvocationConfig invocationConfig)

Description copied from interface: Configuration

Get the cluster configuration and related metadata. The configuration returned by this API only contains the user-visible configuration properties available for a the cluster. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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 Configuration

Parameters:

cluster - Identifier of the cluster The parameter must be an identifier for the resource type: ClusterComputeResource.

commit - Identifier of the commit to get. The parameter must be an identifier for the resource type: ClusterComputeResource.

invocationConfig - Configuration for the method invocation.

get

public void get(java.lang.String cluster,
                java.lang.String commit,
                DocumentStructure docStructure,
                AsyncCallback<ConfigurationTypes.Info> asyncCallback)

Description copied from interface: Configuration

Get the cluster configuration and related metadata. The configuration returned by this API only contains the user-visible configuration properties available for a the cluster. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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

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 cluster associated with cluster or no commit associated with commit in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.ClusterConfiguration.View.
• The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.ClusterConfiguration.View.

Specified by:

get in interface Configuration

Parameters:

cluster - Identifier of the cluster The parameter must be an identifier for the resource type: ClusterComputeResource.

commit - Identifier of the commit to get. The parameter must be an identifier for the resource type: ClusterComputeResource.

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

get

public void get(java.lang.String cluster,
                java.lang.String commit,
                DocumentStructure docStructure,
                AsyncCallback<ConfigurationTypes.Info> asyncCallback,
                InvocationConfig invocationConfig)

Description copied from interface: Configuration

Get the cluster configuration and related metadata. The configuration returned by this API only contains the user-visible configuration properties available for a the cluster. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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

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 cluster associated with cluster or no commit associated with commit in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.ClusterConfiguration.View.
• The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.ClusterConfiguration.View.

Specified by:

get in interface Configuration

Parameters:

cluster - Identifier of the cluster The parameter must be an identifier for the resource type: ClusterComputeResource.

commit - Identifier of the commit to get. The parameter must be an identifier for the resource type: ClusterComputeResource.

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

invocationConfig - Configuration for the method invocation.

apply_Task

public java.lang.String apply_Task(java.lang.String cluster,
                                   ConfigurationTypes.ApplySpec spec)

Description copied from interface: Configuration

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

Specified by:

apply_Task in interface Configuration

Returns:

identifier for the task created by this API invocation

apply_Task

public java.lang.String apply_Task(java.lang.String cluster,
                                   ConfigurationTypes.ApplySpec spec,
                                   InvocationConfig invocationConfig)

Description copied from interface: Configuration

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:

apply_Task in interface Configuration

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

apply_Task

public void apply_Task(java.lang.String cluster,
                       ConfigurationTypes.ApplySpec spec,
                       AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: Configuration

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:

Specified by:

apply_Task in interface Configuration

Parameters:

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

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

apply_Task

public void apply_Task(java.lang.String cluster,
                       ConfigurationTypes.ApplySpec spec,
                       AsyncCallback<java.lang.String> asyncCallback,
                       InvocationConfig invocationConfig)

Description copied from interface: Configuration

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:

Specified by:

apply_Task in interface Configuration

Parameters:

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

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

invocationConfig - Configuration for the method invocation.

checkCompliance_Task

public java.lang.String checkCompliance_Task(java.lang.String cluster)

Description copied from interface: Configuration

Check all the hosts in the cluster for compliance with the desired document. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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

Specified by:

checkCompliance_Task in interface Configuration

Parameters:

cluster - Identifier of the cluster The parameter must be an identifier for the resource type: ClusterComputeResource.

Returns:

identifier for the task created by this API invocation

checkCompliance_Task

public java.lang.String checkCompliance_Task(java.lang.String cluster,
                                             InvocationConfig invocationConfig)

Description copied from interface: Configuration

Check all the hosts in the cluster for compliance with the desired document. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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:

checkCompliance_Task in interface Configuration

Parameters:

cluster - Identifier of the cluster The parameter must be an identifier for the resource type: ClusterComputeResource.

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

checkCompliance_Task

public void checkCompliance_Task(java.lang.String cluster,
                                 AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: Configuration

Check all the hosts in the cluster for compliance with the desired document. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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:
Error - If an internal error occurred. The accompanying error message will give more details about the failure.
InvalidArgument - If API is called on a cluster that is not managed by desired configuration management platform.
NotFound - If there is no cluster associated with cluster
ServiceUnavailable - If the service is not available.
TimedOut - If the API timed out before completion.
Unauthenticated - If the caller is not authenticated.

Specified by:

checkCompliance_Task in interface Configuration

Parameters:

cluster - Identifier of the cluster The parameter must be an identifier for the resource type: ClusterComputeResource.

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

checkCompliance_Task

public void checkCompliance_Task(java.lang.String cluster,
                                 AsyncCallback<java.lang.String> asyncCallback,
                                 InvocationConfig invocationConfig)

Description copied from interface: Configuration

Check all the hosts in the cluster for compliance with the desired document. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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:
Error - If an internal error occurred. The accompanying error message will give more details about the failure.
InvalidArgument - If API is called on a cluster that is not managed by desired configuration management platform.
NotFound - If there is no cluster associated with cluster
ServiceUnavailable - If the service is not available.
TimedOut - If the API timed out before completion.
Unauthenticated - If the caller is not authenticated.

Specified by:

checkCompliance_Task in interface Configuration

Parameters:

cluster - Identifier of the cluster The parameter must be an identifier for the resource type: ClusterComputeResource.

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

invocationConfig - Configuration for the method invocation.

validate_Task

public java.lang.String validate_Task(java.lang.String cluster)

Description copied from interface: Configuration

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

Specified by:

validate_Task in interface Configuration

Returns:

identifier for the task created by this API invocation

validate_Task

public java.lang.String validate_Task(java.lang.String cluster,
                                      InvocationConfig invocationConfig)

Description copied from interface: Configuration

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:

validate_Task in interface Configuration

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

validate_Task

public void validate_Task(java.lang.String cluster,
                          AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: Configuration

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:

Specified by:

validate_Task in interface Configuration

Parameters:

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

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

validate_Task

public void validate_Task(java.lang.String cluster,
                          AsyncCallback<java.lang.String> asyncCallback,
                          InvocationConfig invocationConfig)

Description copied from interface: Configuration

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:

Specified by:

validate_Task in interface Configuration

Parameters:

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

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

invocationConfig - Configuration for the method invocation.

precheck_Task

public java.lang.String precheck_Task(java.lang.String cluster)

Description copied from interface: Configuration

This API will perform precheck of the desired cluster configuration on each of the hosts in the cluster. The API will check against the desired image schema whether the desired configuration has added any requirements for the host to be put in maintenance mode or to be rebooted. The API will also invoke plugins provided by the configuration owner to detect if the host needs to be put in maintenance mode or to be rebooted. If any host needs to be put in maintenance mode or rebooted, prechecks will be performed at the cluster and host level. The result will specify the validation errors if the desired configuration is not valid on the host. If valid, the result will specify host impact of the desired configuration, and list the configurations that will change on applying the desired configuration. If host impact is maintenance mode or reboot, precheck results will also be specified in the result. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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

Specified by:

precheck_Task in interface Configuration

Parameters:

cluster - The cluster on which to perform precheck. The parameter must be an identifier for the resource type: ClusterComputeResource.

Returns:

identifier for the task created by this API invocation

precheck_Task

public java.lang.String precheck_Task(java.lang.String cluster,
                                      InvocationConfig invocationConfig)

Description copied from interface: Configuration

This API will perform precheck of the desired cluster configuration on each of the hosts in the cluster. The API will check against the desired image schema whether the desired configuration has added any requirements for the host to be put in maintenance mode or to be rebooted. The API will also invoke plugins provided by the configuration owner to detect if the host needs to be put in maintenance mode or to be rebooted. If any host needs to be put in maintenance mode or rebooted, prechecks will be performed at the cluster and host level. The result will specify the validation errors if the desired configuration is not valid on the host. If valid, the result will specify host impact of the desired configuration, and list the configurations that will change on applying the desired configuration. If host impact is maintenance mode or reboot, precheck results will also be specified in the result. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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:

precheck_Task in interface Configuration

Parameters:

cluster - The cluster on which to perform precheck. The parameter must be an identifier for the resource type: ClusterComputeResource.

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

precheck_Task

public void precheck_Task(java.lang.String cluster,
                          AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: Configuration

This API will perform precheck of the desired cluster configuration on each of the hosts in the cluster. The API will check against the desired image schema whether the desired configuration has added any requirements for the host to be put in maintenance mode or to be rebooted. The API will also invoke plugins provided by the configuration owner to detect if the host needs to be put in maintenance mode or to be rebooted. If any host needs to be put in maintenance mode or rebooted, prechecks will be performed at the cluster and host level. The result will specify the validation errors if the desired configuration is not valid on the host. If valid, the result will specify host impact of the desired configuration, and list the configurations that will change on applying the desired configuration. If host impact is maintenance mode or reboot, precheck results will also be specified in the result. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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 API is called on a cluster that is not managed by desired configuration management platform.
NotFound - If the cluster is not found in the system.
ServiceUnavailable - If the service is not available.
TimedOut - If the API timed out before completion.
Unauthenticated - If the caller is not authenticated.

Specified by:

precheck_Task in interface Configuration

Parameters:

cluster - The cluster on which to perform precheck. The parameter must be an identifier for the resource type: ClusterComputeResource.

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

precheck_Task

public void precheck_Task(java.lang.String cluster,
                          AsyncCallback<java.lang.String> asyncCallback,
                          InvocationConfig invocationConfig)

Description copied from interface: Configuration

This API will perform precheck of the desired cluster configuration on each of the hosts in the cluster. The API will check against the desired image schema whether the desired configuration has added any requirements for the host to be put in maintenance mode or to be rebooted. The API will also invoke plugins provided by the configuration owner to detect if the host needs to be put in maintenance mode or to be rebooted. If any host needs to be put in maintenance mode or rebooted, prechecks will be performed at the cluster and host level. The result will specify the validation errors if the desired configuration is not valid on the host. If valid, the result will specify host impact of the desired configuration, and list the configurations that will change on applying the desired configuration. If host impact is maintenance mode or reboot, precheck results will also be specified in the result. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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 API is called on a cluster that is not managed by desired configuration management platform.
NotFound - If the cluster is not found in the system.
ServiceUnavailable - If the service is not available.
TimedOut - If the API timed out before completion.
Unauthenticated - If the caller is not authenticated.

Specified by:

precheck_Task in interface Configuration

Parameters:

cluster - The cluster on which to perform precheck. The parameter must be an identifier for the resource type: ClusterComputeResource.

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

invocationConfig - Configuration for the method invocation.

importConfig_Task

public java.lang.String importConfig_Task(java.lang.String cluster,
                                          ConfigurationTypes.ImportSpec spec)

Description copied from interface: Configuration

This API replaces the existing desired configuration of the cluster with the configuration provided in the input parameter document. The API will internally validate the input configuration against the configuration schema derived from the cluster software specification associated with the cluster. If the input configuration document passes validation, then it will be the desired configuration of the cluster. The result will specify whether the input document was import successfully. The result will also list the validation errors in case the import operation failed. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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

Specified by:

importConfig_Task in interface Configuration

Parameters:

cluster - The cluster on which this operation must be performed. The parameter must be an identifier for the resource type: ClusterComputeResource.

spec - An ImportSpec that contains the new desired configuration for the cluster.

Returns:

identifier for the task created by this API invocation

importConfig_Task

public java.lang.String importConfig_Task(java.lang.String cluster,
                                          ConfigurationTypes.ImportSpec spec,
                                          InvocationConfig invocationConfig)

Description copied from interface: Configuration

This API replaces the existing desired configuration of the cluster with the configuration provided in the input parameter document. The API will internally validate the input configuration against the configuration schema derived from the cluster software specification associated with the cluster. If the input configuration document passes validation, then it will be the desired configuration of the cluster. The result will specify whether the input document was import successfully. The result will also list the validation errors in case the import operation failed. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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:

importConfig_Task in interface Configuration

Parameters:

cluster - The cluster on which this operation must be performed. The parameter must be an identifier for the resource type: ClusterComputeResource.

spec - An ImportSpec that contains the new desired configuration for the cluster.

invocationConfig - Configuration for the method invocation.

Returns:

identifier for the task created by this API invocation

importConfig_Task

public void importConfig_Task(java.lang.String cluster,
                              ConfigurationTypes.ImportSpec spec,
                              AsyncCallback<java.lang.String> asyncCallback)

Description copied from interface: Configuration

This API replaces the existing desired configuration of the cluster with the configuration provided in the input parameter document. The API will internally validate the input configuration against the configuration schema derived from the cluster software specification associated with the cluster. If the input configuration document passes validation, then it will be the desired configuration of the cluster. The result will specify whether the input document was import successfully. The result will also list the validation errors in case the import operation failed. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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:
Error - If there is some other unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If the cluster is not found in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.

Specified by:

importConfig_Task in interface Configuration

Parameters:

cluster - The cluster on which this operation must be performed. The parameter must be an identifier for the resource type: ClusterComputeResource.

spec - An ImportSpec that contains the new desired configuration for the cluster.

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

importConfig_Task

public void importConfig_Task(java.lang.String cluster,
                              ConfigurationTypes.ImportSpec spec,
                              AsyncCallback<java.lang.String> asyncCallback,
                              InvocationConfig invocationConfig)

Description copied from interface: Configuration

This API replaces the existing desired configuration of the cluster with the configuration provided in the input parameter document. The API will internally validate the input configuration against the configuration schema derived from the cluster software specification associated with the cluster. If the input configuration document passes validation, then it will be the desired configuration of the cluster. The result will specify whether the input document was import successfully. The result will also list the validation errors in case the import operation failed. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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:
Error - If there is some other unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If the cluster is not found in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.

Specified by:

importConfig_Task in interface Configuration

Parameters:

cluster - The cluster on which this operation must be performed. The parameter must be an identifier for the resource type: ClusterComputeResource.

spec - An ImportSpec that contains the new desired configuration for the cluster.

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

invocationConfig - Configuration for the method invocation.

exportConfig

public ExportResult exportConfig(java.lang.String cluster)

Description copied from interface: Configuration

This API will export the configuration associated with the cluster. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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

Specified by:

exportConfig in interface Configuration

Parameters:

cluster - Identifier of the cluster on which operation should be performed. The parameter must be an identifier for the resource type: ClusterComputeResource.

Returns:

This output structure of type com.vmware.esx.settings.clusters.Configuration#ExportResult contains the configuration document encoded as JSON.

exportConfig

public ExportResult exportConfig(java.lang.String cluster,
                                 InvocationConfig invocationConfig)

Description copied from interface: Configuration

This API will export the configuration associated with the cluster. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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:

exportConfig in interface Configuration

Parameters:

cluster - Identifier of the cluster on which operation should be performed. The parameter must be an identifier for the resource type: ClusterComputeResource.

invocationConfig - Configuration for the method invocation.

Returns:

This output structure of type com.vmware.esx.settings.clusters.Configuration#ExportResult contains the configuration document encoded as JSON.

exportConfig

public void exportConfig(java.lang.String cluster,
                         AsyncCallback<ExportResult> asyncCallback)

Description copied from interface: Configuration

This API will export the configuration associated with the cluster. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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

Invocation Result:
This output structure of type com.vmware.esx.settings.clusters.Configuration#ExportResult contains the configuration document encoded as JSON.

Operation Errors:
Error - If there is some other unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If the cluster is not found in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.ClusterConfiguration.Export.
• The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.ClusterConfiguration.Export.

Specified by:

exportConfig in interface Configuration

Parameters:

cluster - Identifier of the cluster on which operation should be performed. The parameter must be an identifier for the resource type: ClusterComputeResource.

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

exportConfig

public void exportConfig(java.lang.String cluster,
                         AsyncCallback<ExportResult> asyncCallback,
                         InvocationConfig invocationConfig)

Description copied from interface: Configuration

This API will export the configuration associated with the cluster. Warning: This method is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

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:
This output structure of type com.vmware.esx.settings.clusters.Configuration#ExportResult contains the configuration document encoded as JSON.

Operation Errors:
Error - If there is some other unknown internal error. The accompanying error message will give more details about the failure.
NotFound - If the cluster is not found in the system.
ServiceUnavailable - If the service is not available.
Unauthenticated - If the caller is not authenticated.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires VcIntegrity.ClusterConfiguration.Export.
• The resource ClusterComputeResource referenced by the parameter cluster requires VcIntegrity.ClusterConfiguration.Export.

Specified by:

exportConfig in interface Configuration

Parameters:

cluster - Identifier of the cluster on which operation should be performed. The parameter must be an identifier for the resource type: ClusterComputeResource.

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

invocationConfig - Configuration for the method invocation.