AgentSkillsCN

ecs-cli-reference

AWS CLI ECS命令参考。当理解用户如何通过AWS CLI与ECS交互时使用，包括命令语法、选项、示例和输出格式。对于KECS兼容性至关重要。

SKILL.md
--- frontmatter
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:

OptionDescription
--regionAWS region to use
--profileNamed credential profile
--outputOutput format: json, text, table, yaml, yaml-stream
--queryJMESPath filter for response
--endpoint-urlOverride service endpoint (critical for KECS)
--debugEnable debug logging
--no-verify-sslDisable SSL verification
--no-paginateDisable 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:

bash
# 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