Policy management API - GET level-bindings for a group

Latest Dynatrace
Reference
Published Jul 22, 2022

Gets all bindings of a policy level for a group via the Policy management API.

The request produces an application/json payload.

GET

https://api.dynatrace.com/iam/v1/repo/{levelType}/{levelId}/bindings/{policyUuid}/{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
groupUuid	-	The ID of the required user group.	path	Required
policyUuid	-	The ID of the required policy.	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	LevelPolicyBindingDto	Successful response - list of policy bindings with parameters
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
boundaries	string[]	List of boundary UUIDs used in the binding.

The `ErrorDto` object

Element	Type	Description
code	number	The code of the error.
message	string	A short description of the error.
errorsMap	object	-

Response body JSON models

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

{
  "code": 1,
  "message": "string",
  "errorsMap": {}
}