Amazon ECS website screenshot

Amazon ECS

Amazon Elastic Container Service (ECS) is a fully managed container orchestration service that makes it easy to deploy, manage, and scale containerized applications.

4 APIs 8 Features
AmazonAwsContainersDockerEcsOrchestration

APIs

Amazon ECS API

The Amazon ECS API provides programmatic access to manage containerized applications using Docker containers.

Amazon ECS Service Connect API

Amazon ECS Service Connect provides management of service-to-service communication as Amazon ECS configuration, building both service discovery and a service mesh for connecting...

Amazon ECS Anywhere API

Amazon ECS Anywhere extends Amazon ECS to support registering external instances such as on-premises servers or virtual machines to your Amazon ECS cluster, allowing you to run ...

AWS Copilot CLI

AWS Copilot is an open source command line interface that simplifies building, releasing, and operating production-ready containerized applications on Amazon ECS and AWS Fargate...

Collections

Pricing Plans

Amazon Ecs Plans Pricing

3 plans

PLANS

Rate Limits

Amazon Ecs Rate Limits

2 limits

RATE LIMITS

FinOps

Features

Fully Managed Container Orchestration

Run and manage Docker containers at scale without managing the underlying infrastructure or control plane.

AWS Fargate Integration

Run containers serverlessly without provisioning or managing EC2 instances using AWS Fargate launch type.

Service Auto Scaling

Automatically scale container workloads based on CloudWatch metrics, target tracking, or step scaling policies.

Service Connect

Built-in service discovery and service mesh for connecting containerized services within and across clusters.

ECS Anywhere

Extend ECS to on-premises and edge infrastructure to run containers on your own servers and virtual machines.

Capacity Providers

Manage compute capacity with capacity provider strategies for optimal resource allocation across EC2 and Fargate.

Task Definitions

Define containerized applications as task definitions with CPU, memory, networking, and IAM role configurations.

Container Insights

Monitor container performance metrics and logs with CloudWatch Container Insights for operational visibility.

Use Cases

Microservices Architecture

Deploy and manage microservices with independent scaling, deployment, and lifecycle management per service.

Batch Processing

Run batch computing workloads using ECS tasks with automatic scaling and job scheduling.

CI/CD Pipeline Deployment

Integrate with AWS CodePipeline and CodeDeploy for automated blue/green and rolling deployments of containerized applications.

Hybrid Cloud Workloads

Run containerized workloads across AWS cloud and on-premises environments using ECS Anywhere.

Machine Learning Inference

Deploy ML models as containerized inference endpoints with auto-scaling based on demand.

Semantic Vocabularies

Amazon Ecs Context

0 classes · 0 properties

JSON-LD

API Governance Rules

Amazon ECS API Rules

7 rules · 7 errors

SPECTRAL

JSON Structure

Amazon Ecs Attachment Structure

4 properties

JSON STRUCTURE

Amazon Ecs Capacity Provider Structure

6 properties

JSON STRUCTURE

Amazon Ecs Cluster Configuration Structure

2 properties

JSON STRUCTURE

Amazon Ecs Cluster Setting Structure

2 properties

JSON STRUCTURE

Amazon Ecs Cluster Structure

14 properties

JSON STRUCTURE

Amazon Ecs Container Definition Structure

38 properties

JSON STRUCTURE

Amazon Ecs Container Instance Structure

18 properties

JSON STRUCTURE

Amazon Ecs Container Structure

17 properties

JSON STRUCTURE

Amazon Ecs Create Cluster Request Structure

5 properties

JSON STRUCTURE

Amazon Ecs Create Cluster Response Structure

0 properties

JSON STRUCTURE

Amazon Ecs Create Service Request Structure

19 properties

JSON STRUCTURE

Amazon Ecs Deployment Configuration Structure

4 properties

JSON STRUCTURE

Amazon Ecs Deployment Controller Structure

1 properties

JSON STRUCTURE

Amazon Ecs Deployment Structure

15 properties

JSON STRUCTURE

Amazon Ecs Ephemeral Storage Structure

1 properties

JSON STRUCTURE

Amazon Ecs Error Structure

2 properties

JSON STRUCTURE

Amazon Ecs Failure Structure

3 properties

JSON STRUCTURE

Amazon Ecs Health Check Structure

5 properties

JSON STRUCTURE

Amazon Ecs Inference Accelerator Structure

2 properties

JSON STRUCTURE

Amazon Ecs Key Value Pair Structure

2 properties

JSON STRUCTURE

Amazon Ecs Linux Parameters Structure

7 properties

JSON STRUCTURE

Amazon Ecs Load Balancer Structure

4 properties

JSON STRUCTURE

Amazon Ecs Log Configuration Structure

3 properties

JSON STRUCTURE

Amazon Ecs Mount Point Structure

3 properties

JSON STRUCTURE

Amazon Ecs Network Configuration Structure

1 properties

JSON STRUCTURE

Amazon Ecs Placement Constraint Structure

2 properties

JSON STRUCTURE

Amazon Ecs Placement Strategy Structure

2 properties

JSON STRUCTURE

Amazon Ecs Port Mapping Structure

6 properties

JSON STRUCTURE

Amazon Ecs Proxy Configuration Structure

3 properties

JSON STRUCTURE

Amazon Ecs Resource Structure

6 properties

JSON STRUCTURE

Amazon Ecs Run Task Request Structure

15 properties

JSON STRUCTURE

Amazon Ecs Run Task Response Structure

2 properties

JSON STRUCTURE

Amazon Ecs Runtime Platform Structure

2 properties

JSON STRUCTURE

Amazon Ecs Service Registry Structure

4 properties

JSON STRUCTURE

Amazon Ecs Service Structure

27 properties

JSON STRUCTURE

Amazon Ecs Tag Structure

2 properties

JSON STRUCTURE

Amazon Ecs Task Definition Structure

23 properties

JSON STRUCTURE

Amazon Ecs Task Override Structure

6 properties

JSON STRUCTURE

Amazon Ecs Task Structure

34 properties

JSON STRUCTURE

Amazon Ecs Volume Structure

5 properties

JSON STRUCTURE

Example Payloads

Amazon Ecs Cluster Example

14 fields

EXAMPLE

Amazon Ecs Container Example

17 fields

EXAMPLE

Amazon Ecs Deployment Example

15 fields

EXAMPLE

Amazon Ecs Error Example

2 fields

EXAMPLE

Amazon Ecs Failure Example

3 fields

EXAMPLE

Amazon Ecs Resource Example

6 fields

EXAMPLE

Amazon Ecs Service Example

27 fields

EXAMPLE

Amazon Ecs Tag Example

2 fields

EXAMPLE

Amazon Ecs Task Example

34 fields

EXAMPLE

Amazon Ecs Volume Example

5 fields

EXAMPLE

Resources

🔗
Documentation
Documentation
💰
Pricing
Pricing
💬
FAQ
FAQ
🚀
GettingStarted
GettingStarted
🔗
Resources
Resources
🔗
Partners
Partners
📰
Blog
Blog
🟢
StatusPage
StatusPage
📦
SDKs
SDKs
🔗
CLI
CLI
🔗
Security
Security
🔗
Compliance
Compliance
🔗
BestPractices
BestPractices
🔗
Documentation
Documentation
🔗
Documentation
Documentation
🔗
Troubleshooting
Troubleshooting
🌐
Console
Console
🔗
KnowledgeCenter
KnowledgeCenter
📄
ChangeLog
ChangeLog
🔗
Documentation
Documentation
🔗
Documentation
Documentation
👥
GitHubRepository
GitHubRepository
👥
GitHubOrganization
GitHubOrganization

Sources

Raw ↑
opencollection: 1.0.0
info:
  name: Amazon ECS Amazon Elastic Container Service (ECS) API
  version: '2014-11-13'
request:
  auth:
    type: apikey
    key: Authorization
    value: '{{Authorization}}'
    placement: header
items:
- info:
    name: Clusters
    type: folder
  items:
  - info:
      name: Amazon Ecs Create a New Ecs Cluster
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.CreateCluster
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Creates a new Amazon ECS cluster. By default, your account receives a default cluster when you launch your first
      container instance. You can create additional clusters to group resources.
  - info:
      name: Amazon Ecs Delete an Ecs Cluster
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DeleteCluster
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Deletes the specified cluster. The cluster must have been deregistered, and must not contain any services or tasks.
  - info:
      name: Amazon Ecs Describe One or More Ecs Clusters
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeClusters
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Describes one or more of your clusters. Returns details about a cluster including its status, statistics, tags,
      and settings.
  - info:
      name: Amazon Ecs List Ecs Clusters
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ListClusters
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Returns a list of existing clusters.
  - info:
      name: Amazon Ecs Update an Ecs Cluster
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.UpdateCluster
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Updates the cluster settings and configuration.
  - info:
      name: Amazon Ecs Tag an Ecs Resource
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.TagResource
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Associates the specified tags to a resource with the specified resourceArn.
  - info:
      name: Amazon Ecs Remove Tags From an Ecs Resource
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.UntagResource
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Deletes specified tags from a resource.
  - info:
      name: Amazon Ecs List Tags for an Ecs Resource
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ListTagsForResource
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Lists the tags for the specified resource.
- info:
    name: Default
    type: folder
  items:
  - info:
      name: Amazon Ecs Create a New Ecs Service
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.CreateService
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Runs and maintains a specified number of instances of a task definition simultaneously in an ECS cluster. If the
      desired count of tasks in a service drops below the desired count, Amazon ECS runs another instantiation of the task
      to bring the count back up.
  - info:
      name: Amazon Ecs Delete an Ecs Service
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DeleteService
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Deletes a specified service within a cluster. You can delete a service if you have no running tasks in it and the
      desired task count is zero.
  - info:
      name: Amazon Ecs Describe One or More Ecs Services
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeServices
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Describes the specified services running in a cluster.
  - info:
      name: Amazon Ecs List Ecs Services
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ListServices
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Returns a list of services in a specified cluster.
  - info:
      name: Amazon Ecs Update an Ecs Service
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.UpdateService
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Modifies the parameters of a service. Changes take effect in a rolling update fashion depending on the deployment
      configuration.
- info:
    name: Task Definitions
    type: folder
  items:
  - info:
      name: Amazon Ecs Register a New Task Definition
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.RegisterTaskDefinition
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Registers a new task definition from the supplied family and container definitions. You can also register task definitions
      with a volumes parameter for data volumes used by the task containers.
  - info:
      name: Amazon Ecs Deregister a Task Definition
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DeregisterTaskDefinition
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Deregisters the specified task definition by family and revision. Upon deregistration, the task definition is marked
      as INACTIVE.
  - info:
      name: Amazon Ecs Describe a Task Definition
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeTaskDefinition
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Describes a task definition. You can specify a family and revision to find information about a specific task definition,
      or you can simply specify the family to find the latest ACTIVE revision in that family.
  - info:
      name: Amazon Ecs List Task Definitions
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ListTaskDefinitions
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Returns a list of task definitions that are registered to your account. You can filter by family name to find all
      revisions for a specific family.
  - info:
      name: Amazon Ecs List Task Definition Families
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ListTaskDefinitionFamilies
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Returns a list of task definition families that are registered to your account, with ACTIVE task definitions.
- info:
    name: Tasks
    type: folder
  items:
  - info:
      name: Amazon Ecs Run a New Task
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.RunTask
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Starts a new task using the specified task definition. You can specify the cluster, launch type, network configuration,
      and overrides.
  - info:
      name: Amazon Ecs Start a Task on a Specific Container Instance
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.StartTask
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Starts a new task from the specified task definition on the specified container instance or instances.
  - info:
      name: Amazon Ecs Stop a Running Task
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.StopTask
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Stops a running task. Resources are cleaned up and the task transitions to STOPPED status.
  - info:
      name: Amazon Ecs Describe One or More Tasks
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeTasks
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Describes a specified task or tasks in a cluster.
  - info:
      name: Amazon Ecs List Tasks
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ListTasks
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Returns a list of tasks. You can filter by cluster, container instance, family, or service.
  - info:
      name: Amazon Ecs Execute a Command in a Running Container
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ExecuteCommand
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Runs a command remotely on a container within a task that is managed by Amazon ECS using AWS Systems Manager Session
      Manager.
- info:
    name: Capacity Providers
    type: folder
  items:
  - info:
      name: Amazon Ecs Create a Capacity Provider
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.CreateCapacityProvider
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Creates a new capacity provider. Capacity providers are associated with an Auto Scaling group to manage the infrastructure
      for your tasks and services.
  - info:
      name: Amazon Ecs Describe Capacity Providers
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeCapacityProviders
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Describes one or more capacity providers.
- info:
    name: Container Instances
    type: folder
  items:
  - info:
      name: Amazon Ecs Describe Container Instances
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.DescribeContainerInstances
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Describes Amazon ECS container instances in a cluster.
  - info:
      name: Amazon Ecs List Container Instances
      type: http
    http:
      method: POST
      url: https://ecs.{region}.amazonaws.com/#X-Amz-Target=AmazonEC2ContainerServiceV20141113.ListContainerInstances
      headers:
      - name: X-Amz-Target
        value: ''
      body:
        type: json
        data: '{}'
    docs: Returns a list of container instances in a specified cluster.
bundled: true