2018-05-12 18:39:29 +02:00
|
|
|
---
|
|
|
|
|
layout: "functions"
|
2018-12-20 05:35:11 +01:00
|
|
|
page_title: "merge - Functions - Configuration Language"
|
2018-05-12 18:39:29 +02:00
|
|
|
sidebar_current: "docs-funcs-collection-merge"
|
|
|
|
|
description: |-
|
|
|
|
|
The merge function takes an arbitrary number of maps and returns a single
|
|
|
|
|
map after merging the keys from each argument.
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# `merge` Function
|
|
|
|
|
|
2019-01-17 01:33:57 +01:00
|
|
|
-> **Note:** This page is about Terraform 0.12 and later. For Terraform 0.11 and
|
|
|
|
|
earlier, see
|
|
|
|
|
[0.11 Configuration Language: Interpolation Syntax](../../configuration-0-11/interpolation.html).
|
|
|
|
|
|
2018-05-12 18:39:29 +02:00
|
|
|
`merge` takes an arbitrary number of maps and returns a single map that
|
|
|
|
|
contains a merged set of elements from all of the maps.
|
|
|
|
|
|
|
|
|
|
If more than one given map defines the same key then the one that is later
|
|
|
|
|
in the argument sequence takes precedence.
|
|
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
> merge({"a"="b", "c"="d"}, {"e"="f", "c"="z"})
|
|
|
|
|
{
|
|
|
|
|
"a" = "b"
|
|
|
|
|
"c" = "z"
|
|
|
|
|
"e" = "f"
|
|
|
|
|
}
|
|
|
|
|
```
|
