跳到主要内容

ecctl

为 Agent 而生的阿里云弹性计算命令行 —— 面向资源操作,默认输出 JSON,创建后等待资源就绪再返回。

$brew tap aliyun/ecctl https://github.com/aliyun/elastic-compute-control-cli && brew install ecctl
# 一条命令:创建、等到 Available、回读资源
$ ecctl vpc create --name demo
{
"vpc": {
"id": "vpc-2zeo51…",
"status": "Available",
...
},
...
}
面向资源统一语法操作所有产品
执行前可查必填参数、风险与等待行为
同步返回资源就绪后返回最终结果
结构化输出结果与错误均为 JSON
为什么是 ecctl

为 Agent 设计,而不仅是终端

01

面向资源,而非接口

以统一的 product/resource/action 语法操作阿里云弹性计算资源,无需记忆 OpenAPI 操作名与参数展开。

02

执行前可查看命令要求

运行前即可查看命令的必填参数、风险等级与等待行为。

03

异步操作同步返回

异步操作默认等待资源就绪并回读,命令返回最终结果,而非“已提交”状态。

04

结果与错误均为 JSON

默认输出 JSON;错误亦为结构化 JSON,包含错误码、是否可重试与云端 request_id。

05

更安全的变更

支持 dry-run 校验、通过幂等避免重复创建,破坏性删除需显式确认。

06

长尾能力可回退

常用操作提供现成命令;尚未建模的能力可直接发起原始 OpenAPI 调用。

日常使用

直接运行命令,需要时再查细节

命令按产品、资源、动作组织,形态可预期,大多数时候直接运行即可。

  • 直接运行命令资源命令形态统一、可预期,常见操作可直接运行。
  • 加 -h 查看参数任意命令追加 -h,即可查看用法、必填项和 flag。
  • 用 schema 看完整规格面对复杂参数或自动化场景,schema 以结构化 JSON 返回每个参数与行为,便于 Agent 读取和填参。
阅读文档
直接运行命令ecctl ecs instance list --filter status=Running
加 -h 查看参数ecctl ecs instance create -h
用 schema 看完整规格ecctl schema ecs.instance.create --brief

用一套资源命令操作阿里云弹性计算产品

按快速开始安装 ecctl,运行你的第一个资源命令。

阅读文档