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