Create a bucket

This page documents an earlier version of InfluxDB. InfluxDB v2.7 is the latest stable version. View this page in the v2.7 documentation.

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

Bucket limits

A single InfluxDB 2.3 OSS instance supports approximately 20 buckets actively being written to or queried across all organizations depending on the use case. Any more than that can adversely affect performance.

Create a bucket in the InfluxDB UI

There are two places you can create a bucket in the UI.

Create a bucket from the Load Data menu

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

   Load Data

2. Click Create Bucket in the upper right.

3. Enter a Name for the bucket.

4. Select when to Delete Data:

   • Never to retain data forever.
   • Older than to choose a specific retention period.
5. Click Create to create the bucket.

Create a bucket in the Data Explorer

1. In the navigation menu on the left, select *Explore (Data Explorer).

   Data Explorer

2. In the From panel in the Flux Builder, select + Create Bucket.

3. Enter a Name for the bucket.

4. Select when to Delete Data:

   • Never to retain data forever.
   • Older than to choose a specific retention period.
5. Click Create to create the bucket.

Create a bucket using the influx CLI

Use the influx bucket create command to create a new bucket. A bucket requires the following:

• bucket name

• organization name or ID

• retention period (duration to keep data) in one of the following units:

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

  The minimum retention period is one hour.

# Syntax
influx bucket create -n <bucket-name> -o <org-name> -r <retention-period-duration>
# Example
influx bucket create -n my-bucket -o my-org -r 72h

Create a bucket using the InfluxDB API

Use the InfluxDB API to create a bucket.

Bucket limits

A single InfluxDB 2.3 OSS instance supports approximately 20 buckets actively being written to or queried across all organizations depending on the use case. Any more than that can adversely affect performance.

Create a bucket in InfluxDB using an HTTP request to the InfluxDB API /buckets endpoint. Use the POST request method and include the following in your request:

Example

The URL depends on the version and location of your InfluxDB 2.3 instance (see InfluxDB URLs).

INFLUX_TOKEN=YOUR_API_TOKEN
INFLUX_ORG_ID=YOUR_ORG_ID
curl --request POST \
  "http://localhost:8086/api/v2/buckets" \
  --header "Authorization: Token ${INFLUX_TOKEN}" \
  --header "Content-type: application/json" \
  --data '{
    "orgID": "'"${INFLUX_ORG_ID}"'",
    "name": "iot-center",
    "retentionRules": [
      {
        "type": "expire",
        "everySeconds": 86400,
        "shardGroupDurationSeconds": 0
      }
    ]
  }'

For information about InfluxDB API options and response codes, see InfluxDB API Buckets documentation.