All Products
Search
Document Center

Resource Orchestration Service:Fn::SelectMapList

Last Updated:Mar 15, 2024

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-2

In this example, [value2-2, value3-2] is returned.