Policy management API - DELETE bindings of a policy level

Removes all policies of a level from all user groups that are using them.

DELETE

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 Authentication.

Parameters

Parameter Type Description In Required

levelType

string

Parameter	Type	Description	In	Required
levelType	string	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
levelId	string	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

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

levelId

string

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

Response

Response codes

Code	Type	Description
204		Success. Policy bindings have been deleted. The response doesn't have a body.
400	ErrorDto	Failed. The request is invalid
404	ErrorDto	Failed. The specified resource is not found.
422	ErrorDto	The specified response not found

Example

In this example, the request removes all the environment-level policies of the mySampleEnv environment from all user groups that are using them. The response code of 204 indicates a successful request.

Curl

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

Request URL

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

Response code

204