The built-in function Fn::SelectMapList returns values from a list of maps by using a 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 that you want to use to query values from a list of maps.key1: value1-1, key3: value1-3, ...: the list of maps from which you want to query values.
Return value
The values that consist of the value queried from each map in the list by using the key.
Examples
!SelectMapList
- key2
- - key1: value1-1
key3: value1-3
- key1: value2-1
key2: value2-2
- key1: value3-1
key2: value3-2In this example, [value2-2, value3-2] is returned.