AWS CloudFormation
用户指南 (API 版本 2010-05-15)

Fn::FindInMap

内部函数 Fn::FindInMap 返回与 Mappings 部分声明的双层映射中的键对应的值。

声明

JSON

{ "Fn::FindInMap" : [ "MapName", "TopLevelKey", "SecondLevelKey"] }

YAML

完整函数名称的语法:

Fn::FindInMap: [ MapName, TopLevelKey, SecondLevelKey ]

短格式的语法:

!FindInMap [ MapName, TopLevelKey, SecondLevelKey ]

注意

您无法以简短形式嵌套两个函数的两个实例。

参数

MapName

Mappings 部分中所声明映射的逻辑名称,包含密钥和值。

TopLevelKey

顶层密钥名称。其值是一个键值对列表。

SecondLevelKey

第二层密钥的名称,设置为分配给 TopLevelKey 的列表中的其中一个密钥。

返回值:

分配给 SecondLevelKey 的值。

示例

以下示例显示了如何在具有以下特征的模板中使用 Fn::FindInMap:具有包含单一映射 MappingsRegionMap 部分,该映射将 AMI 与 AWS 地区关联起来。

  • 该映射具有 5 个对应多个 AWS 地区的顶层密钥。

  • 每个顶层密钥都分配有一个包含两个第二层密钥的列表,这两个密钥是 "HVM64""HVMG2",与 AMI 的结构相对应。

  • 每个第二层密钥都分配有一个适当的 AMI 名称。

该示例模板包含由 AWS::EC2::Instance 函数设置 ImageId 属性的 FindInMap 资源。

MapName 设置为所需的映射,在该示例中为 "RegionMap"TopLevelKey 设置为创建堆栈的区域,这是使用 "AWS::Region" 伪参数确定的。SecondLevelKey 设置为所需的架构,在该示例中为"HVM64"

FindInMap 将返回分配给 FindInMap 的 AMI。对于 us-east-1 中的 HVM64 实例,FindInMap 将返回 "ami-0ff8a91507f77f867"

JSON

{ ... "Mappings" : { "RegionMap" : { "us-east-1" : { "HVM64" : "ami-0ff8a91507f77f867", "HVMG2" : "ami-0a584ac55a7631c0c" }, "us-west-1" : { "HVM64" : "ami-0bdb828fd58c52235", "HVMG2" : "ami-066ee5fd4a9ef77f1" }, "eu-west-1" : { "HVM64" : "ami-047bb4163c506cd98", "HVMG2" : "ami-0a7c483d527806435" }, "ap-southeast-1" : { "HVM64" : "ami-08569b978cc4dfa10", "HVMG2" : "ami-0be9df32ae9f92309" }, "ap-northeast-1" : { "HVM64" : "ami-06cd52961ce9f0d85", "HVMG2" : "ami-053cdd503598e4a9d" } } }, "Resources" : { "myEC2Instance" : { "Type" : "AWS::EC2::Instance", "Properties" : { "ImageId" : { "Fn::FindInMap" : [ "RegionMap", { "Ref" : "AWS::Region" }, "HVM64" ] }, "InstanceType" : "m1.small" } } } }

YAML

Mappings: RegionMap: us-east-1: HVM64: "ami-0ff8a91507f77f867" HVMG2: "ami-0a584ac55a7631c0c" us-west-1: HVM64: "ami-0bdb828fd58c52235" HVMG2: "ami-066ee5fd4a9ef77f1" eu-west-1: HVM64: "ami-047bb4163c506cd98" HVMG2: "ami-31c2f645" ap-southeast-1: HVM64: "ami-08569b978cc4dfa10" HVMG2: "ami-0be9df32ae9f92309" ap-northeast-1: HVM64: "ami-06cd52961ce9f0d85" HVMG2: "ami-053cdd503598e4a9d" Resources: myEC2Instance: Type: "AWS::EC2::Instance" Properties: ImageId: !FindInMap - RegionMap - !Ref 'AWS::Region' - HVM64 InstanceType: m1.small

支持的函数

您可以在 Fn::FindInMap 函数中使用以下函数:

  • Fn::FindInMap

  • Ref