# Amazon EC2 Container Service API

> Amazon EC2 Container Service API on Apizie: 56 endpoints (Creates a new capacity provider. Capacity providers are associated with an Amazon ECS cluster and are used…, Creates a new Amazon ECS cluster. By default, your account receives a default cluster when you launch your…, Runs and maintains your desired number of tasks from a specified task definition. If the number of tasks…, Create a task set in the specified cluster and service. This is used when a service uses the EXTERNAL…, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:amazonaws-ecs`
- Category: Cloud
- Status: byok
- Source: https://github.com/mermade/aws2openapi
- Page: https://zieapi.vercel.app/api/cloud/amazonaws-ecs
- OpenAPI: https://zieapi.vercel.app/api/cloud/amazonaws-ecs/openapi.json

Amazon Elastic Container Service Amazon Elastic Container Service (Amazon ECS) is a highly scalable, fast, container management service. It makes it easy to run, stop, and manage Docker containers. You can host your…

## Endpoints

### Creates a new capacity provider. Capacity providers are associated with an Amazon ECS cluster and are used…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/create-capacity-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Creates a new Amazon ECS cluster. By default, your account receives a default cluster when you launch your…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/create-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Runs and maintains your desired number of tasks from a specified task definition. If the number of tasks…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/create-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Create a task set in the specified cluster and service. This is used when a service uses the EXTERNAL…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/create-task-set` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Disables an account setting for a specified user, role, or the root user for an account.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/delete-account-setting` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes one or more custom attributes from an Amazon ECS resource.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/delete-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes the specified capacity provider. The FARGATE and FARGATE_SPOT capacity providers are reserved and…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/delete-capacity-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes the specified cluster. The cluster transitions to the INACTIVE state. Clusters with an INACTIVE…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/delete-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes a specified service within a cluster. You can delete a service if you have no running tasks in it…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/delete-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes one or more task definitions. You must deregister a task definition revision before you delete it.…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/delete-task-definitions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes a specified task set within a service. This is used when a service uses the EXTERNAL deployment…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/delete-task-set` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deregisters an Amazon ECS container instance from the specified cluster. This instance is no longer…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/deregister-container-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deregisters the specified task definition by family and revision. Upon deregistration, the task definition…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/deregister-task-definition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Describes one or more of your capacity providers.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/describe-capacity-providers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Describes one or more of your clusters.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/describe-clusters` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Describes one or more container instances. Returns metadata about each container instance requested.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/describe-container-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Describes the specified services running in your cluster.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/describe-services` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Describes a task definition. You can specify a family and revision to find information about a specific task…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/describe-task-definition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Describes the task sets in the specified cluster and service. This is used when a service uses the EXTERNAL…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/describe-task-sets` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Describes a specified task or tasks. Currently, stopped tasks appear in the returned results for at least…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/describe-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/discover-poll-endpoint` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Runs a command remotely on a container within a task. If you use a condition key in your IAM policy to…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/execute-command` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Retrieves the protection status of tasks in an Amazon ECS service.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/get-task-protection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Lists the account settings for a specified principal.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/list-account-settings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Lists the attributes for Amazon ECS resources within a specified target type and cluster. When you specify a…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/list-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Returns a list of existing clusters.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/list-clusters` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Returns a list of container instances in a specified cluster. You can filter the results of a…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/list-container-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Returns a list of services. You can filter the results by cluster, launch type, and scheduling strategy.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/list-services` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### This operation lists all of the services that are associated with a Cloud Map namespace. This list might…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/list-services-by-namespace` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### List the tags for an Amazon ECS resource.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/list-tags-for-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Returns a list of task definition families that are registered to your account. This list includes task…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/list-task-definition-families` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Returns a list of task definitions that are registered to your account. You can filter the results by family…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/list-task-definitions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Returns a list of tasks. You can filter the results by cluster, task definition family, container instance,…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/list-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| maxResults | string | no | Pagination limit |
| nextToken | string | no | Pagination token |
| body | object | no | JSON request body |

### Modifies an account setting. Account settings are set on a per-Region basis. If you change the root user…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/put-account-setting` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Modifies an account setting for all users on an account for whom no individual account setting has been…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/put-account-setting-default` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Create or update an attribute on an Amazon ECS resource. If the attribute doesn't exist, it's created. If…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/put-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Modifies the available capacity providers and the default capacity provider strategy for a cluster. You must…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/put-cluster-capacity-providers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/register-container-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Registers a new task definition from the supplied family and containerDefinitions . Optionally, you can add…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/register-task-definition` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Starts a new task using the specified task definition. You can allow Amazon ECS to place tasks for you, or…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/run-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Starts a new task from the specified task definition on the specified container instance or instances.…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/start-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Stops a running task. Any tags associated with the task will be deleted. When StopTask is called on a task,…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/stop-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent. Sent…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/submit-attachment-state-changes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent. Sent…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/submit-container-state-change` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent. Sent…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/submit-task-state-change` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Associates the specified tags to a resource with the specified resourceArn . If existing tags on a resource…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/tag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Deletes specified tags from a resource.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/untag-resource` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Modifies the parameters for a capacity provider.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/update-capacity-provider` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates the cluster.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/update-cluster` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Modifies the settings to use for a cluster.
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/update-cluster-settings` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates the Amazon ECS container agent on a specified container instance. Updating the Amazon ECS container…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/update-container-agent` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Modifies the status of an Amazon ECS container instance. Once a container instance has reached an ACTIVE…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/update-container-instances-state` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Modifies the parameters of a service. For services using the rolling update ( ECS ) you can update the…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/update-service` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Modifies which task set in a service is the primary task set. Any parameters that are updated on the primary…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/update-service-primary-task-set` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Updates the protection status of a task. You can set protectionEnabled to true to protect your task from…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/update-task-protection` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

### Modifies a task set. This is used when a service uses the EXTERNAL deployment controller type. For more…
`POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/update-task-set` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| region | string | no | The AWS region |
| body | object | no | JSON request body |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/create-capacity-provider" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Amazon EC2 Container Service API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:amazonaws-ecs/create-capacity-provider with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Amazon EC2 Container Service API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Amazon EC2 Container Service itself also needs your own key from amazonaws.com.

### Can AI agents use the Amazon EC2 Container Service API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:amazonaws-ecs.

### What is the status of the Amazon EC2 Container Service API?
Needs your own provider key (bring your own key)