調用內建函式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 字元串。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
:字典中的某個鍵,返回鍵對應的值。當字典中不存在該鍵,如果指定了預設值則返回預設值,如果未指定預設值則返回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列表,您可以使用以下函數。