The `influx bucket delete` command in the Influx CLI (version 2.0.0 and above) allows you to delete a bucket from InfluxDB along with all its contained data.
### Usage
To use the command, you can follow this format:
```sh
influx bucket delete [flags]
```
### Flags
Here are the flags you can use with this command:
- `-c`, `--active-config`: The CLI configuration for the command.
- `--configs-path`: Path to `influx` CLI configurations. The default is `~/.influxdbv2/configs`.
- `-h`, `--help`: Provides help for the `delete` command.
- `--hide-headers`: Hides table headers. The default is `false`.
- `--host`: The HTTP address of InfluxDB. The default is `http://localhost:8086`.
- `--http-debug`: Provides inspection for communication with InfluxDB servers.
- `-i`, `--id`: The ID of the bucket to be deleted. This is required if no name (`--name`) is provided.
- `-n`, `--name`: The name of the bucket to be deleted. This requires organization (`org` or `org-id`) details.
- `-o`, `--org`: Organization name (can't be used with '--org-id').
- '--org-id': Organization ID (can't be used with '--org').
- '--skip-verify': Skips TLS certificate verification.
- '-t', '--token': API token.
### Examples
Authentication credentials like **host**, **organization**, and **token** can be provided by either an active influx CLI configuration or environment variables (`INFLUX_HOST`, `INFLUX_ORG`, and `INFLUX_TOKEN`).
#### Delete a Bucket by Name
```sh
influx bucket delete --name example-bucket
```
#### Delete a Bucket by ID
```sh
influx bucket delete --id 06c86c40a9f36000
```
Note: If you don't have the CLI configuration or environment variables set, provide these credentials with each command using the appropriate flags.
---
References:
- [influx bucket delete | InfluxDB Cloud (TSM) Documentation (influxdata.com)](https://docs.influxdata.com/influxdb/cloud/reference/cli/influx/bucket/delete/)