Terraform
lookup Function
⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️
[!IMPORTANT]
Documentation Update: Product documentation previously located in/website
has moved to thehashicorp/web-unified-docs
repository, where all product documentation is now centralized. Please make contributions directly toweb-unified-docs
, since changes to/website
in this repository will not appear on developer.hashicorp.com. ⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️⚠️
lookup
retrieves the value of a single element from a map, given its key.
If the given key does not exist, 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
retrieves a value from a list given its index.