View a markdown version of this page

Fn:: perangkat tambahan FindInMap - AWS CloudFormation
PernyataanParameterContohFungsi yang didukungSumber daya terkait

Ini adalah Panduan Referensi CloudFormation Template baru. Harap perbarui bookmark dan tautan Anda. Untuk bantuan memulai CloudFormation, lihat Panduan AWS CloudFormation Pengguna.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Fn:: perangkat tambahan FindInMap

AWS::LanguageExtensionsTransformasi meningkatkan fungsionalitas fungsi Fn::FindInMap intrinsik dalam template. CloudFormation

Fn::FindInMapFungsi standar hanya mendukung Fn::FindInMap dan Ref sebagai fungsi intrinsik bersarang. AWS::LanguageExtensionsTransformasi menghilangkan batasan ini, memungkinkan Anda untuk menggunakan berbagai fungsi intrinsik yang lebih luas untuk menentukan parameter. Fn::FindInMap

catatan

DefaultValueParameter untuk Fn::FindInMap tidak lagi membutuhkan AWS::LanguageExtensions transformasi. Anda dapat menggunakan DefaultValue dalam CloudFormation template apa pun. Untuk informasi selengkapnya, lihat Fn:: FindInMap.

Pernyataan

JSON

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

Jika Anda ingin menentukan nilai fallback ketika kunci tidak ditemukan dalam pemetaan, sertakan: DefaultValue

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

YAML

Sintaks untuk nama fungsi penuh:

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

Sintaks untuk bentuk pendek:

!FindInMap [ MapName, TopLevelKey, SecondLevelKey ]

Jika Anda ingin menentukan nilai fallback ketika kunci tidak ditemukan dalam pemetaan, sertakan: DefaultValue

Sintaks untuk nama fungsi penuh:

Fn::FindInMap:
  - MapName
  - TopLevelKey
  - SecondLevelKey
  - DefaultValue: DefaultValue

Sintaks untuk bentuk pendek:

!FindInMap
  - MapName
  - TopLevelKey
  - SecondLevelKey
  - DefaultValue: DefaultValue

Parameter

Dengan AWS::LanguageExtensions transformasi, parameterMapName,, TopLevelKeySecondLevelKey, dan masing-masing DefaultValue dapat menjadi fungsi intrinsik, asalkan menyelesaikan ke nilai yang valid selama transformasi.

Contoh

Contoh berikut menunjukkan cara menggunakan fungsi intrinsik dalam parameter Fn::FindInMap saat Anda menambahkan transformasi. AWS::LanguageExtensions

Menggunakan fungsi intrinsik untuk menentukan kunci tingkat atas

Berikut ini adalah contoh menggunakan fungsi dengan Fn::Select dan Fn::FindInMap fungsi Fn::Split intrinsik tertanam di dalamnya untuk menentukan kunci tingkat atas.

JSON

{
  //...
  "Transform": "AWS::LanguageExtensions",
  //...
      "Fn::FindInMap": [
        "MyMap",
        {
          "Fn::Select": [
            0,
            {
              "Fn::Split": [
                "|",
                { "Ref": "InputKeys" }
              ]
            }
          ]
        },
        "SecondKey"
      ]
//...
}

YAML

Transform: 'AWS::LanguageExtensions'
#...
    !FindInMap: [MyMap, !Select [0, !Split [|, !Ref InputKeys]], SecondKey]
#...

Fungsi yang didukung

Anda dapat menggunakan fungsi-fungsi berikut dalam parameter Fn::FindInMap dengan AWS::LanguageExtensions transformasi:

Sumber daya terkait

Untuk informasi lebih lanjut dan contoh yang menunjukkan cara menggunakan fungsi Fn::FindInMap intrinsik, termasuk DefaultValue parameter, lihat. Fn:: FindInMap

Untuk informasi lebih lanjut tentang AWS::LanguageExtensions transformasi, lihatTansformasi AWS::LanguageExtensions.