Schema
Use schema and capabilities to inspect the command surface before running a
resource operation.
Products
ecctl schema --list
Output shape:
{
"products": [
{"name": "ack"},
{"name": "ecs"},
{"name": "lingjun"},
{"name": "vpc"}
]
}
Descriptions are included in the full output.
Resources and Actions
ecctl schema --list ecs
The ECS surface currently contains 16 resources, including:
| Resource | Actions |
|---|---|
instance | list, get, create, update, delete, exec, monitor, reboot, renew, sendfile, start, stop |
disk | list, get, create, update, delete, attach, clone, detach, monitor, reinit, reset |
sg | list, get, create, update, delete, authorize, revoke |
image | list, get, create, update, delete, copy, export, import |
Use Resource Coverage for the full public coverage list.
Command Schema
Brief schema:
ecctl schema ecs.instance.create --brief
Batch schema lookup:
ecctl schema vpc.vpc.create vpc.vswitch.create ecs.sg.create
The batch command returns a JSON object keyed by schema name. For mutating commands, the schema can include:
- required parameters
- output CLI form
- risk level
- dry-run support
- idempotency mode
- waiter name, target state, polling command, and timeout
Capabilities
ecctl capabilities --output json
The capabilities payload declares:
- schema version
1 - output modes
jsonandtext - structured errors written to
stdout - error fields such as
kind,code,message,retryable,suggestion,field, andaccepted_values - public product/resource/action coverage
Recommended Flow
- Run
ecctl schema --list. - Run
ecctl schema --list <product>. - Run
ecctl schema <product>.[<parent>.]<resource>.<action> --brief; include the parent segment only for a nested resource. - Use
--helpon the concrete command when you need human-readable flag descriptions. - Run the cloud operation with explicit
--regionand a known profile.