阿里云 CLI 自主操作
接收用户的自然语言指令，将其转换为正确的阿里云 CLI 命令并执行。核心目标是让用户无需记忆命令语法，用日常语言描述需求即可完成云资源操作。
工作流程
第一步：理解用户意图
从用户的自然语言中提取关键信息：
- 目标产品：用户操作的云产品（如 SLS、ECS、RDS、OSS 等）
- 操作类型：增（创建/写入）、删（删除）、改（更新/修改）、查（查询/列出）
- 资源标识：项目名、实例名、Logstore 名、Bucket 名等
- 操作数据：要写入或修改的具体数据内容
- 附加条件：地域、时间范围、过滤条件等
第二步：探索 API
如果不确定该使用哪个 API 或参数格式，通过 --help 逐层探索：
# 查看产品支持的所有 API
aliyun <ProductCode> --help
# 查看具体 API 的参数详情
aliyun <ProductCode> <APIName> --help
这一步很重要，因为不同产品的 API 风格（RPC 或 ROA）和参数要求各不相同。先查帮助再执行，可以避免参数错误。
第三步：构建并执行命令
根据探索到的 API 信息，构建正确的命令并执行。
命令结构
阿里云 CLI 有两种 API 风格，产品内通常统一使用一种风格：
RPC 风格（大多数产品，如 ECS、RDS）
aliyun <ProductCode> <APIName> --参数名 '参数值'
示例：
aliyun ecs DescribeInstances --RegionId cn-hangzhou
aliyun ecs DescribeInstanceAttribute --InstanceId 'i-uf6f5trc95ug8t33****'
ROA 风格（如 SLS、CS）
aliyun <ProductCode> <Method> <PathPattern> --body '...'
# 或使用语法糖：
aliyun <ProductCode> <APIName> --参数名 值 --body '...'
示例：
# 使用 APIName 语法糖（推荐，更简洁）
aliyun sls PutLogs --logstore my-logstore --project my-project --body '<JSON数据>'
# 使用原始 Method + PathPattern
aliyun sls POST /logstores/my-logstore/shards/lb --project my-project --body '<JSON数据>'
参数格式（macOS/Linux 环境）
参数名严格区分大小写。
- 普通字符串：无特殊字符可直接传入，有特殊字符用单引号包裹
- JSON 参数：用单引号包裹整个 JSON，内部用双引号
- JSON 数组：
'["value1","value2"]' - JSON 对象列表：
'[{"key":"value"},{"key":"value"}]' - 日期时间：ISO8601 格式
YYYY-MM-DDThh:mm:ssZ - 特殊字符问题：若引号包含后仍报错，尝试
--参数名=值格式
常用产品操作速查
ECS 云服务器（RPC 风格）
# 查询实例列表
aliyun ecs DescribeInstances --RegionId cn-hangzhou
# 启动实例
aliyun ecs StartInstance --InstanceId 'i-xxxxx'
# 停止实例
aliyun ecs StopInstance --InstanceId 'i-xxxxx'
# 查询地域列表
aliyun ecs DescribeRegions
OSS 对象存储
阿里云 CLI 内置了 OSS 专用命令（不同于 API 调用）：
# 列出 Bucket
aliyun oss ls
# 上传文件
aliyun oss cp <local-file> oss://<bucket>/<path>
# 下载文件
aliyun oss cp oss://<bucket>/<path> <local-file>
# 列出对象
aliyun oss ls oss://<bucket>/<prefix>
RDS 云数据库（RPC 风格）
# 查询实例列表
aliyun rds DescribeDBInstances --RegionId cn-hangzhou
# 查询数据库列表
aliyun rds DescribeDBInstanceAttribute --DBInstanceId 'rm-xxxxx'
常用命令行选项
| 选项 | 说明 |
|---|---|
--region | 指定地域，如 cn-hangzhou、cn-beijing |
--profile | 指定凭证配置名称 |
--output cols=<字段> | 表格化输出 |
--dryrun | 模拟执行，不实际操作 |
--force | 强制调用（绕过元数据检查） |
--body-file <path> | 从文件读取请求体（ROA风格） |
执行原则
- 先探索后执行：对不熟悉的 API，先用
--help查看参数要求 - 危险操作确认：执行删除、停止、修改类操作前，先告知用户操作内容和影响范围，获得确认后再执行
- 使用 dryrun 验证：对复杂或高风险操作，先用
--dryrun预览请求内容 - 错误处理：命令执行失败时，分析错误信息并给出修复建议。常见问题包括参数格式不正确、权限不足、资源不存在等
- 批量操作：处理多条数据时，考虑合并为一次 API 调用（如 PutLogs 支持一次写入多条日志），提升效率
- 结果解读：执行完成后，用自然语言向用户解释返回结果的含义
参考文档
- 安装、更新、卸载 - 安装、更新、卸载 aliyun cli
- SLS 日志服务操作指南 - 写入日志、查询日志、数据转换规则