Map

The Map state is internally used by the StepFunctions component to add a Map workflow state to a state machine.

You’ll find this component returned by the map method of the StepFunctions component.

Used to store variables. The Assign field accepts a JSON object with key/value pairs that define variable names and their assigned values. Alternatively, you can pass in a JSONata expression directly.

For more information, see Passing data between states with variables.

Provide a JSON object with variable names and values.

{
  assign: {
    productName: "product1",
    count: 42,
    available: true,
  }
}

Assign values from state input and result using JSONata expressions.

  {
    assign: {
      product: "{% $states.input.order.product %}",
      currentPrice: "{% $states.result.Payload.current_price %}"
    }
  }

comment?

Type Input<string>

A comment to describe the state.

itemSelector?

Type Input<Record<string, Input<any>>>

Overrides the values of the input array items before they’re passed on to each Map state iteration.

Learn more about ItemSelector.

items?

Type Input<any[] | “{% ${string} %}”>

A JSON array or a JSONata expression that must evaluate to an array.

Learn more about Items.

Specify an array of items to process.

{
  items: ["item1", "item2", "item3"],
}

Alternatively, specify a JSONata expression to evaluate to an array.

{
  items: "{% $states.input.items %}",
}

maxConcurrency?

Type Input<number | “{% ${string} %}”>

Default 0

Specifies an integer value or a JSONata expression that evaluates to an integer. This provides the upper bound on the number of Map state iterations that can run in parallel.

The default value is 0, which places no limit on concurrency. Step Functions invokes iterations as concurrently as possible.

Limit the Map state to 10 concurrent iterations running at one time.