Viewing Amazon ECS service deployments

You can see the most recent 90-day history for deployments created on or after October 25, 2024. The service deployments can be in any of the following states:

• In-progress

• Pending

• Completed

You can use this information to determine if you need to update how the service is being deployed, or the service revision. For information about the included properties, see Properties included in an Amazon ECS service deployment.

Before you begin, configure the required permssions for viewing service deployments. For more information, see Permissions required for viewing Amazon ECS service deployments.

Amazon ECS Console

1. Open the console at https://console.aws.amazon.com/ecs/v2.

2. On the Clusters page, choose the cluster.

3. On the cluster details page, in the Services section, choose the service.

   The service details page displays.

4. On the service details page, choose Deployments.

5. Choose the service deployment to view.

   To view service deployments for this deployment type	Do this
   Ongoing deployment	Under Ongoing deployments, choose the Deployment ID.
   Last deployment	Under Last deployment, choose the Deployment ID.
   Completed deployments	Under Service deployments, choose the Deployment ID.

   The service deployment details page appears.

6. (Optional) Compare service revisions to view the differences.

   Under Service revisions, choose Compare revisions, and then select 2 revisions to compare.

   The service revisions are displayed side-by-side with the differences highlighted.

AWS CLI

1. Run list-service-deployments to retrieve the service deployment ARN.

   Replace the variables with your values.

   aws ecs list-service-deployments --cluster cluster-name --service service-name

   Note the serviceDeploymentArn for the deployment you want to view.

   {
       "serviceDeployments": [
           {
               "serviceDeploymentArn": "arn:aws:ecs:us-west-2:123456789012:service-deployment/example/sd-example/NCWGC2ZR-taawPAYrIaU5",
               "serviceArn": "arn:aws:ecs:us-west-2:123456789012:service/example/sd-example",
               "clusterArn": "arn:aws:ecs:us-west-2:123456789012:cluster/example",
               "targetServiceRevisionArn": "arn:aws:ecs:us-west-2:123456789012:service-revision/example/sd-example/4980306466373577095",
               "status": "SUCCESSFUL"
           }
       ]
   }
   

2. Run describe-service-deployments. Use the serviceDeploymentArn that was returned from list-service-deployments.

   Replace the variables with your values.

   aws ecs describe-service-deployments --service-deployment-arns arn:aws:ecs:region:123456789012:service-deployment/cluster-name/service-name/NCWGC2ZR-taawPAYrIaU5

Next steps

You can view the details for service revisions in the deployment. For more information, see Viewing Amazon ECS service revision details