Fn::ForEach

ザ・Fn::ForEach組み込み関数は、コレクションとフラグメントを受け取り、コレクション内のアイテムを提供されたフラグメントの識別子に適用します。Fn::ForEach次のような他の組み込み関数を含むことができますFn::ForEachそれ自体で、そしてその中で使用してください条件、[Outputs] (出力)、リソース(リソースプロパティを含む) セクション。では使用できません形式バージョン、説明、メタデータ、変換、パラメータ、Mappings、[Rules] (ルール)、またはHooksセクション。例については、「例」を参照してください。

重要

を使用する必要がありますAWS::LanguageExtensions 変換を使用するにはFn::ForEach本質的な機能。

重要

を使用するFn::ForEach組み込み関数は、生成されるテンプレートに適用されるクォータを変更しません。クォータには、テンプレートの最大サイズとテンプレート内のリソースの最大数が含まれます。詳細については、「AWS CloudFormation のクォータ」を参照してください。

宣言

JSON

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

YAML

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

パラメータ

UniqueLoopName

このループの名前。名前はテンプレート内で一意でなければならず、テンプレート内の論理 ID 値と競合しないようにする必要があります。リソーステンプレートのセクション。この名前は変換後の出力にはありません。

Identifier

置き換えたい識別子はOutputKeyそしてOutputValue 複製されるテンプレートフラグメントを表すパラメーター。のすべてのインスタンス$ {識別子}にOutputKeyそしてOutputValue パラメータは、の値に置き換えられますCollectionパラメーター。

Collection

反復処理する値のコレクション。これは、このパラメータの配列でも、RefにCommaDelimitedList。

OutputKey

変換されたテンプレートのキー。$ {識別子}に含める必要がありますOutputKeyパラメーター。たとえば、もしFn::ForEachで使用されていますリソーステンプレートのセクション。これは各リソースの論理IDです。

OutputValue

変換後のテンプレートに複製される値は、内の各項目についてです。Collectionパラメーター。たとえば、もしFn::ForEachで使用されていますリソーステンプレートのセクション。これは各リソースを設定するために繰り返されるテンプレートフラグメントです。

戻り値

コレクション内のアイテムごとに 1 回繰り返されるオブジェクトフラグメントを含む拡張オブジェクト。フラグメント内の識別子はコレクションのアイテムに置き換えられます。

サポートされている関数

内では次の機能を使用できますFn::ForEach。

• 条件関数:

  • Fn::And

  • Fn::Equals

  • Fn::If

  • Fn::Not

  • Fn::Or

• Fn::Base64

• Fn::FindInMap

• Fn::GetAtt

• Fn::GetAZs

• Fn::ImportValue

• Fn::Join

• Fn::Length

• Fn::Transform

• Fn::Select

• Fn::Sub

• Fn::ToJsonString

• Ref

例

例については、「例」を参照してください。