Documentation

influx v1 auth create

influx CLI 2.0.0+

InfluxDB 2.0.0+

Updated in CLI v2.0.3

The influx v1 auth create command creates a legacy authorization with the InfluxDB 1.x compatibility API.

Usage

influx v1 auth create [flags]

Flags

FlagDescriptionInput typeMaps to ?
-c--active-configConfig name to use for commandstring$INFLUX_ACTIVE_CONFIG
--configs-pathPath to the influx CLI configurations (default: ~/.influxdbv2/configs)string$INFLUX_CONFIGS_PATH
-d--descriptionToken descriptionstring
-h--helpHelp for the create command
--hide-headersHide the table headers (default: false)$INFLUX_HIDE_HEADERS
--hostHTTP address of InfluxDBstring$INFLUX_HOST
--jsonOutput data as JSON (default: false)$INFLUX_OUTPUT_JSON
--no-passwordDon’t prompt for a password (to use the token, you must set a password with influx v1 auth set-password)
-o--orgOrganization name (mutually exclusive with --org-id)string$INFLUX_ORG
--org-idOrganization ID (mutually exclusive with --org)string$INFLUX_ORG_ID
--passwordPassword to set on the authorization
--read-bucketBucket ID to assign read permissions tostringArray
--skip-verifySkip TLS certificate verificationINFLUX_SKIP_VERIFY
-t--tokenAPI tokenstring$INFLUX_TOKEN
--username(Required) Token usernamestring
--write-bucketBucket ID to assign write permissions tostringArray

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 v1 authorization with read and write permissions
# Create an authorization with read and write access to bucket 00xX00o0X001
# but only read access to bucket 00xX00o0X002
influx v1 auth create \
  --read-bucket 00xX00o0X001 \
  --read-bucket 00xX00o0X002 \
  --write-bucket 00xX00o0X001 \
  --username example-user

Set your InfluxDB URL

Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.