获取有关 API 调用的信息

本页面适用于 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 文档。

本页面介绍了如何获取有关 API 调用的信息，包括：

此信息可帮助您评估 Apigee 订阅级别，如 订阅权益中所述。

对所有 API 进行的调用总数

要查找给定时间范围内对单个组织和环境中所有 API 进行的总调用次数，请使用类似于如下所示的 Metrics API 调用。结果会考虑将代理链接在一起的场景。

curl -v "https://apigee.googleapis.com/v1/organizations/ORG/environments/ENV/stats/?select=sum(message_count)&timeRange=03/01/2023+00:00~03/31/2023+23:59" \
-H "Authorization: Bearer $TOKEN"

在上面的调用中：

  • ORG 是组织。
  • ENV 是环境。
  • timeRange 是报告的时间范围，格式为 MM/DD/YYYY+HH:MM~MM/DD/YYYY+HH:MM，其中开始日期和时间以及结束日期和时间的格式为 MM/DD/YYYY+HH:MM。
  • $TOKEN 是一个设置为您的 OAuth 2.0 访问令牌的环境变量，如获取 OAuth 2.0 访问令牌中所述。如需了解此示例中使用的 curl 选项，请参阅使用 curl。

以下是上述调用的响应示例：

{
  "environments": [
    {
      "metrics": [
        {
          "name": "sum(message_count)",
          "values": [
            "7.44944088E8"
          ]
        }
      ],
      "name": "prod"
    }
  ],
...
}

响应的 values 字段包含在指定时间范围内对组织和环境中的 API 的调用次数。

所有 API 处理的数据总量

要查找给定时间范围内单个组织和环境中所有 API 处理的数据总量，请使用两个调用：一个用于请求数据，另一个用于响应数据。

如需查找请求数据总量，请使用类似于以下内容的调用：

curl -v "https://apigee.googleapis.com/v1/organizations/ORG/environments/ENV/stats/?select=sum(request_size)&timeRange=03/01/2023+00:00~03/31/2023+23:59" \
-H "Authorization: Bearer $TOKEN"

如需查找响应总量数据，请使用如下所示的调用：

curl -v "https://apigee.googleapis.com/v1/organizations/ORG/environments/ENV/stats/?select=sum(response_size)&timeRange=03/01/2023+00:00~03/31/2023+23:59" \
-H "Authorization: Bearer $TOKEN"

这些调用中的变量与上一个示例中的变量相同。

有关代理链的说明

如果环境包含多个链接在一起的代理，则对其中一个代理的单个调用将转发到链中的其他代理。这样会增加 API 调用的总数以及所有 API 调用处理的数据总量。返回此信息的命令（如以上部分所示）会考虑代理链。