1. Docs
  2. Pulumi IaC
  3. Concepts
  4. Resource options
  5. retainOnDelete

Resource option: retainOnDelete

The retainOnDelete resource option marks a resource to be retained. If this option is set then Pulumi will not call through to the resource provider’s Delete method when deleting or replacing the resource during pulumi up or pulumi destroy. As a result, the resource will not be deleted from the backing cloud provider, but will be removed from the Pulumi state.

If a retained resource is deleted by Pulumi and you later want to actually delete it from the backing cloud provider you will either need to use your provider’s manual interface to find and delete the resource, or import the resource back into Pulumi to unset retainOnDelete and delete it again fully.

To actually delete a retained resource, this setting must first be set to false.

  • Set retainOnDelete: false and then run pulumi up

Once the resource is no longer marked retained, it can be fully deleted as part of a following update.

The default is to inherit this value from the parent resource, and false for resources without a parent.

let db = new Database("db", {}, { retainOnDelete: true });
Copy
let db = new Database("db", {}, { retainOnDelete: true });
Copy
db = Database("db", opts=ResourceOptions(retain_on_delete=True))
Copy
db, _ := NewDatabase(ctx, "db", &DatabaseArgs{}, pulumi.RetainOnDelete(true));
Copy
var db = new Database("db", new DatabaseArgs(),
    new CustomResourceOptions { RetainOnDelete = true });
Copy
var db = new Database("db",
    DatabaseArgs.Empty,
    CustomResourceOptions.builder()
        .retainOnDelete(true)
        .build());
Copy
resources:
  db:
    type: Database
    options:
      retainOnDelete: true
Copy
The retainOnDelete resource option does not apply to component resources, and will not have the intended effect.

Was this page helpful?

PulumiUP May 6, 2025. Register Now.