AWS's ecs service · portable interface driver.ECS · AWS index
| Operation | Description |
|---|---|
CreateCapacityProvider |
|
CreateCluster |
|
CreateService |
|
DeleteAccountSetting |
|
DeleteAttributes |
|
DeleteCapacityProvider |
|
DeleteCluster |
|
DeleteService |
|
DeregisterContainerInstance |
|
DeregisterTaskDefinition |
|
DescribeCapacityProviders |
|
DescribeClusters |
|
DescribeContainerInstances |
|
DescribeServices |
|
DescribeTaskDefinition |
|
DescribeTasks |
|
ExecuteCommand |
|
ListAccountSettings |
|
ListAttributes |
|
ListClusters |
|
ListContainerInstances |
|
ListServices |
|
ListTagsForResource |
|
ListTaskDefinitionFamilies |
|
ListTaskDefinitions |
|
ListTasks |
|
PutAccountSetting |
|
PutAccountSettingDefault |
|
PutAttributes |
|
PutClusterCapacityProviders |
|
RegisterContainerInstance |
|
RegisterTaskDefinition |
|
RunTask |
|
StopTask |
|
TagResource |
|
UntagResource |
|
UpdateCapacityProvider |
|
UpdateCluster |
|
UpdateClusterSettings |
|
UpdateContainerInstancesState |
|
UpdateService |
Discovered by type assertion; only some providers implement these.
ServiceDeployments exposes the deployment history of ECS-controller services.
| Operation | Description |
|---|---|
DescribeServiceDeployments |
|
DescribeServiceRevisions |
|
ListServiceDeployments |
|
StopServiceDeployment |
ServiceNamespaces lists the services that joined a Service Connect namespace.
| Operation | Description |
|---|---|
ListServicesByNamespace |
TaskProtection reads and changes the scale-in protection of service tasks.
| Operation | Description |
|---|---|
GetTaskProtection |
|
UpdateTaskProtection |
TaskSets manages task sets, the task groups of EXTERNAL-controller services.
| Operation | Description |
|---|---|
CreateTaskSet |
|
DeleteTaskSet |
|
DescribeTaskSets |
|
UpdateServicePrimaryTaskSet |
|
UpdateTaskSet |
- No workload runs unless a container engine is attached, so the usage-driven metrics (
CPUUtilization,MemoryUtilization, network and storage series) are never published. Only metrics derived from state the emulator holds are:AWS/ECSCPUReservation,MemoryReservationandLiveTaskCount, and theECS/ContainerInsightstask, service, instance, deployment and task-set counts (only for clusters withcontainerInsightsenabled or enhanced, or enabled on the account). - Task lifecycle events cover PROVISIONING (awsvpc tasks), PENDING, ACTIVATING, RUNNING, DEACTIVATING, STOPPING, DEPROVISIONING (awsvpc tasks) and STOPPED. The transient
DELETEDstate is not published. A task counts as awsvpc when it has an ENI attachment, which today only Fargate tasks do. - Container-instance state-change events omit
versionInfo(agent and Docker versions), since the emulator runs no agent. ECS Deployment State Changeevents are published for the in-progress and completed states. The deployment circuit breaker is stored and echoed but never trips, soSERVICE_DEPLOYMENT_FAILEDand automatic rollback do not happen.SERVICE_TASK_PLACEMENT_FAILUREis published when a service create or update leaves tasks unplaced, not when a replacement task cannot be placed.SERVICE_DESIRED_COUNT_UPDATEDis not published: it signals scheduler or Service Auto Scaling changes, which the emulator does not model.- Service deployments and revisions exist for services that use the ECS deployment controller; they complete immediately, so
StopServiceDeploymentonly succeeds while the deployment is still in progress, which is the--async-settlewindow. A stop of a completed deployment is aConflictException. The lifecycle stage is not reported, and blue/green, linear and canary strategies, lifecycle hooks, alarms andContinueServiceDeploymentare not modelled. The newest 100 deployments of a service are kept. - Task sets run their tasks directly and replace a stopped task to restore
computedDesiredCount. They are not registered with load balancer target groups or service discovery, and a capacity provider strategy on a task set is stored and echoed but not used for placement (the same as for services). ListServicesByNamespacematches a service by the namespace string (name or ARN) it was configured with. There is no Cloud Map in the emulator to resolve one to the other, so an unknown namespace lists nothing instead of returningNamespaceNotFoundException.- Where AWS does not document an exact message or exception, the emulator picks the closest documented exception and its own wording: a task-set call on a service that does not use the EXTERNAL controller, an invalid
launchType,ExecuteCommandon a task that is not RUNNING, andStopTaskon an already-stopped task (it keeps the original reason). DeleteTaskSetdrains the set immediately whether or notforceis set.CreateClusteron an existing ACTIVE name returns that cluster unchanged and ignores the tags and settings in the new request.