com.vmware.vcenter.namespaces

Interface Instances

All Superinterfaces:

InstancesTypes, Service

All Known Implementing Classes:

InstancesStub

public interface Instances
extends Service, InstancesTypes

The Instances interface provides methods to create and delete a namespace object. In this version, an Instance is an abstraction around a Kubernetes namespace.

Nested Class Summary

Nested classes/interfaces inherited from interface com.vmware.vcenter.namespaces.InstancesTypes

InstancesTypes.Access, InstancesTypes.ConfigStatus, InstancesTypes.CreateSpec, InstancesTypes.CreateSpecV2, InstancesTypes.Info, InstancesTypes.InfoV2, InstancesTypes.Ipv4Cidr, InstancesTypes.LoadBalancerSize, InstancesTypes.Message, InstancesTypes.NetworkCreateSpec, InstancesTypes.NetworkProvider, InstancesTypes.NsxNetworkCreateSpec, InstancesTypes.Principal, InstancesTypes.SetSpec, InstancesTypes.Stats, InstancesTypes.StorageSpec, InstancesTypes.Summary, InstancesTypes.SummaryV2, InstancesTypes.UpdateSpec, InstancesTypes.VMServiceSpec

Field Summary

Fields inherited from interface com.vmware.vcenter.namespaces.InstancesTypes

_VAPI_SERVICE_ID, RESOURCE_TYPE

Method Summary

Modifier and Type	Method and Description
void	create(InstancesTypes.CreateSpec spec) Create a namespace object on a single vSphere cluster.
void	create(InstancesTypes.CreateSpec spec, AsyncCallback<java.lang.Void> asyncCallback) Create a namespace object on a single vSphere cluster.
void	create(InstancesTypes.CreateSpec spec, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Create a namespace object on a single vSphere cluster.
void	create(InstancesTypes.CreateSpec spec, InvocationConfig invocationConfig) Create a namespace object on a single vSphere cluster.
void	createV2(InstancesTypes.CreateSpecV2 spec) Create a namespace object on a Supervisor.
void	createV2(InstancesTypes.CreateSpecV2 spec, AsyncCallback<java.lang.Void> asyncCallback) Create a namespace object on a Supervisor.
void	createV2(InstancesTypes.CreateSpecV2 spec, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Create a namespace object on a Supervisor.
void	createV2(InstancesTypes.CreateSpecV2 spec, InvocationConfig invocationConfig) Create a namespace object on a Supervisor.
void	delete(java.lang.String namespace) Delete the namespace object in the cluster.
void	delete(java.lang.String namespace, AsyncCallback<java.lang.Void> asyncCallback) Delete the namespace object in the cluster.
void	delete(java.lang.String namespace, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Delete the namespace object in the cluster.
void	delete(java.lang.String namespace, InvocationConfig invocationConfig) Delete the namespace object in the cluster.
InstancesTypes.Info	get(java.lang.String namespace) Returns information about a specific namespace on a single vSphere cluster.
void	get(java.lang.String namespace, AsyncCallback<InstancesTypes.Info> asyncCallback) Returns information about a specific namespace on a single vSphere cluster.
void	get(java.lang.String namespace, AsyncCallback<InstancesTypes.Info> asyncCallback, InvocationConfig invocationConfig) Returns information about a specific namespace on a single vSphere cluster.
InstancesTypes.Info	get(java.lang.String namespace, InvocationConfig invocationConfig) Returns information about a specific namespace on a single vSphere cluster.
InstancesTypes.InfoV2	getV2(java.lang.String namespace) Returns information about a specific namespace on a Supervisor.
void	getV2(java.lang.String namespace, AsyncCallback<InstancesTypes.InfoV2> asyncCallback) Returns information about a specific namespace on a Supervisor.
void	getV2(java.lang.String namespace, AsyncCallback<InstancesTypes.InfoV2> asyncCallback, InvocationConfig invocationConfig) Returns information about a specific namespace on a Supervisor.
InstancesTypes.InfoV2	getV2(java.lang.String namespace, InvocationConfig invocationConfig) Returns information about a specific namespace on a Supervisor.
java.util.List<InstancesTypes.Summary>	list() Returns the information about all namespaces in this vCenter Server.
void	list(AsyncCallback<java.util.List<InstancesTypes.Summary>> asyncCallback) Returns the information about all namespaces in this vCenter Server.
void	list(AsyncCallback<java.util.List<InstancesTypes.Summary>> asyncCallback, InvocationConfig invocationConfig) Returns the information about all namespaces in this vCenter Server.
java.util.List<InstancesTypes.Summary>	list(InvocationConfig invocationConfig) Returns the information about all namespaces in this vCenter Server.
java.util.List<InstancesTypes.SummaryV2>	listV2() Returns the information about all namespaces in this vCenter Server.
void	listV2(AsyncCallback<java.util.List<InstancesTypes.SummaryV2>> asyncCallback) Returns the information about all namespaces in this vCenter Server.
void	listV2(AsyncCallback<java.util.List<InstancesTypes.SummaryV2>> asyncCallback, InvocationConfig invocationConfig) Returns the information about all namespaces in this vCenter Server.
java.util.List<InstancesTypes.SummaryV2>	listV2(InvocationConfig invocationConfig) Returns the information about all namespaces in this vCenter Server.
void	set(java.lang.String namespace, InstancesTypes.SetSpec spec) Set a new configuration on the namespace object.
void	set(java.lang.String namespace, InstancesTypes.SetSpec spec, AsyncCallback<java.lang.Void> asyncCallback) Set a new configuration on the namespace object.
void	set(java.lang.String namespace, InstancesTypes.SetSpec spec, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Set a new configuration on the namespace object.
void	set(java.lang.String namespace, InstancesTypes.SetSpec spec, InvocationConfig invocationConfig) Set a new configuration on the namespace object.
void	update(java.lang.String namespace, InstancesTypes.UpdateSpec spec) Update the namespace object.
void	update(java.lang.String namespace, InstancesTypes.UpdateSpec spec, AsyncCallback<java.lang.Void> asyncCallback) Update the namespace object.
void	update(java.lang.String namespace, InstancesTypes.UpdateSpec spec, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Update the namespace object.
void	update(java.lang.String namespace, InstancesTypes.UpdateSpec spec, InvocationConfig invocationConfig) Update the namespace object.

Method Detail

create

void create(InstancesTypes.CreateSpec spec)

Create a namespace object on a single vSphere cluster.

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

Parameters:

spec - The specification for setting up the namespace.

Throws:

AlreadyExists - if a namespace with the same name exists in vCenter server.

Error - if the system reports an error while responding to the request.

InvalidArgument - if spec contains any errors or if an invalid name is specified.

NotAllowedInCurrentState - if the associated Supervisor cluster is being disabled or if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace creation is not allowed.

NotFound - if InstancesTypes.CreateSpec.getCluster() is not registered on this vCenter server.

Unsupported - ifInstancesTypes.CreateSpec.getCluster() is not enabled for Namespaces, or if the networks field is set when the InstancesTypes.CreateSpec.getCluster() hosting the namespace uses NSXT_CONTAINER_PLUGIN as its network provider, or if the Supervisor cluster does not support customizable VM classes.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

create

void create(InstancesTypes.CreateSpec spec,
            InvocationConfig invocationConfig)

Create a namespace object on a single vSphere cluster.

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 - The specification for setting up the namespace.

invocationConfig - Configuration for the method invocation.

Throws:

AlreadyExists - if a namespace with the same name exists in vCenter server.

Error - if the system reports an error while responding to the request.

InvalidArgument - if spec contains any errors or if an invalid name is specified.

NotAllowedInCurrentState - if the associated Supervisor cluster is being disabled or if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace creation is not allowed.

NotFound - if InstancesTypes.CreateSpec.getCluster() is not registered on this vCenter server.

Unsupported - ifInstancesTypes.CreateSpec.getCluster() is not enabled for Namespaces, or if the networks field is set when the InstancesTypes.CreateSpec.getCluster() hosting the namespace uses NSXT_CONTAINER_PLUGIN as its network provider, or if the Supervisor cluster does not support customizable VM classes.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

create

void create(InstancesTypes.CreateSpec spec,
            AsyncCallback<java.lang.Void> asyncCallback)

Create a namespace object on a single vSphere cluster.

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

Operation Errors:
AlreadyExists - if a namespace with the same name exists in vCenter server.
Error - if the system reports an error while responding to the request.
InvalidArgument - if spec contains any errors or if an invalid name is specified.
NotAllowedInCurrentState - if the associated Supervisor cluster is being disabled or if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace creation is not allowed.
NotFound - if InstancesTypes.CreateSpec.getCluster() is not registered on this vCenter server.
Unsupported - ifInstancesTypes.CreateSpec.getCluster() is not enabled for Namespaces, or if the networks field is set when the InstancesTypes.CreateSpec.getCluster() hosting the namespace uses NSXT_CONTAINER_PLUGIN as its network provider, or if the Supervisor cluster does not support customizable VM classes.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

Parameters:

spec - The specification for setting up the namespace.

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

create

void create(InstancesTypes.CreateSpec spec,
            AsyncCallback<java.lang.Void> asyncCallback,
            InvocationConfig invocationConfig)

Create a namespace object on a single vSphere cluster.

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:
AlreadyExists - if a namespace with the same name exists in vCenter server.
Error - if the system reports an error while responding to the request.
InvalidArgument - if spec contains any errors or if an invalid name is specified.
NotAllowedInCurrentState - if the associated Supervisor cluster is being disabled or if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace creation is not allowed.
NotFound - if InstancesTypes.CreateSpec.getCluster() is not registered on this vCenter server.
Unsupported - ifInstancesTypes.CreateSpec.getCluster() is not enabled for Namespaces, or if the networks field is set when the InstancesTypes.CreateSpec.getCluster() hosting the namespace uses NSXT_CONTAINER_PLUGIN as its network provider, or if the Supervisor cluster does not support customizable VM classes.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

Parameters:

spec - The specification for setting up the namespace.

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

invocationConfig - Configuration for the method invocation.

createV2

void createV2(InstancesTypes.CreateSpecV2 spec)

Create a namespace object on a Supervisor. 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:

spec - The specification for setting up the namespace.

Throws:

AlreadyExists - if a namespace with the same name exists in vCenter server.

Error - if the system reports an error while responding to the request.

InvalidArgument - if spec contains any errors or if an invalid name is specified.

NotAllowedInCurrentState - if the associated Supervisor is being disabled or if the associated Supervisor is being restored from a backup. When a Supervisor is restored, there's a window of time during which the restored Supervisor's state is being synchronized back to vCenter. During that time, namespace creation is not allowed.

NotFound - if the Supervisor is not registered on this vCenter server.

Unsupported - if the Supervisor is not enabled for Namespaces, or if the networks field is set when the Supervisor hosting the namespace uses NSXT_CONTAINER_PLUGIN as its network provider, or if the Supervisor does not support customizable VM classes.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

createV2

void createV2(InstancesTypes.CreateSpecV2 spec,
              InvocationConfig invocationConfig)

Create a namespace object on a Supervisor. 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:

spec - The specification for setting up the namespace.

invocationConfig - Configuration for the method invocation.

Throws:

AlreadyExists - if a namespace with the same name exists in vCenter server.

Error - if the system reports an error while responding to the request.

InvalidArgument - if spec contains any errors or if an invalid name is specified.

NotAllowedInCurrentState - if the associated Supervisor is being disabled or if the associated Supervisor is being restored from a backup. When a Supervisor is restored, there's a window of time during which the restored Supervisor's state is being synchronized back to vCenter. During that time, namespace creation is not allowed.

NotFound - if the Supervisor is not registered on this vCenter server.

Unsupported - if the Supervisor is not enabled for Namespaces, or if the networks field is set when the Supervisor hosting the namespace uses NSXT_CONTAINER_PLUGIN as its network provider, or if the Supervisor does not support customizable VM classes.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

createV2

void createV2(InstancesTypes.CreateSpecV2 spec,
              AsyncCallback<java.lang.Void> asyncCallback)

Create a namespace object on a Supervisor. 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.

Operation Errors:
AlreadyExists - if a namespace with the same name exists in vCenter server.
Error - if the system reports an error while responding to the request.
InvalidArgument - if spec contains any errors or if an invalid name is specified.
NotAllowedInCurrentState - if the associated Supervisor is being disabled or if the associated Supervisor is being restored from a backup. When a Supervisor is restored, there's a window of time during which the restored Supervisor's state is being synchronized back to vCenter. During that time, namespace creation is not allowed.
NotFound - if the Supervisor is not registered on this vCenter server.
Unsupported - if the Supervisor is not enabled for Namespaces, or if the networks field is set when the Supervisor hosting the namespace uses NSXT_CONTAINER_PLUGIN as its network provider, or if the Supervisor does not support customizable VM classes.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

Parameters:

spec - The specification for setting up the namespace.

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

createV2

void createV2(InstancesTypes.CreateSpecV2 spec,
              AsyncCallback<java.lang.Void> asyncCallback,
              InvocationConfig invocationConfig)

Create a namespace object on a Supervisor. 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.

Operation Errors:
AlreadyExists - if a namespace with the same name exists in vCenter server.
Error - if the system reports an error while responding to the request.
InvalidArgument - if spec contains any errors or if an invalid name is specified.
NotAllowedInCurrentState - if the associated Supervisor is being disabled or if the associated Supervisor is being restored from a backup. When a Supervisor is restored, there's a window of time during which the restored Supervisor's state is being synchronized back to vCenter. During that time, namespace creation is not allowed.
NotFound - if the Supervisor is not registered on this vCenter server.
Unsupported - if the Supervisor is not enabled for Namespaces, or if the networks field is set when the Supervisor hosting the namespace uses NSXT_CONTAINER_PLUGIN as its network provider, or if the Supervisor does not support customizable VM classes.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

Parameters:

spec - The specification for setting up the namespace.

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

invocationConfig - Configuration for the method invocation.

delete

void delete(java.lang.String namespace)

Delete the namespace object in the cluster.

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

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

Throws:

Error - if the system reports an error while responding to the request.

NotAllowedInCurrentState - if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace deletion is not allowed.

NotFound - if the specified namespace could not be located.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

delete

void delete(java.lang.String namespace,
            InvocationConfig invocationConfig)

Delete the namespace object in the cluster.

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:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

invocationConfig - Configuration for the method invocation.

Throws:

Error - if the system reports an error while responding to the request.

NotAllowedInCurrentState - if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace deletion is not allowed.

NotFound - if the specified namespace could not be located.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

delete

void delete(java.lang.String namespace,
            AsyncCallback<java.lang.Void> asyncCallback)

Delete the namespace object in the cluster.

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

Operation Errors:
Error - if the system reports an error while responding to the request.
NotAllowedInCurrentState - if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace deletion is not allowed.
NotFound - if the specified namespace could not be located.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

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

delete

void delete(java.lang.String namespace,
            AsyncCallback<java.lang.Void> asyncCallback,
            InvocationConfig invocationConfig)

Delete the namespace object in the cluster.

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 the system reports an error while responding to the request.
NotAllowedInCurrentState - if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace deletion is not allowed.
NotFound - if the specified namespace could not be located.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

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

invocationConfig - Configuration for the method invocation.

get

InstancesTypes.Info get(java.lang.String namespace)

Returns information about a specific namespace on a single vSphere cluster.

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

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

Returns:

Information about the desired state of the specified namespace.

Throws:

NotFound - if namespace could not be located.

Error - if the system reports an error while responding to the request.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have System.Read privilege.

get

InstancesTypes.Info get(java.lang.String namespace,
                        InvocationConfig invocationConfig)

Returns information about a specific namespace on a single vSphere cluster.

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:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

invocationConfig - Configuration for the method invocation.

Returns:

Information about the desired state of the specified namespace.

Throws:

NotFound - if namespace could not be located.

Error - if the system reports an error while responding to the request.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have System.Read privilege.

get

void get(java.lang.String namespace,
         AsyncCallback<InstancesTypes.Info> asyncCallback)

Returns information about a specific namespace on a single vSphere cluster.

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

Invocation Result:
Information about the desired state of the specified namespace.

Operation Errors:
NotFound - if namespace could not be located.
Error - if the system reports an error while responding to the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have System.Read privilege.

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

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

get

void get(java.lang.String namespace,
         AsyncCallback<InstancesTypes.Info> asyncCallback,
         InvocationConfig invocationConfig)

Returns information about a specific namespace on a single vSphere cluster.

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 desired state of the specified namespace.

Operation Errors:
NotFound - if namespace could not be located.
Error - if the system reports an error while responding to the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have System.Read privilege.

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

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

invocationConfig - Configuration for the method invocation.

getV2

InstancesTypes.InfoV2 getV2(java.lang.String namespace)

Returns information about a specific namespace on a Supervisor. 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:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

Returns:

Information about the desired state of the specified namespace on a Supervisor.

Throws:

NotFound - if namespace could not be located.

Error - if the system reports an error while responding to the request.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have System.Read privilege.

getV2

InstancesTypes.InfoV2 getV2(java.lang.String namespace,
                            InvocationConfig invocationConfig)

Returns information about a specific namespace on a Supervisor. 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:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

invocationConfig - Configuration for the method invocation.

Returns:

Information about the desired state of the specified namespace on a Supervisor.

Throws:

NotFound - if namespace could not be located.

Error - if the system reports an error while responding to the request.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have System.Read privilege.

getV2

void getV2(java.lang.String namespace,
           AsyncCallback<InstancesTypes.InfoV2> asyncCallback)

Returns information about a specific namespace on a Supervisor. 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 desired state of the specified namespace on a Supervisor.

Operation Errors:
NotFound - if namespace could not be located.
Error - if the system reports an error while responding to the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have System.Read privilege.

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

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

getV2

void getV2(java.lang.String namespace,
           AsyncCallback<InstancesTypes.InfoV2> asyncCallback,
           InvocationConfig invocationConfig)

Returns information about a specific namespace on a Supervisor. 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 desired state of the specified namespace on a Supervisor.

Operation Errors:
NotFound - if namespace could not be located.
Error - if the system reports an error while responding to the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have System.Read privilege.

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

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

invocationConfig - Configuration for the method invocation.

list

java.util.List<InstancesTypes.Summary> list()

Returns the information about all namespaces in this vCenter Server. The information is tied to a single vSphere cluster.

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

Returns:

Information about all namespaces in this vCenter server.

Throws:

Error - if the system reports an error while responding to the request.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have System.Read privilege.

list

java.util.List<InstancesTypes.Summary> list(InvocationConfig invocationConfig)

Returns the information about all namespaces in this vCenter Server. The information is tied to a single vSphere cluster.

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:

invocationConfig - Configuration for the method invocation.

Returns:

Information about all namespaces in this vCenter server.

Throws:

Error - if the system reports an error while responding to the request.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have System.Read privilege.

list

void list(AsyncCallback<java.util.List<InstancesTypes.Summary>> asyncCallback)

Returns the information about all namespaces in this vCenter Server. The information is tied to a single vSphere cluster.

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

Invocation Result:
Information about all namespaces in this vCenter server.

Operation Errors:
Error - if the system reports an error while responding to the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have System.Read privilege.

Parameters:

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

list

void list(AsyncCallback<java.util.List<InstancesTypes.Summary>> asyncCallback,
          InvocationConfig invocationConfig)

Returns the information about all namespaces in this vCenter Server. The information is tied to a single vSphere cluster.

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 all namespaces in this vCenter server.

Operation Errors:
Error - if the system reports an error while responding to the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have System.Read privilege.

Parameters:

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

invocationConfig - Configuration for the method invocation.

listV2

java.util.List<InstancesTypes.SummaryV2> listV2()

Returns the information about all namespaces in this vCenter Server. The information is tied to a Supervisor. 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.

Returns:

Information about all namespaces in this vCenter server.

Throws:

Error - if the system reports an error while responding to the request.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have System.Read privilege.

listV2

java.util.List<InstancesTypes.SummaryV2> listV2(InvocationConfig invocationConfig)

Returns the information about all namespaces in this vCenter Server. The information is tied to a Supervisor. 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:

invocationConfig - Configuration for the method invocation.

Returns:

Information about all namespaces in this vCenter server.

Throws:

Error - if the system reports an error while responding to the request.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have System.Read privilege.

listV2

void listV2(AsyncCallback<java.util.List<InstancesTypes.SummaryV2>> asyncCallback)

Returns the information about all namespaces in this vCenter Server. The information is tied to a Supervisor. 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 all namespaces in this vCenter server.

Operation Errors:
Error - if the system reports an error while responding to the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have System.Read privilege.

Parameters:

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

listV2

void listV2(AsyncCallback<java.util.List<InstancesTypes.SummaryV2>> asyncCallback,
            InvocationConfig invocationConfig)

Returns the information about all namespaces in this vCenter Server. The information is tied to a Supervisor. 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 all namespaces in this vCenter server.

Operation Errors:
Error - if the system reports an error while responding to the request.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have System.Read privilege.

Parameters:

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

invocationConfig - Configuration for the method invocation.

set

void set(java.lang.String namespace,
         InstancesTypes.SetSpec spec)

Set a new configuration on the namespace object. The specified configuration is applied in entirety and will replace the current configuration fully.

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

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

spec - New specification for the namespace.

Throws:

Error - if the system reports an error while responding to the request.

InvalidArgument - if spec contain any errors.

NotAllowedInCurrentState - if the namespace is marked for deletion or if the associated Supervisor cluster is being disabled or if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace configuration modifications are not allowed.

NotFound - if namespace with the name namespace could not be located.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

Unsupported - if customizable VM classes are not suported for this Supervisor cluster.

set

void set(java.lang.String namespace,
         InstancesTypes.SetSpec spec,
         InvocationConfig invocationConfig)

Set a new configuration on the namespace object. The specified configuration is applied in entirety and will replace the current configuration fully.

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:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

spec - New specification for the namespace.

invocationConfig - Configuration for the method invocation.

Throws:

Error - if the system reports an error while responding to the request.

InvalidArgument - if spec contain any errors.

NotAllowedInCurrentState - if the namespace is marked for deletion or if the associated Supervisor cluster is being disabled or if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace configuration modifications are not allowed.

NotFound - if namespace with the name namespace could not be located.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

Unsupported - if customizable VM classes are not suported for this Supervisor cluster.

set

void set(java.lang.String namespace,
         InstancesTypes.SetSpec spec,
         AsyncCallback<java.lang.Void> asyncCallback)

Set a new configuration on the namespace object. The specified configuration is applied in entirety and will replace the current configuration fully.

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

Operation Errors:
Error - if the system reports an error while responding to the request.
InvalidArgument - if spec contain any errors.
NotAllowedInCurrentState - if the namespace is marked for deletion or if the associated Supervisor cluster is being disabled or if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace configuration modifications are not allowed.
NotFound - if namespace with the name namespace could not be located.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.
Unsupported - if customizable VM classes are not suported for this Supervisor cluster.

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

spec - New specification for the namespace.

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

set

void set(java.lang.String namespace,
         InstancesTypes.SetSpec spec,
         AsyncCallback<java.lang.Void> asyncCallback,
         InvocationConfig invocationConfig)

Set a new configuration on the namespace object. The specified configuration is applied in entirety and will replace the current configuration fully.

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 the system reports an error while responding to the request.
InvalidArgument - if spec contain any errors.
NotAllowedInCurrentState - if the namespace is marked for deletion or if the associated Supervisor cluster is being disabled or if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace configuration modifications are not allowed.
NotFound - if namespace with the name namespace could not be located.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.
Unsupported - if customizable VM classes are not suported for this Supervisor cluster.

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

spec - New specification for the namespace.

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

invocationConfig - Configuration for the method invocation.

update

void update(java.lang.String namespace,
            InstancesTypes.UpdateSpec spec)

Update the namespace object. The specified configuration is applied partially and null fields in spec will leave those parts of configuration as-is.

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

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

spec - Specification for updating the namespace.

Throws:

Error - if the system reports an error while responding to the request.

InvalidArgument - if spec contain any errors.

NotAllowedInCurrentState - if the namespace is marked for deletion or if the associated Supervisor cluster is being disabled or if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace configuration modifications are not allowed.

NotFound - if namespace with the name namespace could not be located.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

Unsupported - if customizable VM classes are not suported for this Supervisor cluster.

update

void update(java.lang.String namespace,
            InstancesTypes.UpdateSpec spec,
            InvocationConfig invocationConfig)

Update the namespace object. The specified configuration is applied partially and null fields in spec will leave those parts of configuration as-is.

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:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

spec - Specification for updating the namespace.

invocationConfig - Configuration for the method invocation.

Throws:

Error - if the system reports an error while responding to the request.

InvalidArgument - if spec contain any errors.

NotAllowedInCurrentState - if the namespace is marked for deletion or if the associated Supervisor cluster is being disabled or if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace configuration modifications are not allowed.

NotFound - if namespace with the name namespace could not be located.

Unauthenticated - if the user can not be authenticated.

Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.

Unsupported - if customizable VM classes are not suported for this Supervisor cluster.

update

void update(java.lang.String namespace,
            InstancesTypes.UpdateSpec spec,
            AsyncCallback<java.lang.Void> asyncCallback)

Update the namespace object. The specified configuration is applied partially and null fields in spec will leave those parts of configuration as-is.

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

Operation Errors:
Error - if the system reports an error while responding to the request.
InvalidArgument - if spec contain any errors.
NotAllowedInCurrentState - if the namespace is marked for deletion or if the associated Supervisor cluster is being disabled or if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace configuration modifications are not allowed.
NotFound - if namespace with the name namespace could not be located.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.
Unsupported - if customizable VM classes are not suported for this Supervisor cluster.

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

spec - Specification for updating the namespace.

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

update

void update(java.lang.String namespace,
            InstancesTypes.UpdateSpec spec,
            AsyncCallback<java.lang.Void> asyncCallback,
            InvocationConfig invocationConfig)

Update the namespace object. The specified configuration is applied partially and null fields in spec will leave those parts of configuration as-is.

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 the system reports an error while responding to the request.
InvalidArgument - if spec contain any errors.
NotAllowedInCurrentState - if the namespace is marked for deletion or if the associated Supervisor cluster is being disabled or if the associated Supervisor cluster is being restored from a backup. When a Supervisor cluster is restored, there's a window of time during which the restored Supervisor cluster's state is being synchronized back to vCenter. During that time, namespace configuration modifications are not allowed.
NotFound - if namespace with the name namespace could not be located.
Unauthenticated - if the user can not be authenticated.
Unauthorized - if the user does not have Namespaces.Configure privilege or the namespace identifier begins with "vmware-system" prefix.
Unsupported - if customizable VM classes are not suported for this Supervisor cluster.

Parameters:

namespace - Identifier for the namespace. The parameter must be an identifier for the resource type: com.vmware.vcenter.namespaces.Instance.

spec - Specification for updating the namespace.

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

invocationConfig - Configuration for the method invocation.