Service - MessageClient

Class: VMware.Hv.MessageClient
See also: MessageClientId, MessageClientInfo
Since: Horizon 7.7

Service Description

Methods

Methods defined in this Service
MessageClient_Create, MessageClient_Delete, MessageClient_Get, MessageClient_Update

MessageClient_Create

Create a message client.

Privileges

Privilege	Description
ADMINISTRATOR	Administrator is required to create the message client.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the MessageClient used to make the method call.
clientUuid	xsd:string	The message client uuid, which is generated by client itself
clientType	xsd:string	The message client type, which should be a member of MessageClientType.
pemCertificates	xsd:string[]	The message client certificates in PEM format. PemCertificate should be valid now, expired after 7 days, and its subject should be CN=clientType/clientUuid, otherwise InvalidArgumentFault will be thrown.

Return Value

Type	Description
MessageClientInfo

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.

Events

Event	Description
VLSI_CREATE_MESSAGE_CLIENT	If the message client was created successfully.
VLSI_CREATE_MESSAGE_CLIENT_FAILED	If the message client 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="MessageClient_Create" type="vdi:MessageClient_CreateRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="MessageClient_CreateResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:MessageClientInfo"/>
               </sequence>
            </complexType>
         </element>

MessageClient_Delete

Delete a message client.

Privileges

Privilege	Description
ADMINISTRATOR	Administrator is delete the message client.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the MessageClient used to make the method call.
id	MessageClientId	The message client id.

Return Value

Type	Description
MessageClientInfo

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.

Events

Event	Description
VLSI_DELETE_MESSAGE_CLIENT	If the message client was deleted successfully.
VLSI_DELETE_MESSAGE_CLIENT_FAILED	If the message client 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="MessageClient_Delete" type="vdi:MessageClient_DeleteRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="MessageClient_DeleteResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:MessageClientInfo"/>
               </sequence>
            </complexType>
         </element>

MessageClient_Get

Get the messageClientInfo with id

Privileges

Privilege	Description
ADMINISTRATOR_VIEW	Administrator (read-only) is required to get message client.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the MessageClient used to make the method call.
id	MessageClientId	The message client id.

Return Value

Type	Description
MessageClientInfo	The messageClientInfo

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="MessageClient_Get" type="vdi:MessageClient_GetRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="MessageClient_GetResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:MessageClientInfo"/>
               </sequence>
            </complexType>
         </element>

MessageClient_Update

Update a message client.

Privileges

Privilege	Description
ADMINISTRATOR	Administrator is required to update the message client.

Parameters

Name	Type	Description
_this	ManagedObjectReference	A reference to the MessageClient used to make the method call.
id	MessageClientId
pemCertificates	xsd:string[]	The message client certificates in PEM format. PemCertificate should be valid now, expired after 7 days, and its subject should be CN=clientType/clientUuid, otherwise InvalidArgumentFault will be thrown.

Return Value

Type	Description
MessageClientInfo

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.

Events

Event	Description
VLSI_UPDATE_MESSAGE_CLIENT	If the message client was updated successfully.
VLSI_UPDATE_MESSAGE_CLIENT_FAILED	If the message client 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="MessageClient_Update" type="vdi:MessageClient_UpdateRequestType"/>
         <element xmlns="http://www.w3.org/2001/XMLSchema" xmlns:vdi="urn:vdi" xmlns:vim25="urn:vim25" name="MessageClient_UpdateResponse">
            <complexType>
               <sequence>
                  <element name="returnval" type="vdi:MessageClientInfo"/>
               </sequence>
            </complexType>
         </element>