smithery.ai

ecs-api-reference

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.

First seen Mar 27, 2026

Installation

$ npx skills add https://smithery.ai

Summary

  • 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.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Skill metadata

Parsed from SKILL.md frontmatter.

Allowed toolsRead, Grep, Glob

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,799 B
  • docs SUMMARY.md 307 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

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.