Manage database tokens

InfluxDB Clustered database tokens grant read and write permissions to one or more databases and allow for actions like writing and querying data.

Create a database token

Use the influxctl token create command to create a database token for reading and writing data in your InfluxDB cluster. Provide a token description and permissions for databases.

influxctl token create \
  --read-database DATABASE1_NAME \
  --read-database DATABASE2_NAME \
  --write-database DATABASE2_NAME \
  --expires-at 2030-01-01T00:00:00Z \
  "Read-only on DATABASE1_NAME, Read/write on DATABASE2_NAME"

Update a database token

Use the influxctl token update command to update a database token’s permissions in your InfluxDB cluster.

influxctl token update \
  --read-database <DATABASE1_NAME> \
  --read-database <DATABASE2_NAME> \
  --write-database <DATABASE2_NAME> \
  <TOKEN_ID>

List database tokens

Use the influxctl token list command to list tokens in your InfluxDB cluster.

influxctl token list

Revoke a database token

Use the influxctl token revoke command to revoke a token from your InfluxDB cluster and disable all permissions associated with the token. Provide the ID of the token you want to revoke.

influxctl token revoke <TOKEN_ID>

Was this page helpful?

Thank you for your feedback!