Policy management API - DELETE bindings of a policy

Removes a policy from all user groups on the specified level. After a successful request, no user group is using the policy anymore.

DELETE

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

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
levelTypestring

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.

pathrequired
levelIdstring

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.
pathrequired
policyUuidstring

The ID of the required policy.

pathrequired
forceMultipleboolean

Forces multiple in case delete by parameters and metadata query

queryrequired
query-paramsobject

Key-value pairs for policy template parameters and metadata. Only bindings matching given parameters and metadata will be updated or deleted.

queryoptional

Response

Response codes

CodeTypeDescription
204-

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

400ErrorDto

Failed. The request is invalid

404ErrorDto

Failed. The specified resource is not found.

Example

In this example, the request removes the environment-level (mySampleEnv environment) policy with the UUID of 0c621587-f978-4c7b-89ee-d2045f611b03 from all user groups that are using it. The response code of 204 indicates a successful request.

Curl

curl --request DELETE \
--url 'https://api.dynatrace.com/iam/v1/repo/environment/mySampleEnv/bindings/0c621587-f978-4c7b-89ee-d2045f611b03?forceMultiple=false' \
--header 'Authorization: Bearer abcdefjhij1234567890'

Request URL

https://api.dynatrace.com/iam/v1/repo/environment/mySampleEnv/bindings/0c621587-f978-4c7b-89ee-d2045f611b03?forceMultiple=false

Response code

204