阿里云资源编排Fn::Select函数 - 资源编排

调用内部函数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表示列表中元素的数量），负数表示从右往左第几个元素。当索引不在取值范围内，如果指定了默认值则返回默认值，如果未指定则返回空字符串。
start、stop和step：根据指定的起始位置和终止位置获取列表中的元素，可以指定步长，即每隔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未命中时返回的默认值。如果未指定，则返回空字符串。

返回值

选定的数据。

使用示例

获取列表或数组中的值

YAML

!Select ['1', [apples, grapes, oranges, mangoes]]

JSON

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

返回值：grapes。

YAML

!Select ['1:3', [1,2,3,4,5]]

JSON

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

返回值：[2, 3]。

YAML

!Select ['::2', [1,2,3,4,5]]

JSON

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

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

YAML

!Select ['5:0:-2', [1,2,3,4,5]]

JSON

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

返回值：[5, 3]。

获取字典某个键对应的值

YAML

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

JSON

{
  "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列表，您可以使用以下函数。