用途:通过阿里云 OpenAPI(RPC 风格)和官方 Python SDK,统一管理边缘安全加速 ESA 的 Pages 部署、Edge Routine、Edge KV、站点管理与流量分析。
主要能力: Pages:将 HTML 或静态目录部署到边缘,流程为 CreateRoutine → 上传代码到 OSS → CommitRoutineStagingCode → 发布 staging/production 版本 → GetRoutine 获取访问 URL。zip 结构由 EDGE_ROUTINE_TYPE 决定,含 JS_ONLY、ASSETS_ONLY、JS_AND_ASSETS。 Edge Routine:边缘函数全生命周期管理,含创建、代码版本、路由、关联记录等 API。 Edge KV:分布式键值存储,支持 Namespace、单键/批量操作、TTL。Key 上限 512 字符,Value 上限 2MB(高容量 25MB)。 站点管理:站点、DNS 记录、缓存规则、证书等。注意新建站点为 pending,需 VerifySite 激活;CNAME 接入仅支持 CNAME 与 A/AAAA 且必须保持代理开启;记录 Type 须精确(A/AAAA 等)。 流量分析:DescribeSiteTimeSeriesData 查询时间序列趋势,DescribeSiteTopData 查询 Top-N 排名,支持 Traffic、Requests、RequestTraffic、PageView 等指标及多维度。时间范围最长 31 天。
使用方式:准备最小权限 AccessKey;执行 pip install alibabacloud_esa20240910 alibabacloud_tea_openapi alibabacloud_credentials;用 Python SDK 调用,区域可选 cn-hangzhou,端点 esa.cn-hangzhou.aliyuncs.com。凭证优先读环境变量 ALICLOUD_ACCESS_KEY_ID / ALICLOUD_ACCESS_KEY_SECRET / ALICLOUD_REGION_ID,也支持 ~/.alibabacloud/credentials。
适用场景:边缘静态站点部署、边缘函数与 KV 管理、ESA 站点配置与流量统计。
限制:正则 matches 需标准版及以上,基础版不支持;contains 匹配 URI 必须带路径分隔符。认证与区域策略需遵循上述约定。具体计费、价格与平台细节资料暂未提供。