用途:这是一个面向智能体的华为云 CDN 只读查询参考技能,用于在需要查询 CDN 信息时查找正确的 hcloud CLI 命令语法、必填参数和已知注意事项,覆盖全部 44 个 GET 只读 CDN 接口,并已端到端验证。
主要能力:按四类组织命令——域名管理(14 个,如 ListDomains/v2、ShowDomainDetail、ShowDomainFullConfig/v2、ShowCacheRules、ShowHttpInfo、ShowTags/v2)、统计与分析(12 个,如 ShowDomainStats/v2、ShowBandwidthCalc、ShowTopDomainNames、ShowDomainLocationStats/v2)、刷新/日志/导出(8 个,如 ShowHistoryTasks/v2、ShowLogs/v2、DownloadStatisticsExcel)、模板/规则/标签/账户(10 个)。提供命令模板、参数指引、12 条已验证的注意事项与排错说明,并明确列出 55 个被禁止的非 GET 操作。
使用方式:命令格式为 hcloud CDN <Operation> --cli-region=<region> [--parameter=value ...],参数必须用等号连接,不支持空格分隔;数组参数用 --key.1=value1。CDN 接口仅支持 cn-north-1 与 ap-southeast-1 两个区域,推荐 cn-north-1,查询结果与区域无关。使用前需确认 hcloud(KooCLI)版本不低于 3.2.0(hcloud version),并已配置凭证(hcloud configure list)。凭证只能来自环境变量或本地配置文件,禁止在对话中读取、回显或接收 AK/SK。
适用场景:查询域名配置、流量与带宽统计、刷新预热任务历史、日志下载、证书与回源配置、缓存规则、域名归属、账户配额等只读场景。
限制:严格只读,所有 POST/PUT/DELETE 操作(共 55 个,含创建/删除域名、修改配置、启停域名、修改计费模式、创建刷新预热任务等)一律拒绝,需改用华为云 CDN 控制台或手动执行 CLI。非 CDN 服务查询、控制台操作与账户管理不在范围内。若需使用未列出的命令,须先用 hcloud CDN <Operation> --help 查看 Method 字段,仅 GET 可执行。部分接口有额外约束,如 ShowHistoryTasks/v2 的 page_number 与 page_size 必须同时传入,ShowBandwidthCalc 时间跨度最多 31 天,ShowTopDomainNames 最多 1 天,ShowUrlTaskInfo/v2 时间跨度不超过 24 小时,ShowLogs/v2 的域名不能属于企业项目,导出 Excel 需设置 --cli-read-timeout=60。