AWS Toolkit中API Gateway无REST API显示，请求排查解决方法

可能原因及对应解决办法 #

1. API Gateway类型不匹配 #

AWS API Gateway分三种类型：REST API（旧版）、HTTP API（新版）和WebSocket API。控制台默认展示的可能是某一类，如果你创建的是HTTP API，但控制台停在REST API标签页，就会看不到内容。

• 解决：
  • 控制台：在API Gateway页面顶部切换到对应的API类型标签（比如HTTP API、REST API），再查看列表。
  • CLI：使用对应类型的查询命令：
    • 查询REST API：aws apigateway get-rest-apis --region eu-central-1
    • 查询HTTP/WebSocket API：aws apigatewayv2 get-apis --region eu-central-1

2. 区域配置不一致 #

虽然你设置了默认区域为法兰克福（eu-central-1），但CLI或控制台的实际区域可能存在偏差。

• 解决：
  • 控制台：确认右上角区域选择器确实是eu-central-1（法兰克福），刷新页面避免缓存问题。
  • CLI：执行aws configure get region检查当前区域，若不符则执行aws configure set region eu-central-1重新配置，再重试查询。

3. IAM权限不足 #

当前使用的IAM账号/角色没有API Gateway资源的读取权限，导致控制台和CLI都返回空结果。

• 解决：
  • 检查IAM权限，确保添加了apigateway:GET相关权限（比如托管策略AmazonAPIGatewayReadOnlyAccess，或自定义策略包含apigateway:get-rest-apis、apigatewayv2:get-apis等动作）。
  • 若使用临时凭证，确认凭证权限范围包含API Gateway的读权限。

4. API未创建或已被删除 #

可能你误以为创建了API，但实际操作失败，或者已被误删除。

• 解决：
  • 查看CloudTrail日志，搜索CreateRestApi、CreateApi（对应HTTP API）或DeleteRestApi、DeleteApi事件，确认API的生命周期记录。
  • 尝试创建一个测试API，再用控制台和CLI查询，验证是否能正常显示。

5. 控制台缓存或网络问题 #

浏览器缓存、CDN缓存或网络波动导致控制台未加载最新数据。

• 解决：
  • 用无痕模式打开AWS控制台访问API Gateway页面。
  • 清除浏览器缓存后刷新页面。
  • 切换网络环境（比如从公司网络换为家用网络）重试。

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