如何在AWS EventBridge定时任务中指定API Gateway端点及请求参数？

一、解决无法指定API Gateway端点的问题 #

创建EventBridge规则时，目标类型必须选择API Gateway，配置核心要点：

• 需提供API Gateway的完整ARN，格式示例：arn:aws:apigateway:<区域>::/apis/<API ID>/stages/<阶段名称>/paths/<路径>
• 确认API Gateway授权方式适配：私有API需开放EventBridge访问权限；IAM授权需为EventBridge执行角色添加execute-api:Invoke权限

二、含ARN、端点及请求头的JSON请求体示例 #

以下是通过API/CLI创建规则时的完整配置示例，覆盖所有关键参数：

{
  "Rule": "定时调用API规则",
  "ScheduleExpression": "rate(5 minutes)",
  "State": "ENABLED",
  "Targets": [
    {
      "Id": "API-Gateway-Target",
      "Arn": "arn:aws:apigateway:us-east-1::/apis/abc123/stages/prod/paths/{proxy+}",
      "HttpParameters": {
        "HeaderParameters": {
          "Content-Type": "application/json",
          "X-Custom-Header": "CustomValue"
        },
        "PathParameterValues": [
          "api-endpoint-path"
        ],
        "QueryStringParameters": {
          "param1": "value1",
          "param2": "value2"
        }
      },
      "Input": "{\"key\": \"value\"}"
    }
  ]
}

参数说明 #

• Arn：替换为你的API Gateway实际ARN，包含区域、API ID、阶段和路径信息
• HttpParameters.HeaderParameters：自定义请求头，按需添加API要求的字段
• Input：发送给API的请求体，需匹配API接收格式
• ScheduleExpression：定时频率，支持rate(5 minutes)或cron(0 12 * * ? *)这类表达式

三、权限配置示例 #

为EventBridge执行角色添加API调用权限的策略：

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "execute-api:Invoke",
      "Resource": "arn:aws:apigateway:us-east-1::/apis/abc123/stages/prod/*"
    }
  ]
}

内容的提问来源于stack exchange，提问作者Carlos