1.6 KiB
| layout | page_title | sidebar_current |
|---|---|---|
| docs | Interpolation Syntax | docs-config-interpolation |
Interpolation Syntax
Embedded within strings in Terraform, whether you're using the
Terraform syntax or JSON syntax, you can interpolate other values
into strings. These interpolations are wrapped in ${}, such as
${var.foo}.
The interpolation syntax is powerful and allows you to reference variables, attributes of resources, call functions, etc.
To reference variables, use the var. prefix followed by the
variable name. For example, ${var.foo} will interpolate the
foo variable value. If the variable is a mapping, then you
can reference static keys in the map with the syntax
var.MAP.KEY. For example, ${var.amis.us-east-1} would
get the value of the us-east-1 key within the amis variable
that is a mapping.
To reference attributes of other resources, the syntax is
TYPE.NAME.ATTRIBUTE. For example, ${aws_instance.web.id}
will interpolate the ID attribute from the "aws_instance"
resource named "web".
Finally, Terraform ships with built-in functions. Functions
are called with the syntax name(arg, arg2, ...). For example,
to read a file: ${file("path.txt")}. The built-in functions
are documented below.
Built-in Functions
The supported built-in functions are:
-
concat(args...)- Concatenates the values of multiple arguments into a single string. -
file(path)- Reads the contents of a file into the string. Variables in this file are not interpolated. The contents of the file are read as-is. -
lookup(map, key)- Performs a dynamic lookup into a mapping variable.