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
Flag | Description | Input type | Maps to ? | |
---|---|---|---|---|
-c | —active-config | Config name to use for command | string | INFLUX_ACTIVE_CONFIG |
—configs-path | Path to the influx CLI configurations (default: ~/.influxdbv2/configs ) | string | INFLUX_CONFIGS_PATH | |
-d | —description | Token description | string | |
-h | —help | Help for the create command | ||
—hide-headers | Hide the table headers (default: false ) | INFLUX_HIDE_HEADERS | ||
—host | HTTP address of InfluxDB | string | INFLUX_HOST | |
—json | Output data as JSON (default: false ) | INFLUX_OUTPUT_JSON | ||
—no-password | Don’t prompt for a password (to use the token, you must set a password with influx v1 auth set-password ) | |||
-o | —org | Organization name (mutually exclusive with —org-id ) | string | INFLUX_ORG |
—org-id | Organization ID (mutually exclusive with —org ) | string | INFLUX_ORG_ID | |
—password | Password to set on the authorization | |||
—read-bucket | Bucket ID to assign read permissions to | stringArray | ||
—skip-verify | Skip TLS certificate verification | INFLUX_SKIP_VERIFY | ||
-t | —token | API token | string | INFLUX_TOKEN |
—username | (Required) Token username | string | ||
—write-bucket | Bucket ID to assign write permissions to | stringArray |
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:
--host
: InfluxDB host-o, --org
or--org-id
: InfluxDB organization name or ID-t, --token
: InfluxDB API token
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
Related
- Upgrade from InfluxDB 1.x to 2.7
- influx CLI—Provide required authentication credentials
- `influx` CLI—Flag patterns and conventions