Fn::FindInMap - AWS CloudFormation
DeclaraciónParámetrosValor devueltoEjemplosFunciones compatiblesRecursos relacionados

Esta es la nueva Guía de referencia de plantillas de CloudFormation. Actualice sus marcadores y enlaces. Para obtener ayuda sobre cómo empezar a usar CloudFormation, consulte la Guía del usuario de AWS CloudFormation.

Fn::FindInMap

La función Fn::FindInMap intrínseca devuelve el valor correspondiente a claves en una asignación de dos niveles declarada en la sección Mappings.

Declaración

JSON

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

YAML

Sintaxis del nombre de función completo:

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

Sintaxis de la forma abreviada:

!FindInMap [ MapName, TopLevelKey, SecondLevelKey ]
nota

No puede anidar dos instancias de dos funciones de manera abreviada.

Parámetros

MapName

El nombre lógico de un mapeo declarado en la sección Mappings que contiene las claves y valores.

TopLevelKey

El nombre de clave de nivel superior. Su valor es una lista de pares clave-valor.

SecondLevelKey

El nombre de la clave de segundo nivel, que se ha establecido en una de las claves de la lista asignada a TopLevelKey.

Valor devuelto

El valor que se ha asignado a SecondLevelKey.

Ejemplos

Los siguientes ejemplos muestran cómo utilizar la función Fn::FindInMap.

Uso de Fn::FindInMap con valores específicos de la región

El siguiente ejemplo muestra cómo utilizar Fn::FindInMap en una plantilla que incluye dos asignaciones: AWSInstanceType2Arch y AWSRegionArch2AMI. También incluye un parámetro InstanceType que le permite elegir entre t3.micro y t4g.nano. El valor predeterminado es t3.micro, pero se puede anular durante la creación de la pila.

Fn::FindInMap primero determina la arquitectura (HVM64 o ARM64) en función del tipo de instancia seleccionado y, a continuación, busca el ID de AMI correcto para esa arquitectura en la Región de AWS actual.

nota

Los ID de AMI que se muestran en estos ejemplos son marcadores de posición con fines de demostración. Siempre que sea posible, considere la posibilidad de utilizar referencias dinámicas a los parámetros AWS Systems Manager como alternativa a la sección Mappings. Para evitar actualizar todas las plantillas con un nuevo ID cada vez que cambie la AMI que desea utilizar, utilice un parámetro AWS Systems Manager para obtener el último ID de AMI al crear o actualizar la pila. Las versiones más recientes de las AMI más utilizadas también están disponibles como parámetros públicos en Systems Manager. Para obtener más información, consulte Obtención de valores almacenados en otros servicios con referencias dinámicas.

JSON

{
  "AWSTemplateFormatVersion": "2010-09-09",
  "Parameters": {
    "InstanceType": {
      "Description": "The EC2 instance type",
      "Type": "String",
      "AllowedValues": [
        "t3.micro",
        "t4g.nano"
      ],
      "Default": "t3.micro"
    }
  },
  "Mappings": {
    "AWSInstanceType2Arch": {
      "t3.micro": {
        "Arch": "HVM64"
      },
      "t4g.nano": {
        "Arch": "ARM64"
      }
    },
    "AWSRegionArch2AMI": {
      "us-east-1" : { 
        "HVM64" : "ami-12345678901234567", "ARM64" : "ami-23456789012345678" 
      },
      "us-west-1" : { 
        "HVM64" : "ami-34567890123456789", "ARM64" : "ami-45678901234567890"
      },
      "eu-west-1" : { 
        "HVM64" : "ami-56789012345678901", "ARM64" : "ami-67890123456789012" 
      },
      "ap-southeast-1" : { 
        "HVM64" : "ami-78901234567890123", "ARM64" : "ami-89012345678901234" 
      },
      "ap-northeast-1" : { 
        "HVM64" : "ami-90123456789012345", "ARM64" : "ami-01234567890123456" 
      }
    }
  },
  "Resources" : {
    "MyEC2Instance" : {
      "Type" : "AWS::EC2::Instance",
      "Properties" : {
        "InstanceType" : { "Ref": "InstanceType" },
        "ImageId" : {
          "Fn::FindInMap" : [ "AWSRegionArch2AMI", { "Ref": "AWS::Region" }, { "Fn::FindInMap": [ "AWSInstanceType2Arch", { "Ref": "InstanceType" }, "Arch" ]}]
        }
      }
    }
  }
}

YAML

AWSTemplateFormatVersion: 2010-09-09
Parameters:
  InstanceType:
    Description: The EC2 instance type
    Type: String
    AllowedValues:
      - t3.micro
      - t4g.nano
    Default: t3.micro
Mappings: 
  AWSInstanceType2Arch:
    t3.micro:
      Arch: HVM64
    t4g.nano:
      Arch: ARM64
  AWSRegionArch2AMI:
    us-east-1: 
      HVM64: ami-12345678901234567
      ARM64: ami-23456789012345678
    us-west-1: 
      HVM64: ami-34567890123456789
      ARM64: ami-45678901234567890
    eu-west-1: 
      HVM64: ami-56789012345678901
      ARM64: ami-67890123456789012
    ap-southeast-1: 
      HVM64: ami-78901234567890123
      ARM64: ami-89012345678901234
    ap-northeast-1: 
      HVM64: ami-90123456789012345
      ARM64: ami-01234567890123456
Resources: 
  myEC2Instance: 
    Type: AWS::EC2::Instance
    Properties:
      InstanceType: !Ref InstanceType
      ImageId:
        Fn::FindInMap:
        - AWSRegionArch2AMI
        - Ref: AWS::Region
        - Fn::FindInMap:
          - AWSInstanceType2Arch
          - Ref: InstanceType
          - Arch

Uso de Fn::FindInMap para configuraciones específicas del entorno

El siguiente ejemplo muestra cómo utilizar Fn::FindInMap para una plantilla con una sección Mappings que contiene una única asignación, SecurityGroups. También contiene un parámetro EnvironmentType que le permite especificar si el entorno es Dev o Prod. Su valor predeterminado es Dev, pero se puede anular durante la creación de la pila.

Fn::FindInMap devuelve los SecurityGroupIds apropiados en función del parámetro EnvironmentType. A continuación, Fn::Split divide la cadena separada por comas de los identificadores de los grupos de seguridad en una lista, que es el formato esperado para SecurityGroupIds.

Si implementa esta pila con EnvironmentType establecido en Dev, el valor de SecurityGroupIds para EC2Instance será sg-12345678. Si establece EnvironmentType en Prod, usará sg-abcdef01 y sg-ghijkl23.

JSON

{
  "AWSTemplateFormatVersion": "2010-09-09",
  "Parameters":{
    "EnvironmentType":{
      "Description":"The environment type (Dev or Prod)",
      "Type":"String",
      "Default":"Dev",
      "AllowedValues":[
        "Dev",
        "Prod"
      ]
    }
  },
  "Mappings":{
    "SecurityGroups":{
      "Dev":{
        "SecurityGroupIds":"sg-12345678"
      },
      "Prod":{
        "SecurityGroupIds":"sg-abcdef01,sg-ghijkl23"
      }
    }
  },
  "Resources":{
    "Ec2Instance":{
      "Type":"AWS::EC2::Instance",
      "Properties":{
        "ImageId": "{{resolve:ssm:/aws/service/ami-amazon-linux-latest/al2023-ami-kernel-6.1-x86_64}}",
        "InstanceType": "t2.micro",
        "SecurityGroupIds":{
          "Fn::Split":[
            ",",
            {
              "Fn::FindInMap":[
                "SecurityGroups",
                {
                  "Ref":"EnvironmentType"
                },
                "SecurityGroupIds"
              ]
            }
          ]
        }
      }
    }
  }
}

YAML

AWSTemplateFormatVersion: 2010-09-09
Parameters:
  EnvironmentType:
    Description: The environment type (Dev or Prod)
    Type: String
    Default: Dev
    AllowedValues:
      - Dev
      - Prod
Mappings:
  SecurityGroups:
    Dev:
      SecurityGroupIds: sg-12345678
    Prod:
      SecurityGroupIds: sg-abcdef01,sg-ghijkl23
Resources:
  Ec2Instance:
    Type: AWS::EC2::Instance
    Properties:
      ImageId: '{{resolve:ssm:/aws/service/ami-amazon-linux-latest/al2023-ami-kernel-6.1-x86_64}}'
      InstanceType: t2.micro
      SecurityGroupIds:
        Fn::Split:
          - ","
          - Fn::FindInMap: [ SecurityGroups, !Ref EnvironmentType, SecurityGroupIds ]

Funciones compatibles

Puede utilizar las siguientes funciones en una función Fn::FindInMap:

  • Fn::FindInMap

  • Ref

Recursos relacionados

Para usar otras funciones intrínsecas o un valor predeterminado en una función Fn::FindInMap, debe declarar la transformación AWS::LanguageExtensions en su plantilla. Para obtener más información, consulte Fn::FindInMap enhancements.

Estos temas relacionados pueden resultarle útiles a la hora de desarrollar plantillas que utilicen la función Fn::FindInMap.