Session Manager Acquire Generic Service Ticket

Session Manager Acquire Generic Service Ticket

Creates and returns a one-time credential that may be used to make the specified request.

Required privileges: System.Anonymous

Request
URI
POST
https://{api_host}/sdk/vim25/{release}/SessionManager/{moId}/AcquireGenericServiceTicket
COPY
Path Parameters
string
moId
Required

The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId, in this case SessionManager/{moId}.

string
release
Required

The vSphere release schema. The current specification covers vSphere 9.0.0.0 APIs.


Request Body
AcquireGenericServiceTicketRequestType of type(s) application/json
Required
"AcquireGenericServiceTicketRequestType Object"
spec
Required

specification for the service request which will be invoked with the ticket.

Authentication
This operation uses the following authentication methods.
Responses
200

a ticket that may be used to invoke the specified request. The first choice for authenticating the host is sslCertificate. If sslCertificate is unset, the following logic is used to authenticate the host: 1. If the VC system supports the crypto hash algorithm of the sslThumbprint or certThumbprintList (if set), they will be verified against that of the server certificate. If they doesn't match, the CA certificates will be used to authenticate the host. 2. If the VC system does not support the crypto hash algorithm of sslThumbprint or certThumbprintList, only the CA certificates will be used to authenticate the host.

Returns SessionManagerGenericServiceTicket of type(s) application/json
"SessionManagerGenericServiceTicket Object"
string As password As password
id
Required

A unique string identifying the ticket.

string
hostName
Optional

The name of the host that the service is running on

string
sslThumbprint
Optional

The expected thumbprint of the SSL certificate of the host.

If it is empty, the host must be authenticated by name.

array of object
certThumbprintList
Optional

List of expected thumbprints of the certificate of the host to which we are connecting.

The list can be configured on the host to include only certain hash types. The default configuration includes all hash types that are considered secure. See vmware.com for the current security standards.

Since: vSphere API Release 7.0.3.1

string
sslCertificate
Optional

Supported only by vCenter.

The expected SSL certificate of the host to which we are connecting to, in PEM format. Note: SessionManagerGenericServiceTicket.sslThumbprint and SessionManagerGenericServiceTicket.sslCertificate parameters are mutually exclusive, and should never be used simultaneously.

Since: vSphere API Release 9.0.0.0

string
ticketType
Optional

Type of the ticket See { @Vim::SessionManager::GenericServiceTicket::TicketType }

Since: vSphere API Release 7.0.2.0


Code Samples
COPY
                    curl -X POST -H 'Authorization: <value>' -H 'Content-Type: application/json' -d '[{}]' https://{api_host}/sdk/vim25/{release}/SessionManager/{moId}/AcquireGenericServiceTicket