Fn::ForEach - AWS CloudFormation
Pernyataan ParameterNilai yang dikembalikanFungsi yang didukungContoh

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

Fn::ForEach

Fungsi Fn::ForEach intrinsik mengambil koleksi dan fragmen, dan menerapkan item dalam koleksi ke pengidentifikasi di fragmen yang disediakan. Fn::ForEachdapat berisi fungsi intrinsik lainnya, termasuk Fn::ForEach dirinya sendiri, dan digunakan dalamConditions,Outputs, Resources (termasuk properti sumber daya) bagian. Itu tidak dapat digunakan diVersi format,Description,Metadata,Transform,Parameters,Mappings,Rules, atau Hooks bagian. Sebagai contoh, lihat Contoh.

penting

Anda harus menggunakan Tansformasi AWS::LanguageExtensions untuk menggunakan fungsi Fn::ForEach intrinsik.

penting

Menggunakan fungsi Fn::ForEach intrinsik tidak mengubah kuota, yang berlaku untuk template yang dihasilkan. Kuota mencakup ukuran maksimum template dan jumlah maksimum sumber daya dalam template. Untuk informasi selengkapnya, lihat Memahami CloudFormation kuota.

Pernyataan

JSON

"Fn::ForEach::UniqueLoopName": [
  "Identifier",
  ["Value1","Value2"], // Collection
  {"OutputKey": {OutputValue}}
]

YAML

'Fn::ForEach::UniqueLoopName':
    - Identifier
    - - Value1 # Collection
      - Value2
    - 'OutputKey':
        OutputValue

Parameter

UniqueLoopName

Nama untuk loop ini. Nama harus unik dalam template dan tidak dapat bertentangan dengan nilai ID logis di CloudFormation Template Resources sintaksis bagian template. Nama ini tidak ada dalam output yang diubah.

Identifier

Pengidentifikasi yang ingin Anda ganti dalam OutputKey dan OutputValue parameter yang mewakili fragmen template yang direplikasi. Semua contoh${Identifier}, atau&{Identifier}, dalam OutputValue parameter OutputKey dan diganti dengan nilai-nilai dari Collection parameter.

Collection

Kumpulan nilai untuk diulang. Ini bisa berupa array dalam parameter ini, atau bisa juga Ref ke aCommaDelimitedList. Saat menggunakan&{Identifier}, karakter non-alfanumerik dapat diteruskan di. Collection

OutputKey

Kunci dalam template yang diubah. ${Identifier}atau &{Identifier} harus dimasukkan dalam OutputKey parameter. Misalnya, jika Fn::ForEach digunakan di Resources bagian template, ini adalah Id logis dari setiap sumber daya.

&{}Sintaks memungkinkan karakter non-alfanumerik dalam Collection untuk digunakan dalam parameter. OutputKey Untuk contoh ini, lihatMelewati karakter non-alfanumerik dalam for CollectionFn::ForEach.

OutputValue

Nilai yang direplikasi dalam template yang diubah untuk setiap item dalam Collection parameter. Misalnya, jika Fn::ForEach digunakan di Resources bagian template, ini adalah fragmen template yang diulang untuk mengkonfigurasi setiap sumber daya.

Nilai yang dikembalikan

Objek yang diperluas yang berisi fragmen objek diulang sekali untuk setiap item dalam koleksi, di mana pengidentifikasi dalam fragmen diganti dengan item dari koleksi.

Fungsi yang didukung

Anda dapat menggunakan fungsi-fungsi berikut di dalamnyaFn::ForEach.

Contoh

Sebagai contoh, lihat Contoh.