client.apps.network 仅适用于 Web 应用。每个方法都以应用 ID 作为第一个参数。
时间窗口
analytics、errors、logs 和 performance 接受 start 和 end,每个都是 ISO 8601 字符串或 datetime。naive(不带时区的)datetime 被视为本地时间,并转换为 UTC。一个窗口最长 7 天,且 start 会被限制为不早于应用的创建日期。无效的窗口会返回 400 INVALID_TIME_RANGE。
RATE_LIMITED。
分析
network.analytics(app_id, start, end, **filters) 返回流量总计和细分数据。对于没有流量的窗口返回 None。
countries、devices、os、browsers、protocols、methods、paths、referers、providers、ips、status_codes、bots 和 content_types。每个分组都有 type、visits、requests 和 bytes。
过滤器
过滤器以关键字参数传入,会缩小每个细分维度的范围。每个过滤器接受其对应细分维度中确切的type 值:
无效的过滤器会返回 400
INVALID_FILTER。设置为 None 或 '' 的过滤器不会被发送。
错误
network.errors(app_id, start, end, include_4xx=False) 返回该窗口内的 5xx 响应,设置 include_4xx=True(仅限关键字参数)时还包括 4xx。对于空窗口返回 None。
请求日志
network.logs(app_id, start, end) 返回单个请求,包含客户端、请求和响应的详细信息。适用于 Pro 和 Enterprise 套餐(否则返回 403 UPGRADE_REQUIRED)。
性能
network.performance(app_id, start, end) 返回边缘和源站的延迟百分位数(p50、p95、p99,单位为毫秒),按国家、按位置以及最慢的路径分别统计。对于空窗口返回 None。适用于 Pro 和 Enterprise 套餐。
DNS
network.dns(app_id) 返回你的自定义域名所需的 DNS 记录及其状态。没有自定义域名时返回 400 NO_CUSTOM_DOMAIN。
自定义域名
network.set_domain(app_id, domain) 绑定一个自定义域名(Standard 及以上套餐)。传入 "@" 即可移除。
清除缓存
network.purge_cache(app_id) 清除应用的边缘缓存。每 60 秒最多清除一次(429 KEEP_CALM)。

