Service - UserHomeSite

Class: VMware.Hv.UserHomeSite
See also: GlobalApplicationEntitlementId, GlobalEntitlementId, UserHomeSiteBase, UserHomeSiteId, UserHomeSiteInfo, UserOrGroupId
Since: Horizon View 6.0

Service Description

Representing the configured home site information for users/user groups. It can be used to determine which site the session should be assigned. And it can be configured in 2 ways:
1. Globally configured home site for a user or a group.
2. GlobalEntitlement specific Home site for a user or a group. When this configuration is present, it will overwrite the globally configured home site for that GlobalEntitlement.
It is possible that a user is a member of multiple groups and those groups are configured with different home sites within the same GlobalEntitlement, this essentially creates a conflict. UserHomeSite also provides helper methods to aid the discovery and resolution of conflicting home site configurations.
There's no update supported for UserHomeSite. All update to existing UserHomeSite can be done via delete and create.

Methods

Methods defined in this Service
UserHomeSite_Create, UserHomeSite_Delete, UserHomeSite_Get, UserHomeSite_GetInfos, UserHomeSite_List, UserHomeSite_Resolve, UserHomeSite_ResolveForGAE

UserHomeSite_Create

Creating a home site configuration for a user or a group. When GlobalEntitlement is absent, this represents a global configuration; otherwise, it represent a home site override for that GlobalEntitlement.
If the home site is already the user or group's home site, it will not be added again.
The request will NOT fail if the specified user is a member of another group which already has a different home site.
It is OK if the specified user is an individual user if they belong to a group that is already entitled to the specified GlobalEntitlement.
It is NOT OK if the specified user is a group if it is NOT already entitled to the specified GlobalEntitlement.

Privileges

Privilege	Description
FEDERATED_LDAP_MANAGE	Global LDAP management is required to create a user home site.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the UserHomeSite used to make the method call.
base	UserHomeSiteBase	Base data for creating a UserHomeSite object

Return Value

Type	Description
UserHomeSiteId	Id The Id of the UserHomeSite object created.

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 required entity Id in the baseData is missing.
InvalidState	Thrown if PodFederation 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_USER_HOME_SITE_ADDED	If the user home site was successfully created.
VLSI_USER_HOME_SITE_ADD_FAILED	If the user home site 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="UserHomeSite_Create" type="vdi:UserHomeSite_CreateRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="UserHomeSite_CreateResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:UserHomeSiteId"/>
               </sequence>
            </complexType>
         </element>

UserHomeSite_Delete

Remove the home site configuration for the specified UserHomeSite.

Privileges

Privilege	Description
FEDERATED_LDAP_MANAGE	Global LDAP management is required to delete a user home site.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the UserHomeSite used to make the method call.
id	UserHomeSiteId	the Id for the user/group's existing home site

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.
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_USER_HOME_SITE_DELETED	If the user home site was successfully deleted.
VLSI_USER_HOME_SITE_DELETE_FAILED	If the user home site 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="UserHomeSite_Delete" type="vdi:UserHomeSite_DeleteRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="UserHomeSite_DeleteResponse">
            <complexType/>
         </element>

UserHomeSite_Get

Retrieve the UserHomeSiteInfo given a UserHomeSiteId. Callers would be able to get a handle of UserHomeSiteId via EntitledUserOrGroup service.

Privileges

Privilege	Description
FEDERATED_LDAP_VIEW	Global LDAP read is required to read a user home site.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the UserHomeSite used to make the method call.
id	UserHomeSiteId	The id of the UserHomeSite object.

Return Value

Type	Description
UserHomeSiteInfo	UserHomeSiteInfo

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 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.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="UserHomeSite_Get" type="vdi:UserHomeSite_GetRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="UserHomeSite_GetResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:UserHomeSiteInfo" minOccurs="0"/>
               </sequence>
            </complexType>
         </element>

UserHomeSite_GetInfos

Retrieve the UserHomeSiteInfo given an array of UserHomeSiteIds. Callers would be able to get a handle of UserHomeSiteId via EntitledUserOrGroup service.

Privileges

Privilege	Description
FEDERATED_LDAP_VIEW	Global LDAP read is required to read multiple user home sites.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the UserHomeSite used to make the method call.
ids	UserHomeSiteId[]	The ids of the UserHomeSite object.

Return Value

Type	Description
UserHomeSiteInfo[]	UserHomeSiteInfo

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 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.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="UserHomeSite_GetInfos" type="vdi:UserHomeSite_GetInfosRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="UserHomeSite_GetInfosResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:UserHomeSiteInfo" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

UserHomeSite_List

Given a user or group, retrieve their list of UserHomeSiteInfo.
All home site configurations for the UserOrGroup will be returned. They include both globally configured home sites as well as per-GlobalEntitlement overwriting home sites.
Only home site information configured directly against the specified UserOrGroup will be returned. It will not return any home site information for the groups that UserOrGroup is part of.

Privileges

Privilege	Description
FEDERATED_LDAP_VIEW	Global LDAP read is required to list user home sites.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the UserHomeSite used to make the method call.
userOrGroup	UserOrGroupId	Id for a user or group

Return Value

Type	Description
UserHomeSiteInfo[]	UserHomeSiteInfo

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 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.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="UserHomeSite_List" type="vdi:UserHomeSite_ListRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="UserHomeSite_ListResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:UserHomeSiteInfo" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

UserHomeSite_Resolve

Given a UserOrGroupId for an individual user and a GlobalEntitlementId, return the resolved home site information as well as any conflicting configurations.
This operation will look up the user home site configuration data for the specified user; as well as user home site configurations for any immediate groups that this user is a member of. It will calculate override home site configuration and apply conflict resolution algorithm appropriately.
A home site configuration is in conflict if the specified UserOrGroupId belongs to more than one group, and those groups are entitled to the same GlobalEntitlement but they have different overriding home sites.
It will return the UserHomeSiteInfo objects that represent the resolved user home site as well as any conflicting home site configurations. If there's no home site configured, null will be returned.
The resolved home site is always the first element in the returned list, any conflicting user home site configurations will follow after that.
The resolved home site will be the site that a new persistent resource assignment will take place for this UserOrGroup and GlobalEntitlement.

Privileges

Privilege	Description
FEDERATED_LDAP_VIEW	Global LDAP read is required to resolve user home sites.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the UserHomeSite used to make the method call.
user	UserOrGroupId	Id for an individual user whose home site to be resolved. UserOrGroupId for group is not supported.
globalEntitlement	GlobalEntitlementId	The Id of the GlobalEntitlement the UserOrGroup is entitled to.

Return Value

Type	Description
UserHomeSiteInfo[]	A list of user home site configurations. The resolved home site will be the first element in the list, followed by conflicting home site configurations. Return null if no home site configuration found.

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 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.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="UserHomeSite_Resolve" type="vdi:UserHomeSite_ResolveRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="UserHomeSite_ResolveResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:UserHomeSiteInfo" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>

UserHomeSite_ResolveForGAE

Given a UserOrGroupId for an individual user and a GlobalApplicationEntitlementId, return the resolved home site information as well as any conflicting configurations.
This operation will look up the user home site configuration data for the specified user; as well as user home site configurations for any immediate groups that this user is a member of. It will calculate override home site configuration and apply conflict resolution algorithm appropriately.
A home site configuration is in conflict if the specified UserOrGroupId belongs to more than one group, and those groups are entitled to the same GlobalApplicationEntitlement but they have different overriding home sites.
It will return the UserHomeSiteInfo objects that represent the resolved user home site as well as any conflicting home site configurations. If there's no home site configured, null will be returned.
The resolved home site is always the first element in the returned list, any conflicting user home site configurations will follow after that.
The resolved home site will be the site that a new persistent resource assignment will take place for this UserOrGroup and GlobalApplicationEntitlement.

Privileges

Privilege	Description
FEDERATED_LDAP_VIEW	Global LDAP read is required to resolve user home sites.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the UserHomeSite used to make the method call.
user	UserOrGroupId	Id for an individual user whose home site to be resolved. UserOrGroupId for group is not supported.
globalApplicationEntitlement	GlobalApplicationEntitlementId	The Id of the GlobalApplicationEntitlement the UserOrGroup is entitled to.

Return Value

Type	Description
UserHomeSiteInfo[]	A list of user home site configurations. The resolved home site will be the first element in the list, followed by conflicting home site configurations. Return null if no home site configuration found.

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 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.

Show WSDL type definition

         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="UserHomeSite_ResolveForGAE" type="vdi:UserHomeSite_ResolveForGAERequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="UserHomeSite_ResolveForGAEResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:UserHomeSiteInfo" minOccurs="0" maxOccurs="unbounded"/>
               </sequence>
            </complexType>
         </element>