Create user groups

This API call creates multiple cluster user groups.

Authentication

The ServiceProviderAPI (Service Provider API) Api-Token scope is required to get the default realm password policy configuration using the Dynatrace API. With this API method, you can preset user's password by passing passwordClearText value. This is allowed only if a specific Feature Flag is enabled. To do this, Please contact a Dynatrace ONE product specialist by selecting the chat button in the upper-right corner of the Dynatrace menu bar..

Endpoint

/api/v1.0/onpremise/groups/bulk

Parameter

jsoncopydownload
[
  {
    "isClusterAdminGroup": true,
    "hasAccessAccountRole": true,
    "hasManageAccountAndViewProductUsageRole": true,
    "isAccessAccount": true,
    "isManageAccount": true,
    "id": "string",
    "name": "string",
    "ldapGroupNames": [
      "string"
    ],
    "ssoGroupNames": [
      "string"
    ],
    "accessRight": {}
  }
]

Response

jsoncopydownload
[
  {
    "isClusterAdminGroup": true,
    "hasAccessAccountRole": true,
    "hasManageAccountAndViewProductUsageRole": true,
    "isAccessAccount": true,
    "isManageAccount": true,
    "id": "string",
    "name": "string",
    "ldapGroupNames": [
      "string"
    ],
    "ssoGroupNames": [
      "string"
    ],
    "accessRight": {}
  }
]

Example

In this example, you add user groups Sales Group and Developers in a single request. This will set their data and assign environment permissions. As a response, you will receive back persisted state of the entities.

Curl

bashcopydownload
curl -X 'POST' \
  'https://mymanaged.cluster.com/api/v1.0/onpremise/groups/bulk' \
  -H 'accept: application/json' \
  -H 'Authorization: Api-Token FG563.LKJHDFLKJHDFHLKJDGV.ABCDEFGHJKLMNOP' \
  -H 'Content-Type: application/json' \
  -d '[
  {
    "isClusterAdminGroup": true,
    "isAccessAccount": true,
    "isManageAccount": true,
    "name": "Sales Group",
    "ldapGroupNames": [
      "sales-group"
    ],
    "ssoGroupNames": [
      "sales-group"
    ],
    "accessRight": {
    "VIEWER": [
      "3fcc5d83-d9e5-4bf9-9e00-d997f9c4c63d"
    ],
    "REPLAY_SESSION_DATA": [
      "3fcc5d83-d9e5-4bf9-9e00-d997f9c4c63d"
    ]
    }
  },
{
    "isClusterAdminGroup": true,
    "isAccessAccount": true,
    "isManageAccount": true,
    "name": "Developers",
    "ldapGroupNames": [
      "dev-group"
    ],
    "ssoGroupNames": [
      "dev-group"
    ],
    "accessRight": {
    "VIEWER": [
      "3fcc5d83-d9e5-4bf9-9e00-d997f9c4c63d"
    ]

    }
  }

]'

Request URL

plaintextcopydownload
https://mymanaged.cluster.com/api/v1.0/onpremise/groups/bulk

Response body

jsoncopydownload
[
  {
    "isClusterAdminGroup": true,
    "isManageAccount": true,
    "isAccessAccount": true,
    "id": "salesgroup",
    "name": "Sales Group",
    "ldapGroupNames": [
      "sales-group"
    ],
    "ssoGroupNames": [
      "sales-group"
    ],
    "accessRight": {}
  },
  {
    "isClusterAdminGroup": true,
    "isManageAccount": true,
    "isAccessAccount": true,
    "id": "developers",
    "name": "Developers",
    "ldapGroupNames": [
      "dev-group"
    ],
    "ssoGroupNames": [
      "dev-group"
    ],
    "accessRight": {}
  }
]

Response code

200