Policy management API - DELETE bindings of a policy level

  • Classic
  • Latest Dynatrace
  • Reference

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 OAuth clients.

Parameters

ParameterTypeDescriptionInRequired
levelId-

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

  • account: use the UUID of the account.
  • environment: use the ID of the environment.
pathrequired
levelType-

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

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

pathrequired

Response

Response codes

CodeTypeDescription
204-

Success. Policy bindings have been deleted. The response doesn't have a body.

400ErrorDto

Failed. The request is invalid

404ErrorDto

Failed. The specified resource is not found.

422ErrorDto

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

curl --request DELETE \
  --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 code

204