2018-06-02 03:56:34 +02:00
|
|
|
---
|
|
|
|
|
layout: "functions"
|
2018-12-20 05:35:11 +01:00
|
|
|
page_title: "lookup - Functions - Configuration Language"
|
2018-06-02 03:56:34 +02:00
|
|
|
sidebar_current: "docs-funcs-collection-lookup"
|
|
|
|
|
description: |-
|
|
|
|
|
The lookup function retrieves an element value from a map given its key.
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# `lookup` 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-06-02 03:56:34 +02:00
|
|
|
`lookup` retrieves the value of a single element from a map, given its key.
|
|
|
|
|
If the given key does not exist, a the given default value is returned instead.
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
lookup(map, key, default)
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
-> For historical reasons, the `default` parameter is actually optional. However,
|
|
|
|
|
omitting `default` is deprecated since v0.7 because that would then be
|
|
|
|
|
equivalent to the native index syntax, `map[key]`.
|
|
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
> lookup({a="ay", b="bee"}, "a", "what?")
|
|
|
|
|
ay
|
|
|
|
|
> lookup({a="ay", b="bee"}, "c", "what?")
|
|
|
|
|
what?
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Related Functions
|
|
|
|
|
|
|
|
|
|
* [`element`](./element.html) retrieves a value from a _list_ given its _index_.
|
