Skip to main content

ecctl

The Alibaba Cloud elastic computing CLI, built for agents — operate by resource, return structured JSON, and wait for the result by default.

$brew tap aliyun/ecctl https://github.com/aliyun/elastic-compute-control-cli && brew install ecctl
Read the docsGitHub
# created, waited for Available, read back — one command
$ ecctl vpc create --name demo
{
"vpc": {
"id": "vpc-2zeo51…",
"status": "Available",
...
},
...
}
ResourcesOne grammar across all products
Inspect firstParameters and risk before you run
SynchronousReturns when the resource is ready
Structured outputResults and errors, all JSON
Why ecctl

Designed for agents, not just terminals

01

Operate by resource, not endpoint

Operate Alibaba Cloud elastic computing resources through one product/resource/action grammar, without memorizing OpenAPI operation names or parameter expansion.

02

Inspect a command before running it

Before running, inspect a command’s required parameters, risk level, and waiting behavior.

03

Synchronous results

Asynchronous operations wait for the resource to be ready and read it back, so a command returns the final result rather than a pending status.

04

JSON results and errors

Output is JSON by default; failures are structured JSON too, with an error code, a retryable flag, and the cloud request_id.

05

Safe by default

Validate with a dry run, stay idempotent to avoid duplicate creates, and require confirmation before destructive deletes.

06

Fallback for the long tail

Common operations have ready-made commands; capabilities not yet modeled remain reachable through a raw OpenAPI call.

Everyday use

Run commands; look up details when you need them

Commands are organized by product, resource, and action, so most of the time you just run them.

  • Run the commandResource commands have a regular, predictable shape, so common operations run directly.
  • Add -h for flagsAppend -h to any command to see its usage, required fields, and flags.
  • Use schema for the full specFor complex parameters or automation, schema returns every parameter and behavior as structured JSON an agent can read.
Read the docs
Run the commandecctl ecs instance list --filter status=Running
Add -h for flagsecctl ecs instance create -h
Use schema for the full spececctl schema ecs.instance.create --brief

Operate Alibaba Cloud elastic computing with one set of resource commands

Follow the quick start to install ecctl and run your first resource command.

Read the docs