External DocumentationTo learn more, visit the Terraform Cloud documentation.
Parameters
| Parameter | Description |
|---|---|
| Allow Empty Apply | Specifies whether Terraform can apply the run even when the plan contains no changes. Often used to upgrade state after upgrading a workspace to a new terraform version. |
| Auto Apply | Whether to automatically apply changes when a Terraform plan is successful. |
| Configuration Version ID | Specifies the configuration version to use for this run. If the configuration-version object is omitted (left empty), the run will be created using the workspace’s latest configuration version. |
| Message | Specifies the message associated with this run. |
| Plan-Only | Specifies if this is a speculative, plan-only run that Terraform cannot apply. Often used in conjunction with terraform-version in order to test whether an upgrade would succeed. |
| Refresh | Whether or not to refresh the state before a plan. |
| Replace Addresses | Specifies an optional list of resource addresses to be passed to the -replace flag. Of the form array[string]. |
| Target Addresses | Specifies an optional list of resource addresses to be passed to the -target flag. Of the form array[string]. |
| Terraform Version | Specifies the Terraform version to use in this run. Only valid for plan-only runs; must be a valid Terraform version available to the organization. |
| Type | Specifies if this plan is a destroy plan that will destroy all provisioned resources, a refresh-only plan which should refresh the state without modifying any resources or neither. |
| Variables | Specifies an optional list of run-specific variable values. Refer to Run-Specific Variables for details. Of the form array[{key, value}] e.g. |
| Workspace ID | Specifies the workspace ID where the run will be executed. |
Workflow Library Example
Create a Run with Terraform Cloud and Send Results Via Email