• Home
  • 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.

ElementTypeDescriptionRequired
concurrentSessionPolicyDtoConcurrentSessionPolicy

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

required
automaticLogoutDtoAutomaticLogoutConfiguration

Configuration of automatic logout.

required

The ConcurrentSessionPolicy object

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

ElementTypeDescriptionRequired
userLimitinteger

Session limit for regular users (0 = no limit)

required
adminLimitinteger

Session limit for admin users (0 = no limit)

required

The AutomaticLogoutConfiguration object

Configuration of automatic logout.

ElementTypeDescriptionRequired
logoutInactiveUsersEnabledboolean

True if automatic logout is enabled

required
userInactivityTimeoutinteger

User inactivity timeout

required

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

plaintext
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