# metalcloud-cli bucket list

List all buckets in an infrastructure

## Synopsis

List all buckets within a specified infrastructure with optional filtering capabilities.

This command displays all buckets associated with the given infrastructure, showing their 
status, configuration, and metadata. Results can be filtered by bucket status to focus 
on specific states.

Required Arguments:
  infrastructure_id_or_label    The ID or label of the infrastructure

Optional Flags:
  --filter-status strings      Filter buckets by their status (can be repeated for multiple statuses)

Examples:
  ## List all buckets in infrastructure with ID 100
  metalcloud-cli bucket list 100

  ## List all buckets in infrastructure labeled "production"
  metalcloud-cli bucket list production

  ## List only active buckets
  metalcloud-cli bucket list 100 --filter-status active

  ## List buckets with multiple status filters
  metalcloud-cli bucket list production --filter-status active --filter-status pending

```
metalcloud-cli bucket list infrastructure_id_or_label [flags]
```

### Options

```
      --filter-status strings   Filter the result by bucket status.
  -h, --help                    help for list
```

### Options inherited from parent commands

```
  -k, --api_key string         MetalCloud API key
  -c, --config string          Config file path
  -d, --debug                  Set to enable debug logging
  -e, --endpoint string        MetalCloud API endpoint
  -f, --format string          Output format. Supported values are 'text','csv','md','json','yaml'. (default "text")
  -i, --insecure_skip_verify   Set to allow insecure transport
  -l, --log_file string        Log file path
  -v, --verbosity string       Log level verbosity (default "INFO")
```

### SEE ALSO

* [metalcloud-cli bucket](/content/configuration/cli/metalcloud-cli_bucket.md)	 - Manage S3-compatible object storage buckets

#### Auto generated by spf13/cobra on 11-Aug-2025