Todos os produtos
Search

Este produto

    Resource Orchestration Service:Fn::FindInMap

    Central de documentação

    Resource Orchestration Service:Fn::FindInMap

    Última atualização: Jun 27, 2026

    A função Fn::FindInMap retorna o valor correspondente às chaves em um mapeamento de dois níveis declarado na seção Mappings.

    Declaração

    • JSON

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

    • YAML

      • Sintaxe do nome completo da função:

        Fn::FindInMap:
  - MapName
  - TopLevelKey
  - SecondLevelKey

      • Sintaxe da forma abreviada:

        !FindInMap [MapName,TopLevelKey,SecondLevelKey]

    Parâmetros

    • MapName: nome do mapeamento declarado na seção Mappings. Para mais informações, consulte Mappings.

    • TopLevelKey: chave de nível superior. O valor consiste em pares chave-valor.

    • SecondLevelKey: chave de segundo nível. O valor é uma string ou um número.

    Valor de retorno

    O valor atribuído a SecondLevelKey.

    Exemplos

    O exemplo a seguir define a propriedade ImageId do recurso WebServer. Ele usa regionParam na seção Parameters para especificar regiões e RegionMap na seção Mappings para associar cada região a um ImageId. A função Fn::FindInMap busca o ImageId no RegionMap com base na região especificada.

    • O parâmetro MapName está definido como RegionMap.

    • O parâmetro TopLevelKey corresponde à região onde a pilha é criada. Neste exemplo, o parâmetro é determinado por ! Ref regionParam. Para mais informações, consulte Ref.

    • O parâmetro SecondLevelKey indica a arquitetura desejada. Neste exemplo, usa-se "32".

    ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  regionParam:
    Description: the region where you want to create the ECS instance
    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": "the region where you want to create the ECS instance",
      "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"
          }
        ]
      }
    }
  }
}

    Funções compatíveis