View a markdown version of this page

使用 Step Functions 新增 EventBridge 事件 - AWS Step Functions
支援的 API錯誤處理IAM 政策

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

使用 Step Functions 新增 EventBridge 事件

Step Functions 提供與 Amazon EventBridge 整合的服務整合 API。了解如何直接從 Step Functions 工作流程傳送自訂事件，來建置事件驅動型應用程式。

若要了解如何在 Step Functions 中整合 AWS服務，請參閱 整合 服務和 在 Step Functions 中將參數傳遞至服務 API。

Optimized EventBridge 整合的主要功能

  • 執行 ARN 和狀態機器 ARN 會自動附加到每個 的 Resources 欄位PutEventsRequestEntry。

  • 如果 的回應PutEvents包含非零FailedEntryCount，則Task狀態會失敗並顯示錯誤 EventBridge.FailedEntry。

若要使用 PutEvents API，您需要在帳戶中建立符合您將傳送之事件特定模式的 EventBridge 規則。例如，您可以：

  • 在您的帳戶中建立 Lambda 函數，該函數會接收並列印符合 EventBridge 規則的事件。

  • 在符合特定事件模式並以 Lambda 函數為目標的預設事件匯流排上，在您的帳戶中建立 EventBridge 規則。

如需詳細資訊，請參閱：

以下包含傳送自訂事件Task的 ：

{
  "Type": "Task",
  "Resource": "arn:aws:states:::events:putEvents",
  "Arguments": {
    "Entries": [
      {
        "Detail": {
          "Message": "MyMessage"
        },
        "DetailType": "MyDetailType",
        "EventBusName": "MyEventBus",
        "Source": "my.source"
      }
    ]
  },
  "End": true
}
輸入或結果資料的配額

在服務之間傳送或接收資料時，任務的最大輸入或結果為 256 KiB 的資料，做為 UTF-8 編碼字串。請參閱 狀態機器執行的相關配額。

最佳化 EventBridge API

支援的 EventBridge API 和語法包括：

錯誤處理

PutEvents API 接受項目陣列做為輸入，然後傳回結果項目陣列。只要PutEvents動作成功， PutEvents就會傳回 HTTP 200 回應，即使一或多個項目失敗。 會PutEvents傳回 FailedEntryCount 欄位中失敗的項目數。

Step Functions 會檢查 FailedEntryCount 是否大於零。如果大於零，Step Functions 會失敗狀態並顯示錯誤 EventBridge.FailedEntry。這可讓您在任務狀態上使用 Step Functions 的內建錯誤處理，在項目失敗時擷取或重試，而不需要使用其他狀態來分析回應FailedEntryCount中的 。

注意

如果您已實作冪等性，並且可以安全地對所有項目重試，則可以使用 Step Functions 的重試邏輯。在重試之前，Step Functions 不會從PutEvents輸入陣列中移除成功的項目。反之，它會重試原始項目陣列。

用於呼叫 EventBridge 的 IAM 政策

下列範例範本顯示 如何根據狀態機器定義中的資源AWS Step Functions產生 IAM 政策。如需詳細資訊，請參閱Step Functions 如何為整合服務產生 IAM 政策及探索 Step Functions 中的服務整合模式。

PutEvents

靜態資源

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Action": [
                "events:PutEvents"
            ],
            "Resource": [
                "arn:aws:events:us-east-1:123456789012:event-bus/my-project-eventbus"
            ],
            "Effect": "Allow"
        }
    ]
}

動態資源

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "events:PutEvents"
            ],
            "Resource": "arn:aws:events:*:*:event-bus/*"
        }
    ]
}