Edit or delete a policy

Change a custom policy's document, name or description, or delete the policy and detach it everywhere.

Last updated 18 November 2026View as Markdown

Only custom policies can be changed. Managed policies are maintained by Deutsche Cloud; to change what one grants, copy its document into a custom policy (see Create a policy). Replace policy-id with the policy's id.

Prerequisites

  • To edit, iam:UpdatePolicy on the policy. To delete, iam:DeletePolicy.
  • In the console, also iam:ListPolicies to see Policies and iam:GetPolicy on the policy to open it (without it the page is not found).

Edit the document

A change applies to every user, group and role that holds the policy, from their next request on.

  1. Open Identity, choose Policies, then the policy.
  2. Choose Document, then Edit. A managed policy has no Edit.
  3. Change the JSON, then choose Save document. The document is checked as you type; an unchanged document is not saved.

The console changes the document only; the name and the description change through the CLI, the API or Terraform.

The new document is checked the same way as at creation; see Create a policy.

Delete the policy

Warning

Every user, group and role holding the policy loses its permissions the moment it is deleted.

  1. Open the policy, then choose Danger zone.
  2. Choose Delete policy, type the policy name, and confirm.

Deleting detaches the policy from everyone who held it.

If the change is refused

  • 400 Cannot modify a managed policy or Cannot delete a managed policy.
  • 400 Invalid policy document: … for a document that does not pass the checks.
Did this page help you?