全部产品
Search
文档中心

资源编排:Fn::Select

更新时间:Feb 02, 2024

调用内部函数Fn::Select,通过索引返回列表或字典中的数据。

函数声明

获取列表(数组)中的数据

根据索引获取单个数据

  • JSON

    {
      "Fn::Select": [
        "index",
        [
          "value1",
          "value2",
          ...
        ],
        "default_value"
      ]
    }
  • YAML

    • 完整函数名的语法。

      Fn::Select:
        - index
        - - value1
          - value2
          - ...
        - default_value
    • 缩写形式语法。

      !Select [index, [value1, value2, ...], default_value]

根据索引获取多个数据

  • JSON

    {
      "Fn::Select": [
        "start:stop:step",
        [
          "value1",
          "value2",
          ...
        ]
      ]
    }
  • YAML

    • 完整函数名的语法。

      Fn::Select:
        - start:stop:step
        - - value1
          - value2
          - ...
    • 缩写形式语法。

      !Select [start:stop:step, [value1, value2, ...]]

获取字典(映射表)某个键对应的值

  • JSON

    {
      "Fn::Select": [
        "key",
        {
          "key1": "value1",
          "key2": "value2",
          ...
        },
        "default_value"
      ]
    }
  • YAML

    • 完整函数名的语法。

      Fn::Select:
        - key
        - key1: value1
          key2: value2
          ...
        - default_value
    • 缩写形式语法。

      !Select [key, {key1:value1, key2:value2}, default_value]

参数信息

  • index:待检索数据的索引。索引是0到N-1之间或者-N到-1之间的某个值(其中N表示列表中元素的数量),负数表示从右往左第几个元素。当索引不在取值范围内,如果指定了默认值则返回默认值,如果未指定则返回空字符串。

  • startstopstep:根据指定的起始位置和终止位置获取列表中的元素,可以指定步长,即每隔step-1个元素取一个元素,最后返回一个列表。

    • start:stop:start、stop与index的取值要求相同,start不填时默认为0,stop不填时默认为N。返回列表中第start+1到第stop个元素组成的列表,如果二者取值不在取值范围内则返回空列表。

    • start:stop:step:step不填时默认为1,如果step为负数时,则start表示的元素索引应大于stop表示的元素索引,从第start个元素到第stop+1元素,每隔-step-1个元素取一个元素,返回一个列表。

  • key:字典中的某个键,返回键对应的值。当字典中不存在该键,如果指定了默认值则返回默认值,如果未指定默认值则返回空字符串。

  • default_value:index或key未命中时返回的默认值。如果未指定,则返回空字符串。

返回值

选定的数据。

使用示例

获取列表或数组中的值

  • !Select ['1', [apples, grapes, oranges, mangoes]] 
    {
      "Fn::Select": [
        "1",
        ["apples", "grapes", "oranges", "mangoes"]
      ]
    }

    返回值:grapes。

  • !Select ['1:3', [1,2,3,4,5]]
    {
      "Fn::Select": [
        "1:3",
        [1,2,3,4,5]
      ]
    }

    返回值:[2, 3]。

  • !Select ['::2', [1,2,3,4,5]]
    {
      "Fn::Select": [
        "::2",
        [1,2,3,4,5]
      ]
    }

    返回值:[1, 3, 5]。

  • !Select ['5:0:-2', [1,2,3,4,5]]
    {
      "Fn::Select": [
        "5:0:-2",
        [1,2,3,4,5]
      ]
    }

    返回值:[5, 3]。

获取字典某个键对应的值

!Select [key1, {key1: grapes, key2: mangoes}]
{
  "Fn:Select": [
    "key1",
    {
      "key1": "grapes",
      "key2": "mangoes"
    }
  ]
}

返回值:grapes。

如果数据元列表是一个CommaDelimitedList

Parameters:
  userParam:
    Type: CommaDelimitedList
    Default: 10.0.0.1, 10.0.0.2, 10.0.0.3
Resources:
  resourceID:
    Properties:
      CidrBlock:
        !Select:
          - '0'
          - !Ref userParam

返回值:10.0.0.1。

支持的函数

对于Fn::Select索引值,您可以使用Ref函数。

对于对象的Fn::Select列表,您可以使用以下函数。