docs: Explicitly mention Computed-only attribute behavior for Proposed New State

Reference: 21bb677db7/internal/plans/objchange/objchange.go (L289-L292)

Previously, the resource lifecycle documentation for Proposed New State only mentioned special behavior for Optional and Computed attributes. This minor documentation update mentions that Terraform also imposes special behavior on Computed-only attributes (preserving any Prior State value).
This commit is contained in:
Brian Flad
2023-01-10 14:50:02 -05:00
parent 21bb677db7
commit 0b8c65fa4e

View File

@@ -33,9 +33,11 @@ The various object values used in different parts of this process are:
which a provider may use as a starting point for its planning operation. which a provider may use as a starting point for its planning operation.
The built-in logic primarily deals with the expected behavior for attributes The built-in logic primarily deals with the expected behavior for attributes
marked in the schema as both "optional" _and_ "computed", which means that marked in the schema as "computed". If an attribute is only "computed",
the user may either set it or may leave it unset to allow the provider Terraform expects the value to only be chosen by the provider and it will
to choose a value instead. preserve any Prior State. If an attribute is marked as "computed" and
"optional", this means that the user may either set it or may leave it
unset to allow the provider to choose a value.
Terraform Core therefore constructs the proposed new state by taking the Terraform Core therefore constructs the proposed new state by taking the
attribute value from Configuration if it is non-null, and then using the attribute value from Configuration if it is non-null, and then using the