• Home
  • Dynatrace Managed
  • Cluster API
  • Cluster API v2
  • User management
  • Get cluster user sessions configuration

Get cluster user sessions configuration

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

CodeTypeDescription
200UserSessionsConfig

Successful

Response body objects

The UserSessionsConfig object

The configuration of user sessions - concurrent sessions policy and automatic logout.

ElementTypeDescription
concurrentSessionPolicyDtoConcurrentSessionPolicy

The configuration of the concurrent sessions policy. Set '0' to disable session limitation.

automaticLogoutDtoAutomaticLogoutConfiguration

Configuration of automatic logout.

The ConcurrentSessionPolicy object

The configuration of the concurrent sessions policy. Set '0' to disable session limitation.

ElementTypeDescription
userLimitinteger

Session limit for regular users (0 = no limit)

adminLimitinteger

Session limit for admin users (0 = no limit)

The AutomaticLogoutConfiguration object

Configuration of automatic logout.

ElementTypeDescription
logoutInactiveUsersEnabledboolean

True if automatic logout is enabled

userInactivityTimeoutinteger

User inactivity timeout

Response body JSON model

json
{ "concurrentSessionPolicyDto": { "userLimit": 1, "adminLimit": 1 }, "automaticLogoutDto": { "logoutInactiveUsersEnabled": true, "userInactivityTimeout": 900 } }

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

bash
curl -X GET "https://myManaged.cluster.com/api/cluster/v2/clusterConfig/userSessions" -H "accept: application/json"

Request URL

plaintext
https://myManaged.cluster.com/api/cluster/v2/clusterConfig/userSessions

Response body

json
{ "concurrentSessionPolicyDto": { "userLimit": 2, "adminLimit": 5 }, "automaticLogoutDto": { "logoutInactiveUsersEnabled": true, "userInactivityTimeout": 900 } }

Response code

204