# atmos aws cloudformation output

Show the deployed stack's `Outputs` (`DescribeStacks`), formatted for
consumption by shells, other tools, or other Atmos components. `apply`
renders this same view automatically at the end of a successful deploy.

> ⚠️ Experimental

## Usage

```shell
atmos aws cloudformation output <component> --stack <stack> [options]
```

```shell
atmos aws cloudformation output vpc -s plat-ue2-dev
```

Choose an output format:

```shell
atmos aws cloudformation output vpc -s plat-ue2-dev --format=json
atmos aws cloudformation output vpc -s plat-ue2-dev --format=env
atmos aws cloudformation output vpc -s plat-ue2-dev --format=github
```

Flatten nested Outputs into compound keys, or uppercase every key:

```shell
atmos aws cloudformation output vpc -s plat-ue2-dev --format=dotenv --flatten --uppercase
```

Show output for all or affected components:

```shell
atmos aws cloudformation output --all -s plat-ue2-dev
atmos aws cloudformation output --affected --base origin/main
```

## Flags

- **`--stack`, `-s` (required for a single component)**
  Atmos stack. Required when operating on a single component; optional (and used only to narrow the selected set) with 
  `--all`
  /
  `--affected`
  .
- **`--format` (optional, default `table`)**
  Output format: 
  `json`
  , 
  `yaml`
  , 
  `hcl`
  , 
  `env`
  , 
  `dotenv`
  , 
  `bash`
  , 
  `csv`
  , 
  `tsv`
  , 
  `table`
  , or 
  `github`
  .
- **`--flatten` (optional)**
  Flatten nested Outputs into compound keys.
- **`--uppercase` (optional)**
  Uppercase Output keys.
- **`--all` (optional)**
  Show Outputs for all 
  `aws/cloudformation`
   components in dependency order.
- **`--affected` (optional)**
  Show Outputs for affected 
  `aws/cloudformation`
   components and their dependencies.
- **`--include-dependents` (optional)**
  With 
  `--affected`
  , include dependent 
  `aws/cloudformation`
   components.
- **`--base` (optional)**
  Git base ref or SHA to compare against for affected detection: 
  `--base origin/main`
  . Used with 
  `--affected`
  .
- **`--tags` (optional)**
  Filter by tags (comma-separated, matches any): 
  `--tags=production,tier-1`
  . Composes with 
  `--all`
  /
  `--affected`
   to narrow the selected set further; cannot be combined with a single component argument.
- **`--labels` (optional)**
  Filter by labels (comma-separated 
  `key=value`
   or 
  `key:value`
   pairs, matches all): 
  `--labels=cost-center=platform,compliance=sox`
  . Composes with 
  `--all`
  /
  `--affected`
  /
  `--tags`
  ; cannot be combined with a single component argument.

:::note
`outputs` is accepted as an alias for `output`.
:::