Fn::SelectMapList returns a list of values extracted from a list of maps by using a specified key.
Declaration
-
JSON
{ "Fn::SelectMapList": [ "key2", [ { "key1": "value1-1", "key3": "value1-3" }, { "key1": "value2-1", "key2": "value2-2" }, { "key1": "value3-1", "key2": "value3-2" } ] ] } -
YAML
-
Syntax for the full function name:
Fn::SelectMapList: - key2 - - key1: value1-1 key3: value1-3 - key1: value2-1 key2: value2-2 - key1: value3-1 key2: value3-2 - ... -
Syntax for the short form:
!SelectMapList - key2 - - key1: value1-1 key3: value1-3 - key1: value2-1 key2: value2-2 - key1: value3-1 key2: value3-2 - ...
-
Parameters
-
key2: the key used to extract values from each map in the list. -
key1: value1-1, key3: value1-3, ...: the list of maps from which values are extracted.
Return value
A list of values, each extracted from the corresponding map by using the specified key.
Examples
!SelectMapList
- key2
- - key1: value1-1
key3: value1-3
- key1: value2-1
key2: value2-2
- key1: value3-1
key2: value3-2
In this example, [value2-2, value3-2] is returned.