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 |  |
| Panel | ||||
|---|---|---|---|---|
On this page:
|
| Note | |||||
|---|---|---|---|---|---|
| |||||
Remember, you can also show what methods are allowed and method description, parameters, etc. by making a GET HTTP request to /v2/session.
|
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:
| Code Block |
|---|
http -a $TK GET "https://vss-api.eis.utoronto.ca:8001/v2/session" "Authorization: Bearer $TK" curl -uH "Authorization: Bearer $TK" -X GET "https://vss-api.eis.utoronto.ca:8001/v2/session" |
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"_links": {
"api": "https://vss-api.eis.utoronto.ca:8001/v2/",
"self": "https://vss-api.eis.utoronto.ca:8001/v2/session"
},
"data": [
{
"_links": {
"self": "https://vss-api.eis.utoronto.ca:8001/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:
| Code Block |
|---|
http -a $TK GET "https://vss-api.eis.utoronto.ca:8001/v2/session/521615fc-1b09-bee9-0350-2a79568f4ad0" "Authorization: Bearer $TK" curl -uH "Authorization: Bearer $TK" -X GET "https://vss-api.eis.utoronto.ca:8001/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.
|
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
{
"_links": {
"self": "https://vss-api.eis.utoronto.ca:8001/v2/session/521615fc-1b09-bee9-0350-2a79568f4ad0",
"session": "https://vss-api.eis.utoronto.ca:8001/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"
}
} |