Get user groups

This API call retrieves information on a specific cluster user groups.

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/v1.0/onpremise/groups

Parameter

The request doesn't provide any configurable parameters.

Response

Response codes

Code	Type	Description
200	GroupConfig[]	Success

Response body objects

The `ResponseBody` object

The object doesn't provide any parameters.

The `GroupConfig` object

The configuration of the group.

Element	Type	Description
isClusterAdminGroup	boolean	If true, then the group has the cluster administrator rights.
hasAccessAccountRole	boolean	If true, then the group has the access account rights.
hasManageAccountAndViewProductUsageRole	boolean	If true, then the group has the manage account rights.
isAccessAccount	boolean	-
isManageAccount	boolean	-
id	string	Group ID. Leave empty if creating group. Set if updating group.
name	string	Group name
ldapGroupNames	string[]	LDAP group names
ssoGroupNames	string[]	SSO group names. If defined it's used to map SSO group name to Dynatrace group name, otherwise mapping is done by group name
accessRight	object	Access rights

Response body JSON model

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

Example

In this example, you retrieve user groups with details.

Curl

bash
curl -X GET "https://myManaged.cluster.com/api/v1.0/onpremise/groups' \
  -H 'accept: application/json' \
  -H 'Authorization: Api-Token FG563.LKJHDFLKJHDFHLKJDGV.ABCDEFGHJKLMNOP'

Request URL

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

Response body

json
[
  {
    "isClusterAdminGroup": true,
    "isManageAccount": true,
    "isAccessAccount": true,
    "id": "owners",
    "name": "Owners",
    "ldapGroupNames": [
      "LDAPM_ClusterBasicAccess"
    ],
    "ssoGroupNames": [],
    "accessRight": {}
  },
  {
    "isClusterAdminGroup": false,
    "isManageAccount": false,
    "isAccessAccount": false,
    "id": "mobile",
    "name": "TeamPh",
    "ldapGroupNames": [
      "TeamPh"
    ],
    "ssoGroupNames": [],
    "accessRight": {
      "VIEWER": [
        "3d211429-1ebd-40a2-49ff-d2c40e605ff4",
        "c69c1533-18c1-ed0e-fa15-9132f3a1a18b"
      ],
      "MANAGE_SETTINGS": [
        "3d211429-1ebd-40a2-49ff-d2c40e605ff4",
        "c69c1533-18c1-ed0e-fa15-9132f3a1a18b"
      ],
      "AGENT_INSTALL": [
        "3d211429-1ebd-40a2-49ff-d2c40e605ff4",
        "c69c1533-18c1-ed0e-fa15-9132f3a1a18b"
      ],
      "LOG_VIEWER": [
        "3d211429-1ebd-40a2-49ff-d2c40e605ff4",
        "c69c1533-18c1-ed0e-fa15-9132f3a1a18b"
      ],
      "VIEW_SENSITIVE_REQUEST_DATA": [
        "3d211429-1ebd-40a2-49ff-d2c40e605ff4",
        "c69c1533-18c1-ed0e-fa15-9132f3a1a18b"
      ],
      "CONFIGURE_REQUEST_CAPTURE_DATA": [
        "3d211429-1ebd-40a2-49ff-d2c40e605ff4",
        "c69c1533-18c1-ed0e-fa15-9132f3a1a18b"
      ],
      "REPLAY_SESSION_DATA": [
        "3d211429-1ebd-40a2-49ff-d2c40e605ff4",
        "c69c1533-18c1-ed0e-fa15-9132f3a1a18b"
      ]
    }
  }
]

Response code

200