Policy management API - GET bindings of a policy level

Lists all user groups, using policies of a policy level.

The request produces an application/json payload.

GET	`https://api.dynatrace.com/iam/v1/repo/{levelType}/{levelId}/bindings`

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

levelId

Parameter	Type	Description	In	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

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	LevelPolicyBindingDto	Success. The response contains bindings of the level policies.
404	ErrorDto	Failed. The specified resource is not found.

Response body objects

The `LevelPolicyBindingDto` object

Element	Type	Description
levelType	string	The type of the policy level.
levelId	string	The ID of the policy level.
policyBindings	Binding[]	-

The `Binding` object

Element	Type	Description
policyUuid	string	The ID of the policy.
groups	string[]	A list of user groups to which the policy applies.
parameters	object	Parameters from bound policies
metadata	object	Metadata from bound policies

Response body JSON model

{
  "levelType": "string",
  "levelId": "string",
  "policyBindings": [
    {
      "policyUuid": "string",
      "groups": [
        "string"
      ],
      "parameters": {},
      "metadata": {}
    }
  ]
}

Example

In this example, the request lists all user groups that are using environment-level policies for the mySampleEnv environment.

Curl

curl --request GET \
  --url 'https://api.dynatrace.com/iam/v1/repo/environment/mySampleEnv/bindings' \
  --header 'Authorization: Bearer abcdefjhij1234567890'

Request URL

https://api.dynatrace.com/iam/v1/repo/environment/mySampleEnv/bindings

Response body

{
  "levelType": "environment",
  "levelId": "mySampleEnv",
  "policyBindings": [
    {
      "policyUuid": "0c621587-f978-4c7b-89ee-d2045f611b03",
      "groups": [
        "a468e0e0-ef8f-45d8-9b0f-e016984d838b"
      ]
    },
    {
      "policyUuid": "74e51763-1118-4833-8b1e-6b5f0082052a",
      "groups": [
        "541802b0-623c-4193-8728-036ed01d4eb4"
      ]
    }
  ]
}

Response code

200