AWS CodeDeploy
User Guide (API Version 2014-10-06)

A new console design is available for this service. Although the procedures in this guide were written for the older version of the console, you will find many of the concepts and basic procedures in this guide still apply.

View Instance Details with AWS CodeDeploy

You can use the AWS CodeDeploy console, the AWS CLI, or the AWS CodeDeploy APIs to view details about instances used in a deployment.

For information about using AWS CodeDeploy API actions to view instances, see GetDeploymentInstance, ListDeploymentInstances, and ListOnPremisesInstances.

View Instance Details (Console)

To view instance details:

  1. Sign in to the AWS Management Console and open the AWS CodeDeploy console at


    Sign in with the same account or IAM user information you used in Getting Started with AWS CodeDeploy.

  2. On the AWS CodeDeploy menu, choose Deployments.


    If no entries are displayed, make sure the correct region is selected. On the navigation bar, in the region selector, choose one of the regions listed in Region and Endpoints in the AWS General Reference. AWS CodeDeploy is supported in these regions only.

  3. To display deployment details, choose the arrow next to the deployment ID that corresponds to the instance.

  4. In Instances, choose View all instances.

  5. To see information about individual deployment lifecycle events for an instance, on the deployment details page, in the Events column, choose View events.


    If Failed is displayed for any of the lifecycle events, on the instance details page, choose View logs, View in EC2, or both. You can find troubleshooting tips in Troubleshoot Instance Issues.

  6. If you want to see more information about an Amazon EC2 instance, but View in EC2 is not available on the instance details page, return to the deployment details page, and in the Instance ID column, choose the ID of the Amazon EC2 instance.

View Instance Details (CLI)

To use the AWS CLI to view instance details, call either the get-deployment-instance command or the list-deployment-instances command.

To view details about a single instance, call the get-deployment-instance command, specifying:

To view a list of IDs for instances used in a deployment, call the list-deployment-instances command, specifying:

  • The unique deployment ID. To get the deployment ID, call the list-deployments command.

  • Optionally, whether to include only specific instance IDs by their deployment status. (If not specified, all matching instance IDs will be listed, regardless of their deployment status.)