ResultWriter (Map)

次の例では、3 つのフィールド (WriterConfig、Resources、Parameters) の可能な組み合わせによる設定を示しています。

WriterConfig のみ

この例では、WriterConfig フィールドに出力フォーマットと変換を指定して、ステートの出力のプレビュー表示方法を設定します。Amazon S3 バケット仕様を指定する Resource および Parameters フィールドがないため、ステートの出力リソースが暗黙的に使用されます。結果は次のステートに渡されます。

"ResultWriter": {
    "WriterConfig": { 
        "Transformation": "FLATTEN", 
        "OutputType": "JSON"
    }
}

Resources と Parameters のみ

この例では、WriterConfig フィールドがないため、追加のフォーマットや変換なしで、ステートの出力を指定された Amazon S3 バケットにエクスポートします。

"ResultWriter": {
    "Resource": "arn:aws:states:::s3:putObject",
    "Parameters": {
        "Bucket": "amzn-s3-demo-destination-bucket",
        "Prefix": "csvProcessJobs"
    }

WriterConfig、Resources、Parameters の 3 つのフィールドすべて

この例では、WriterConfig フィールドの指定に従ってステートの出力をフォーマットします。また、Resource および Parameters フィールドの指定に従って、ステートの出力を Amazon S3 バケットにエクスポートします。

"ResultWriter": {
     "WriterConfig": { 
        "Transformation": "FLATTEN",
        "OutputType": "JSON"
    },
    "Resource": "arn:aws:states:::s3:putObject",
    "Parameters": {
        "Bucket": "amzn-s3-demo-destination-bucket",
        "Prefix": "csvProcessJobs"
    }
}

これらの例では、各子ワークフロー実行がオブジェクトの配列を出力として返すとします。

[
  {
    "customer_id": "145538",
    "order_id": "100000"
  },
  {
    "customer_id": "898037",
    "order_id": "100001"
  }
]

これらの例では、OutputType が JSON の場合で、さまざまな Transformation 値によってフォーマットされた出力を示しています。

変換: NONE

これは NONE 変換を使用した場合の処理結果の例です。出力は変更されず、ワークフローのメタデータが含まれています。

[
    {
        "ExecutionArn": "arn:aws:states:region:account-id:execution:orderProcessing/getOrders:da4e9fc7-abab-3b27-9a77-a277e463b709",
        "Input": ...,
        "InputDetails": {
            "Included": true
        },
        "Name": "da4e9fc7-abab-3b27-9a77-a277e463b709",
        "Output": "[{\"customer_id\":\"145538\",\"order_id\":\"100000\"},{\"customer_id\":\"898037\",\"order_id\":\"100001\"}]",
        "OutputDetails": {
            "Included": true
        },
        "RedriveCount": 0,
        "RedriveStatus": "NOT_REDRIVABLE",
        "RedriveStatusReason": "Execution is SUCCEEDED and cannot be redriven",
        "StartDate": "2025-02-04T01:49:50.099Z",
        "StateMachineArn": "arn:aws:states:region:account-id:stateMachine:orderProcessing/getOrders",
        "Status": "SUCCEEDED",
        "StopDate": "2025-02-04T01:49:50.163Z"
    },
    ...
    {
        "ExecutionArn": "arn:aws:states:region:account-id:execution:orderProcessing/getOrders:f43a56f7-d21e-3fe9-a40c-9b9b8d0adf5a",
        "Input": ...,
        "InputDetails": {
            "Included": true
        },
        "Name": "f43a56f7-d21e-3fe9-a40c-9b9b8d0adf5a",
        "Output": "[{\"customer_id\":\"169881\",\"order_id\":\"100005\"},{\"customer_id\":\"797471\",\"order_id\":\"100006\"}]",
        "OutputDetails": {
            "Included": true
        },
        "RedriveCount": 0,
        "RedriveStatus": "NOT_REDRIVABLE",
        "RedriveStatusReason": "Execution is SUCCEEDED and cannot be redriven",
        "StartDate": "2025-02-04T01:49:50.135Z",
        "StateMachineArn": "arn:aws:states:region:account-id:stateMachine:orderProcessing/getOrders",
        "Status": "SUCCEEDED",
        "StopDate": "2025-02-04T01:49:50.227Z"
    }
]

変換: COMPACT

これは COMPACT 変換を使用した場合の処理結果の例です。これは、元の配列構造を保持したままの子ワークフロー実行の出力を結合した結果です。

[
    [
        {
            "customer_id": "145538",
            "order_id": "100000"
        },
        {
            "customer_id": "898037",
            "order_id": "100001"
        }
    ],
    ...,
    
    [
        {
            "customer_id": "169881",
            "order_id": "100005"
        },
        {
            "customer_id": "797471",
            "order_id": "100006"
        }
    ]
]

変換: FLATTEN

これは FLATTEN 変換を使用した場合の処理結果の例です。これは、子ワークフロー実行で返された複数の配列を 1 つに平坦化した出力結果です。

[
    {
        "customer_id": "145538",
        "order_id": "100000"
    },
    {
        "customer_id": "898037",
        "order_id": "100001"
    },
    ...
    {
        "customer_id": "169881",
        "order_id": "100005"
    },
    {
        "customer_id": "797471",
        "order_id": "100006"
    }
]