腾讯云 tccli API 调用

要解决什么问题

在自动化脚本或 Agent 里直接拼 HTTP 签名调用腾讯云 OpenAPI，容易在地域、参数类型和凭证管理上踩坑；一旦并行多进程写同一套 tccli 配置，还会出现偶发失败。本技能把「怎么调、用什么工具、凭证怎么处理」收敛成一套可执行的约定。

技能如何工作

统一入口：所有腾讯云 API 都通过 tccli 发起，未安装时按 references/install.md 补齐环境。

调用约定：

• 地域：多数产品需 --region（如 ap-guangzhou）；CAM、账号、DNSPod、域名、SSL、BA、标签等全局接口可省略。
• 参数：非简单类型必须传标准 JSON，例如 --Placement '{"Zone":"ap-guangzhou-2"}'。
• 串行：当前 tccli 并行调用存在配置文件竞争，应逐个接口调用，避免批量并发。

凭证：已有凭证时 CLI 可直接工作；若报 secretId is invalid，执行 tccli auth login 走浏览器 OAuth（本地端口阻塞直至回调完成）。多用户与授权原理见 references/auth.md。

查文档：用 curl 配合 grep 检索业务名（如 cvm、cbs）、最佳实践、<Action> 接口说明及数据结构，按需再深挖字段。

适用边界与注意点

• 安全红线：严禁向用户索要 SecretId/SecretKey，也拒绝可能打印凭证的操作（尤其 tccli configure list）。
• 创建类接口参数需按官方文档替换示例中的占位字段；最佳实践优先于裸接口列表。