# metalcloud-cli bucket delete

Delete a bucket and all its contents

## Synopsis

Permanently delete a bucket and all its contents from the specified infrastructure.

This command removes a bucket and all objects stored within it. This operation is 
irreversible and will permanently destroy all data in the bucket. Use with caution 
in production environments.

Required Arguments:
  infrastructure_id_or_label    The ID or label of the infrastructure containing the bucket
  bucket_id                     The unique identifier of the bucket to delete

Examples:
  ## Delete bucket with ID 42 from infrastructure 100
  metalcloud-cli bucket delete 100 42

  ## Delete bucket using infrastructure label
  metalcloud-cli bucket delete production bucket-abc123

  ## Remove bucket using alias
  metalcloud-cli bucket rm staging my-bucket-id

```
metalcloud-cli bucket delete infrastructure_id_or_label bucket_id [flags]
```

### Options

```
  -h, --help   help for delete
```

### 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