API 参考

项目统计

查询您部署项目的基于 CloudWatch 的流量、错误和延迟指标。

最后更新： 2026年5月28日

Project Stats API

查询已部署项目的 CloudWatch 支持的 Amplify 指标。返回在 24 小时、7 天或 30 天窗口内聚合的流量、错误和延迟数据。

获取统计数据

GET /api/v1/projects/{projectId}/stats?range=24h|7d|30d&debug=1

没有部署的项目返回 400 NO_DEPLOYMENT。上游 CloudWatch 错误返回 502 UPSTREAM_ERROR，并附带 AWS 错误名称，以便调试权限和维度问题。设置 debug=1 可在未返回数据点时包含诊断信息和ListMetrics 探测结果。

{
  "data": {
    "metrics": [
      { "name": "Requests", "datapoints": [{ "timestamp": "...", "value": 42 }] },
      { "name": "4xxErrors", "datapoints": [...] },
      { "name": "Latency",   "datapoints": [...] }
    ],
    "range": "7d",
    "hours": 168
  }
}