Policy management API - DELETE a policy
Deletes an access policy. You can't delete a global-level policy, as these are managed by Dynatrace.
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 Authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
levelType | string | The type of the policy level. The following values are available:
Each level inherits policies of a higher level and extends it 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 |
force | boolean | Set to | path | required |
Response
Response codes
Code | Type | Description |
---|---|---|
204 | Success. The policy has 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. |
Example
In this example, the request deletes the apiExample policy from the POST request example. The response code of 204 indicates successful deletion.
Curl
curl --request DELETE \
--url https://api.dynatrace.com/iam/v1/repo/environment/lde68092/policies/0c621587-f978-4c7b-89ee-d2045f611b03 \
--header 'Authorization: Bearer abcdefjhij1234567890'
Request URL
https://api.dynatrace.com/iam/v1/repo/environment/lde68092/policies/0c621587-f978-4c7b-89ee-d2045f611b03
Response code
204