ecs-cli-reference
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.
When & Why to Use This Skill
This Claude skill provides a comprehensive technical reference for AWS CLI ECS commands, specifically optimized for developers and DevOps engineers working with Amazon ECS and KECS (Kubernetes ECS) environments. It streamlines cloud infrastructure management by offering instant access to command syntax, global options, and resource lifecycle management details, ensuring high compatibility and operational efficiency.
Use Cases
- Container Orchestration Management: Quickly retrieve syntax for managing the lifecycle of ECS clusters, services, and tasks to maintain high availability.
- KECS Compatibility & Emulation: Ensure that custom or local ECS-compatible environments (like KECS) perfectly mirror standard AWS CLI behaviors and output formats.
- DevOps Scripting and Automation: Reference precise command options, pagination tokens, and JMESPath query filters to build robust CI/CD pipelines and automation scripts.
- Infrastructure Troubleshooting: Utilize detailed documentation on global options like --debug, --endpoint-url, and --query to diagnose connectivity issues and filter complex API responses.
| name | ecs-cli-reference |
|---|---|
| description | 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. |
| allowed-tools | Read, Grep, Glob |
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