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 commands
service-commands.md: Service management commands
task-commands.md: Task execution and management
task-definition-commands.md: Task definition registration
other-commands.md: Tags, attributes, account settings, capacity providers, task sets
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
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. Use when this capability is needed.4---56# AWS CLI ECS Command Reference78This skill provides comprehensive AWS CLI ECS command specifications to ensure KECS compatibility with user expectations when using `aws ecs` commands.910## Overview1112AWS CLI ECS commands allow users to interact with Amazon ECS services. KECS emulates these APIs, so understanding CLI behavior is crucial for compatibility.1314### Global CLI Options1516All ECS commands support these global options:1718| 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 |2829### Pagination Options3031For paginated operations:32- `--max-items`: Total items to return33- `--page-size`: Items per API call34- `--starting-token`: Resume from previous response3536### Input Options3738- `--cli-input-json`: Read arguments from JSON39- `--cli-input-yaml`: Read arguments from YAML40- `--generate-cli-skeleton`: Print request skeleton4142## Command Categories4344### Core Resources45- **Cluster Commands**: create-cluster, describe-clusters, list-clusters, delete-cluster, update-cluster46- **Service Commands**: create-service, describe-services, list-services, update-service, delete-service47- **Task Commands**: run-task, stop-task, describe-tasks, list-tasks, execute-command48- **Task Definition Commands**: register-task-definition, deregister-task-definition, describe-task-definition, list-task-definitions, list-task-definition-families4950### Advanced Features51- **TaskSet Commands**: create-task-set, describe-task-sets, update-task-set, delete-task-set52- **Capacity Provider Commands**: create-capacity-provider, describe-capacity-providers, update-capacity-provider, delete-capacity-provider, put-cluster-capacity-providers53- **Attribute Commands**: put-attributes, list-attributes, delete-attributes54- **Tag Commands**: tag-resource, untag-resource, list-tags-for-resource55- **Account Settings**: put-account-setting, put-account-setting-default, list-account-settings, delete-account-setting5657## KECS-Specific Usage5859When using AWS CLI with KECS:6061```bash62# Point to KECS endpoint63export AWS_ENDPOINT_URL=http://localhost:80806465# Or per-command66aws ecs list-clusters --endpoint-url http://localhost:80806768# With custom kubeconfig69export KUBECONFIG=/tmp/kecs-instance.config70aws ecs describe-clusters --cluster default71```7273## Support Files7475- `cluster-commands.md`: Cluster lifecycle commands76- `service-commands.md`: Service management commands77- `task-commands.md`: Task execution and management78- `task-definition-commands.md`: Task definition registration79- `other-commands.md`: Tags, attributes, account settings, capacity providers, task sets8081---82> Converted and distributed by [TomeVault](https://tomevault.io/claim/nandemo-ya) — claim your Tome and manage your conversions.83<!-- tomevault:4.0:skill_md:2026-04-11 -->