• Home
  • Setup and configuration
  • Dynatrace Managed
  • Cluster API
  • Cluster API v2
  • User management
  • Update cluster user sessions configuration

Update cluster user sessions configuration

This API call updates a cluster user sessions configuration. You can modify the user sessions configuration by specifying new concurrent user session limits for cluster admin accounts and regular users. Set limits to 0 for unlimited concurrent user sessions. If you choose to set any of the limits to 0, the limit for the other account type also must be set to 0.

You can use this request to update automatic logout policy. By default, there's no auto logout of users who stay on auto-refreshable page. Use below payload to turn automatic logout on and set the session timeout to 900 seconds (15 minutes).

json
"automaticLogoutDto": { "logoutInactiveUsersEnabled": true, "userInactivityTimeout": 900 }

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

ParameterTypeDescriptionInRequired
bodyUserSessionsConfig

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

bodyoptional

Request 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

Request body JSON model

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.

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

Response

Response codes

CodeDescription
200

Successful

400

Wrong parameters

510

Configuration update failed

Example

In this example, the request updates the cluster user sessions configuration. Cluster updates the current session policy for concurrent sign-ins and user inactivity. The request indicates that the concurrent sign-in limit for users is 3. The limit for cluster admin accounts is 5. Also, the inactivity sign-out policy is in effect and is set to 900 seconds.

Curl

bash
curl -X PUT "https://myManaged.cluster.com/api/cluster/v2/clusterConfig/userSessions" -H "accept: */*" -H "Content-Type: */*" -d "{\"concurrentSessionPolicyDto\":{\"userLimit\":0,\"adminLimit\":0},\"automaticLogoutDto\":{\"logoutInactiveUsersEnabled\":true,\"userInactivityTimeout\":900}}"

Request URL

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

Request body

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

Response code

204