Documentation

influx v1 auth create

Not supported in InfluxDB Cloud

InfluxDB Cloud does not support InfluxDB 1.x compatible authorizations. Using the influx v1 auth create command with InfluxDB Cloud will result in an error. To authenticate with InfluxDB Cloud, use InfluxDB token authentication.

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 verification
-t--tokenAuthentication 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

Select your region

Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.