CloudFlow:foreach ステップ

foreach ステップの仕組み

foreach ステップは、入力配列パラメーターをイテレーションし、配列内の各要素に対して steps フィールドで定義されたステップを実行します。foreach ステップはプログラミング言語の foreach と同様に動作しますが、イテレーションが順番に実行されるのではなく、並列で実行される点が異なります。

foreach ステップが実行されると、次のシーケンスで実行されます：

1. foreach ステップは配列内の各要素に対して 1 つのイテレーションを開始し、イテレーションを並行して実行します。

2. 各イテレーションは独自のローカル変数を持ちます。イテレーション内のステップは、そのイテレーションのローカル変数のみを変更します。

3. すべてのブランチが完了すると、すべてのイテレーションのローカル変数が foreach ステップの $local 変数となります。この変数は配列であり、各要素は 1 回のイテレーションの結果を記録する JSON オブジェクトです。

4. foreach ステップの出力マッピングが、イテレーションのローカル変数の配列を foreach ステップの出力に変換します。

制限

foreach ステップは、最大 100 個のイテレーションを並行して実行します。

プロパティ

foreach ステップは、次のプロパティをサポートします。

foreach ステップの iterationMapping プロパティには、次のフィールドが含まれます。

例

次のフロー定義には、myforeach という名前の foreach ステップが含まれています。 names 配列内の各要素に対して、foreach ステップは toUpperCase という名前のタスクステップを 1 つ実行します。

version: v1
type: flow
steps:
  - type: foreach
    name: myforeach
    iterationMapping:
      collection: $.names
      item: name
    steps:
      - type: task
        name: toUpperCase
        resourceArn: acs:fc:{region}:{account}:services/fnf_test/functions/toUpperCase
    outputMappings:
      - target: names
        source: $local[*].name

resourceArn 内の {region} と {account} を、ご自身の値に置き換えてください。

{
  "names": ["a", "b", "c"]
}

{
  "name": "a",
  "names":["a","b","c"]
}

{
  "name": "b",
  "names":["a","b","c"]
}

{
  "name": "c",
  "names":["a","b","c"]
}

{
  "name": "A"
}

{
  "name": "B"
}

{
  "name": "C"
}

[
  {
    "name": "A"
  },
  {
    "name": "B"
  },
  {
    "name": "C"
  }
]

{
  "names": ["A", "B", "C"]
}