Introduction

The /v2/session resource provides a list of valid vCenter sessions of the user making the request.

Resource	URI	Description	GET	POST	PUT	DELETE
Session	/session	Current user vCenter active sessions

On this page:

TK stores the Cloud API Token generated as a result of the following POST request to the /auth/request-token resource:

curl -X POST https://vss-api.eis.utoronto.ca/auth/request-token -u <username>

For example, extracting the token with the jq command:

TK=$(curl -X POST https://vss-api.eis.utoronto.ca/auth/request-token -u <username> | jq -r '.token')

List

Enumerating current user valid vCenter sessions can be done by making a GET request to /v2/session resource, which in case the user actually has at least one valid session, a list of JSON objects with the following attributes will be the result:

Attribute	Type	Description
key	string	vCenter session key
username	string	Full username including domain associated with session
_links	object	Contains reference to current session to display further information

The following examples implements HTTPie and CURL to list valid vCenter sessions:

http GET "https://vss-api.eis.utoronto.ca/v2/session" "Authorization: Bearer $TK"
curl -H "Authorization: Bearer $TK" -X GET "https://vss-api.eis.utoronto.ca/v2/session"

Response Body

{
    "_links": {
        "api": "https://vss-api.eis.utoronto.ca/v2/",
        "self": "https://vss-api.eis.utoronto.ca/v2/session"
    },
    "data": [
        {
            "_links": {
                "self": "https://vss-api.eis.utoronto.ca/v2/session/521615fc-1b09-bee9-0350-2a79568f4ad0"
            },
            "key": "521615fc-1b09-bee9-0350-2a79568f4ad0",
            "username": "VSKEY5\\josem"
        }
    ],
    "meta": {
        "count": 1,
        "time": "0.00801s",
        "user": "josem"
    }
}

Getting additional information about specific session can be done appending the session key to the /v2/session URI as follows:

http GET "https://vss-api.eis.utoronto.ca/v2/session/521615fc-1b09-bee9-0350-2a79568f4ad0" "Authorization: Bearer $TK"
curl -H "Authorization: Bearer $TK" -X GET "https://vss-api.eis.utoronto.ca/v2/session/521615fc-1b09-bee9-0350-2a79568f4ad0"

Additional attributes will be shown as a result and are described in the following table:

Attribute	Type	Description
domain	string	Authentication domain (usually VSKEY).
ip	string	IP address of remote client.
lastActiveTime	string	Timestamp of last active time
lastActiveTimeDelta	string	Time delta of last active time to now.
loginTime	string	Timestamp when login.
loginTimeDelta	string	Time delta of login time to now.
userAgent	string	What application is connected to vCenter. VMware VI Client - vSphere Windows Client

Response Body

{
    "_links": {
        "self": "https://vss-api.eis.utoronto.ca/v2/session/521615fc-1b09-bee9-0350-2a79568f4ad0",
        "session": "https://vss-api.eis.utoronto.ca/v2/session"
    },
    "data": [
        {
            "domain": "VSKEY5",
            "ip": "10.0.0.1",
            "lastActiveTime": "2016-05-09 10:58:21",
            "lastActiveTimeDelta": "0:13:59.079416",
            "loginTime": "2016-04-15 11:11:28",
            "loginTimeDelta": "24 days, 0:00:51.439527",
            "userAgent": "VMware VI Client/4.0",
            "username": "VSKEY5\\josem"
        }
    ],
    "meta": {
        "count": 1,
        "time": "0.03858s",
        "user": "josem"
    }
}