pulumi_gcp.organizations.Project has a new undocumented parameter deletion_policy

[aaron-tillekeratne]

Describe what happened

Looks like pulumi_gcp.organizations.Project's deletion_policy parameter is undocumented.

See https://www.pulumi.com/registry/packages/gcp/api-docs/organizations/project/#state_deletion_policy_python

Sample program

import pulumi
import pulumi_gcp as gcp

project = gcp.organizations.Project("foo", project_id="bar", deletion_policy="WHAT GOES HERE?")

Log output

No response

Affected Resource(s)

pulumi_gcp.organizations.Project

Output of pulumi about

Not required as this is documentation

Additional context

No response

Contributing

Vote on this issue by adding a 👍 reaction.
To contribute a fix for this issue, leave a comment (and link to your pull request, if you've opened one already).

[guineveresaenger]

Hi @aaron-tillekeratne - thank you for making us aware of the missing documentation. We're sorry that you're running into these issues.

For quick reference, the constructor example shows the type of this field to be a string and according to the upstream documentation, possible values are: "PREVENT", "ABANDON", "DELETE". Default value is PREVENT.

Unfortunately, this is an example of a common limitation in our docs generator.

While we have workarounds, and may choose to employ one in this case, we're also in the situation where we need to reconsider our global approach. We'll update this issue as soon as we have a plan.