influx bucket create

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

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

The influx bucket create command creates a bucket in InfluxDB.

Usage

  1. influx bucket create [flags]

Flags

FlagDescriptionInput typeMaps to ?
-c—active-configCLI configuration to use for commandstring
—configs-pathPath to influx CLI configurations (default ~/.influxdbv2/configs)stringINFLUX_CONFIGS_PATH
-d—descriptionBucket descriptionstring
-h—helpHelp for the create command
—hide-headersHide table headers (default false)INFLUX_HIDE_HEADERS
—hostHTTP address of InfluxDB (default http://localhost:8086)stringINFLUX_HOST
—http-debugInspect communication with InfluxDB servers.string
—jsonOutput data as JSON (default false)INFLUX_OUTPUT_JSON
-n—nameBucket namestringINFLUX_BUCKET_NAME
-o—orgOrganization name (mutually exclusive with —org-id)stringINFLUX_ORG
—org-idOrganization ID (mutually exclusive with —org)stringINFLUX_ORG_ID
-r—retentionDuration bucket retains data (0 is infinite, default is 0)duration
—schema-typeBucket schema type (explicit, default implicit) (Cloud only). For more information, see Manage bucket schema.string
—shard-group-durationBucket shard group duration (OSS only)string
—skip-verifySkip TLS certificate verificationINFLUX_SKIP_VERIFY
-t—tokenAPI tokenstringINFLUX_TOKEN

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 either the active influx CLI configuration 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:

Create a bucket with infinite data retention
  1. influx bucket create --name example-bucket
Create a bucket that retains data for 30 days
  1. influx bucket create \
  2. --name example-bucket \
  3. --retention 30d
Create a bucket with a description
  1. influx bucket create \
  2. --name example-bucket \
  3. --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.

  1. influx bucket create \
  2. --name example-bucket \
  3. --retention 30d \
  4. --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.

  1. influx bucket create \
  2. --name my_schema_bucket \
  3. --schema-type explicit