调用内部函数Fn::FindInMap,返回Mappings中声明的双层映射中键(key)对应的值。
函数声明
JSON
{ "Fn::FindInMap": [ "MapName", "TopLevelKey", "SecondLevelKey" ] }
YAML
完整函数的语法。
Fn::FindInMap: - MapName - TopLevelKey - SecondLevelKey
缩写形式语法。
!FindInMap [MapName,TopLevelKey,SecondLevelKey]
参数信息
MapName
:Mappings中定义的合集名称。更多信息,请参见映射(Mappings)。TopLevelKey
:Map合集中嵌套的第一级键(key),其值是一个键值对列表。SecondLevelKey
:Map合集中嵌套的第二级键(key),其值是一个字符串或者数字。
返回值
返回SecondLevelKey中对应的值。
使用示例
当创建名为WebServer资源时,需要指定ImageId属性。您可以在Parameters中声明指定的区域,在Mappings中声明根据区域区分的ImageId映射。Fn::FindInMap会根据您指定的区域,在Map合集中查找对应的ImageId映射,然后在映射中获取对应的ImageId。
MapName
在本示例中为RegionMap
。TopLevelKey
设置为创建资源栈的区域,在本示例中通过! Ref regionParam
确定。更多信息,请参见Ref。SecondLevelKey
设置为所需的架构,在本示例中为"32"
。
ROSTemplateFormatVersion: '2015-09-01'
Parameters:
regionParam:
Description: 选择创建ECS的区域
Type: String
AllowedValues:
- hangzhou
- beijing
Mappings:
RegionMap:
hangzhou:
'32': m-25l0rcfjo
'64': m-25l0rcfj1
beijing:
'32': m-25l0rcfj2
'64': m-25l0rcfj3
Resources:
WebServer:
Type: ALIYUN::ECS::Instance
Properties:
ImageId: !FindInMap [RegionMap, !Ref regionParam, "32"]
InstanceType: ecs.t1.small
SecurityGroupId: sg-25zwc****
ZoneId: cn-beijing-b
Tags:
- Key: key1
Value: value1
- Key: key2
Value: value2
{
"ROSTemplateFormatVersion": "2015-09-01",
"Parameters": {
"regionParam": {
"Description": "选择创建ECS的区域",
"Type": "String",
"AllowedValues": [
"hangzhou",
"beijing"
]
}
},
"Mappings": {
"RegionMap": {
"hangzhou": {
"32": "m-25l0rcfjo",
"64": "m-25l0rcfj1"
},
"beijing": {
"32": "m-25l0rcfj2",
"64": "m-25l0rcfj3"
}
}
},
"Resources": {
"WebServer": {
"Type": "ALIYUN::ECS::Instance",
"Properties": {
"ImageId": {
"Fn::FindInMap": [
"RegionMap",
{
"Ref": "regionParam"
},
"32"
]
},
"InstanceType": "ecs.t1.small",
"SecurityGroupId": "sg-25zwc****",
"ZoneId": "cn-beijing-b",
"Tags": [
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": "value2"
}
]
}
}
}
}