AgentSkillsCN

ecs-api-reference

Amazon ECS API规范参考。当在KECS中实现兼容ECS的API时使用，以准确重现请求/响应结构、参数、错误码和行为。用于实现CreateCluster、CreateService、RunTask、RegisterTaskDefinition等API的参考。

SKILL.md
--- frontmatter
name: ecs-api-reference
description: Amazon ECS API specification reference. Use when implementing ECS-compatible APIs in KECS to accurately reproduce request/response structures, parameters, error codes, and behaviors. Reference for implementing APIs like CreateCluster, CreateService, RunTask, RegisterTaskDefinition.
allowed-tools: Read, Grep, Glob

Amazon ECS API Reference for KECS

Reference skill for implementing ECS-compatible APIs in KECS.

Overview

This skill provides detailed specifications for the following ECS API categories:

  1. •Cluster API - Cluster management (cluster-api.md)
  2. •Service API - Service management (service-api.md)
  3. •Task API - Task execution and management (task-api.md)
  4. •Task Definition API - Task definition management (task-definition-api.md)
  5. •Other APIs - Tags, TaskSets, Attributes, Account Settings, etc. (other-apis.md)

Use Cases

  • •Implementing new ECS API endpoints
  • •Verifying request/response structures of existing APIs
  • •Aligning error codes and behaviors with AWS ECS
  • •Writing API compatibility tests

Common API Specifications

HTTP Request Format

code
POST / HTTP/1.1
Host: ecs.{region}.amazonaws.com
Content-Type: application/x-amz-json-1.1
X-Amz-Target: AmazonEC2ContainerServiceV20141113.{ActionName}

Common Error Codes

ErrorHTTPDescription
ClientException400Client-side error (insufficient permissions, invalid ID, etc.)
InvalidParameterException400Invalid parameter
ServerException500Server error
ClusterNotFoundException400Cluster not found
ServiceNotFoundException400Service not found

Tag Limits

  • •Maximum 50 tags per resource
  • •Key length: Maximum 128 characters (UTF-8)
  • •Value length: Maximum 256 characters (UTF-8)
  • •aws: prefix is reserved (cannot edit or delete)

Pagination

  • •maxResults: 1-100 (default 10 or 100 depending on API)
  • •nextToken: Opaque continuation token

ARN Format

code
arn:aws:ecs:{region}:{account}:{resource-type}/{resource-id}

Resource types: cluster, service, task, task-definition, container-instance, capacity-provider, task-set

Detailed Specifications

Refer to the following support files for detailed API specifications:

  • •cluster-api.md - CreateCluster, DescribeClusters, ListClusters, DeleteCluster, UpdateCluster
  • •service-api.md - CreateService, DescribeServices, UpdateService, DeleteService, ListServices
  • •task-api.md - RunTask, StopTask, DescribeTasks, ListTasks, ExecuteCommand
  • •task-definition-api.md - RegisterTaskDefinition, DeregisterTaskDefinition, DescribeTaskDefinition, ListTaskDefinitions
  • •other-apis.md - TagResource, ListTagsForResource, CreateTaskSet, PutAttributes, PutAccountSetting, etc.