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 |
|
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 |
---|---|---|---|---|
levelType | string | The type of the policy level. The following values are available:
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:
| path | required |
policyUuid | string | The ID of the required policy. | path | required |
forceMultiple | boolean | Forces multiple in case delete by parameters and metadata query | query | required |
query-params | object | Key-value pairs for policy template parameters and metadata. Only bindings matching given parameters and metadata will be updated or deleted. | query | optional |
Response
Response codes
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