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

layout	page_title	sidebar_current	description
language	setunion - Functions - Configuration Language	docs-funcs-collection-setunion	The setunion function takes multiple sets and produces a single set containing the elements from all of the given sets.

setunion Function

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

The setunion function takes multiple sets and produces a single set containing the elements from all of the given sets. In other words, it computes the union of the sets.

setunion(sets...)

Examples

> setunion(["a", "b"], ["b", "c"], ["d"])
[
  "d",
  "b",
  "c",
  "a",
]

The given arguments are converted to sets, so the result is also a set and the ordering of the given elements is not preserved.

Related Functions

• contains tests whether a given list or set contains a given element value.
• setintersection computes the intersection of multiple sets.
• setproduct computes the Cartesian product of multiple sets.
• setsubtract computes the relative complement of two sets