tcb domains edit
更新已绑定自定义域名的域名级配置（证书、接入方式、启用状态），不修改路由规则。只更新显式传入的字段。
v3.8.3+
tcb domains edit 自 v3.8.3 起提供。
语法
tcb domains edit <domain> [options]
参数
| 参数 | 必填 | 说明 | 默认值 |
|---|---|---|---|
<domain> | 是 | 要更新的域名 | — |
--certid <certId> | 否 | 新的 SSL 证书 ID | — |
--access-type <type> | 否 | 新的接入方式：DIRECT / CDN / CUSTOM / EO | — |
--custom-cname <cname> | 否 | 新的自定义 CNAME，仅 --access-type CUSTOM 时可用 | — |
--enable | 否 | 将域名设为启用，与 --disable 互斥 | — |
--disable | 否 | 将域名设为禁用，与 --enable 互斥 | — |
--dry-run | 否 | 只展示将要更新的配置，不实际执行 | false |
-e, --env-id <envId> | 否 | 环境 ID | 配置文件 envId |
--platform-id <platformId> | 否 | 平台版资源池 ID，与 -e 互斥（v3.8.3+） | — |
示例
# 更新 SSL 证书
tcb domains edit api.example.com --certid <certId> -e <envId>
# 变更接入方式为 CDN
tcb domains edit api.example.com --access-type CDN -e <envId>
# 自定义接入，需指定 CNAME 源站
tcb domains edit api.example.com --access-type CUSTOM --custom-cname origin.example.com -e <envId>
# 禁用域名
tcb domains edit api.example.com --disable -e <envId>
# 预览将要更新的配置
tcb domains edit api.example.com --certid <certId> --dry-run -e <envId>
# 平台版资源池下的域名（v3.8.3+）
tcb domains edit api.example.com --platform-id <platformId> --access-type EO --certid <certId> --enable
注意事项
- 至少指定一个要更新的字段（
--certid/--access-type/--custom-cname/--enable/--disable） - 域名需已绑定，新增域名用
tcb domains add - 只更新域名级配置，路由规则修改用
tcb routes edit