IP 占用率

使用 GraphQL API 获取聚合数据并监控您的专用 IP 容量（以前称为 Aegis）。

每个专用 CDN 出口 IP 在每个源站 IP 端口上最多可支持 40,000 个并发连接。例如，如果您有一个专用 IP 和两个源站（A 和 B），则该单个 IP 可以支持到源站 A 的 40,000 个并发连接，同时支持到源站 B 的 40,000 个并发连接。

有关进一步的指导，请参阅 GraphQL Analytics API 文档，或考虑使用下面的示例进行快速入门。

GraphQL schema

用于获取 Dedicated CDN Egress IPs 数据的特定 schema 称为 aegisIpUtilizationAdaptiveGroups。

您可以获取平均 (avg) 或最大 (max) 占用率值（以百分比表示），并使用以下维度：

datetimeFiveMinutes time
- 截断至五分钟的时间戳。例如，2025-01-10T00:05:00Z。
popName string
- Cloudflare 接入点 (PoP)。例如，sjc。
egressIp string
- 为您分配的 Dedicated CDN Egress IP。例如，192.0.2.1。
origin string
- 源 IP 和端口。例如，203.0.113.150:443。
popUtilizationKey string
- Cloudflare 接入点 (PoP)、Dedicated CDN Egress IP 以及源 IP 和端口。例如，sjc 192.0.2.1 203.0.113.150:443。

示例

参阅以下查询以了解如何按接入点获取平均占用率和最大占用率，并过滤结果。

您还可以选择底部的按钮，通过 Cloudflare GraphQL API 浏览器 ↗ 将此查询用于您的账户。确保提供您的账户 ID 和时间戳，并根据需要替换 popName、egressIp 和 origin 的占位符。

query AegisIpUtilizationQuery(
  $accountTag: string
  $datetimeStart: string
  $datetimeEnd: string
) {
  viewer {
    utilization: accounts(filter: { accountTag: $accountTag }) {
      avgByPopUtilization: aegisIpUtilizationAdaptiveGroups(
        limit: 100
        filter: {
          datetimeFiveMinutes_geq: $datetimeStart
          datetimeFiveMinutes_leq: $datetimeEnd
        }
        orderBy: [datetimeFiveMinutes_ASC]
      ) {
        avg {
          utilization
        }
        dimensions {
          datetimeFiveMinutes
          popUtilizationKey
        }
      }

      maxByPopUtilization: aegisIpUtilizationAdaptiveGroups(
        limit: 100
        filter: {
          datetimeFiveMinutes_geq: $datetimeStart
          datetimeFiveMinutes_leq: $datetimeEnd
        }
        orderBy: [datetimeFiveMinutes_ASC]
      ) {
        max {
          utilization
        }
        dimensions {
          datetimeFiveMinutes
          popUtilizationKey
        }
      }

      filterPopUtilization: aegisIpUtilizationAdaptiveGroups(
        limit: 100
        filter: {
          datetimeFiveMinutes_geq: $datetimeStart
          datetimeFiveMinutes_leq: $datetimeEnd
          popName: "<CLOUDFLARE_POP>"
        }
        orderBy: [datetimeFiveMinutes_ASC]
      ) {
        max {
          utilization
        }
        dimensions {
          datetimeFiveMinutes
          popUtilizationKey
        }
      }

      filterIPUtilization: aegisIpUtilizationAdaptiveGroups(
        limit: 100
        filter: {
          datetimeFiveMinutes_geq: $datetimeStart
          datetimeFiveMinutes_leq: $datetimeEnd
          egressIp: "<YOUR_EGRESS_IP>"
        }
        orderBy: [datetimeFiveMinutes_ASC]
      ) {
        max {
          utilization
        }
        dimensions {
          datetimeFiveMinutes
          popUtilizationKey
        }
      }

      filterOriginUtilization: aegisIpUtilizationAdaptiveGroups(
        limit: 100
        filter: {
          datetimeFiveMinutes_geq: $datetimeStart
          datetimeFiveMinutes_leq: $datetimeEnd
          origin: "<ORIGIN_IP_AND_PORT>"
        }
        orderBy: [datetimeFiveMinutes_ASC]
      ) {
        max {
          utilization
        }
        dimensions {
          datetimeFiveMinutes
          popUtilizationKey
        }
      }
    }
  }
}