View instance details with CodeDeploy - Amazon CodeDeploy
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

View instance details with CodeDeploy

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

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

View instance details (console)

To view instance details:

  1. Sign in to the Amazon Web Services Management Console and open the CodeDeploy console at


    Sign in with the same account or IAM user information that you used in Getting started with 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 Amazon General Reference. 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 Amazon 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.)