All Products
Search
Document Center

Resource Orchestration Service:Fn::SelectMapList

Last Updated:Jun 17, 2026

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.