AWS CLI ECS Command Reference
This skill provides comprehensive AWS CLI ECS command specifications to ensure KECS compatibility with user expectations when using aws ecs commands.
Overview
AWS CLI ECS commands allow users to interact with Amazon ECS services. KECS emulates these APIs, so understanding CLI behavior is crucial for compatibility.
Global CLI Options
All ECS commands support these global options:
| Option |
Description |
--region |
AWS region to use |
--profile |
Named credential profile |
--output |
Output format: json, text, table, yaml, yaml-stream |
--query |
JMESPath filter for response |
--endpoint-url |
Override service endpoint (critical for KECS) |
--debug |
Enable debug logging |
--no-verify-ssl |
Disable SSL verification |
--no-paginate |
Disable automatic pagination |
Pagination Options
For paginated operations:
--max-items: Total items to return--page-size: Items per API call--starting-token: Resume from previous response
Input Options
--cli-input-json: Read arguments from JSON--cli-input-yaml: Read arguments from YAML--generate-cli-skeleton: Print request skeleton
Command Categories
Core Resources
- Cluster Commands: create-cluster, describe-clusters, list-clusters, delete-cluster, update-cluster
- Service Commands: create-service, describe-services, list-services, update-service, delete-service
- Task Commands: run-task, stop-task, describe-tasks, list-tasks, execute-command
- Task Definition Commands: register-task-definition, deregister-task-definition, describe-task-definition, list-task-definitions, list-task-definition-families
Advanced Features
- TaskSet Commands: create-task-set, describe-task-sets, update-task-set, delete-task-set
- Capacity Provider Commands: create-capacity-provider, describe-capacity-providers, update-capacity-provider, delete-capacity-provider, put-cluster-capacity-providers
- Attribute Commands: put-attributes, list-attributes, delete-attributes
- Tag Commands: tag-resource, untag-resource, list-tags-for-resource
- Account Settings: put-account-setting, put-account-setting-default, list-account-settings, delete-account-setting
KECS-Specific Usage
When using AWS CLI with KECS:
# Point to KECS endpoint
export AWS_ENDPOINT_URL=http://localhost:8080
# Or per-command
aws ecs list-clusters --endpoint-url http://localhost:8080
# With custom kubeconfig
export KUBECONFIG=/tmp/kecs-instance.config
aws ecs describe-clusters --cluster default
Support Files
cluster-commands.md: Cluster lifecycle commandsservice-commands.md: Service management commandstask-commands.md: Task execution and managementtask-definition-commands.md: Task definition registrationother-commands.md: Tags, attributes, account settings, capacity providers, task sets
1---2name: ecs-cli-reference3description: AWS CLI ECS command reference. Use when understanding how users interact with ECS via AWS CLI, including command syntax, options, examples, and output formats. Essential for KECS compatibility.4---5
6# AWS CLI ECS Command Reference
7
8This skill provides comprehensive AWS CLI ECS command specifications to ensure KECS compatibility with user expectations when using `aws ecs` commands.
9
10## Overview
11
12AWS CLI ECS commands allow users to interact with Amazon ECS services. KECS emulates these APIs, so understanding CLI behavior is crucial for compatibility.
13
14### Global CLI Options
15
16All ECS commands support these global options:
17
18| Option | Description |
19|--------|-------------|
20| `--region` | AWS region to use |
21| `--profile` | Named credential profile |
22| `--output` | Output format: `json`, `text`, `table`, `yaml`, `yaml-stream` |
23| `--query` | JMESPath filter for response |
24| `--endpoint-url` | Override service endpoint (critical for KECS) |
25| `--debug` | Enable debug logging |
26| `--no-verify-ssl` | Disable SSL verification |
27| `--no-paginate` | Disable automatic pagination |
28
29### Pagination Options
30
31For paginated operations:
32- `--max-items`: Total items to return
33- `--page-size`: Items per API call
34- `--starting-token`: Resume from previous response
35
36### Input Options
37
38- `--cli-input-json`: Read arguments from JSON
39- `--cli-input-yaml`: Read arguments from YAML
40- `--generate-cli-skeleton`: Print request skeleton
41
42## Command Categories
43
44### Core Resources
45- **Cluster Commands**: create-cluster, describe-clusters, list-clusters, delete-cluster, update-cluster
46- **Service Commands**: create-service, describe-services, list-services, update-service, delete-service
47- **Task Commands**: run-task, stop-task, describe-tasks, list-tasks, execute-command
48- **Task Definition Commands**: register-task-definition, deregister-task-definition, describe-task-definition, list-task-definitions, list-task-definition-families
49
50### Advanced Features
51- **TaskSet Commands**: create-task-set, describe-task-sets, update-task-set, delete-task-set
52- **Capacity Provider Commands**: create-capacity-provider, describe-capacity-providers, update-capacity-provider, delete-capacity-provider, put-cluster-capacity-providers
53- **Attribute Commands**: put-attributes, list-attributes, delete-attributes
54- **Tag Commands**: tag-resource, untag-resource, list-tags-for-resource
55- **Account Settings**: put-account-setting, put-account-setting-default, list-account-settings, delete-account-setting
56
57## KECS-Specific Usage
58
59When using AWS CLI with KECS:
60
61```bash
62# Point to KECS endpoint
63export AWS_ENDPOINT_URL=http://localhost:8080
64
65# Or per-command
66aws ecs list-clusters --endpoint-url http://localhost:8080
67
68# With custom kubeconfig
69export KUBECONFIG=/tmp/kecs-instance.config
70aws ecs describe-clusters --cluster default
71```
72
73## Support Files
74
75- `cluster-commands.md`: Cluster lifecycle commands
76- `service-commands.md`: Service management commands
77- `task-commands.md`: Task execution and management
78- `task-definition-commands.md`: Task definition registration
79- `other-commands.md`: Tags, attributes, account settings, capacity providers, task sets
majiayu000