com.vmware.vcenter.compute

Interface Policies

All Superinterfaces:

PoliciesTypes, Service

All Known Implementing Classes:

PoliciesStub

public interface Policies
extends Service, PoliciesTypes

The Policies interface provides methods to manage compute policies in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. A compute policy defines the intended behavior for a collection of vSphere objects identified by a tag. A compute policy is an instance of a capability. It is created by providing a value for the creation type specified by the capability. See CapabilitiesTypes.Info.getCreateSpecType(). Warning: This interface 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.

Nested Class Summary

Nested classes/interfaces inherited from interface com.vmware.vcenter.compute.PoliciesTypes

PoliciesTypes.Summary

Field Summary

Fields inherited from interface com.vmware.vcenter.compute.PoliciesTypes

_VAPI_SERVICE_ID, RESOURCE_TYPE

Method Summary

Modifier and Type	Method and Description
java.lang.String	create(Structure spec) Creates a new compute policy in VMware Cloud on AWS.
void	create(Structure spec, AsyncCallback<java.lang.String> asyncCallback) Creates a new compute policy in VMware Cloud on AWS.
void	create(Structure spec, AsyncCallback<java.lang.String> asyncCallback, InvocationConfig invocationConfig) Creates a new compute policy in VMware Cloud on AWS.
java.lang.String	create(Structure spec, InvocationConfig invocationConfig) Creates a new compute policy in VMware Cloud on AWS.
void	delete(java.lang.String policy) Deletes a specific compute policy in VMware Cloud on AWS.
void	delete(java.lang.String policy, AsyncCallback<java.lang.Void> asyncCallback) Deletes a specific compute policy in VMware Cloud on AWS.
void	delete(java.lang.String policy, AsyncCallback<java.lang.Void> asyncCallback, InvocationConfig invocationConfig) Deletes a specific compute policy in VMware Cloud on AWS.
void	delete(java.lang.String policy, InvocationConfig invocationConfig) Deletes a specific compute policy in VMware Cloud on AWS.
Structure	get(java.lang.String policy) Returns information about a specific compute policy in VMware Cloud on AWS.
void	get(java.lang.String policy, AsyncCallback<Structure> asyncCallback) Returns information about a specific compute policy in VMware Cloud on AWS.
void	get(java.lang.String policy, AsyncCallback<Structure> asyncCallback, InvocationConfig invocationConfig) Returns information about a specific compute policy in VMware Cloud on AWS.
Structure	get(java.lang.String policy, InvocationConfig invocationConfig) Returns information about a specific compute policy in VMware Cloud on AWS.
java.util.List<PoliciesTypes.Summary>	list() Returns information about the compute policies available in this vCenter server in VMware Cloud on AWS.
void	list(AsyncCallback<java.util.List<PoliciesTypes.Summary>> asyncCallback) Returns information about the compute policies available in this vCenter server in VMware Cloud on AWS.
void	list(AsyncCallback<java.util.List<PoliciesTypes.Summary>> asyncCallback, InvocationConfig invocationConfig) Returns information about the compute policies available in this vCenter server in VMware Cloud on AWS.
java.util.List<PoliciesTypes.Summary>	list(InvocationConfig invocationConfig) Returns information about the compute policies available in this vCenter server in VMware Cloud on AWS.

Method Detail

create

java.lang.String create(Structure spec)

Creates a new compute policy in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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.

Parameters:

spec - Specification for the new policy to be created. The new policy will be an instance of the capability that has the creation type (see CapabilitiesTypes.Info.getCreateSpecType()) equal to the type of the specified value (see spec). The parameter must contain all the properties defined in CreateSpec.

Returns:

The identifier of the newly created policy. Use this identifier to get or destroy the policy. The return value will be an identifier for the resource type: com.vmware.vcenter.compute.Policy.

Throws:

AlreadyExists - if a policy with the same name is already present on this vCenter server.

InvalidArgument - if a parameter passed in the spec is invalid.

UnableToAllocateResource - if more than 100 policies are created.

Unauthorized - if the user doesn't have the required privileges.

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

• Method execution requires ComputePolicy.Manage.

create

java.lang.String create(Structure spec,
                        InvocationConfig invocationConfig)

Creates a new compute policy in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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.

Parameters:

spec - Specification for the new policy to be created. The new policy will be an instance of the capability that has the creation type (see CapabilitiesTypes.Info.getCreateSpecType()) equal to the type of the specified value (see spec). The parameter must contain all the properties defined in CreateSpec.

invocationConfig - Configuration for the method invocation.

Returns:

The identifier of the newly created policy. Use this identifier to get or destroy the policy. The return value will be an identifier for the resource type: com.vmware.vcenter.compute.Policy.

Throws:

AlreadyExists - if a policy with the same name is already present on this vCenter server.

InvalidArgument - if a parameter passed in the spec is invalid.

UnableToAllocateResource - if more than 100 policies are created.

Unauthorized - if the user doesn't have the required privileges.

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

• Method execution requires ComputePolicy.Manage.

create

void create(Structure spec,
            AsyncCallback<java.lang.String> asyncCallback)

Creates a new compute policy in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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:
The identifier of the newly created policy. Use this identifier to get or destroy the policy. The return value will be an identifier for the resource type: com.vmware.vcenter.compute.Policy.

Operation Errors:
AlreadyExists - if a policy with the same name is already present on this vCenter server.
InvalidArgument - if a parameter passed in the spec is invalid.
UnableToAllocateResource - if more than 100 policies are created.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires ComputePolicy.Manage.

Parameters:

spec - Specification for the new policy to be created. The new policy will be an instance of the capability that has the creation type (see CapabilitiesTypes.Info.getCreateSpecType()) equal to the type of the specified value (see spec). The parameter must contain all the properties defined in CreateSpec.

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

create

void create(Structure spec,
            AsyncCallback<java.lang.String> asyncCallback,
            InvocationConfig invocationConfig)

Creates a new compute policy in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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:
The identifier of the newly created policy. Use this identifier to get or destroy the policy. The return value will be an identifier for the resource type: com.vmware.vcenter.compute.Policy.

Operation Errors:
AlreadyExists - if a policy with the same name is already present on this vCenter server.
InvalidArgument - if a parameter passed in the spec is invalid.
UnableToAllocateResource - if more than 100 policies are created.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires ComputePolicy.Manage.

Parameters:

spec - Specification for the new policy to be created. The new policy will be an instance of the capability that has the creation type (see CapabilitiesTypes.Info.getCreateSpecType()) equal to the type of the specified value (see spec). The parameter must contain all the properties defined in CreateSpec.

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

invocationConfig - Configuration for the method invocation.

list

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

Returns information about the compute policies available in this vCenter server in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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.

Returns:

The list of compute policies available on this vCenter server.

Throws:

Unauthorized - if the user doesn't have the required privileges.

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

• Method execution requires System.Read.

list

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

Returns information about the compute policies available in this vCenter server in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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.

Parameters:

invocationConfig - Configuration for the method invocation.

Returns:

The list of compute policies available on this vCenter server.

Throws:

Unauthorized - if the user doesn't have the required privileges.

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

• Method execution requires System.Read.

list

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

Returns information about the compute policies available in this vCenter server in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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:
The list of compute policies available on this vCenter server.

Operation Errors:
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires System.Read.

Parameters:

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

list

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

Returns information about the compute policies available in this vCenter server in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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:
The list of compute policies available on this vCenter server.

Operation Errors:
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires System.Read.

Parameters:

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

invocationConfig - Configuration for the method invocation.

get

Structure get(java.lang.String policy)

Returns information about a specific compute policy in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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.

Parameters:

policy - Identifier of the policy for which information should be retrieved. The parameter must be an identifier for the resource type: com.vmware.vcenter.compute.Policy.

Returns:

Detailed information about the specified compute policy. The returned value can be converted to the information type of the capability that this policy is based on. See CapabilitiesTypes.Info.getInfoType(). The return value will contain all the properties defined in Info.

Throws:

NotFound - if a policy with this identifier does not exist.

Unauthorized - if the user doesn't have the required privileges.

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

• Method execution requires System.Read.

get

Structure get(java.lang.String policy,
              InvocationConfig invocationConfig)

Returns information about a specific compute policy in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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.

Parameters:

policy - Identifier of the policy for which information should be retrieved. The parameter must be an identifier for the resource type: com.vmware.vcenter.compute.Policy.

invocationConfig - Configuration for the method invocation.

Returns:

Detailed information about the specified compute policy. The returned value can be converted to the information type of the capability that this policy is based on. See CapabilitiesTypes.Info.getInfoType(). The return value will contain all the properties defined in Info.

Throws:

NotFound - if a policy with this identifier does not exist.

Unauthorized - if the user doesn't have the required privileges.

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

• Method execution requires System.Read.

get

void get(java.lang.String policy,
         AsyncCallback<Structure> asyncCallback)

Returns information about a specific compute policy in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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:
Detailed information about the specified compute policy. The returned value can be converted to the information type of the capability that this policy is based on. See CapabilitiesTypes.Info.getInfoType(). The return value will contain all the properties defined in Info.

Operation Errors:
NotFound - if a policy with this identifier does not exist.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires System.Read.

Parameters:

policy - Identifier of the policy for which information should be retrieved. The parameter must be an identifier for the resource type: com.vmware.vcenter.compute.Policy.

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

get

void get(java.lang.String policy,
         AsyncCallback<Structure> asyncCallback,
         InvocationConfig invocationConfig)

Returns information about a specific compute policy in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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:
Detailed information about the specified compute policy. The returned value can be converted to the information type of the capability that this policy is based on. See CapabilitiesTypes.Info.getInfoType(). The return value will contain all the properties defined in Info.

Operation Errors:
NotFound - if a policy with this identifier does not exist.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires System.Read.

Parameters:

policy - Identifier of the policy for which information should be retrieved. The parameter must be an identifier for the resource type: com.vmware.vcenter.compute.Policy.

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

invocationConfig - Configuration for the method invocation.

delete

void delete(java.lang.String policy)

Deletes a specific compute policy in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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.

Parameters:

policy - Identifier of the policy to be deleted. The parameter must be an identifier for the resource type: com.vmware.vcenter.compute.Policy.

Throws:

NotFound - if a policy with this identifier does not exist.

Unauthorized - if the user doesn't have the required privileges.

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

• Method execution requires ComputePolicy.Manage.

delete

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

Deletes a specific compute policy in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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.

Parameters:

policy - Identifier of the policy to be deleted. The parameter must be an identifier for the resource type: com.vmware.vcenter.compute.Policy.

invocationConfig - Configuration for the method invocation.

Throws:

NotFound - if a policy with this identifier does not exist.

Unauthorized - if the user doesn't have the required privileges.

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

• Method execution requires ComputePolicy.Manage.

delete

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

Deletes a specific compute policy in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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:
NotFound - if a policy with this identifier does not exist.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires ComputePolicy.Manage.

Parameters:

policy - Identifier of the policy to be deleted. The parameter must be an identifier for the resource type: com.vmware.vcenter.compute.Policy.

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

delete

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

Deletes a specific compute policy in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. 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:
NotFound - if a policy with this identifier does not exist.
Unauthorized - if the user doesn't have the required privileges.
Unauthorized - if you do not have all of the privileges described as follows:

• Method execution requires ComputePolicy.Manage.

Parameters:

policy - Identifier of the policy to be deleted. The parameter must be an identifier for the resource type: com.vmware.vcenter.compute.Policy.

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

invocationConfig - Configuration for the method invocation.