InfluxDB Docs

Update a bucket

Use the influx command line interface (CLI) or the InfluxDB user interface (UI) to update a bucket.

Note that updating an bucket’s name will affect any assets that reference the bucket by name, including the following:

  • Queries
  • Dashboards
  • Tasks
  • Telegraf configurations
  • Templates

If you change a bucket name, be sure to update the bucket in the above places as well.

Update a bucket’s name in the InfluxDB UI

  1. Click the Settings tab in the navigation bar.

  2. Select the Buckets tab.

  3. Hover over the name of the bucket you want to rename in the list.

  4. Click Rename.

  5. Review the information in the window that appears and click I understand, let’s rename my bucket.

  6. Update the bucket’s name and click Change Bucket Name.

Update a bucket’s retention policy in the InfluxDB UI

  1. Click the Settings tab in the navigation bar.

  2. Select the Buckets tab.

  3. Click the name of the bucket you want to update from the list.

  4. In the window that appears, edit the bucket’s retention policy.

  5. Click Save Changes.

Update a bucket using the influx CLI

Use the influx bucket update command to update a bucket. Updating a bucket requires the following:

  • The bucket ID (provided in the output of influx bucket find)
  • The name or ID of the organization to which the bucket belongs
Update the name of a bucket
# Pattern
influx bucket update -i <bucket-id> -o <org-name> -n <new-bucket-name>

# Example
influx bucket update -i 034ad714fdd6f000 -o my-org -n my-new-bucket
Update a bucket’s retention policy
# Pattern
influx bucket update -i <bucket-id> -o <org-name> -r <retention period in nanoseconds>

# Example
influx bucket update -i 034ad714fdd6f000 -o my-org -r 1209600000000000