Service - GlobalApplicationEntitlement

Class: VMware.Hv.GlobalApplicationEntitlement
See also: ApplicationId, GlobalApplicationEntitlementBase, GlobalApplicationEntitlementId, GlobalApplicationEntitlementInfo, MapEntry
Since: Horizon View 6.2

Service Description

The Global Application Entitlement service interface.

Methods

Methods defined in this Service
GlobalApplicationEntitlement_AddApplicationsToGAE, GlobalApplicationEntitlement_Create, GlobalApplicationEntitlement_Delete, GlobalApplicationEntitlement_Get, GlobalApplicationEntitlement_Update, GlobalEntitlement_ListCompatibleBackupGAEs

GlobalApplicationEntitlement_AddApplicationsToGAE

Add list of applications to the Global Application Entitlement.

Privileges

Privilege	Description
POOL_MANAGEMENT	privilege is required to update an Application.
FEDERATED_LDAP_MANAGE	Global LDAP management is required to update the ApplicationInfo#data.globalApplicationEntitlement members of an application.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the GlobalApplicationEntitlement used to make the method call.
id	GlobalApplicationEntitlementId	unique identifier for Global Application Entitlement
applications	ApplicationId[]	Applications to be added to the Global Application Entitlement

Return Value

Type	Description
None

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidType	Thrown if the type of any specified argument is invalid.
PartialFailureFault	Thrown if all operations were not successful, a PartialFailureFault will be thrown indicating which applications were successfully added and which ones failed. The index of results in the PartialFailureFault corresponds to the application's index in request. The result entry will contain either the original return type (on success) or an exception (on failure).
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Events

Event	Description
VLSI_APPLICATION_UPDATED	for each Application attribute that was updated
VLSI_APPLICATION_UPDATE_FAILED	if the Application update failed.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="GlobalApplicationEntitlement_AddApplicationsToGAE" type="vdi:GlobalApplicationEntitlement_AddApplicationsToGAERequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="GlobalApplicationEntitlement_AddApplicationsToGAEResponse">
            <complexType/>
         </element>

GlobalApplicationEntitlement_Create

Creates a Global Application Entitlement. Global application entitlements are used to route users to their resources across multiple pods. These are persisted in a global ldap instance that is replicated across all pods in a linked mode view set.

Privileges

Privilege	Description
FEDERATED_LDAP_MANAGE	Global LDAP management is required to create a global application entitlement.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the GlobalApplicationEntitlement used to make the method call.
base	GlobalApplicationEntitlementBase	attributes required to create a Global Application Entitlement

Return Value

Type	Description
GlobalApplicationEntitlementId	unique identifier for Global Application Entitlement

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidState	Thrown if this pod is not part of a Pod Federation
InvalidType	Thrown if the type of any specified argument is invalid.
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Events

Event	Description
VLSI_GAE_ADDED	If the global application entitlement was successfully created.
VLSI_GAE_ADD_FAILED	If the global application entitlement could not be created.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="GlobalApplicationEntitlement_Create" type="vdi:GlobalApplicationEntitlement_CreateRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="GlobalApplicationEntitlement_CreateResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:GlobalApplicationEntitlementId"/>
               </sequence>
            </complexType>
         </element>

GlobalApplicationEntitlement_Delete

Deletes a Global Application Entitlement.

Privileges

Privilege	Description
FEDERATED_LDAP_MANAGE	Global LDAP management is required to delete a Global Application Entitlement.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the GlobalApplicationEntitlement used to make the method call.
id	GlobalApplicationEntitlementId	unique identifier for Global Application Entitlement to be deleted

Return Value

Type	Description
None

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidRequest	Thrown if Global Application Entitlement is active and has resources associated with it in any pod.
InvalidState	Thrown if the Pod Federation has not been initialized.
InvalidType	Thrown if the type of any specified argument is invalid.
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Events

Event	Description
VLSI_GAE_DELETED	If the Global Application Entitlement was successfully deleted.
VLSI_GAE_DELETE_FAILED	If the Global Application Entitlement could not be deleted.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="GlobalApplicationEntitlement_Delete" type="vdi:GlobalApplicationEntitlement_DeleteRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="GlobalApplicationEntitlement_DeleteResponse">
            <complexType/>
         </element>

GlobalApplicationEntitlement_Get

Returns Global Application Entitlement information corresponding to a specific Global Application Entitlement id.

Privileges

Privilege	Description
FEDERATED_LDAP_VIEW	Global LDAP read is required to read a Global Application Entitlement.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the GlobalApplicationEntitlement used to make the method call.
id	GlobalApplicationEntitlementId	unique identifier for Global Application Entitlement

Return Value

Type	Description
GlobalApplicationEntitlementInfo	Global Application Entitlement information

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidState	Thrown if this pod is not part of a Pod Federation
InvalidType	Thrown if the type of any specified argument is invalid.
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="GlobalApplicationEntitlement_Get" type="vdi:GlobalApplicationEntitlement_GetRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="GlobalApplicationEntitlement_GetResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:GlobalApplicationEntitlementInfo"/>
               </sequence>
            </complexType>
         </element>

GlobalApplicationEntitlement_Update

Updates Global Application Entitlement with the set of attributes in the map.

Privileges

Privilege	Description
FEDERATED_LDAP_MANAGE	Global LDAP management is required to update a Global Application Entitlement.

Parameters

Name

Type

Description

_this

ManagedObjectReference

A reference to the GlobalApplicationEntitlement used to make the method call.

GlobalApplicationEntitlementId

unique identifier for Global Application Entitlement to be updated

updates

MapEntry[]

key value pairs describing attributes to be updated

This parameter is an update map based on GlobalApplicationEntitlementInfo.

Return Value

Type	Description
None

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidRequest	Thrown if the update map contains invalid or non-permitted fields
InvalidState	Thrown if the Pod Federation has not been initialized.
InvalidType	Thrown if the type of any specified argument is invalid.
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Events

Event	Description
VLSI_GAE_CHANGED	If the Global Application Entitlement was successfully updated.
VLSI_GAE_CHANGE_FAILED	If the Global Application Entitlement could not be updated.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="GlobalApplicationEntitlement_Update" type="vdi:GlobalApplicationEntitlement_UpdateRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="GlobalApplicationEntitlement_UpdateResponse">
            <complexType/>
         </element>

GlobalEntitlement_ListCompatibleBackupGAEs

Lists the Global Application Entitlements that can be associated as backup Global Application Entitlement.

Privileges

Privilege	Description
FEDERATED_LDAP_VIEW	Global LDAP read is required to read a global application entitlement.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the GlobalApplicationEntitlement used to make the method call.
id	GlobalApplicationEntitlementId	unique identifier for Global Application Entitlement

Return Value

Type	Description
GlobalApplicationEntitlementInfo[]

Faults

Type	Description
EntityNotFound	Thrown if any specified entity cannot be found.
InsufficientPermission	Thrown if the user does not have sufficient permission to perform the operation.
InvalidArgument	Thrown if any specified argument is invalid.
InvalidType	Thrown if the type of any specified argument is invalid.
UnexpectedFault	Thrown if an unexpected error occurs while performing the operation.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="GlobalEntitlement_ListCompatibleBackupGAEs" type="vdi:GlobalEntitlement_ListCompatibleBackupGAEsRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="GlobalEntitlement_ListCompatibleBackupGAEsResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:GlobalApplicationEntitlementInfo" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>