Get cluster user sessions

This API call gets users sessions based on a specific user ID. You can request a list of user sessions for a specific user ID in a specific environment.

Authentication

To execute this request, you need the Service Provider API (ServiceProviderAPI) permission assigned to your API token. Generate your API token via Cluster Management Console (CMC). To learn how to obtain and use it, see Cluster API - Authentication.

Endpoint

/api/cluster/v2/userSessions

Parameters

Parameter	Type	Description	In	Required
userId	string	User ID (optional)	query	optional

Response

Response codes

Code	Type	Description
200	UserSession[]	Success
500		Operation failed

Response body objects

The `ResponseBody` object

The object doesn't provide any parameters.

The `UserSession` object

Managed user session instance

Element	Type	Description
userId	string	User id
nodeId	integer	Node on which user session exists
sessionId	string	User session id
creationTime	integer	User session creation timestamp
lastAccessedTimestamp	integer	Timestamp when session was recently accessed
tenantUuid	string	UUID of tenant to which user has logged in (or cluster UUID if user has logged in to CMC)
loginType	string	The way user has logged in The element can hold these values `LOCAL` `LDAP` `SSO_MANAGED` `DEVOPSTOKEN`
device	string	Device on which user has logged in
ip	string	IP from which has logged in

Response body JSON model

json
[
  {
    "userId": "string",
    "nodeId": 1,
    "sessionId": "string",
    "creationTime": 1,
    "lastAccessedTimestamp": 1,
    "tenantUuid": "string",
    "loginType": "LOCAL",
    "device": "string",
    "ip": "string"
  }
]

Example

In this example, the request lists user sessions in the myManaged.cluster.com cluster for user user.name.

Curl

bash
curl -X GET "https://myManaged.cluster.com/api/cluster/v2/userSessions?userId=user.name"
     -H  "accept: application/json"

Request URL

plaintext
https://myManaged.cluster.com/api/cluster/v2/userSessions?userId=user.name

Response body

json
[
  {
    "userId": "user.name",
    "nodeId": 4,
    "sessionId": "string",
    "creationTime": 0,
    "lastAccessedTimestamp": 0,
    "tenantUuid": "string",
    "loginType": "LOCAL",
    "device": "string",
    "ip": "string"
  }
]

Response code

200