Claude Code Plugins

Community-maintained marketplace

Feedback

ecs-api-reference

@nandemo-ya/kecs
40
0

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.

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

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

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

Error HTTP Description
ClientException 400 Client-side error (insufficient permissions, invalid ID, etc.)
InvalidParameterException 400 Invalid parameter
ServerException 500 Server error
ClusterNotFoundException 400 Cluster not found
ServiceNotFoundException 400 Service 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

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.