How to List Stacks in AWS CDK

List Stacks in AWS CDK #

A CDK App can consist of one or more stacks.

In order to list the stacks in a CDK application we have to use the cdk list command:

npx cdk list

If we have a simple CDK application consisting of 2 stacks:

const app = new cdk.App();

new MyCdkStack(app, 'my-stack-dev', {
  stackName: 'my-stack-dev',
});

new MyCdkStack(app, 'my-stack-prod', {
  stackName: 'my-stack-prod',
});

The output from the command looks like:

Alternatively we could use the alias - cdk ls:

npx cdk ls

The output from the command is the same:

We can look at all of the available flags of the cdk list command by appending the --help flag.

npx cdk list --help

The flag that I use the most is --long, i.e.:

npx cdk list --long

The --long outputs information about the environments (account and region) our stacks belong to:

- id: my-stack-dev
  name: my-stack-dev
  environment:
    account: '123456789'
    region: us-east-1
    name: aws://123456789/us-east-1
- id: my-stack-prod
  name: my-stack-prod
  environment:
    account: '123456789'
    region: us-east-1
    name: aws://123456789/us-east-1

Further Reading #

• AWS CDK Tutorial for Beginners - Step-by-Step Guide
• How does AWS CDK work
• What is a Token in AWS CDK
• CDK Constructs - Complete Guide
• What is an identifier (id) in AWS CDK
• How to use Context in AWS CDK
• How to use Parameters in AWS CDK