You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
page_title: terraform.applying reference - Functions - Configuration Language
3
-
description: |-
4
-
The terraform.applying symbol enables you to determine if Terraform is currently running an apply operation.
2
+
page_title: terraform.applying reference - Functions - Configuration Language
3
+
description: |-
4
+
The terraform.applying symbol enables you to determine if Terraform is currently running an apply operation.
5
5
---
6
6
7
7
# The `terraform.applying` symbol
@@ -12,23 +12,33 @@ You can use the `terraform.applying` symbol in your configuration to determine i
12
12
13
13
Terraform automatically sets `terraform.applying` to `true` when you run an [apply](/terraform/cli/commands/apply) operation, and `false` during any other operation. The [planning mode](/terraform/cli/commands/plan#planning-modes) you run `terraform apply` in does not affect `terraform.applying`, meaning that even in destroy mode, `terraform.applying` is still `true`.
14
14
15
-
A common example of where `terraform.applying`can be helpful is when you want to use different credentials if Terraform is either planning or applying.
15
+
You can use `terraform.applying`to change Terraform behavior during apply operations. In the following example, Terraform uses your read-only credentials when running a plan operation but uses your write credentials when you run an apply operation:
The `terraform.applying` symbol is an ephemeral value, meaning it is only available during Terraform operations and Terraform does not write this value to plan or state files. Additionally, you can only reference `terraform.applying` in ephemeral contexts:
29
35
30
-
* In a [write-only argument](/terraform/language/resources/ephemeral/write-only)
31
-
* In [ephemeral variables](/terraform/language/values/variables#exclude-values-from-state)
32
-
* In [local values](/terraform/language/values/locals#ephemeral-values)
33
-
* In [ephemeral resources](/terraform/language/resources/ephemeral)
34
-
* In [ephemeral outputs](/terraform/language/values/outputs#ephemeral-avoid-storing-values-in-state-or-plan-files)
36
+
The `terraform.applying` symbol is an ephemeral value and is only available during Terraform operations. Terraform does not write ephemeral values to plan or state files. Additionally, you can only reference `terraform.applying` in the following ephemeral contexts:
37
+
38
+
- In a [write-only argument](/terraform/language/resources/ephemeral/write-only)
39
+
- In [ephemeral variables](/terraform/language/values/variables#exclude-values-from-state)
40
+
- In [local values](/terraform/language/values/locals#ephemeral-values)
41
+
- In [ephemeral resources](/terraform/language/resources/ephemeral)
42
+
- In [ephemeral outputs](/terraform/language/values/outputs#ephemeral-avoid-storing-values-in-state-or-plan-files)
43
+
- Configuring providers in the `provider` block
44
+
- In [provisioner](/terraform/language/resources/provisioners/syntax) and [connection](/terraform/language/resources/provisioners/connection) blocks
0 commit comments