取得 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"

這些呼叫中的變數與前一個範例中的變數相同。

關於 Proxy 鏈結的注意事項

如果環境包含多個連結在一起的 Proxy，對其中一個 Proxy 的單一呼叫會轉送至鏈中的其他 Proxy。這會增加 API 呼叫的總數，以及所有 API 呼叫處理的資料總量。上述章節所列的傳回這類資訊的指令會考量到 Proxy Chaining。