---
title: Update a bucket
description: Update a bucket’s name or retention period in InfluxDB using the InfluxDB UI or the influx CLI.
url: https://docs.influxdata.com/influxdb/v2/admin/buckets/update-bucket/
estimated_tokens: 904
product: InfluxDB OSS v2
version: v2
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/v2/admin/buckets/update-bucket/
date: '2023-11-06T15:53:12-07:00'
lastmod: '2023-11-06T15:53:12-07:00'
---

This page documents an earlier version of InfluxDB OSS.[InfluxDB 3 Core](/influxdb3/core/) is the latest stable version.

#### API token hashing is enabled by default in InfluxDB OSS 2.9.0

Stronger token security: tokens are stored as hashes on disk, so a
copy of the database file doesn’t expose usable tokens. Existing
tokens are hashed on first startup and the original strings can’t
be recovered afterward — **capture any plaintext tokens you still
need before you upgrade**.

For more information, see [Token hashing](/influxdb/v2/admin/tokens/#token-hashing).

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** under 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**.

> [!Note]
> > [!Note]
> For information about permitted bucket names, see[bucket naming restrictions](/influxdb/cloud/admin/buckets/create-bucket/#bucket-naming-restrictions).

## 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, edit the bucket’s retention period.

4. Click **Save Changes**.

## Update a bucket using the influx CLI

Use the [`influx bucket update` command](/influxdb/v2/reference/cli/influx/bucket/update)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.

#### Authentication credentials

The examples below assume your InfluxDB **host**, **organization**, and **token** are
provided by either the [active `influx` CLI configuration](/influxdb/v2/reference/cli/influx/#provide-required-authentication-credentials) or by environment variables (`INFLUX_HOST`, `INFLUX_ORG`, and `INFLUX_TOKEN`).
If you do not have a CLI configuration set up or the environment variables set, include these required credentials for each command with the following flags:

* `--host`: [InfluxDB host](/influxdb/v2/reference/urls/)
* `-o, --org` or `--org-id`: InfluxDB organization name or ID
* `-t, --token`: InfluxDB API token

##### Update the name of a bucket

For information about permitted bucket names, see[bucket naming restrictions](/influxdb/cloud/admin/buckets/create-bucket/#bucket-naming-restrictions).

```sh
# 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`)

> [!Note]
> The minimum retention period is **one hour**.

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

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