# atmos aws cloudformation backend list

List every `kind: aws/s3` provision target declared on the component, and
whether each one's bucket currently exists.

> ⚠️ Experimental

**CloudFormation Configuration**

Configure templates, parameters, and delivery targets for your component.
Configuration Reference[Read more](/stacks/components/aws-cloudformation#delivery-targets)

## Usage

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

## Examples

```shell
atmos aws cloudformation backend list vpc -s plat-ue2-dev
atmos aws cloudformation backend list vpc -s plat-ue2-dev --format json
```

## Arguments

- **`component` (required)**
  CloudFormation component name in the Atmos stack.

## Flags

- **`--stack`, `-s` (required)**
  Atmos stack.
- **`--format`, `-f` (optional)**
  Output format: 
  `table`
   (default), 
  `yaml`
  , or 
  `json`
  .
- **`--identity`, `-i` (optional)**
  Atmos identity to authenticate with.

## Behavior

The command lists every S3 target for one component; it does not accept
`--target`. Supply a component name and `--stack`.

The `table` format prints a header row (`TARGET`, `BUCKET`, `REGION`,
`STATUS`). The `json` and `yaml` formats use snake\_case keys; see [`backend
describe`](/cli/commands/aws/cloudformation/backend/describe) for the shape.

### Targets that cannot be inspected

Each target uses its own identity. Failed authentication or bucket checks appear
as error rows; healthy targets still appear in the output:

```text
TARGET               BUCKET                         REGION         STATUS
a-broken             broken-bucket                  us-east-1      error: aws/cloudformation component requested an identity, but the auth manager could not resolve it: identity "devv" not found
b-good               good-bucket                    us-east-1      exists
```

In the `json` and `yaml` formats the failed entry carries an `error` field with
the same cause; healthy entries omit it.

After the rows print, the command exits non-zero if any target failed. The
error names the failed targets and their count, and hints to run
`atmos aws cloudformation backend describe --target <name>` for details.