阿里云资源编排Fn::FindInMap函数_资源编排(ROS)-阿里云帮助中心

调用内部函数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"。

YAML

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

JSON

{
  "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"
          }
        ]
      }
    }
  }
}

函数声明

参数信息

返回值

使用示例

支持的函数