如何配置AWS API Gateway集成请求调用CloudWatch Logs的StartQuery操作？

问题背景 #

我正在配置AWS API Gateway，添加POST方法调用CloudWatch Logs的StartQuery操作，但日志持续返回404错误。在编辑集成请求时，Action type有两个选项：Use action name或Use path override。

根据CloudWatch Logs文档，请求需POST至https://logs.eu-west-1.amazonaws.com/，但以下尝试均失败：

• 选择Use action name，填入?ActionName=Logs_20140328.StartQuery或仅填?
• 选择Use path override，填入/，生成的请求地址变为https://logs.eu-west-1.amazonaws.com//

相关日志输出：

Thu Apr 10 11:14:01 UTC 2025 : Sending request to https://logs.eu-west-1.amazonaws.com/?Action=StartQuery
Thu Apr 10 11:14:01 UTC 2025 : Received response. Status: 404, Integration latency: 5 ms
Thu Apr 10 11:14:01 UTC 2025 : Endpoint response headers: {x-amzn-RequestId=ed419694-9f07-4a9f-9fcc-ad3767064de9, Content-Length=29, Date=Thu, 10 Apr 2025 11:14:01 GMT}
Thu Apr 10 11:14:01 UTC 2025 : Endpoint response body before transformations: <UnknownOperationException/>

正确配置步骤 #

• 确认集成类型：API Gateway集成类型选择AWS Service，不要用HTTP集成
• 填写服务基础信息：
  • 服务名称：CloudWatch Logs（或直接填logs）
  • 区域：eu-west-1
  • HTTP方法：POST
  • 执行角色：选择具备logs:StartQuery权限的IAM角色
• 设置Action type：选择Use action name，在Action name输入框中直接填写StartQuery（无需前缀、问号或其他多余字符）
• 清空路径覆盖：如果之前设置过路径覆盖，务必清空该字段，API Gateway会自动生成正确的请求路径
• 配置请求映射：确保请求体映射正确，将API Gateway收到的请求参数（如logGroupName、startTime、endTime、queryString等）正确传递给CloudWatch Logs的StartQuery接口

错误原因说明 #

• 你之前填写的?ActionName=Logs_20140328.StartQuery格式错误：AWS服务集成中，Action name只需填纯操作名，API Gateway会自动处理服务命名空间（Logs_20140328）和参数格式
• 用Use path override填/导致双斜杠，是因为API Gateway默认会在服务域名后添加路径分隔符，手动输入/会造成重复，清空即可避免
• 日志中的UnknownOperationException是因为请求的Action参数格式不符合CloudWatch Logs要求，导致服务无法识别操作

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