Ini adalah *Panduan Referensi CloudFormation Template* baru. Harap perbarui bookmark dan tautan Anda. Untuk bantuan memulai CloudFormation, lihat [Panduan AWS CloudFormation Pengguna](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

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

# `Fn::ForEach`
<a name="intrinsic-function-reference-foreach"></a>

Fungsi `Fn::ForEach` intrinsik mengambil koleksi dan fragmen, dan menerapkan item dalam koleksi ke pengidentifikasi di fragmen yang disediakan. `Fn::ForEach`dapat berisi fungsi intrinsik lainnya, termasuk `Fn::ForEach` dirinya sendiri, dan digunakan dalam bagian`Conditions`,`Outputs`, dan `Resources` (termasuk properti sumber daya). Ini tidak dapat digunakan di salah satu bagian berikut, `AWSTemplateFormatVersion``Description`,`Metadata`,`Transform`,`Parameters`, `Mappings``Rules`, atau `Hooks` bagian.

Jika Anda menggunakan fungsi `Fn::ForEach` intrinsik dalam template Anda, Anda juga harus menggunakan. [Tansformasi `AWS::LanguageExtensions`](transform-aws-languageextensions.md)

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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cloudformation-limits.html) di *Panduan AWS CloudFormation Pengguna*.

## Pernyataan
<a name="intrinsic-function-reference-foreach-declaration"></a>

### JSON
<a name="intrinsic-function-reference-foreach-declaration.json"></a>

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

### YAML
<a name="intrinsic-function-reference-foreach-declaration.yaml"></a>

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

## Parameter
<a name="intrinsic-function-reference-foreach-parameters"></a>

*Loop nama logis*  
ID logis untuk loop. Nama harus unik dalam template dan tidak dapat bertentangan dengan nilai ID logis di `Resources` bagian template. Nama ini tidak ada dalam output yang diubah. Ini digunakan untuk referensi internal dalam CloudFormation template itu sendiri.

*Pengidentifikasi*  
Pengidentifikasi untuk placeholder yang diganti dalam parameter dan`OutputKey`. `OutputValue` Semua contoh `${Identifier}` atau `&{Identifier}` dalam `OutputValue` parameter `OutputKey` dan akan diganti dengan nilai dari `Collection` parameter.

*Koleksi*  
Kumpulan nilai untuk diulang. Ini bisa berupa array dalam parameter ini, atau bisa juga [`Ref`](intrinsic-function-reference-ref.md) ke a`CommaDelimitedList`. Saat menggunakan`&{Identifier}`, karakter non-alfanumerik dapat diteruskan di file. `Collection`

*Kunci keluaran*  
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, lihat[Melewati karakter non-alfanumerik dalam for `Collection` `Fn::ForEach`](intrinsic-function-reference-foreach-example-resource.md#intrinsic-function-reference-foreach-example-non-alphanumeric).

*Nilai keluaran*  
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 mengonfigurasi setiap sumber daya.

## Nilai yang dikembalikan
<a name="intrinsic-function-reference-foreach-return-value"></a>

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
<a name="intrinsic-function-reference-foreach-nested-functions"></a>

Anda dapat menggunakan fungsi-fungsi berikut di dalamnya`Fn::ForEach`.
+ Fungsi kondisi:
  + [`Fn::And`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-and)
  + [`Fn::Equals`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-equals)
  + [`Fn::If`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-if)
  + [`Fn::Not`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-not)
  + [`Fn::Or`](intrinsic-function-reference-conditions.md#intrinsic-function-reference-conditions-or)
+ [`Fn::Base64`](intrinsic-function-reference-base64.md)
+ [`Fn::FindInMap`](intrinsic-function-reference-findinmap.md)
+ [`Fn::GetAtt`](intrinsic-function-reference-getatt.md)
+ [`Fn::GetAZs`](intrinsic-function-reference-getavailabilityzones.md)
+ [`Fn::ImportValue`](intrinsic-function-reference-importvalue.md)
+ [`Fn::Join`](intrinsic-function-reference-join.md)
+ [`Fn::Length`](intrinsic-function-reference-length.md)
+ [`Fn::Transform`](intrinsic-function-reference-transform.md)
+ [`Fn::Select`](intrinsic-function-reference-select.md)
+ [`Fn::Sub`](intrinsic-function-reference-sub.md)
+ [`Fn::ToJsonString`](intrinsic-function-reference-ToJsonString.md)
+ [`Ref`](intrinsic-function-reference-ref.md)

## Contoh
<a name="intrinsic-function-reference-foreach-example-pointer"></a>

Anda dapat menemukan contoh untuk`Conditions`,`Outputs`, dan `Resources` bagian di[Contoh](intrinsic-function-reference-foreach-examples.md).