terraform/website/docs/configuration/functions/list.html.md

layout	page_title	sidebar_current	description
functions	list - Functions - Configuration Language	docs-funcs-collection-list	The list function constructs a list from some given elements.

list Function

-> Note: This page is about Terraform 0.12 and later. For Terraform 0.11 and earlier, see 0.11 Configuration Language: Interpolation Syntax.

~> This function is deprecated. From Terraform v0.12, the Terraform language has built-in syntax for creating lists using the [ and ] delimiters. Use the built-in syntax instead. The list function will be removed in a future version of Terraform.

list takes an arbitrary number of arguments and returns a list containing those values in the same order.

Examples

> list("a", "b", "c")
[
  "a",
  "b",
  "c",
]

Do not use the above form in Terraform v0.12 or above. Instead, use the built-in list construction syntax, which achieves the same result:

> ["a", "b", "c"]
[
  "a",
  "b",
  "c",
]

Related Functions

• tolist converts a set value to a list.