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
In the navigation menu on the left, select Data (Load Data) > Buckets.
Click Settings under the bucket you want to rename.
Click Rename.
Review the information in the window that appears and click I understand, let’s rename my bucket.
Update the bucket’s name and click Change Bucket Name.
Update a bucket’s retention policy in the InfluxDB UI
In the navigation menu on the left, select Data (Load Data) > Buckets.
Click Settings next to the bucket you want to update.
In the window that appears, edit the bucket’s retention policy.
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 policy
Valid retention policy 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
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, the following resources are available:
InfluxDB Cloud and InfluxDB Enterprise customers can contact InfluxData Support.