Resource options
All Pulumi IaC resources support a common set of options that allow you to customize how your resources are managed. Resource options allow you to do things like protect resources from being deleted, express more fine-grained control to the order in which resources are changed, or apply custom code that will allow you to change the properties of your resources.
Resource constructors accept the following resource options:
- additionalSecretOutputs: specify properties that must be encrypted as secrets.
- aliases: specify aliases for this resource, so that renaming or refactoring doesn’t replace it.
- customTimeouts: override the default retry/timeout behavior for resource provisioning. The default value varies by resource.
- deleteBeforeReplace: override the default create-before-delete behavior when replacing a resource.
- deletedWith: If set, the provider’s Delete method will not be called for this resource if the specified resource is being deleted as well.
- dependsOn: specify additional explicit dependencies in addition to the ones in the dependency graph.
- ignoreChanges: declare that changes to certain properties should be ignored during a diff.
- import: bring an existing cloud resource into Pulumi.
- parent: establish a parent/child relationship between resources.
- protect: prevent accidental deletion of a resource by marking it as protected.
- provider: pass an explicitly configured provider, instead of using the default global provider.
- providers: pass a set of explicitly configured providers. These are used if provider is not given, and are passed to child resources.
- replaceOnChanges: declare that changes to certain properties should be treated as forcing a replacement.
- retainOnDelete: if true the resource will be retained in the backing cloud provider during a Pulumi delete operation.
- transformations: dynamically transform a resource’s properties on the fly. Prefer
transforms
if possible.transformations
will be deprecated in the future in favor oftransforms
. - transforms: dynamically transform a resource’s properties on the fly.
- version: pass a provider plugin version that should be used when operating on a resource.
Thank you for your feedback!
If you have a question about how to use Pulumi, reach out in Community Slack.
Open an issue on GitHub to report a problem or suggest an improvement.