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.

   Load Data

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.

   Load Data

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> -n <new-bucket-name>

# Example
influx bucket update -i 034ad714fdd6f000 -n my-new-bucket

Update a bucket’s retention period

Valid retention period duration units:

• nanoseconds (ns)
• microseconds (us or µs)
• milliseconds (ms)
• seconds (s)
• minutes (m)
• hours (h)
• days (d)
• weeks (w)

# Syntax
influx bucket update -i <bucket-id> -r <retention period with units>

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