パス

Amazon States Language では、パスは、JSON テキスト内でコンポーネントを識別するために使用できる $ で始まる文字列です。JsonPathパスは構文に従います。InputPath、ResultPath、および OutputPath に値を指定するときに、入力のサブセットにアクセスするパスを指定できます。詳細については、Step Functions の入出力処理 を参照してください。

注記

また、状態の定義の Parameters フィールド内のパスを使用して、入力あるいはコンテキストオブジェクトの JSON ノードを指定することもできます。パラメータをサービス API に渡す を参照してください。

リファレンスパス

リファレンスパスは、JSON 構造内の単一ノードのみを識別できるように構文が制限されたパスです。

• オブジェクトのフィールドにアクセスするには、ドット (.) と角括弧 ([ ]) のみを使用して表記します。

• length() などの関数はサポートされていません。

• 非シンボリックなレキシカル演算子 (subsetofサポートされていないなど)。

• 正規表現によるフィルタリングや JSON 構造内の別の値の参照によるフィルタリングはサポートされていません。

• @フィルタで処理中の現在のノードと一致する演算子は、スカラー値と一致しません。オブジェクトにのみマッチします。

例えば、if 状態入力データには次の値が含まれます。

{
  "foo": 123,
  "bar": ["a", "b", "c"],
  "car": {
      "cdr": true
  },
  "jar": [{"a": 1}, {"a": 5}, {"a": 2}, {"a": 7}, {"a": 3}]
}

次のリファレンスパスは以下を返します。

$.foo => 123
$.bar => ["a", "b", "c"]
$.car.cdr => true
$.jar[?(@.a >= 5)] => [{"a": 5}, {"a": 7}]

特定の状態はパスおよびリファレンスパスを使用して、ステートマシンのフローの制御、または状態の設定やオプションを構成します。詳細については、「データフローシミュレーターによるワークフロー入出力パス処理のモデル化」と「JSONPath の効果的な使用」を参照してください。AWS Step Functions