调用AWS CloudWatch PutMetricData添加ApiGateway指标时遇参数错误

问题原因 #

AWS不允许用户直接向AWS/开头的托管服务命名空间（比如AWS/ApiGateway）提交自定义指标，这是触发InvalidParameterValue错误的核心原因。

可行解决方案 #

1. 生成真实的5XX错误指标 #

通过调用API Gateway端点生成真实的5XX错误，从而触发原生指标：

• 在ApiGateway中配置一个返回500状态码的测试端点
• 使用AWS CLI命令模拟调用并返回5XX状态，示例：

aws apigateway test-invoke-method --rest-api-id 你的API-ID --resource-id 你的资源ID --http-method GET --path-with-query-string "/" --status-code 500

这种方式会自动生成AWS/ApiGateway命名空间下的真实5XXError指标，无需手动提交。

2. 使用自定义命名空间提交测试指标 #

如果需要手动提交测试数据，改用自定义命名空间，再同步修改CloudWatch告警的指标源：

• 提交自定义指标的命令：

aws cloudwatch put-metric-data --namespace Custom/ApiGateway --metric-name 5XXError --dimensions ApiName=SpacesApi,Stage=prod --value 1

• 编辑CloudWatch告警规则，将指标命名空间改为Custom/ApiGateway，匹配提交的自定义指标。

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