Documentation

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. In the navigation menu on the left, select Data (Load Data) > Buckets.

  2. Click Settings to the right of the bucket you want to rename.

  3. Click Rename.

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

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

Update a bucket’s retention period in the InfluxDB UI

  1. In the navigation menu on the left, select Data (Load Data) > Buckets.

  2. Click Settings next to the bucket you want to update.

  3. In the window that appears, under Delete data, select a retention period:

    • Never: data in the bucket is retained indefinitely.
    • Older Than: select a predefined retention period from the dropdown menu.

    Use the influx bucket update command to set a custom retention period.

  4. 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 list)
  • The name or ID of the organization the bucket belongs to.
Update the name of a bucket
# Syntax
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 period

Valid retention period duration units are nanoseconds (ns), microseconds (us or µs), milliseconds (ms), seconds (s), minutes (m), hours (h), days (d), or weeks (w).

# Syntax
influx bucket update -i <bucket-id> -r <retention period in nanoseconds>

# Example
influx bucket update -i 034ad714fdd6f000 -r 1209600000000000

Select your region

Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.