AppResourceV3
ResourceV3 is the third version of the Resource API type. It absorbs a few breaking changes:
- It adds a map from input property names to the dependencies that affect that input property. This is used to improve the precision of delete-before-create operations.
- It adds a new boolean field,
PendingReplacement, that marks resources that have been deleted as part of a delete-before-create operation but have not yet been recreated. Migrating from ResourceV2 to ResourceV3 involves: - Populating the map from input property names to dependencies by assuming that every dependency listed in
Dependenciesaffects every input property.
Properties
urnstring requiredURN uniquely identifying this resource.customboolean requiredCustom is true when it is managed by a plugin.deleteboolean optionalDelete is true when the resource should be deleted during the next update.idstring optionalID is the provider-assigned resource, if any, for custom resources.typestring requiredType is the resource’s full type token.inputsmap[string]object optionalInputs are the input properties supplied to the provider.outputsmap[string]object optionalOutputs are the output properties returned by the provider after provisioning.parentstring optionalParent is an optional parent URN if this resource is a child of it.protectboolean optionalProtect is set to true when this resource is “protected” and may not be deleted.taintboolean optionalTaint is set to true when we wish to force it to be replaced upon the next update.externalboolean optionalExternal is set to true when the lifecycle of this resource is not managed by Pulumi.dependenciesarray[string] optionalDependencies contains the dependency edges to other resources that this depends on.initErrorsarray[string] optionalInitErrors is the set of errors encountered in the process of initializing resource (i.e., during create or update).providerstring optionalProvider is a reference to the provider that is associated with this resource.propertyDependenciesmap[string]array optionalPropertyDependencies maps from an input property name to the set of resources that property depends on.pendingReplacementboolean optionalPendingReplacement is used to track delete-before-replace resources that have been deleted but not yet recreated.additionalSecretOutputsarray[string] optionalAdditionalSecretOutputs is a list of outputs that were explicitly marked as secret when the resource was created.aliasesarray[string] optionalAliases is a list of previous URNs that this resource may have had in previous deployments.- CustomTimeouts is a configuration block that can be used to control timeouts of CRUD operations.
- ↳
createnumber optionalTimeout in seconds for resource creation operations. - ↳
updatenumber optionalTimeout in seconds for resource update operations. - ↳
deletenumber optionalTimeout in seconds for resource deletion operations. importIDstring optionalImportID is the import input used for imported resources.retainOnDeleteboolean optionalIf set to True, the providers Delete method will not be called for this resource. Pulumi simply stops tracking the deleted resource.deletedWithstring optionalIf set, the providers Delete method will not be called for this resource if specified resource is being deleted as well.replaceWitharray[string] optionalReplaceWith is a list of resources whose replaces will also trigger this resource’s replace.createdstring optionalCreated tracks when the remote resource was first added to state by pulumi. Checkpoints prior to early 2023 do not include this.modifiedstring optionalModified tracks when the resource state was last altered. Checkpoints prior to early 2023 do not include this.sourcePositionstring optionalSourcePosition tracks the source location of this resource’s registration- StackTrace records the stack at the time this resource was registered
- ↳
sourcePositionstring optionalSourcePosition contains the source position associated with the stack frame. ignoreChangesarray[string] optionalIgnoreChanges is a list of properties to ignore changes for.hideDiffarray[string] optionalHideDiff is a list of properties to hide the diff for.replaceOnChangesarray[string] optionalReplaceOnChanges is a list of properties that if changed trigger a replace.replacementTriggerobject optionalIf set, the engine will diff this with the last recorded value, and trigger a replace if they are not equal.refreshBeforeUpdateboolean optionalRefreshBeforeUpdate indicates that this resource should always be refreshed prior to updates.viewOfstring optionalViewOf is a reference to the resource that this resource is a view of.resourceHooksmap[string]array optionalResourceHooks is a map of hook types to lists of hook names for the given type.
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.