全部產品
Search
文件中心

Resource Orchestration Service:Fn::Select

更新時間:Jun 19, 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表示列表中元素的數量),負數表示從右往左第幾個元素。當索引不在取值範圍內,如果指定了預設值則返回預設值,如果未指定則返回Null 字元串。

  • 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:字典中的某個鍵,返回鍵對應的值。當字典中不存在該鍵,如果指定了預設值則返回預設值,如果未指定預設值則返回Null 字元串。

  • default_value:index或key未命中時返回的預設值。如果未指定,則返回Null 字元串。

傳回值

選定的資料。

使用樣本

擷取列表或數組中的值

  • !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列表,您可以使用以下函數。