Policy management API - GET bindings of a user group

Lists all policies assigned to a user group.

The request produces an application/json payload.

GET

https://api.dynatrace.com/iam/v1/repo/{levelType}/{levelId}/bindings/groups/{groupUuid}

Authentication

To execute this request, you need the Allow IAM policy configuration for environments (iam-policies-management) permission assigned to your token. To learn how to obtain and use it, see OAuth clients.

Parameters

Parameter
Type
Description
In
Required
details
-

Optional parameter to print-out additional details containing boundaries, metadata, parameters.

query
optional
groupUuid
-

The ID of the required user group.

path
required
levelId
-

The ID of the policy level. Use one of the following values, depending on the level type:

  • global: use the global value.
  • account: use the UUID of the account.
  • environment: use the ID of the environment.
path
required
levelType
-

The type of the policy level. The following values are available:

  • global: A global policy applies to all accounts and environments. It is defined and managed by Dynatrace.
  • account: An account policy applies to all environments of an account.
  • environment: An environment policy applies to a specific environment.

Each level inherits the policies of the higher level and extends them with its own policies.

path
required

Response

Response codes

Code
Type
Description
200

Success. The response contains the list of policies.

404

Failed. The specified resource is not found.

Response body objects

The PolicyUuidsWithoutMetadataDto object

Element
Type
Description
policyUuids
string[]

A list of policies bound to the user group.

Response body JSON model

{
  "policyUuids": [
    "string"
  ]
}

Example

In this example, the request lists policies assigned to the user group with the UUID of 541802b0-623c-4193-8728-036ed01d4eb4 from the mySampleEnv environment.

Curl

curl --request GET \
  --url 'https://api.dynatrace.com/iam/v1/repo/environment/mySampleEnv/bindings/groups/541802b0-623c-4193-8728-036ed01d4eb4' \
  --header 'Authorization: Bearer abcdefjhij1234567890'

Request URL

https://api.dynatrace.com/iam/v1/repo/environment/mySampleEnv/bindings/groups/541802b0-623c-4193-8728-036ed01d4eb4

Response body

{
  "policyUuids": [
    "74e51763-1118-4833-8b1e-6b5f0082052a"
  ]
}

Response code

200