SuperAPI AI 工具集

volcengine-cli

通用与其它

查看项目

更新于 10-15 17:30

技能介绍

用途:通过 ve 命令调用火山引擎 OpenAPI,创建和管理云资源,覆盖 ECS、VPC、CLB、RDS、Redis 等服务。

主要能力:安装并校验 CLI;会话开始时用 ve sts GetCallerIdentity 验证凭证;查询或变更资源;按 API 定位服务与 Action;读取只读或写入类操作的参数;轮询异步资源状态直到达到目标状态。

安装与初始化:npm i -g @volcengine/cli,或从 GitHub Releases 下载,用 ve --version 验证。凭证可设环境变量 VOLCENGINE_ACCESS_KEY、VOLCENGINE_SECRET_KEY、VOLCENGINE_REGION,或使用 ~/.volcengine/config.json 配置文件(技能只创建空模板,不读取已有配置)。注意 --region 和 VOLCENGINE_REGION 不会覆盖配置文件中的区域,需用 ve configure profile --profile <name> 切换,ve configure list 查看。

使用方式:基本格式为 ve <ServiceCode> <ActionName> --ParamName "value"。读操作可用 --help 查参数;写操作建议用 scripts/fetch_swagger.py 获取完整文档;服务名未知时可用 ve 2>&1 | grep <关键词> 或 python3 scripts/find_api.py <keyword>。参数分扁平格式(嵌套用点号、数组用 .N 从 1 开始)和 JSON 格式(仅 --body '{...}')。

安全规则:只读操作直接执行;写入操作展示完整命令并等待确认;破坏性操作展示命令与影响摘要并要求确认;默认只读;支持 DryRun 时先预演;不得读取或暴露凭证。DryRun 校验通过会返回退出码 1 且 stderr 含 DryRunOperation,属预期行为。

适用场景与限制:适合云资源的创建、查询与编排。部分资源(VKE、RDS、ECS 等)创建需数分钟,须轮询 Describe 直到目标状态;VPC 创建后立即建子资源可能报 InvalidVpc.InvalidStatus,需串行创建或稍后重试。未提供具体价格与配额信息。