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

The procedures in this guide support the new console design. If you choose to use the older version of the console, you will find many of the concepts and basic procedures in this guide still apply. To access help in the new console, choose the information icon.

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 that you used in Getting Started with AWS CodeDeploy.

  2. In the navigation pane, expand Deploy, and then 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 deployment ID for the instance.

  4. You can view all instances in the Instance activity section of the deployment's page.

  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, choose the ID of the instance in the Instance ID column.

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.)