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.

⭐40stars🔀0forks📁View on GitHub🕐Updated Dec 18, 2025

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.
nameecs-cli-reference
descriptionAWS 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-toolsRead, 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 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