{ "version": "1.0", "examples": { "AssociateGatewayWithCluster": [ { "input": { "cluster": "my-cluster", "gateway": "my-gateway" }, "output": { "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster", "gatewayArn": "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678", "status": "ACTIVE" }, "description": "This example associates the gateway named my-gateway with the cluster named my-cluster so that services in the cluster can use the gateway for ingress.", "id": "example-1", "title": "To associate a gateway with a cluster" } ], "ContinueServiceDeployment": [ { "input": { "action": "CONTINUE", "hookId": "ecs-pause-Xk7rT2mP9sLwQn4vB8fYd3hJ6gA1cE5iO0uR_ZpWq", "serviceDeploymentArn": "arn:aws:ecs:us-east-1:123456789012:service-deployment/MyCluster/MyService/r9i43YFjvgF_xlg7m2eJ1r" }, "output": { "serviceDeploymentArn": "arn:aws:ecs:us-east-1:123456789012:service-deployment/MyCluster/MyService/r9i43YFjvgF_xlg7m2eJ1r" }, "description": "This example continues a service deployment that is paused at a lifecycle hook, using the CONTINUE action to proceed to the next deployment stage.", "id": "example-1", "title": "To continue a paused service deployment" }, { "input": { "action": "ROLLBACK", "hookId": "ecs-pause-Xk7rT2mP9sLwQn4vB8fYd3hJ6gA1cE5iO0uR_ZpWq", "serviceDeploymentArn": "arn:aws:ecs:us-east-1:123456789012:service-deployment/MyCluster/MyService/r9i43YFjvgF_xlg7m2eJ1r" }, "output": { "serviceDeploymentArn": "arn:aws:ecs:us-east-1:123456789012:service-deployment/MyCluster/MyService/r9i43YFjvgF_xlg7m2eJ1r" }, "description": "This example rolls back a service deployment that is paused at a lifecycle hook, using the ROLLBACK action to revert to the previous service revision.", "id": "example-2", "title": "To roll back a paused service deployment" } ], "CreateCapacityProvider": [ { "input": { "name": "MyCapacityProvider", "autoScalingGroupProvider": { "autoScalingGroupArn": "arn:aws:autoscaling:us-east-1:123456789012:autoScalingGroup:57ffcb94-11f0-4d6d-bf60-3bac5EXAMPLE:autoScalingGroupName/MyASG", "managedScaling": { "status": "ENABLED", "targetCapacity": 100 }, "managedTerminationProtection": "ENABLED" } }, "output": { "capacityProvider": { "name": "MyCapacityProvider", "autoScalingGroupProvider": { "autoScalingGroupArn": "arn:aws:autoscaling:us-east-1:132456789012:autoScalingGroup:57ffcb94-11f0-4d6d-bf60-3bac5EXAMPLE:autoScalingGroupName/MyASG", "managedScaling": { "instanceWarmupPeriod": 300, "maximumScalingStepSize": 10000, "minimumScalingStepSize": 1, "status": "ENABLED", "targetCapacity": 100 }, "managedTerminationProtection": "ENABLED" }, "capacityProviderArn": "arn:aws:ecs:us-east-1:123456789012:capacity-provider/MyCapacityProvider", "status": "ACTIVE", "tags": [] } }, "description": "This example creates a capacity provider that uses the specified Auto Scaling group MyASG and has managed scaling and manager termination protection enabled. ", "id": "example-1", "title": "To create a capacity provider " } ], "CreateCluster": [ { "input": { "clusterName": "my_cluster" }, "output": { "cluster": { "activeServicesCount": 0, "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/my_cluster", "clusterName": "my_cluster", "pendingTasksCount": 0, "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "status": "ACTIVE" } }, "description": "This example creates a cluster in your default region.", "id": "example-1", "title": "To create a new cluster" } ], "CreateDaemon": [ { "input": { "capacityProviderArns": [ "arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-capacity-provider" ], "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster", "daemonName": "my-monitoring-daemon", "daemonTaskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/monitoring-agent:1", "deploymentConfiguration": { "bakeTimeInMinutes": 5, "drainPercent": 10.0 } }, "output": { "createdAt": "2025-03-15T12:00:00.000Z", "daemonArn": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-monitoring-daemon", "deploymentArn": "arn:aws:ecs:us-east-1:123456789012:daemon-deployment/my-cluster/my-monitoring-daemon/aB1cD2eF3gH4iJ5k", "status": "ACTIVE" }, "description": "This example creates a daemon named my-monitoring-daemon in the specified cluster that uses the monitoring-agent daemon task definition and deploys to the specified capacity provider.", "id": "example-1", "title": "To create a daemon" } ], "CreateGateway": [ { "input": { "name": "my-gateway", "configuration": { "hostSharedAlb": { "httpDesync": "defensive", "maxAlbCount": 10, "networkConfiguration": { "ipAddressType": "ipv4", "subnets": [ "subnet-0123456789abcdef0", "subnet-0fedcba9876543210" ] }, "port": 443, "protocol": "HTTPS", "scheme": "internet-facing" } }, "infrastructureRoleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole", "propagateTags": "GATEWAY", "tags": [ { "key": "team", "value": "web" } ] }, "output": { "name": "my-gateway", "gatewayArn": "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678", "status": "ACTIVE" }, "description": "This example creates a gateway named my-gateway that uses internet-facing Application Load Balancers with host-based routing in the specified subnets.", "id": "example-1", "title": "To create a gateway" } ], "CreateService": [ { "input": { "desiredCount": 10, "serviceName": "ecs-simple-service", "taskDefinition": "hello_world" }, "output": { "service": { "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default", "createdAt": "2016-08-29T16:13:47.298Z", "deploymentConfiguration": { "maximumPercent": 200, "minimumHealthyPercent": 100 }, "deployments": [ { "createdAt": "2016-08-29T16:13:47.298Z", "desiredCount": 10, "id": "ecs-svc/9223370564342348388", "pendingCount": 0, "runningCount": 0, "status": "PRIMARY", "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6", "updatedAt": "2016-08-29T16:13:47.298Z" }, { "createdAt": "2016-08-29T15:52:44.481Z", "desiredCount": 0, "id": "ecs-svc/9223370564343611322", "pendingCount": 0, "runningCount": 0, "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6", "updatedAt": "2016-08-29T16:11:38.941Z" } ], "desiredCount": 10, "events": [], "loadBalancers": [], "pendingCount": 0, "runningCount": 0, "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/default/ecs-simple-service", "serviceName": "ecs-simple-service", "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/default/hello_world:6" } }, "description": "This example creates a service in your default region called ``ecs-simple-service``. The service uses the ``hello_world`` task definition and it maintains 10 copies of that task.", "id": "example-1", "title": "To create a new service" }, { "input": { "desiredCount": 10, "loadBalancers": [ { "containerName": "simple-app", "containerPort": 80, "loadBalancerName": "EC2Contai-EcsElast-15DCDAURT3ZO2" } ], "role": "ecsServiceRole", "serviceName": "ecs-simple-service-elb", "taskDefinition": "console-sample-app-static" }, "output": { "service": { "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default", "createdAt": "2016-08-29T16:02:54.884Z", "deploymentConfiguration": { "maximumPercent": 200, "minimumHealthyPercent": 100 }, "deployments": [ { "createdAt": "2016-08-29T16:02:54.884Z", "desiredCount": 10, "id": "ecs-svc/9223370564343000923", "pendingCount": 0, "runningCount": 0, "status": "PRIMARY", "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/console-sample-app-static:6", "updatedAt": "2016-08-29T16:02:54.884Z" } ], "desiredCount": 10, "events": [], "loadBalancers": [ { "containerName": "simple-app", "containerPort": 80, "loadBalancerName": "EC2Contai-EcsElast-15DCDAURT3ZO2" } ], "pendingCount": 0, "roleArn": "arn:aws:iam::012345678910:role/ecsServiceRole", "runningCount": 0, "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/default/ecs-simple-service-elb", "serviceName": "ecs-simple-service-elb", "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/default/console-sample-app-static:6" } }, "description": "This example creates a service in your default region called ``ecs-simple-service-elb``. The service uses the ``ecs-demo`` task definition and it maintains 10 copies of that task. You must reference an existing load balancer in the same region by its name.", "id": "example-2", "title": "To create a new service behind a load balancer" }, { "input": { "deploymentConfiguration": { "lifecycleHooks": [ { "lifecycleStages": [ "POST_PRODUCTION_TRAFFIC_SHIFT" ], "targetType": "PAUSE", "timeoutConfiguration": { "action": "ROLLBACK", "timeoutInMinutes": 60 } } ], "strategy": "BLUE_GREEN" }, "desiredCount": 2, "serviceName": "ecs-service-with-pause-hook", "taskDefinition": "ecs-demo" }, "output": { "service": { "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default", "createdAt": "2026-05-06T16:00:00.000Z", "deploymentConfiguration": { "lifecycleHooks": [ { "lifecycleStages": [ "POST_PRODUCTION_TRAFFIC_SHIFT" ], "targetType": "PAUSE", "timeoutConfiguration": { "action": "ROLLBACK", "timeoutInMinutes": 60 } } ], "maximumPercent": 200, "minimumHealthyPercent": 100, "strategy": "BLUE_GREEN" }, "deployments": [ { "createdAt": "2026-05-06T16:00:00.000Z", "desiredCount": 2, "id": "ecs-svc/9223370564342348388", "pendingCount": 0, "runningCount": 0, "status": "PRIMARY", "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/ecs-demo:1", "updatedAt": "2026-05-06T16:00:00.000Z" } ], "desiredCount": 2, "events": [], "loadBalancers": [], "pendingCount": 0, "runningCount": 0, "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/default/ecs-service-with-pause-hook", "serviceName": "ecs-service-with-pause-hook", "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/ecs-demo:1" } }, "description": "This example creates a service with a blue/green deployment strategy that includes a pause lifecycle hook at the POST_PRODUCTION_TRAFFIC_SHIFT stage. The deployment will pause at that stage until you explicitly continue or roll back using the ContinueServiceDeployment API, or until the 60-minute timeout expires and triggers a rollback.", "id": "example-3", "title": "To create a service with a pause lifecycle hook" }, { "input": { "desiredCount": 2, "monitoring": { "metricConfigurations": [ { "metricNames": [ "CPUUtilization", "MemoryUtilization" ], "resolutionSeconds": 20 } ] }, "serviceName": "ecs-monitored-service", "taskDefinition": "my-app:1" }, "output": { "service": { "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default", "deploymentConfiguration": { "maximumPercent": 200, "minimumHealthyPercent": 100 }, "desiredCount": 2, "pendingCount": 0, "runningCount": 0, "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/default/ecs-monitored-service", "serviceName": "ecs-monitored-service", "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/my-app:1" } }, "description": "This example creates a service with a monitoring configuration that sets 20-second resolution for CPUUtilization and MemoryUtilization CloudWatch metrics. The monitoring configuration is not returned in the CreateService response. Use DescribeServiceRevisions to view the monitoring configuration.", "id": "example-4", "title": "To create a service with a monitoring configuration" } ], "CreateTaskSet": [ { "input": { "cluster": "MyCluster", "networkConfiguration": { "awsvpcConfiguration": { "securityGroups": [ "sg-12344321" ], "subnets": [ "subnet-12344321" ] } }, "service": "MyService", "taskDefinition": "MyTaskDefinition:2" }, "output": { "taskSet": { "computedDesiredCount": 0, "createdAt": 1557128360.711, "id": "ecs-svc/1234567890123456789", "launchType": "EC2", "loadBalancers": [], "networkConfiguration": { "awsvpcConfiguration": { "assignPublicIp": "DISABLED", "securityGroups": [ "sg-12344321" ], "subnets": [ "subnet-12344321" ] } }, "pendingCount": 0, "runningCount": 0, "scale": { "value": 0, "unit": "PERCENT" }, "serviceRegistries": [], "stabilityStatus": "STABILIZING", "stabilityStatusAt": 1557128360.711, "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/MyTaskDefinition:2", "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", "updatedAt": 1557128360.711 } }, "description": "This example creates a task set in a service that uses the EXTERNAL deployment controller.", "id": "example-1", "title": "To create a task set" } ], "DeleteAccountSetting": [ { "input": { "name": "serviceLongArnFormat" }, "output": { "setting": { "name": "serviceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam:::user/principalName" } }, "description": "This example deletes the account setting for your user for the specified resource type.", "id": "example-1", "title": "To delete your account setting" }, { "input": { "name": "containerInstanceLongArnFormat", "principalArn": "arn:aws:iam:::user/principalName" }, "output": { "setting": { "name": "containerInstanceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam:::user/principalName" } }, "description": "This example deletes the account setting for a specific IAM user or IAM role for the specified resource type. Only the root user can view or modify the account settings for another user.", "id": "example-2", "title": "To delete the account settings for a specific IAM user or IAM role" } ], "DeleteAttributes": [ { "input": { "attributes": [ { "name": "stack", "targetId": "aws:ecs:us-west-2:130757420319:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34" } ] }, "output": { "attributes": [ { "name": "stack", "value": "production", "targetId": "aws:ecs:us-west-2:130757420319:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34" } ] }, "description": "This example deletes an attribute named stack from a container instance. ", "id": "example-1", "title": "To delete a custom attribute from an Amazon ECS instance" } ], "DeleteCapacityProvider": [ { "input": { "capacityProvider": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/ExampleCapacityProvider" }, "output": { "capacityProvider": { "name": "ExampleCapacityProvider", "autoScalingGroupProvider": { "autoScalingGroupArn": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup", "managedScaling": { "maximumScalingStepSize": 10000, "minimumScalingStepSize": 1, "status": "ENABLED", "targetCapacity": 100 }, "managedTerminationProtection": "DISABLED" }, "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/ExampleCapacityProvider", "status": "ACTIVE", "tags": [], "updateStatus": "DELETE_IN_PROGRESS" } }, "description": "This example deletes a specified capacity provider. ", "id": "example-1", "title": "To delete a specified capacity provider" } ], "DeleteCluster": [ { "input": { "cluster": "my_cluster" }, "output": { "cluster": { "activeServicesCount": 0, "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/my_cluster", "clusterName": "my_cluster", "pendingTasksCount": 0, "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "status": "INACTIVE" } }, "description": "This example deletes an empty cluster in your default region.", "id": "example-1", "title": "To delete an empty cluster" } ], "DeleteDaemon": [ { "input": { "daemonArn": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-monitoring-daemon" }, "output": { "createdAt": "2025-03-15T12:00:00.000Z", "daemonArn": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-monitoring-daemon", "deploymentArn": "arn:aws:ecs:us-east-1:123456789012:daemon-deployment/my-cluster/my-monitoring-daemon/mN3oP4qR5sT6uV7w", "status": "DELETE_IN_PROGRESS", "updatedAt": "2025-03-25T09:00:00.000Z" }, "description": "This example deletes the my-monitoring-daemon daemon.", "id": "example-1", "title": "To delete a daemon" } ], "DeleteDaemonTaskDefinition": [ { "input": { "daemonTaskDefinition": "monitoring-agent:1" }, "output": { "daemonTaskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/monitoring-agent:1" }, "description": "This example deletes the first revision of the monitoring-agent daemon task definition.", "id": "example-1", "title": "To delete a daemon task definition" } ], "DeleteGateway": [ { "input": { "gateway": "my-gateway" }, "output": { "name": "my-gateway", "gatewayArn": "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678", "status": "DELETED" }, "description": "This example deletes the gateway named my-gateway. Deletion protection must be disabled and the gateway must not be associated with any clusters.", "id": "example-1", "title": "To delete a gateway" } ], "DeleteService": [ { "input": { "service": "my-http-service" }, "output": {}, "description": "This example deletes the my-http-service service. The service must have a desired count and running count of 0 before you can delete it.", "id": "example-1", "title": "To delete a service" } ], "DeleteTaskDefinitions": [ { "input": { "taskDefinitions": [ "Example-task-definition:1" ] }, "output": { "failures": [], "taskDefinitions": [ { "containerDefinitions": [ { "name": "wave", "command": [ "apt-get update; apt-get install stress; while true; do stress --cpu $(( RANDOM % 4 )) -t $(( RANDOM % 10 )); done" ], "cpu": 50, "entryPoint": [ "bash", "-c" ], "environment": [], "essential": true, "image": "public.ecr.aws/docker/library/ubuntu:latest", "memory": 100, "mountPoints": [], "portMappings": [], "volumesFrom": [] } ], "family": "cpu-wave", "revision": 1, "status": "DELETE_IN_PROGRESS", "taskDefinitionArn": "arn:aws:ecs:us-east-1:012345678910:task-definition/Example-task-definition:1", "volumes": [] } ] }, "description": "This example deletes a specified deregistered task definition. ", "id": "example-1", "title": "To delete a task definition that has been deregistered" } ], "DeleteTaskSet": [ { "input": { "cluster": "MyCluster", "force": true, "service": "MyService", "taskSet": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789" }, "output": { "taskSet": { "computedDesiredCount": 0, "createdAt": 1557130260.276, "id": "ecs-svc/1234567890123456789", "launchType": "EC2", "loadBalancers": [], "networkConfiguration": { "awsvpcConfiguration": { "assignPublicIp": "DISABLED", "securityGroups": [ "sg-12345678" ], "subnets": [ "subnet-12345678" ] } }, "pendingCount": 0, "runningCount": 0, "scale": { "value": 0, "unit": "PERCENT" }, "serviceRegistries": [], "stabilityStatus": "STABILIZING", "stabilityStatusAt": 1557130290.707, "status": "DRAINING", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2", "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", "updatedAt": 1557130290.707 } }, "description": "This example deletes a task set and uses the force flag to force deletion if it hasn't scaled to zero.", "id": "example-1", "title": "To delete a task set within a service that uses the EXTERNAL deployment controller type" } ], "DeregisterContainerInstance": [ { "input": { "cluster": "default", "containerInstance": "container_instance_UUID", "force": true }, "output": {}, "description": "This example deregisters a container instance from the specified cluster in your default region. If there are still tasks running on the container instance, you must either stop those tasks before deregistering, or use the force option.", "id": "example-1", "title": "To deregister a container instance from a cluster" } ], "DeregisterTaskDefinition": [ { "input": { "taskDefinition": "fargate-task:1" }, "output": { "taskDefinition": { "containerDefinitions": [ { "name": "nginx", "cpu": 256, "essential": true, "image": "public.ecr.aws/docker/library/nginx:latest", "memory": 128, "portMappings": [ { "containerPort": 80, "hostPort": 80, "protocol": "tcp" } ] } ], "family": "fargate-task", "status": "INACTIVE", "taskDefinitionArn": "arn:aws:ecs:us-west-2:123456789012:task-definition/fargate-task:1", "volumes": [] } }, "description": "This example deregisters the first revision of the fargate-task task definition", "id": "example-1", "title": "To deregister a revision of a task definition" } ], "DescribeCapacityProviders": [ { "input": {}, "output": { "capacityProviders": [ { "name": "MyCapacityProvider", "autoScalingGroupProvider": { "autoScalingGroupArn": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup", "managedScaling": { "maximumScalingStepSize": 1000, "minimumScalingStepSize": 1, "status": "ENABLED", "targetCapacity": 100 }, "managedTerminationProtection": "ENABLED" }, "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/MyCapacityProvider", "status": "ACTIVE", "tags": [] }, { "name": "FARGATE", "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/FARGATE", "status": "ACTIVE", "tags": [] }, { "name": "FARGATE_SPOT", "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/FARGATE_SPOT", "status": "ACTIVE", "tags": [] } ] }, "description": "This example retrieves details about all capacity providers. ", "id": "example-1", "title": "To describe all capacity providers" }, { "input": { "capacityProviders": [ "MyCapacityProvider" ], "include": [ "TAGS" ] }, "output": { "capacityProviders": [ { "name": "MyCapacityProvider", "autoScalingGroupProvider": { "autoScalingGroupArn": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:a1b2c3d4-5678-90ab-cdef-EXAMPLE11111:autoScalingGroupName/MyAutoScalingGroup", "managedScaling": { "maximumScalingStepSize": 1000, "minimumScalingStepSize": 1, "status": "ENABLED", "targetCapacity": 100 }, "managedTerminationProtection": "ENABLED" }, "capacityProviderArn": "arn:aws:ecs:us-west-2:123456789012:capacity-provider/MyCapacityProvider", "status": "ACTIVE", "tags": [ { "key": "environment", "value": "production" } ] } ] }, "description": "This example retrieves details about the capacity provider MyCapacityProvider", "id": "example-2", "title": "To describe a specific capacity provider" } ], "DescribeClusters": [ { "input": { "clusters": [ "default" ] }, "output": { "clusters": [ { "clusterArn": "arn:aws:ecs:us-east-1:aws_account_id:cluster/default", "clusterName": "default", "status": "ACTIVE" } ], "failures": [] }, "description": "This example provides a description of the specified cluster in your default region.", "id": "example-1", "title": "To describe a cluster" } ], "DescribeContainerInstances": [ { "input": { "cluster": "default", "containerInstances": [ "f2756532-8f13-4d53-87c9-aed50dc94cd7" ] }, "output": { "containerInstances": [ { "agentConnected": true, "containerInstanceArn": "arn:aws:ecs:us-east-1:012345678910:container-instance/default/f2756532-8f13-4d53-87c9-aed50dc94cd7", "ec2InstanceId": "i-807f3249", "pendingTasksCount": 0, "registeredResources": [ { "name": "CPU", "type": "INTEGER", "doubleValue": 0.0, "integerValue": 2048, "longValue": 0 }, { "name": "MEMORY", "type": "INTEGER", "doubleValue": 0.0, "integerValue": 3768, "longValue": 0 }, { "name": "PORTS", "type": "STRINGSET", "doubleValue": 0.0, "integerValue": 0, "longValue": 0, "stringSetValue": [ "2376", "22", "51678", "2375" ] } ], "remainingResources": [ { "name": "CPU", "type": "INTEGER", "doubleValue": 0.0, "integerValue": 1948, "longValue": 0 }, { "name": "MEMORY", "type": "INTEGER", "doubleValue": 0.0, "integerValue": 3668, "longValue": 0 }, { "name": "PORTS", "type": "STRINGSET", "doubleValue": 0.0, "integerValue": 0, "longValue": 0, "stringSetValue": [ "2376", "22", "80", "51678", "2375" ] } ], "runningTasksCount": 1, "status": "ACTIVE" } ], "failures": [] }, "description": "This example provides a description of the specified container instance in your default region, using the container instance UUID as an identifier.", "id": "example-1", "title": "To describe container instance" } ], "DescribeDaemon": [ { "input": { "daemonArn": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-monitoring-daemon" }, "output": { "daemon": { "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster", "createdAt": "2025-03-15T12:00:00.000Z", "currentRevisions": [ { "arn": "arn:aws:ecs:us-east-1:123456789012:daemon-revision/my-cluster/my-monitoring-daemon/4980306466373577095", "capacityProviders": [ { "arn": "arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-capacity-provider", "runningCount": 3 } ], "totalRunningCount": 3 } ], "daemonArn": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-monitoring-daemon", "deploymentArn": "arn:aws:ecs:us-east-1:123456789012:daemon-deployment/my-cluster/my-monitoring-daemon/aB1cD2eF3gH4iJ5k", "status": "ACTIVE", "updatedAt": "2025-03-20T15:30:00.000Z" } }, "description": "This example describes the my-monitoring-daemon daemon.", "id": "example-1", "title": "To describe a daemon" } ], "DescribeDaemonDeployments": [ { "input": { "daemonDeploymentArns": [ "arn:aws:ecs:us-east-1:123456789012:daemon-deployment/my-cluster/my-monitoring-daemon/aB1cD2eF3gH4iJ5k" ] }, "output": { "daemonDeployments": [ { "alarms": { "alarmNames": [], "status": "DISABLED", "triggeredAlarmNames": [] }, "circuitBreaker": { "failureCount": 0, "status": "MONITORING_COMPLETE", "threshold": 10 }, "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster", "createdAt": "2025-03-15T12:00:00.000Z", "daemonDeploymentArn": "arn:aws:ecs:us-east-1:123456789012:daemon-deployment/my-cluster/my-monitoring-daemon/aB1cD2eF3gH4iJ5k", "deploymentConfiguration": { "alarms": { "alarmNames": [], "enable": false }, "bakeTimeInMinutes": 5, "drainPercent": 10.0 }, "finishedAt": "2025-03-15T12:15:00.000Z", "sourceDaemonRevisions": [], "startedAt": "2025-03-15T12:00:05.000Z", "status": "SUCCESSFUL", "statusReason": "Deployment completed successfully.", "targetDaemonRevision": { "arn": "arn:aws:ecs:us-east-1:123456789012:daemon-revision/my-cluster/my-monitoring-daemon/4980306466373577095", "capacityProviders": [ { "arn": "arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-capacity-provider", "drainingInstanceCount": 0, "runningInstanceCount": 3 } ], "totalDrainingInstanceCount": 0, "totalRunningInstanceCount": 3 } } ], "failures": [] }, "description": "This example describes a daemon deployment for the my-monitoring-daemon daemon.", "id": "example-1", "title": "To describe daemon deployments" } ], "DescribeDaemonRevisions": [ { "input": { "daemonRevisionArns": [ "arn:aws:ecs:us-east-1:123456789012:daemon-revision/my-cluster/my-monitoring-daemon/4980306466373577095" ] }, "output": { "daemonRevisions": [ { "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster", "containerImages": [ { "containerName": "cloudwatch-agent", "image": "public.ecr.aws/cloudwatch-agent/cloudwatch-agent:latest", "imageDigest": "sha256:a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2" } ], "createdAt": "2025-03-15T12:00:00.000Z", "daemonArn": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-monitoring-daemon", "daemonRevisionArn": "arn:aws:ecs:us-east-1:123456789012:daemon-revision/my-cluster/my-monitoring-daemon/4980306466373577095", "daemonTaskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/monitoring-agent:1", "enableECSManagedTags": false, "enableExecuteCommand": false, "propagateTags": "NONE" } ], "failures": [] }, "description": "This example describes a daemon revision for the my-monitoring-daemon daemon.", "id": "example-1", "title": "To describe daemon revisions" } ], "DescribeDaemonTaskDefinition": [ { "input": { "daemonTaskDefinition": "monitoring-agent:1" }, "output": { "daemonTaskDefinition": { "containerDefinitions": [ { "name": "cloudwatch-agent", "cpu": 128, "environment": [ { "name": "USE_DEFAULT_CONFIG", "value": "true" } ], "essential": true, "image": "public.ecr.aws/cloudwatch-agent/cloudwatch-agent:latest", "logConfiguration": { "logDriver": "awslogs", "options": { "awslogs-group": "/ecs/daemon/monitoring-agent", "awslogs-region": "us-east-1", "awslogs-stream-prefix": "ecs" } }, "memory": 256, "mountPoints": [], "secrets": [] } ], "cpu": "128", "daemonTaskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/monitoring-agent:1", "executionRoleArn": "arn:aws:iam::123456789012:role/ecsTaskExecutionRole", "family": "monitoring-agent", "memory": "256", "registeredAt": "2025-03-15T10:30:00.000Z", "registeredBy": "arn:aws:iam::123456789012:user/admin", "revision": 1, "status": "ACTIVE", "taskRoleArn": "arn:aws:iam::123456789012:role/ecsDaemonTaskRole", "volumes": [] } }, "description": "This example describes the first revision of the monitoring-agent daemon task definition.", "id": "example-1", "title": "To describe a daemon task definition" } ], "DescribeGateway": [ { "input": { "gateway": "my-gateway" }, "output": { "gateway": { "name": "my-gateway", "accessType": "PUBLIC", "configuration": { "hostSharedAlb": { "currentAlbCount": 1, "httpDesync": "defensive", "maxAlbCount": 10, "networkConfiguration": { "ipAddressType": "ipv4", "subnets": [ "subnet-0123456789abcdef0", "subnet-0fedcba9876543210" ] }, "port": 443, "protocol": "HTTPS", "scheme": "internet-facing" } }, "createdAt": "2026-10-20T12:00:00.000Z", "deletionProtection": true, "gatewayArn": "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678", "infrastructureRoleArn": "arn:aws:iam::123456789012:role/ecsInfrastructureRole", "propagateTags": "GATEWAY", "status": "ACTIVE", "tags": [ { "key": "team", "value": "web" } ], "updatedAt": "2026-10-20T12:00:00.000Z" } }, "description": "This example describes the gateway named my-gateway.", "id": "example-1", "title": "To describe a gateway" } ], "DescribeGatewayResources": [ { "input": { "gateway": "my-gateway" }, "output": { "gatewayResources": { "gatewayArn": "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678", "resources": { "hostSharedAlb": [ { "gatewayRouteArns": [ "arn:aws:ecs:us-east-1:123456789012:gateway-route/my-gateway/a1b2c3d4e5f6478890abcdef12345678/f0e1d2c3b4a5968778695a4b3c2d1e0f" ], "listenerArn": "arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/ecs-gateway-alb-1/50dc6c495c0c9188/f2f7dc8efc522ab2", "loadBalancerArn": "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/ecs-gateway-alb-1/50dc6c495c0c9188", "securityGroup": "sg-0123456789abcdef0" } ] } } }, "description": "This example returns the load balancers, listeners, and gateway routes that the gateway named my-gateway manages.", "id": "example-1", "title": "To describe the infrastructure that a gateway manages" } ], "DescribeGatewayRoute": [ { "input": { "gatewayRouteArn": "arn:aws:ecs:us-east-1:123456789012:gateway-route/my-gateway/a1b2c3d4e5f6478890abcdef12345678/f0e1d2c3b4a5968778695a4b3c2d1e0f" }, "output": { "gatewayRoute": { "gatewayRouteArn": "arn:aws:ecs:us-east-1:123456789012:gateway-route/my-gateway/a1b2c3d4e5f6478890abcdef12345678/f0e1d2c3b4a5968778695a4b3c2d1e0f", "resources": { "hostSharedAlb": [ { "acmCertificateArn": "arn:aws:acm:us-east-1:123456789012:certificate/12345678-90ab-cdef-1234-567890abcdef", "listenerArn": "arn:aws:elasticloadbalancing:us-east-1:123456789012:listener/app/ecs-gateway-alb-1/50dc6c495c0c9188/f2f7dc8efc522ab2", "listenerRuleArn": "arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/ecs-gateway-alb-1/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cabee", "loadBalancerArn": "arn:aws:elasticloadbalancing:us-east-1:123456789012:loadbalancer/app/ecs-gateway-alb-1/50dc6c495c0c9188", "loadBalancerSecurityGroups": [ { "arn": "arn:aws:ec2:us-east-1:123456789012:security-group/sg-0123456789abcdef0", "ruleArns": [ "arn:aws:ec2:us-east-1:123456789012:security-group-rule/sgr-0123456789abcdef0" ] } ], "serviceSecurityGroupArn": "arn:aws:ec2:us-east-1:123456789012:security-group/sg-0fedcba9876543210", "testListenerRuleArns": [ "arn:aws:elasticloadbalancing:us-east-1:123456789012:listener-rule/app/ecs-gateway-alb-1/50dc6c495c0c9188/f2f7dc8efc522ab2/9683b2d02a6cc1d2" ] } ] }, "serviceArn": "arn:aws:ecs:us-east-1:123456789012:service/my-cluster/my-web-service", "serviceContainerPortName": "web", "serviceUrl": "https://my-web-service.example.com", "status": "ACTIVE" } }, "description": "This example describes the specified gateway route, including the service URL and the load balancer resources that the gateway manages for the route.", "id": "example-1", "title": "To describe a gateway route" } ], "DescribeServiceDeployments": [ { "input": { "serviceDeploymentArns": [ "arn:aws:ecs:us-west-2:123456789012:service-deployment/example/sd-example/NCWGC2ZR-taawPAYrIaU5" ] }, "output": { "failures": [], "serviceDeployments": [ { "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/example", "deploymentConfiguration": { "deploymentCircuitBreaker": { "enable": true, "resetOnHealthyTask": true, "rollback": true, "thresholdConfiguration": { "type": "BOUNDED_PERCENT", "value": 50 } }, "maximumPercent": 200, "minimumHealthyPercent": 100 }, "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/example/sd-example", "serviceDeploymentArn": "arn:aws:ecs:us-west-2:123456789012:service-deployment/example/sd-example/NCWGC2ZR-taawPAYrIaU5", "status": "PENDING", "targetServiceRevision": { "arn": "arn:aws:ecs:us-west-2:123456789012:service-revision/example/sd-example/4980306466373577095", "pendingTaskCount": 0, "requestedTaskCount": 0, "runningTaskCount": 0 }, "updatedAt": "2024-09-10T16:49:35.57Z" } ] }, "description": "This example describes a service deployment for the service sd-example in the example cluster. ", "id": "example-1", "title": "To describe a service deployment " }, { "input": { "serviceDeploymentArns": [ "arn:aws:ecs:us-east-1:123456789012:service-deployment/MyCluster/MyService/r9i43YFjvgF_xlg7m2eJ1r" ] }, "output": { "failures": [], "serviceDeployments": [ { "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/MyCluster", "deploymentConfiguration": { "deploymentCircuitBreaker": { "enable": true, "resetOnHealthyTask": true, "rollback": true, "thresholdConfiguration": { "type": "BOUNDED_PERCENT", "value": 50 } }, "lifecycleHooks": [ { "lifecycleStages": [ "POST_PRODUCTION_TRAFFIC_SHIFT" ], "targetType": "PAUSE", "timeoutConfiguration": { "action": "ROLLBACK", "timeoutInMinutes": 60 } } ], "maximumPercent": 200, "minimumHealthyPercent": 100, "strategy": "BLUE_GREEN" }, "lifecycleHookDetails": [ { "expiresAt": "2026-05-06T17:00:00.000Z", "hookId": "ecs-pause-Xk7rT2mP9sLwQn4vB8fYd3hJ6gA1cE5iO0uR_ZpWq", "status": "AWAITING_ACTION", "targetType": "PAUSE", "timeoutAction": "ROLLBACK" } ], "lifecycleStage": "POST_PRODUCTION_TRAFFIC_SHIFT", "serviceArn": "arn:aws:ecs:us-east-1:123456789012:service/MyCluster/MyService", "serviceDeploymentArn": "arn:aws:ecs:us-east-1:123456789012:service-deployment/MyCluster/MyService/r9i43YFjvgF_xlg7m2eJ1r", "status": "IN_PROGRESS", "targetServiceRevision": { "arn": "arn:aws:ecs:us-east-1:123456789012:service-revision/MyCluster/MyService/1234567890123456789", "pendingTaskCount": 1, "requestedTaskCount": 2, "runningTaskCount": 1 }, "updatedAt": "2026-05-06T16:00:00.000Z" } ] }, "description": "This example describes a service deployment that is currently paused at a lifecycle hook. The lifecycleHookDetails field shows the status of the pause hook, including when it will expire and what action will be taken if the timeout is reached.", "id": "example-2", "title": "To describe a service deployment with a paused lifecycle hook" } ], "DescribeServiceRevisions": [ { "input": { "serviceRevisionArns": [ "arn:aws:ecs:us-west-2:123456789012:service-revision/testc/sd1/4980306466373577095" ] }, "output": { "failures": [], "serviceRevisions": [ { "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/example", "createdAt": "2024-09-10T16:49:26.39Z", "launchType": "FARGATE", "networkConfiguration": { "awsvpcConfiguration": { "assignPublicIp": "ENABLED", "securityGroups": [ "sg-09605d60a6bc1b296" ], "subnets": [ "subnet-0a4040e73895f04e1" ] } }, "platformFamily": "DockerLinux", "platformVersion": "1.4.0", "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/example/sd-example", "serviceRevisionArn": "arn:aws:ecs:us-west-2:123456789012:service-revision/example/sd-example/4980306466373577095", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/large-ngingx:1" } ] }, "description": "This example describes a service revision with the specified ARN", "id": "example-1", "title": "To describe a service revision " }, { "input": { "serviceRevisionArns": [ "arn:aws:ecs:us-east-1:012345678910:service-revision/default/ecs-monitored-service/8675309012345678901" ] }, "output": { "failures": [], "serviceRevisions": [ { "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default", "createdAt": "2026-06-10T12:00:00.00Z", "launchType": "FARGATE", "monitoring": { "metricConfigurations": [ { "metricNames": [ "CPUUtilization", "MemoryUtilization" ], "resolutionSeconds": 20 } ] }, "platformFamily": "DockerLinux", "platformVersion": "1.4.0", "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/default/ecs-monitored-service", "serviceRevisionArn": "arn:aws:ecs:us-east-1:012345678910:service-revision/default/ecs-monitored-service/8675309012345678901", "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/my-app:1" } ] }, "description": "This example describes a service revision that has a monitoring configuration with 20-second resolution for CPUUtilization and MemoryUtilization CloudWatch metrics.", "id": "example-2", "title": "To describe a service revision with a monitoring configuration" } ], "DescribeServices": [ { "input": { "services": [ "ecs-simple-service" ] }, "output": { "failures": [], "services": [ { "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default", "createdAt": "2016-08-29T16:25:52.130Z", "deploymentConfiguration": { "maximumPercent": 200, "minimumHealthyPercent": 100 }, "deployments": [ { "createdAt": "2016-08-29T16:25:52.130Z", "desiredCount": 1, "id": "ecs-svc/9223370564341623665", "pendingCount": 0, "runningCount": 0, "status": "PRIMARY", "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6", "updatedAt": "2016-08-29T16:25:52.130Z" } ], "desiredCount": 1, "events": [ { "createdAt": "2016-08-29T16:25:58.520Z", "id": "38c285e5-d335-4b68-8b15-e46dedc8e88d", "message": "(service ecs-simple-service) was unable to place a task because no container instance met all of its requirements. The closest matching (container-instance 3f4de1c5-ffdd-4954-af7e-75b4be0c8841) is already using a port required by your task. For more information, see the Troubleshooting section of the Amazon ECS Developer Guide." } ], "loadBalancers": [], "pendingCount": 0, "runningCount": 0, "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/default/ecs-simple-service", "serviceName": "ecs-simple-service", "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/default/hello_world:6" } ] }, "description": "This example provides descriptive information about the service named ``ecs-simple-service``.", "id": "example-1", "title": "To describe a service" }, { "input": { "services": [ "ecs-service-with-pause-hook" ] }, "output": { "failures": [], "services": [ { "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default", "createdAt": "2026-05-06T16:00:00.000Z", "deploymentConfiguration": { "lifecycleHooks": [ { "lifecycleStages": [ "POST_PRODUCTION_TRAFFIC_SHIFT" ], "targetType": "PAUSE", "timeoutConfiguration": { "action": "ROLLBACK", "timeoutInMinutes": 60 } } ], "maximumPercent": 200, "minimumHealthyPercent": 100, "strategy": "BLUE_GREEN" }, "deployments": [ { "createdAt": "2026-05-06T16:00:00.000Z", "desiredCount": 2, "id": "ecs-svc/9223370564341623665", "pendingCount": 0, "runningCount": 2, "status": "PRIMARY", "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/ecs-demo:1", "updatedAt": "2026-05-06T16:00:00.000Z" } ], "desiredCount": 2, "events": [], "loadBalancers": [], "pendingCount": 0, "runningCount": 2, "serviceArn": "arn:aws:ecs:us-east-1:012345678910:service/default/ecs-service-with-pause-hook", "serviceName": "ecs-service-with-pause-hook", "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-east-1:012345678910:task-definition/ecs-demo:1" } ] }, "description": "This example provides descriptive information about the service ``ecs-service-with-pause-hook``, which is configured with a pause lifecycle hook in its deployment configuration.", "id": "example-2", "title": "To describe a service with a pause lifecycle hook" } ], "DescribeTaskDefinition": [ { "input": { "taskDefinition": "hello_world:8" }, "output": { "taskDefinition": { "containerDefinitions": [ { "name": "wordpress", "cpu": 10, "environment": [], "essential": true, "image": "wordpress", "links": [ "mysql" ], "memory": 500, "mountPoints": [], "portMappings": [ { "containerPort": 80, "hostPort": 80 } ], "volumesFrom": [] }, { "name": "mysql", "cpu": 10, "environment": [ { "name": "MYSQL_ROOT_PASSWORD", "value": "password" } ], "essential": true, "image": "mysql", "memory": 500, "mountPoints": [], "portMappings": [], "volumesFrom": [] } ], "family": "hello_world", "revision": 8, "taskDefinitionArn": "arn:aws:ecs:us-east-1::task-definition/hello_world:8", "volumes": [] } }, "description": "This example provides a description of the specified task definition.", "id": "example-1", "title": "To describe a task definition" } ], "DescribeTaskSets": [ { "input": { "cluster": "MyCluster", "service": "MyService", "taskSets": [ "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789" ] }, "output": { "failures": [], "taskSets": [ { "computedDesiredCount": 0, "createdAt": 1557207715.195, "id": "ecs-svc/1234567890123456789", "launchType": "EC2", "loadBalancers": [], "networkConfiguration": { "awsvpcConfiguration": { "assignPublicIp": "DISABLED", "securityGroups": [ "sg-1234431" ], "subnets": [ "subnet-12344321" ] } }, "pendingCount": 0, "runningCount": 0, "scale": { "value": 0, "unit": "PERCENT" }, "serviceRegistries": [], "stabilityStatus": "STEADY_STATE", "stabilityStatusAt": 1557207740.014, "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2", "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", "updatedAt": 1557207740.014 } ] }, "description": "This example describes a task set in service MyService that uses an EXTERNAL deployment controller. ", "id": "example-1", "title": "To describe a task set " } ], "DescribeTasks": [ { "input": { "tasks": [ "c5cba4eb-5dad-405e-96db-71ef8eefe6a8" ] }, "output": { "failures": [], "tasks": [ { "clusterArn": "arn:aws:ecs:::cluster/default", "containerInstanceArn": "arn:aws:ecs:::container-instance/default/18f9eda5-27d7-4c19-b133-45adc516e8fb", "containers": [ { "name": "ecs-demo", "containerArn": "arn:aws:ecs:::container/7c01765b-c588-45b3-8290-4ba38bd6c5a6", "lastStatus": "RUNNING", "networkBindings": [ { "bindIP": "0.0.0.0", "containerPort": 80, "hostPort": 80 } ], "taskArn": "arn:aws:ecs:::task/default/c5cba4eb-5dad-405e-96db-71ef8eefe6a8" } ], "desiredStatus": "RUNNING", "lastStatus": "RUNNING", "overrides": { "containerOverrides": [ { "name": "ecs-demo" } ] }, "startedBy": "ecs-svc/9223370608528463088", "taskArn": "arn:aws:ecs:::task/default/c5cba4eb-5dad-405e-96db-71ef8eefe6a8", "taskDefinitionArn": "arn:aws:ecs:::task-definition/amazon-ecs-sample:1" } ] }, "description": "This example provides a description of the specified task, using the task UUID as an identifier.", "id": "example-1", "title": "To describe a task" } ], "DisassociateGatewayFromCluster": [ { "input": { "cluster": "my-cluster", "gateway": "my-gateway" }, "output": { "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster", "gatewayArn": "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678", "status": "DISASSOCIATING" }, "description": "This example removes the association between the gateway named my-gateway and the cluster named my-cluster. The association remains in the DISASSOCIATING state until all gateway routes for the cluster are removed.", "id": "example-1", "title": "To disassociate a gateway from a cluster" } ], "ExecuteCommand": [ { "input": { "cluster": "MyCluster", "command": "/bin/sh", "container": "MyContainer", "interactive": true, "task": "arn:aws:ecs:us-east-1:123456789012:task/MyCluster/d789e94343414c25b9f6bd59eEXAMPLE" }, "output": { "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/MyCluster", "containerArn": "arn:aws:ecs:us-east-1:123456789012:container/MyCluster/d789e94343414c25b9f6bd59eEXAMPLE/43ba4b77-37f7-4a41-b923-69d4abEXAMPLE", "containerName": "MyContainer", "interactive": true, "session": { "sessionId": "ecs-execute-command-794nnsxobsg4p2hiur6gxu9a9e", "streamUrl": "wss://ssmmessages.us-east-1.amazonaws.com/v1/data-channel/ecs-execute-command-794nnsxobsg4p2hiur6gxu9a9e?role=publish_subscribe&cell-number=AAEAAfiZG4oybxqsYj3Zhm15s4J0W1k7d9nxVRenNO8Kl5nzAAAAAGdbWGl479/y/4IrTWPadUic3eBrMu3vmB7aPvI+s12lbpDc142y1KZy", "tokenValue": "AAEAAcVb7ww10N9aNUI5Cl7K7DbHjbD2Ed4Mw6uaGYIc+UFNAAAAAGdbWGmMDaPbGfDkzrVIhyKEsc4CPT2hcToPU6yzlddPm7rRZvYQtpaAgsvQdjbCAd9OB6ohtDYfqZI9gzMqLKegXq0E+KbDcGPnQVODFNHmQxnR1BvC6vNcHqh6HAJuKnQD7RSYx/J5bfYNHj4hCYHuN0HNcueSDOOTRB/MBt5DBDY7Djv2uzs9FD0N1kcsGljZkZWLuPTVKHHyrU3zh0awfrFFC3RXvgaUCBnloIIvZeq2CjTesxn9JJS+3N4I0DVxfkHdWWBbBY/5+wH82JVTJpqN3yOAt74u/W7TvYBd7Xu2lQbvtpuAnEszl++bFG2ZoV3dfnmBkSnfD/qV1FJcEskbxUHKgmqe0Paouv4zwrQKNfWYfcv9xkWskqcExh07IeaxZz1tp/WegZ5D76sD6xYeuH+35TMNXMoY7oudLgxIXsA7b39ElM7orGi4Jy3W2tLyuNIvDoI2JI6ww4tYdEjYZnld9rhKwV9rDHk1Z8wjHMs++3BIkHrFQRsv7BFUWlZ9lyqO9GWlXeBe7dQtOeFNahBuJUE9z/xLHJn1x13VkdROKqUVHTJrT4sXAnI5roWiGPoQPVY7aHVYJnwjSxrPRWJBsgyHiVN3dAWTmeVMjp0VbOiJaLlpBI+AUWs8OeVRzuJSZ+1alETpK7Ukag7ma9K4lxq/N7IxYo2ub0cG/bvX42zQqdJAW+9St9sQ1QMaMvkSq1tdbLoOuY0QjN7JrkuKLFQA5bhs+o1YwItzIp7bNrzQ9Z9IN51qoGL5HDXQzi1kNFfYtAryhwt6BgtQU9Z0k+RpE+V5G+V68E0MMUvb313f0nRBYj1u5VKonWb708wADPbUU+s7nvbWuD5oLp1Z6A4iqI9Om0R4RrFASj/7fVY7r3raNXcIYA=" }, "taskArn": "arn:aws:ecs:us-east-1:123456789012:task/MyCluster/d789e94343414c25b9f6bd59eEXAMPLE" }, "description": "This example runs an interactive /bin/sh command on a container MyContainer. ", "id": "example-1", "title": "To run a command remotely on a container in a task" } ], "GetTaskProtection": [ { "input": { "cluster": "test-task-protection", "tasks": [ "b8b1cf532d0e46ba8d44a40d1de16772" ] }, "output": { "failures": [], "protectedTasks": [ { "expirationDate": "2022-11-02T06:56:32.553Z", "protectionEnabled": true, "taskArn": "arn:aws:ecs:us-west-2:012345678910:task/default/b8b1cf532d0e46ba8d44a40d1de16772" } ] }, "description": "In this example, we get the protection status for a single task.", "id": "example-1", "title": "To get the protection status of a task" } ], "ListAccountSettings": [ { "input": { "effectiveSettings": true }, "output": { "settings": [ { "name": "containerInstanceLongArnFormat", "value": "disabled", "principalArn": "arn:aws:iam:::user/principalName" }, { "name": "serviceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam:::user/principalName" }, { "name": "taskLongArnFormat", "value": "disabled", "principalArn": "arn:aws:iam:::user/principalName" } ] }, "description": "This example displays the effective account settings for your account.", "id": "example-1", "title": "To view your effective account settings" }, { "input": { "effectiveSettings": true, "principalArn": "arn:aws:iam:::user/principalName" }, "output": { "settings": [ { "name": "containerInstanceLongArnFormat", "value": "disabled", "principalArn": "arn:aws:iam:::user/principalName" }, { "name": "serviceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam:::user/principalName" }, { "name": "taskLongArnFormat", "value": "disabled", "principalArn": "arn:aws:iam:::user/principalName" } ] }, "description": "This example displays the effective account settings for the specified user or role.", "id": "example-2", "title": "To view the effective account settings for a specific IAM user or IAM role" } ], "ListAttributes": [ { "input": { "attributeName": "stack", "attributeValue": "production", "cluster": "MyCluster", "targetType": "container-instance" }, "output": { "attributes": [ { "name": "stack", "value": "production", "targetId": "arn:aws:ecs:us-west-2:123456789012:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34" } ] }, "description": "This example lists attributes for a container instance with the attribute \"stack\" equal to the value \"production\".", "id": "example-1", "title": "To list container instances that have a specific attribute" } ], "ListClusters": [ { "input": {}, "output": { "clusterArns": [ "arn:aws:ecs:us-east-1::cluster/test", "arn:aws:ecs:us-east-1::cluster/default" ] }, "description": "This example lists all of your available clusters in your default region.", "id": "example-1", "title": "To list your available clusters" } ], "ListContainerInstances": [ { "input": { "cluster": "default" }, "output": { "containerInstanceArns": [ "arn:aws:ecs:us-east-1::container-instance/default/f6bbb147-5370-4ace-8c73-c7181ded911f", "arn:aws:ecs:us-east-1::container-instance/default/ffe3d344-77e2-476c-a4d0-bf560ad50acb" ] }, "description": "This example lists all of your available container instances in the specified cluster in your default region.", "id": "example-1", "title": "To list your available container instances in a cluster" } ], "ListDaemonDeployments": [ { "input": { "daemonArn": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-monitoring-daemon", "status": [ "SUCCESSFUL" ] }, "output": { "daemonDeployments": [ { "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster", "createdAt": "2025-03-15T12:00:00.000Z", "daemonArn": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-monitoring-daemon", "daemonDeploymentArn": "arn:aws:ecs:us-east-1:123456789012:daemon-deployment/my-cluster/my-monitoring-daemon/aB1cD2eF3gH4iJ5k", "finishedAt": "2025-03-15T12:15:00.000Z", "startedAt": "2025-03-15T12:00:05.000Z", "status": "SUCCESSFUL", "statusReason": "Deployment completed successfully.", "targetDaemonRevisionArn": "arn:aws:ecs:us-east-1:123456789012:daemon-revision/my-cluster/my-monitoring-daemon/4980306466373577095" } ] }, "description": "This example lists all successful daemon deployments for the my-monitoring-daemon daemon.", "id": "example-1", "title": "To list daemon deployments" } ], "ListDaemonTaskDefinitions": [ { "input": { "familyPrefix": "monitoring" }, "output": { "daemonTaskDefinitions": [ { "arn": "arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/monitoring-agent:2", "registeredAt": "2025-03-20T14:00:00.000Z", "registeredBy": "arn:aws:iam::123456789012:user/admin", "status": "ACTIVE" }, { "arn": "arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/monitoring-agent:1", "registeredAt": "2025-03-15T10:30:00.000Z", "registeredBy": "arn:aws:iam::123456789012:user/admin", "status": "ACTIVE" } ] }, "description": "This example lists all daemon task definitions in your account that start with the monitoring prefix.", "id": "example-1", "title": "To list daemon task definitions" } ], "ListDaemons": [ { "input": { "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster" }, "output": { "daemonSummariesList": [ { "createdAt": "2025-03-15T12:00:00.000Z", "daemonArn": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-monitoring-daemon", "status": "ACTIVE", "updatedAt": "2025-03-20T15:30:00.000Z" }, { "createdAt": "2025-03-16T09:00:00.000Z", "daemonArn": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-logging-daemon", "status": "ACTIVE", "updatedAt": "2025-03-16T09:00:00.000Z" } ] }, "description": "This example lists all daemons in the specified cluster.", "id": "example-1", "title": "To list daemons in a cluster" } ], "ListGatewayClusterAssociations": [ { "input": { "gateway": "my-gateway" }, "output": { "gatewayClusterAssociations": [ { "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster", "gatewayArn": "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678", "status": "ACTIVE" }, { "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-staging-cluster", "gatewayArn": "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678", "status": "ACTIVE" } ] }, "description": "This example lists the clusters that are associated with the gateway named my-gateway.", "id": "example-1", "title": "To list the clusters associated with a gateway" } ], "ListGatewayRoutes": [ { "input": { "cluster": "my-cluster", "gateway": "my-gateway" }, "output": { "gatewayRoutes": [ { "clusterArn": "arn:aws:ecs:us-east-1:123456789012:cluster/my-cluster", "gatewayArn": "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678", "gatewayRouteArn": "arn:aws:ecs:us-east-1:123456789012:gateway-route/my-gateway/a1b2c3d4e5f6478890abcdef12345678/f0e1d2c3b4a5968778695a4b3c2d1e0f", "serviceArn": "arn:aws:ecs:us-east-1:123456789012:service/my-cluster/my-web-service", "serviceContainerPortName": "web", "status": "ACTIVE" } ] }, "description": "This example lists the gateway routes for the gateway named my-gateway in the cluster named my-cluster.", "id": "example-1", "title": "To list the gateway routes for a gateway" } ], "ListGateways": [ { "input": { "status": [ "ACTIVE" ] }, "output": { "gateways": [ { "name": "my-gateway", "createdAt": "2026-10-20T12:00:00.000Z", "gatewayArn": "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678", "status": "ACTIVE" }, { "name": "my-internal-gateway", "createdAt": "2026-10-21T09:30:00.000Z", "gatewayArn": "arn:aws:ecs:us-east-1:123456789012:gateway/my-internal-gateway/0f1e2d3c4b5a69788796a5b4c3d2e1f0", "status": "ACTIVE" } ] }, "description": "This example lists the gateways in your account that have a status of ACTIVE.", "id": "example-1", "title": "To list active gateways" } ], "ListServiceDeployments": [ { "input": { "cluster": "example", "service": "sd-example", "status": [ "SUCCESSFUL" ] }, "output": { "serviceDeployments": [ { "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/example", "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/example/sd-example", "serviceDeploymentArn": "arn:aws:ecs:us-west-2:123456789012:service-deployment/example/sd-example/NCWGC2ZR-taawPAYrIaU5", "status": "SUCCESSFUL", "targetServiceRevisionArn": "arn:aws:ecs:us-west-2:123456789012:service-revision/example/sd-example/4980306466373577095" } ] }, "description": "This example lists all successful service deployments for the service \"sd-example\" in the cluster \"example\".", "id": "example-1", "title": "To list service deployments that meet the specified criteria" } ], "ListServices": [ { "input": {}, "output": { "serviceArns": [ "arn:aws:ecs:us-east-1:012345678910:service/default/my-http-service" ] }, "description": "This example lists the services running in the default cluster for an account.", "id": "example-1", "title": "To list the services in a cluster" } ], "ListTagsForResource": [ { "input": { "resourceArn": "arn:aws:ecs:region:aws_account_id:cluster/dev" }, "output": { "tags": [ { "key": "team", "value": "dev" } ] }, "description": "This example lists the tags for the 'dev' cluster.", "id": "example-1", "title": "To list the tags for a cluster." } ], "ListTaskDefinitionFamilies": [ { "input": {}, "output": { "families": [ "node-js-app", "web-timer", "hpcc", "hpcc-c4-8xlarge" ] }, "description": "This example lists all of your registered task definition families.", "id": "example-1", "title": "To list your registered task definition families" }, { "input": { "familyPrefix": "hpcc" }, "output": { "families": [ "hpcc", "hpcc-c4-8xlarge" ] }, "description": "This example lists the task definition revisions that start with \"hpcc\".", "id": "example-2", "title": "To filter your registered task definition families" } ], "ListTaskDefinitions": [ { "input": {}, "output": { "taskDefinitionArns": [ "arn:aws:ecs:us-east-1::task-definition/sleep300:2", "arn:aws:ecs:us-east-1::task-definition/sleep360:1", "arn:aws:ecs:us-east-1::task-definition/wordpress:3", "arn:aws:ecs:us-east-1::task-definition/wordpress:4", "arn:aws:ecs:us-east-1::task-definition/wordpress:5", "arn:aws:ecs:us-east-1::task-definition/wordpress:6" ] }, "description": "This example lists all of your registered task definitions.", "id": "example-1", "title": "To list your registered task definitions" }, { "input": { "familyPrefix": "wordpress" }, "output": { "taskDefinitionArns": [ "arn:aws:ecs:us-east-1::task-definition/wordpress:3", "arn:aws:ecs:us-east-1::task-definition/wordpress:4", "arn:aws:ecs:us-east-1::task-definition/wordpress:5", "arn:aws:ecs:us-east-1::task-definition/wordpress:6" ] }, "description": "This example lists the task definition revisions of a specified family.", "id": "example-2", "title": "To list the registered task definitions in a family" } ], "ListTasks": [ { "input": { "cluster": "default" }, "output": { "taskArns": [ "arn:aws:ecs:us-east-1:012345678910:task/default/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84", "arn:aws:ecs:us-east-1:012345678910:task/default/6b809ef6-c67e-4467-921f-ee261c15a0a1" ] }, "description": "This example lists all of the tasks in a cluster.", "id": "example-1", "title": "To list the tasks in a cluster" }, { "input": { "cluster": "default", "containerInstance": "f6bbb147-5370-4ace-8c73-c7181ded911f" }, "output": { "taskArns": [ "arn:aws:ecs:us-east-1:012345678910:task/default/0cc43cdb-3bee-4407-9c26-c0e6ea5bee84" ] }, "description": "This example lists the tasks of a specified container instance. Specifying a ``containerInstance`` value limits the results to tasks that belong to that container instance.", "id": "example-2", "title": "To list the tasks on a particular container instance" } ], "PutAccountSetting": [ { "input": { "name": "serviceLongArnFormat", "value": "enabled" }, "output": { "setting": { "name": "serviceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam:::user/principalName" } }, "description": "This example modifies your account settings to opt in to the new ARN and resource ID format for Amazon ECS services. If you’re using this command as the root user, then changes apply to the entire AWS account, unless an IAM user or role explicitly overrides these settings for themselves.", "id": "example-1", "title": "To modify your account settings" }, { "input": { "name": "containerInstanceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam:::user/principalName" }, "output": { "setting": { "name": "containerInstanceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam:::user/principalName" } }, "description": "This example modifies the account setting for a specific IAM user or IAM role to opt in to the new ARN and resource ID format for Amazon ECS container instances. If you’re using this command as the root user, then changes apply to the entire AWS account, unless an IAM user or role explicitly overrides these settings for themselves.", "id": "example-2", "title": "To modify the account settings for a specific IAM user or IAM role" } ], "PutAccountSettingDefault": [ { "input": { "name": "serviceLongArnFormat", "value": "enabled" }, "output": { "setting": { "name": "serviceLongArnFormat", "value": "enabled", "principalArn": "arn:aws:iam:::root" } }, "description": "This example modifies the default account setting for the specified resource for all IAM users or roles on an account. These changes apply to the entire AWS account, unless an IAM user or role explicitly overrides these settings for themselves.", "id": "example-1", "title": "To modify the default account settings for all IAM users or roles on an account" } ], "PutAttributes": [ { "input": { "attributes": [ { "name": "stack", "value": "production", "targetId": "arn:aws:ecs:us-west-2:123456789012:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34" } ], "cluster": "MyCluster" }, "output": { "attributes": [ { "name": "stack", "value": "production", "targetId": "arn:aws:ecs:us-west-2:123456789012:container-instance/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34" } ] }, "description": "This example adds an attribute \"stack\" with the value \"production\" to a container instance.", "id": "example-1", "title": "To create or update an attribute on a resource" } ], "PutClusterCapacityProviders": [ { "input": { "capacityProviders": [ "MyCapacityProvider1", "MyCapacityProvider2" ], "cluster": "MyCluster", "defaultCapacityProviderStrategy": [ { "capacityProvider": "MyCapacityProvider1", "weight": 1 }, { "capacityProvider": "MyCapacityProvider2", "weight": 1 } ] }, "output": { "cluster": { "activeServicesCount": 0, "attachments": [ { "type": "as_policy", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider1" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ], "id": "0fb0c8f4-6edd-4de1-9b09-17e470ee1918", "status": "ACTIVE" }, { "type": "as_policy", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider2" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" } ], "id": "ae592060-2382-4663-9476-b015c685593c", "status": "ACTIVE" } ], "attachmentsStatus": "UPDATE_IN_PROGRESS", "capacityProviders": [ "MyCapacityProvider1", "MyCapacityProvider2" ], "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "clusterName": "MyCluster", "defaultCapacityProviderStrategy": [ { "base": 0, "capacityProvider": "MyCapacityProvider1", "weight": 1 }, { "base": 0, "capacityProvider": "MyCapacityProvider2", "weight": 1 } ], "pendingTasksCount": 0, "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "settings": [ { "name": "containerInsights", "value": "enabled" } ], "statistics": [], "status": "ACTIVE", "tags": [] } }, "description": "This example adds an existing capacity provider \"MyCapacityProvider2\" to a cluster that already has the capacity provider \"MyCapacityProvider1\" associated with it. Both \"MyCapacityProvider2\" and \"MyCapacityProvider1\" need to be specified. ", "id": "example-1", "title": "To add an existing capacity provider to a cluuster" }, { "input": { "capacityProviders": [ "MyCapacityProvider1" ], "cluster": "MyCluster", "defaultCapacityProviderStrategy": [ { "base": 0, "capacityProvider": "MyCapacityProvider1", "weight": 1 } ] }, "output": { "cluster": { "activeServicesCount": 0, "attachments": [ { "type": "as_policy", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider1" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ], "id": "0fb0c8f4-6edd-4de1-9b09-17e470ee1918", "status": "ACTIVE" }, { "type": "as_policy", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider2" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" } ], "id": "ae592060-2382-4663-9476-b015c685593c", "status": "DELETING" } ], "attachmentsStatus": "UPDATE_IN_PROGRESS", "capacityProviders": [ "MyCapacityProvider1" ], "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "clusterName": "MyCluster", "defaultCapacityProviderStrategy": [ { "base": 0, "capacityProvider": "MyCapacityProvider1", "weight": 1 } ], "pendingTasksCount": 0, "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "settings": [ { "name": "containerInsights", "value": "enabled" } ], "statistics": [], "status": "ACTIVE", "tags": [] } }, "description": "This example removes a capacity provider \"MyCapacityProvider2\" from a cluster that has both \"MyCapacityProvider2\" and \"MyCapacityProvider1\" associated with it. Only \"MyCapacityProvider1\" needs to be specified in this scenario. ", "id": "example-2", "title": "To remove a capacity provider from a cluster" }, { "input": { "capacityProviders": [], "cluster": "MyCluster", "defaultCapacityProviderStrategy": [] }, "output": { "cluster": { "activeServicesCount": 0, "attachments": [ { "type": "as_policy", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider1" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" } ], "id": "0fb0c8f4-6edd-4de1-9b09-17e470ee1918", "status": "DELETING" }, { "type": "as_policy", "details": [ { "name": "capacityProviderName", "value": "MyCapacityProvider2" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-a1b2c3d4-5678-90ab-cdef-EXAMPLE22222" } ], "id": "ae592060-2382-4663-9476-b015c685593c", "status": "DELETING" } ], "attachmentsStatus": "UPDATE_IN_PROGRESS", "capacityProviders": [], "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "clusterName": "MyCluster", "defaultCapacityProviderStrategy": [], "pendingTasksCount": 0, "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "settings": [ { "name": "containerInsights", "value": "enabled" } ], "statistics": [], "status": "ACTIVE", "tags": [] } }, "description": "This example removes all capacity providers associated with a cluster. ", "id": "example-3", "title": "To remove all capacity providers from a cluster" } ], "RegisterDaemonTaskDefinition": [ { "input": { "containerDefinitions": [ { "name": "cloudwatch-agent", "cpu": 128, "environment": [ { "name": "USE_DEFAULT_CONFIG", "value": "true" } ], "essential": true, "image": "public.ecr.aws/cloudwatch-agent/cloudwatch-agent:latest", "logConfiguration": { "logDriver": "awslogs", "options": { "awslogs-group": "/ecs/daemon/monitoring-agent", "awslogs-region": "us-east-1", "awslogs-stream-prefix": "ecs" } }, "memory": 256 } ], "cpu": "128", "executionRoleArn": "arn:aws:iam::123456789012:role/ecsTaskExecutionRole", "family": "monitoring-agent", "memory": "256", "taskRoleArn": "arn:aws:iam::123456789012:role/ecsDaemonTaskRole" }, "output": { "daemonTaskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/monitoring-agent:1" }, "description": "This example registers a daemon task definition in the monitoring-agent family with a single container that runs a CloudWatch agent.", "id": "example-1", "title": "To register a daemon task definition" } ], "RegisterTaskDefinition": [ { "input": { "containerDefinitions": [ { "name": "sleep", "command": [ "sleep", "360" ], "cpu": 10, "essential": true, "image": "public.ecr.aws/docker/library/busybox:latest", "memory": 10 } ], "family": "sleep360", "taskRoleArn": "", "volumes": [] }, "output": { "taskDefinition": { "containerDefinitions": [ { "name": "sleep", "command": [ "sleep", "360" ], "cpu": 10, "environment": [], "essential": true, "image": "public.ecr.aws/docker/library/busybox:latest", "memory": 10, "mountPoints": [], "portMappings": [], "volumesFrom": [] } ], "family": "sleep360", "revision": 1, "taskDefinitionArn": "arn:aws:ecs:us-east-1::task-definition/sleep360:19", "volumes": [] } }, "description": "This example registers a task definition to the specified family.", "id": "example-1", "title": "To register a task definition" } ], "RunTask": [ { "input": { "cluster": "default", "taskDefinition": "sleep360:1" }, "output": { "tasks": [ { "containerInstanceArn": "arn:aws:ecs:us-east-1::container-instance/default/ffe3d344-77e2-476c-a4d0-bf560ad50acb", "containers": [ { "name": "sleep", "containerArn": "arn:aws:ecs:us-east-1::container/default/58591c8e-be29-4ddf-95aa-ee459d4c59fd", "lastStatus": "PENDING", "taskArn": "arn:aws:ecs:us-east-1::task/default/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0" } ], "desiredStatus": "RUNNING", "lastStatus": "PENDING", "overrides": { "containerOverrides": [ { "name": "sleep" } ] }, "taskArn": "arn:aws:ecs:us-east-1::task/default/a9f21ea7-c9f5-44b1-b8e6-b31f50ed33c0", "taskDefinitionArn": "arn:aws:ecs:us-east-1::task-definition/sleep360:1" } ] }, "description": "This example runs the specified task definition on your default cluster.", "id": "example-1", "title": "To run a task on your default cluster" } ], "StartTask": [ { "input": { "cluster": "MyCluster", "containerInstances": [ "4c543eed-f83f-47da-b1d8-3d23f1da4c64" ], "taskDefinition": "hello-world" }, "output": { "failures": [], "tasks": [ { "version": 1, "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/default", "containerInstanceArn": "arn:aws:ecs:us-east-1:012345678910:container-instance/default/4c543eed-f83f-47da-b1d8-3d23f1da4c64", "containers": [ { "name": "wordpress", "containerArn": "arn:aws:ecs:us-east-1:012345678910:container/e76594d4-27e1-4c74-98b5-46a6435eb769", "lastStatus": "PENDING", "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/default/fdf2c302-468c-4e55-b884-5331d816e7fb" }, { "name": "mysql", "containerArn": "arn:aws:ecs:us-east-1:012345678910:container/default/b19106ea-4fa8-4f1d-9767-96922c82b070", "lastStatus": "PENDING", "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/default/fdf2c302-468c-4e55-b884-5331d816e7fb" } ], "createdAt": 1479765460.842, "desiredStatus": "RUNNING", "lastStatus": "PENDING", "overrides": { "containerOverrides": [ { "name": "wordpress" }, { "name": "mysql" } ] }, "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/default/fdf2c302-468c-4e55-b884-5331d816e7fb", "taskDefinitionArn": "arn:aws:ecs:us-east-1:012345678910:task-definition/hello_world:6" } ] }, "description": "This example starts a new task in the cluster \"MyCluster\" on the specified container instance using the latest revision of the \"hello-world\" task definition.", "id": "example-1", "title": "To start a new task" } ], "StopServiceDeployment": [ { "input": { "serviceDeploymentArn": "arn:aws:ecs:us-east-1:123456789012:service-deployment/MyCluster/MyService/r9i43YFjvgF_xlg7m2eJ1r", "stopType": "ROLLBACK" }, "output": { "serviceDeploymentArn": "arn:aws:ecs:us-east-1:123456789012:service-deployment/MyCluster/MyService/r9i43YFjvgF_xlg7m2eJ1r" }, "description": "This example stops the service deployment using the ROLLBACK option.", "id": "example-1", "title": "To stop a service deployment" } ], "StopTask": [ { "input": { "cluster": "MyCluster", "reason": "testing stop task.", "task": "1dc5c17a-422b-4dc4-b493-371970c6c4d6" }, "output": { "task": { "version": 0, "clusterArn": "arn:aws:ecs:us-east-1:012345678910:cluster/MyCluster", "containerInstanceArn": "arn:aws:ecs:us-east-1:012345678910:container-instance/MyCluster/5991d8da-1d59-49d2-a31f-4230f9e73140", "containers": [ { "name": "simple-app", "containerArn": "arn:aws:ecs:us-east-1:012345678910:container/4df26bb4-f057-467b-a079-961675296e64", "lastStatus": "RUNNING", "networkBindings": [ { "bindIP": "0.0.0.0", "containerPort": 80, "hostPort": 32774, "protocol": "tcp" } ], "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/MyCluster/1dc5c17a-422b-4dc4-b493-371970c6c4d6" }, { "name": "busybox", "containerArn": "arn:aws:ecs:us-east-1:012345678910:container/e09064f7-7361-4c87-8ab9-8d073bbdbcb9", "lastStatus": "RUNNING", "networkBindings": [], "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/MyCluster/1dc5c17a-422b-4dc4-b493-371970c6c4d6" } ], "createdAt": 1476822811.295, "desiredStatus": "STOPPED", "lastStatus": "RUNNING", "overrides": { "containerOverrides": [ { "name": "simple-app" }, { "name": "busybox" } ] }, "startedAt": 1476822833.998, "startedBy": "ecs-svc/9223370560032507596", "stoppedReason": "testing stop task.", "taskArn": "arn:aws:ecs:us-east-1:012345678910:task/1dc5c17a-422b-4dc4-b493-371970c6c4d6", "taskDefinitionArn": "arn:aws:ecs:us-east-1:012345678910:task-definition/console-sample-app-dynamic-ports:1" } }, "description": "This example stops a task with ID \"1dc5c17a-422b-4dc4-b493-371970c6c4d6\" in cluster \"MyCluster\".", "id": "example-1", "title": "To stop a task" } ], "TagResource": [ { "input": { "resourceArn": "arn:aws:ecs:region:aws_account_id:cluster/dev", "tags": [ { "key": "team", "value": "dev" } ] }, "output": {}, "description": "This example tags the 'dev' cluster with key 'team' and value 'dev'.", "id": "example-1", "title": "To tag a cluster." } ], "UntagResource": [ { "input": { "resourceArn": "arn:aws:ecs:region:aws_account_id:cluster/dev", "tagKeys": [ "team" ] }, "output": {}, "description": "This example deletes the 'team' tag from the 'dev' cluster.", "id": "example-1", "title": "To untag a cluster." } ], "UpdateCapacityProvider": [ { "input": { "name": "MyCapacityProvider", "autoScalingGroupProvider": { "managedScaling": { "instanceWarmupPeriod": 150, "status": "ENABLED", "targetCapacity": 90 } } }, "output": { "capacityProvider": { "name": "MyCapacityProvider", "autoScalingGroupProvider": { "autoScalingGroupArn": "arn:aws:autoscaling:us-east-1:132456789012:autoScalingGroup:57ffcb94-11f0-4d6d-bf60-3bac5EXAMPLE:autoScalingGroupName/MyASG", "managedScaling": { "instanceWarmupPeriod": 150, "maximumScalingStepSize": 10000, "minimumScalingStepSize": 1, "status": "ENABLED", "targetCapacity": 90 }, "managedTerminationProtection": "ENABLED" }, "capacityProviderArn": "arn:aws:ecs:us-east-1:123456789012:capacity-provider/MyCapacityProvider", "status": "ACTIVE", "tags": [], "updateStatus": "UPDATE_COMPLETE" } }, "description": "This example updates the targetCapacity and instanceWarmupPeriod parameters for the capacity provider MyCapacityProvider to 90 and 150 respectively.", "id": "example-1", "title": "To update a capacity provider's parameters" } ], "UpdateCluster": [ { "input": { "cluster": "ECS-project-update-cluster", "settings": [ { "name": "containerInsights", "value": "enhanced" } ] }, "output": { "cluster": { "activeServicesCount": 0, "attachments": [ { "type": "as_policy", "details": [ { "name": "capacityProviderName", "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-152363a6-8c65-484c-b721-42c3e070ae93" } ], "id": "069d002b-7634-42e4-b1d4-544f4c8f6380", "status": "CREATED" }, { "type": "managed_draining", "details": [ { "name": "capacityProviderName", "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt" }, { "name": "autoScalingLifecycleHookName", "value": "ecs-managed-draining-termination-hook" } ], "id": "08b5b6ca-45e9-4209-a65d-e962a27c490a", "status": "CREATED" }, { "type": "sc", "details": [], "id": "45d0b36f-8cff-46b6-9380-1288744802ab", "status": "ATTACHED" } ], "attachmentsStatus": "UPDATE_COMPLETE", "capacityProviders": [ "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt" ], "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/ECS-project-update-cluster", "clusterName": "ECS-project-update-cluster", "defaultCapacityProviderStrategy": [ { "base": 0, "capacityProvider": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt", "weight": 1 } ], "pendingTasksCount": 0, "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "serviceConnectDefaults": { "namespace": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-igwrsylmy3kwvcdx" }, "settings": [ { "name": "containerInsights", "value": "enhanced" } ], "statistics": [], "status": "ACTIVE", "tags": [] } }, "description": "This example turns on enhanced containerInsights in an existing cluster. ", "id": "example-1", "title": "To update a cluster's observability settings." }, { "input": { "cluster": "ECS-project-update-cluster", "serviceConnectDefaults": { "namespace": "test" } }, "output": { "cluster": { "activeServicesCount": 0, "attachments": [ { "type": "as_policy", "details": [ { "name": "capacityProviderName", "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt" }, { "name": "scalingPolicyName", "value": "ECSManagedAutoScalingPolicy-152363a6-8c65-484c-b721-42c3e070ae93" } ], "id": "069d002b-7634-42e4-b1d4-544f4c8f6380", "status": "CREATED" }, { "type": "managed_draining", "details": [ { "name": "capacityProviderName", "value": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt" }, { "name": "autoScalingLifecycleHookName", "value": "ecs-managed-draining-termination-hook" } ], "id": "08b5b6ca-45e9-4209-a65d-e962a27c490a", "status": "CREATED" }, { "type": "sc", "details": [], "id": "45d0b36f-8cff-46b6-9380-1288744802ab", "status": "DELETED" }, { "type": "sc", "details": [], "id": "3e6890c3-609c-4832-91de-d6ca891b3ef1", "status": "ATTACHED" }, { "type": "sc", "details": [], "id": "961b8ec1-c2f1-4070-8495-e669b7668e90", "status": "DELETED" } ], "attachmentsStatus": "UPDATE_COMPLETE", "capacityProviders": [ "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt" ], "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/ECS-project-update-cluster", "clusterName": "ECS-project-update-cluster", "defaultCapacityProviderStrategy": [ { "base": 0, "capacityProvider": "Infra-ECS-Cluster-ECS-project-update-cluster-d6bb6d5b-EC2CapacityProvider-3fIpdkLywwFt", "weight": 1 } ], "pendingTasksCount": 0, "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "serviceConnectDefaults": { "namespace": "arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-dtjmxqpfi46ht7dr" }, "settings": [ { "name": "containerInsights", "value": "enhanced" } ], "statistics": [], "status": "ACTIVE", "tags": [] } }, "description": "This example sets a default Service Connect namespace. ", "id": "example-2", "title": "To update a cluster's Service Connect defaults." } ], "UpdateClusterSettings": [ { "input": { "cluster": "default", "settings": [ { "name": "containerInsights", "value": "enabled" } ] }, "output": { "cluster": { "activeServicesCount": 0, "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/MyCluster", "clusterName": "default", "pendingTasksCount": 0, "registeredContainerInstancesCount": 0, "runningTasksCount": 0, "settings": [ { "name": "containerInsights", "value": "enabled" } ], "statistics": [], "status": "ACTIVE", "tags": [] } }, "description": "This example enables CloudWatch Container Insights for the default cluster.", "id": "example-1", "title": "To update a cluster's settings" } ], "UpdateContainerAgent": [ { "input": { "cluster": "MyCluster", "containerInstance": "53ac7152-dcd1-4102-81f5-208962864132" }, "output": { "containerInstance": { "agentConnected": true, "agentUpdateStatus": "PENDING", "versionInfo": { "agentHash": "4023248", "agentVersion": "1.0.0", "dockerVersion": "DockerVersion: 1.5.0" } } }, "description": "This example updates the container agent version on the specified container instance in cluster MyCluster.", "id": "example-1", "title": "To update the container agent version on a container instance" } ], "UpdateContainerInstancesState": [ { "input": { "cluster": "default", "containerInstances": [ "1c3be8ed-df30-47b4-8f1e-6e68ebd01f34" ], "status": "DRAINING" }, "output": { "containerInstances": [ { "version": 30, "agentConnected": true, "attributes": [ { "name": "ecs.availability-zone", "value": "us-west-2b" }, { "name": "com.amazonaws.ecs.capability.logging-driver.syslog" }, { "name": "ecs.instance-type", "value": "c4.xlarge" }, { "name": "ecs.ami-id", "value": "ami-a2ca61c2" }, { "name": "com.amazonaws.ecs.capability.task-iam-role-network-host" }, { "name": "com.amazonaws.ecs.capability.logging-driver.awslogs" }, { "name": "com.amazonaws.ecs.capability.logging-driver.json-file" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.17" }, { "name": "com.amazonaws.ecs.capability.privileged-container" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.18" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.19" }, { "name": "com.amazonaws.ecs.capability.ecr-auth" }, { "name": "ecs.os-type", "value": "linux" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.20" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.21" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.22" }, { "name": "com.amazonaws.ecs.capability.task-iam-role" }, { "name": "com.amazonaws.ecs.capability.docker-remote-api.1.23" } ], "containerInstanceArn": "arn:aws:ecs:us-west-2:012345678910:container-instance/default/1c3be8ed-df30-47b4-8f1e-6e68ebd01f34", "ec2InstanceId": "i-05d99c76955727ec6", "pendingTasksCount": 0, "registeredResources": [ { "name": "CPU", "type": "INTEGER", "doubleValue": 0, "integerValue": 4096, "longValue": 0 }, { "name": "MEMORY", "type": "INTEGER", "doubleValue": 0, "integerValue": 7482, "longValue": 0 }, { "name": "PORTS", "type": "STRINGSET", "doubleValue": 0, "integerValue": 0, "longValue": 0, "stringSetValue": [ "22", "2376", "2375", "51678", "51679" ] }, { "name": "PORTS_UDP", "type": "STRINGSET", "doubleValue": 0, "integerValue": 0, "longValue": 0, "stringSetValue": [] } ], "remainingResources": [ { "name": "CPU", "type": "INTEGER", "doubleValue": 0, "integerValue": 4096, "longValue": 0 }, { "name": "MEMORY", "type": "INTEGER", "doubleValue": 0, "integerValue": 7482, "longValue": 0 }, { "name": "PORTS", "type": "STRINGSET", "doubleValue": 0, "integerValue": 0, "longValue": 0, "stringSetValue": [ "22", "2376", "2375", "51678", "51679" ] }, { "name": "PORTS_UDP", "type": "STRINGSET", "doubleValue": 0, "integerValue": 0, "longValue": 0, "stringSetValue": [] } ], "runningTasksCount": 0, "status": "DRAINING", "versionInfo": { "agentHash": "efe53c6", "agentVersion": "1.13.1", "dockerVersion": "DockerVersion: 1.11.2" } } ], "failures": [] }, "description": "This example updates the state of the specified container instance in the default cluster to DRAINING. ", "id": "example-1", "title": "To update the state of a container instance" } ], "UpdateDaemon": [ { "input": { "capacityProviderArns": [ "arn:aws:ecs:us-east-1:123456789012:capacity-provider/my-capacity-provider" ], "daemonArn": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-monitoring-daemon", "daemonTaskDefinitionArn": "arn:aws:ecs:us-east-1:123456789012:daemon-task-definition/monitoring-agent:2", "deploymentConfiguration": { "bakeTimeInMinutes": 5, "drainPercent": 10.0 } }, "output": { "createdAt": "2025-03-15T12:00:00.000Z", "daemonArn": "arn:aws:ecs:us-east-1:123456789012:daemon/my-cluster/my-monitoring-daemon", "deploymentArn": "arn:aws:ecs:us-east-1:123456789012:daemon-deployment/my-cluster/my-monitoring-daemon/xY9zA8bC7dE6fG5h", "status": "ACTIVE", "updatedAt": "2025-03-20T15:30:00.000Z" }, "description": "This example updates the my-monitoring-daemon daemon to use a new daemon task definition revision.", "id": "example-1", "title": "To update a daemon" } ], "UpdateGateway": [ { "input": { "configuration": { "hostSharedAlb": { "httpDesync": "strictest", "maxAlbCount": 20 } }, "gateway": "my-gateway" }, "output": { "name": "my-gateway", "gatewayArn": "arn:aws:ecs:us-east-1:123456789012:gateway/my-gateway/a1b2c3d4e5f6478890abcdef12345678", "status": "UPDATE_IN_PROGRESS" }, "description": "This example raises the maximum number of Application Load Balancers that the gateway named my-gateway manages, and changes the desync mitigation mode to strictest.", "id": "example-1", "title": "To update a gateway" } ], "UpdateService": [ { "input": { "service": "my-http-service", "taskDefinition": "amazon-ecs-sample" }, "output": {}, "description": "This example updates the my-http-service service to use the amazon-ecs-sample task definition.", "id": "example-1", "title": "To change the task definition used in a service" }, { "input": { "desiredCount": 10, "service": "my-http-service" }, "output": {}, "description": "This example updates the desired count of the my-http-service service to 10.", "id": "example-2", "title": "To change the number of tasks in a service" }, { "input": { "deploymentConfiguration": { "lifecycleHooks": [ { "lifecycleStages": [ "POST_PRODUCTION_TRAFFIC_SHIFT" ], "targetType": "PAUSE", "timeoutConfiguration": { "action": "CONTINUE", "timeoutInMinutes": 30 } } ], "strategy": "BLUE_GREEN" }, "service": "my-blue-green-service" }, "output": {}, "description": "This example updates the my-blue-green-service service to add a pause lifecycle hook at the POST_PRODUCTION_TRAFFIC_SHIFT stage. The deployment will pause at that stage until you explicitly continue or roll back using the ContinueServiceDeployment API, or until the 30-minute timeout expires and triggers a continue.", "id": "example-3", "title": "To update a service to add a pause lifecycle hook" }, { "input": { "monitoring": { "metricConfigurations": [ { "metricNames": [ "CPUUtilization", "MemoryUtilization" ], "resolutionSeconds": 20 } ] }, "service": "ecs-monitored-service" }, "output": {}, "description": "This example updates a service to add a monitoring configuration that sets 20-second resolution for CPUUtilization and MemoryUtilization CloudWatch metrics. The monitoring configuration is not returned in the UpdateService response. Use DescribeServiceRevisions to view the monitoring configuration.", "id": "example-4", "title": "To update a service with a monitoring configuration" } ], "UpdateServicePrimaryTaskSet": [ { "input": { "cluster": "MyCluster", "primaryTaskSet": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", "service": "MyService" }, "output": { "taskSet": { "computedDesiredCount": 1, "createdAt": 1557128360.711, "id": "ecs-svc/1234567890123456789", "launchType": "EC2", "loadBalancers": [], "networkConfiguration": { "awsvpcConfiguration": { "assignPublicIp": "DISABLED", "securityGroups": [ "sg-12344312" ], "subnets": [ "subnet-12344321" ] } }, "pendingCount": 0, "runningCount": 0, "scale": { "value": 50, "unit": "PERCENT" }, "serviceRegistries": [], "stabilityStatus": "STABILIZING", "stabilityStatusAt": 1557129279.914, "status": "PRIMARY", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2", "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", "updatedAt": 1557129412.653 } }, "description": "This example updates the primary task set for a service MyService that uses the EXTERNAL deployment controller type. ", "id": "example-1", "title": "To update the primary task set for a service" } ], "UpdateTaskProtection": [ { "input": { "cluster": "test-task-protection", "expiresInMinutes": 60, "protectionEnabled": true, "tasks": [ "b8b1cf532d0e46ba8d44a40d1de16772" ] }, "output": { "failures": [], "protectedTasks": [ { "expirationDate": "2022-11-02T06:56:32.553Z", "protectionEnabled": true, "taskArn": "arn:aws:ecs:us-west-2:012345678910:task/default/b8b1cf532d0e46ba8d44a40d1de16772" } ] }, "description": "This example enables scale-in protection for a task for 60 minutes.", "id": "example-1", "title": "To set task scale-in protection for a task for 60 minutes" }, { "input": { "cluster": "test-task-protection", "protectionEnabled": true, "tasks": [ "b8b1cf532d0e46ba8d44a40d1de16772" ] }, "output": { "failures": [], "protectedTasks": [ { "expirationDate": "2022-11-02T06:56:32.553Z", "protectionEnabled": true, "taskArn": "arn:aws:ecs:us-west-2:012345678910:task/default/b8b1cf532d0e46ba8d44a40d1de16772" } ] }, "description": "This example enables task scale-in protection for a task, without specifying the expiresInMinutes parameter, for the default protection period of 120 minutes.", "id": "example-2", "title": "To set task scale-in protection for the default time period in minutes" }, { "input": { "cluster": "test-task-protection", "protectionEnabled": false, "tasks": [ "b8b1cf532d0e46ba8d44a40d1de16772" ] }, "output": { "failures": [], "protectedTasks": [ { "protectionEnabled": false, "taskArn": "arn:aws:ecs:us-west-2:012345678910:task/default/b8b1cf532d0e46ba8d44a40d1de16772" } ] }, "description": "This example removes scale-in protection for a task.", "id": "example-3", "title": "To remove task scale-in protection" } ], "UpdateTaskSet": [ { "input": { "cluster": "MyCluster", "scale": { "value": 50, "unit": "PERCENT" }, "service": "MyService", "taskSet": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789" }, "output": { "taskSet": { "computedDesiredCount": 0, "createdAt": 1557128360.711, "id": "ecs-svc/1234567890123456789", "launchType": "EC2", "loadBalancers": [], "networkConfiguration": { "awsvpcConfiguration": { "assignPublicIp": "DISABLED", "securityGroups": [ "sg-12344321" ], "subnets": [ "subnet-12344321" ] } }, "pendingCount": 0, "runningCount": 0, "scale": { "value": 50, "unit": "PERCENT" }, "serviceRegistries": [], "stabilityStatus": "STABILIZING", "stabilityStatusAt": 1557129279.914, "status": "ACTIVE", "taskDefinition": "arn:aws:ecs:us-west-2:123456789012:task-definition/sample-fargate:2", "taskSetArn": "arn:aws:ecs:us-west-2:123456789012:task-set/MyCluster/MyService/ecs-svc/1234567890123456789", "updatedAt": 1557129279.914 } }, "description": "This example updates the task set to adjust the scale.", "id": "example-1", "title": "To update a task set" } ] } }