Overcast is alpha — behaviour and APIs may change between releases. Pin your version and read the changelog before upgrading.

overcast

ECS operations

Every ECS operation Overcast declares — 40 of 48 implemented — with status, behaviour notes and a link to the AWS API reference for each.

40 of 48 listed operations are implemented. Back to ECS.

Summary

Category✅ Supported❌ Unsupported
General408

Endpoints

General

OperationStatusNotesAWS Docs
CreateCapacityProvider✅ SupportedFARGATE and FARGATE_SPOT built-ins seeded automatically; rejects FARGATE* prefix for custom providersdocs
CreateCluster✅ SupportedDefaults name to “default” if emptydocs
CreateService✅ SupportedValidates cluster + task def; creates PRIMARY deployment with rolloutState; scheduler starts Docker-backed tasks carrying the service networkConfiguration, ENI attachment and deployment ID in startedBy; networkConfiguration required when the task definition’s networkMode is awsvpc; deploymentController defaults to ECS; failed placements are recorded as service events and a FAILED rollout when a deploymentCircuitBreaker is enableddocs
CreateTaskSet✅ SupportedRequires CODE_DEPLOY or EXTERNAL deployment controller; Scale defaults to 100%; ComputedDesiredCount calculated from scaledocs
DeleteAccountSetting✅ SupportedRemoves override; subsequent reads return the hardcoded defaultdocs
DeleteAttributes❌ Unsupportedstub; returns 501docs
DeleteCluster✅ SupportedSets status INACTIVEdocs
DeleteService✅ SupportedSets DRAINING, desired=0; reconciler stops excess tasksdocs
DeleteTaskSet✅ SupportedReturns DRAINING status; removes from service task set listdocs
DeregisterContainerInstance✅ SupportedRemoves from store; returns INACTIVE instancedocs
DeregisterTaskDefinition✅ SupportedMarks INACTIVEdocs
DescribeCapacityProviders✅ SupportedFilter by name or return all; failures array for missing providersdocs
DescribeClusters✅ SupportedBy name or ARN; returns failures for missingdocs
DescribeContainerInstances✅ SupportedBy ARN; failures array for missingdocs
DescribeServices✅ SupportedBy name or ARN; recounts task state; returns failures for missingdocs
DescribeTaskDefinition✅ SupportedBy family, family:rev, or ARNdocs
DescribeTaskSets✅ SupportedFilter by task set ID or ARN; returns failures for missingdocs
DescribeTasks✅ SupportedBy task ID or ARN; returns failures for missingdocs
DiscoverPollEndpoint❌ Unsupportedstub; returns 501docs
ExecuteCommand❌ Unsupportedstub; returns 501docs
ListAccountSettings✅ SupportedReturns all known settings with effective values; filter by name; hardcoded defaultsdocs
ListAttributes❌ Unsupportedstub; returns 501docs
ListClusters✅ Supporteddocs
ListContainerInstances✅ SupportedFilter by cluster and optional statusdocs
ListServices✅ SupportedFilter by cluster; optional launchType filterdocs
ListTagsForResource✅ SupportedList tags for an ECS resourcedocs
ListTaskDefinitionFamilies✅ SupportedOptional familyPrefix filterdocs
ListTaskDefinitions✅ SupportedOptional familyPrefix filterdocs
ListTasks✅ SupportedFilter by cluster, desiredStatus, familydocs
PutAccountSetting✅ SupportedStores override for the caller; no per-principal scoping in emulatordocs
PutAccountSettingDefault✅ SupportedIdentical to PutAccountSetting in emulator (no principal distinction)docs
PutAttributes❌ Unsupportedstub; returns 501docs
PutClusterCapacityProviders✅ SupportedAssociates providers and default strategy with a clusterdocs
RegisterContainerInstance✅ SupportedMetadata-only; auto-generates ARN; status ACTIVE; agentConnected truedocs
RegisterTaskDefinition✅ SupportedFamily:revision versioning; Fargate: validates awsvpc networkMode, cpu/memory required with valid combos, rejects host.sourcePath and dockerVolumeConfiguration as AWS does; all four volume shapes honoured at placement (EFS, host.sourcePath binds, dockerVolumeConfiguration, name-only scratch); tags stored against the revision’s ARN, including overcast:hot-reload-pathdocs
RunTask✅ SupportedDocker-backed when available, metadata-only when no container runtime is wired; a task whose containers fail to start is STOPPED with stopCode TaskFailedToStart rather than reported RUNNING; async state transitions; networkConfiguration required when the task definition’s networkMode is awsvpc, synthetic ENI attachment returned, platformVersion defaults to LATEST; awsvpc task containers share one network namespace and address; each lastStatus transition emits an ECS Task State Change event to the default EventBridge bus; emulator-only and off by default, a task definition tagged overcast:debug=true (or overcast:debug/=true) under OVERCAST_ECS_DEBUGGER=true gets a step debugger port per named container, published on the task’s network namespace and released when the task stops — never observable on the AWS API, and a second running task of the same definition runs undebugged (#1939)docs
StartTask❌ Unsupportedstub; returns 501docs
StopTask✅ SupportedStops Docker containers; sets STOPPED with stopCode UserInitiated; cancels pending transitions; emits an ECS Task State Change event to the default EventBridge busdocs
TagResource✅ SupportedAdd tags to any ECS resource by ARNdocs
UntagResource✅ SupportedRemove tags by keydocs
UpdateCapacityProvider✅ SupportedRejects updates to built-in FARGATE/FARGATE_SPOT providersdocs
UpdateCluster✅ SupportedValidates cluster exists; returns current statedocs
UpdateClusterSettings✅ SupportedAccepts settings array (metadata only)docs
UpdateContainerAgent❌ Unsupportedstub; returns 501docs
UpdateContainerInstancesState❌ Unsupportedstub; returns 501docs
UpdateService✅ SupportedUpdate desiredCount and/or taskDefinition; task definition changes and forceNewDeployment start a new deployment whose tasks refresh launch-time secrets and mutable image tags; propagates networkConfiguration/platformVersion; the rollout honours deploymentConfiguration maximumPercent/minimumHealthyPercentdocs
UpdateServicePrimaryTaskSet✅ SupportedPromotes target to PRIMARY; demotes all other task sets to ACTIVEdocs
UpdateTaskSet✅ SupportedUpdates Scale and recalculates ComputedDesiredCountdocs