influx bucket create

• influx CLI 2.0.0+
• InfluxDB 2.0.0+
• Updated in CLI v2.1.0

The influx bucket create command creates a bucket in InfluxDB.

Usage

influx bucket create [flags]

Flags

Retention periods

The minimum retention period is one hour. Valid --retention units:

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

Examples

Authentication credentials

The examples below assume your InfluxDB host, organization, and token are provided by the active influx CLI configuration. If you do not have a CLI configuration set up, use the appropriate flags to provide these required credentials.

• Create a bucket with infinite data retention
• Create a bucket that retains data for 30 days
• Create a bucket with a description
• Create a bucket with a custom shard group duration
• Create a bucket with an explicit schema

Create a bucket with infinite data retention

influx bucket create --name example-bucket

Create a bucket that retains data for 30 days

influx bucket create \
  --name example-bucket \
  --retention 30d

Create a bucket with a description

influx bucket create \
  --name example-bucket \
  --description "Example bucket description"

Create a bucket with a custom shard group duration

Custom shard group durations are only supported in InfluxDB OSS. The shard group duration must be shorter than the bucket’s retention period. For more information, see InfluxDB shards and shard groups.

influx bucket create \
  --name example-bucket \
  --retention 30d \
  --shard-group-duration 2d

Create a bucket with an explicit schema

Explicit bucket schemas are only supported in InfluxDB Cloud. For more information, see Manage bucket schema.

influx bucket create \
  --name my_schema_bucket \
  --schema-type explicit

Related

• Create a bucket
• InfluxDB shards and shard groups
• influx CLI—Provide required authentication credentials
• influx CLI—Flag patterns and conventions