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

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