Data Object - HostServiceTicket

Returned by
AcquireCimServicesTicket
Extends
DynamicData

Data Object Description

Return value for ticketable host services. The server has the option to provide a hostname and port for a future ticket-authenticated connection to a service on a host. If the service provider does not return a host the client must connect to the same host it used to request the ticket. In case the service provider does not return a port, except in the case of connecting to CIM interfaces, the client must connect using the same port it used to request the ticket. In the case of connecting to a CIM interface the standard well known port number for the particular service will be used for the connection.

For example, when a client requests a ticket from an ESX Server, the returned ticket may omit the optional host and port. In such a case, the client establishes an out-of-band ticketed connection to the same server host and on the same port on which it made the connection to request the ticket. If this request is made to the VirtualCenter server, but the server does not provide the required service directly, then the server provides a hostname and port for a server that accepts the ticketed connection and provides the service.

Properties

Name Type Description
host*xsd:string

The name of the host providing the service for which the ticket applies. If omitted, then the client uses the host name for the server that issued the ticket.
port*xsd:int

Access to some services is made possible by connecting to a port on a server. If the service for which a ticket is issued is available on a particular port, that port number is specified with this property. If omitted, except in the case of connecting to CIM interfaces, the port number for the service that issued the ticket is used. In the case of connecting to a CIM interface the standard well known port for the particular service will be used for the connection.
servicexsd:string

The name of the service to which to connect.
serviceVersionxsd:string

A dot-separated string identifying the service protocol version. For example: 1.0 is used for NFC hosted by vpxa and used for managed ESX 2.5 or 1.1 is used for NFC hosted by hostd on ESX 3.0.
sessionIdxsd:string

An identifying string for the session created for the ticketed connection. This is used by the host service to identify the operations permitted within the session.
sslThumbprint*xsd:string

The expected thumbprint of the SSL cert of the host to which we are connecting.

Since VI API 2.5
Properties inherited from DynamicData
dynamicProperty, dynamicType
*Need not be set
Show WSDL type definition