tcb domains cache purge
刷新 HTTP 访问服务域名的 CDN 或 EdgeOne（EO）缓存。域名需已接入 CDN 或 EdgeOne。
语法
tcb domains cache purge <targets...> -d <domain> [options]
参数
| 参数 | 必填 | 说明 | 默认值 |
|---|---|---|---|
<targets...> | 是 | 刷新目标，单次最多 20 个，单条最长 2048 字符 | — |
-d, --domain <domain> | 是 | HTTP 访问服务域名 | — |
-t, --type <type> | 否 | 刷新粒度：url / prefix / host；目标以 / 结尾时自动识别为 prefix | url |
-c, --cache-type <cacheType> | 否 | 缓存类型：cdn / eo，默认按域名接入方式自动识别 | 自动识别 |
-w, --wait | 否 | 提交后等待刷新完成再返回，适合 CI/CD | false |
-e, --env-id <envId> | 否 | 环境 ID | 配置文件 envId |
刷新粒度：
| 粒度 | 说明 | 支持范围 |
|---|---|---|
url | 精确 URL，目标需带 http:// 或 https:// 前缀 | CDN、EO |
prefix | 目录，目标需带协议前缀，如 https://example.com/static/ | 仅 EO |
host | 整个域名，目标可为裸域名或带协议的域名 | 仅 EO |
示例
# 刷新单个 URL
tcb domains cache purge https://example.com/index.html -d example.com -e <envId>
# 批量刷新多个 URL
tcb domains cache purge https://example.com/a.js https://example.com/b.css -d example.com -e <envId>
# 目录刷新（仅 EO）
tcb domains cache purge https://example.com/static/ -d example.com -e <envId> -t prefix
# 域名刷新（仅 EO）
tcb domains cache purge https://example.com -d example.com -e <envId> -t host
# 指定缓存类型并等待完成
tcb domains cache purge https://example.com/index.html -d example.com -e <envId> -c eo --wait
注意事项
- 域名需接入 CDN 或 EdgeOne 后才能刷新缓存
- CDN 域名只支持 URL 粒度，目录与域名刷新是 EO 的能力
- URL 与目录目标需包含
http://或https://协议前缀 - 缓存刷新不支持平台版（
--platform-id）