Get cluster user sessions configuration
This page will soon be available only on the dedicated Dynatrace Managed Documentation site. Update your bookmarks.
This API call gets a cluster user sessions configuration.
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/clusterConfig/userSessions
Parameters
No parameters are required for this API call.
Response
Response codes
Code | Type | Description |
---|---|---|
200 | UserSessionsConfig | Successful |
Response body objects
The UserSessionsConfig
object
The configuration of user sessions - concurrent sessions policy and automatic logout.
Element | Type | Description |
---|---|---|
concurrentSessionPolicyDto | ConcurrentSessionPolicy | The configuration of the concurrent sessions policy. Set '0' to disable session limitation. |
automaticLogoutDto | AutomaticLogoutConfiguration | Configuration of automatic logout. |
The ConcurrentSessionPolicy
object
The configuration of the concurrent sessions policy. Set '0' to disable session limitation.
Element | Type | Description |
---|---|---|
userLimit | integer | Session limit for regular users (0 = no limit) |
adminLimit | integer | Session limit for admin users (0 = no limit) |
The AutomaticLogoutConfiguration
object
Configuration of automatic logout.
Element | Type | Description |
---|---|---|
logoutInactiveUsersEnabled | boolean | True if automatic logout is enabled |
userInactivityTimeout | integer | User inactivity timeout |
Response body JSON model
1{2 "concurrentSessionPolicyDto": {3 "userLimit": 1,4 "adminLimit": 15 },6 "automaticLogoutDto": {7 "logoutInactiveUsersEnabled": true,8 "userInactivityTimeout": 9009 }10}
Example
In this example, the request queries the cluster for the current user sessions configuration. The cluster then returns information about the current session policy for concurrent sign-ins and user inactivity. The response indicates that the concurrent sign-in limit for users is 2
. For cluster admins accounts, the limit is 5
. Also, the inactivity sign-out policy is in effect and is set to 900
seconds.
Curl
1curl -X GET "https://myManaged.cluster.com/api/cluster/v2/clusterConfig/userSessions" -H "accept: application/json"
Request URL
1https://myManaged.cluster.com/api/cluster/v2/clusterConfig/userSessions
Response body
1{2 "concurrentSessionPolicyDto": {3 "userLimit": 2,4 "adminLimit": 55 },6 "automaticLogoutDto": {7 "logoutInactiveUsersEnabled": true,8 "userInactivityTimeout": 9009 }10}
Response code
204