Update a database token
Use the influxctl token update command
to update a database token’s permissions in your InfluxDB cluster.
-
If you haven’t already, download and install the
influxctlCLI. -
Run the
influxctl token createcommand and provide the following:-
Token permissions (read and write)
--read-database: Grants read permissions to the specified database. Repeatable.--write-database: Grants write permissions to the specified database. Repeatable.
Both of these flags support the
*wildcard which grants read or write permissions to all databases. Enclose wildcards in single or double quotes–for example:'*'or"*". -
Token ID
-
influxctl token create \
--read-database DATABASE_NAME \
--write-database DATABASE_NAME \
TOKEN_ID
Replace the following:
DATABASE_NAME: your InfluxDB Clustered databaseTOKEN ID: ID of the token to update
Existing permissions are replaced on update
When updating token permissions, the existing permissions are replaced by the new permissions specified in the update command. To retain existing permissions, include them in the update command.
Examples
- Update a token with read and write access to a database
- Update a token with read and write access to all databases
- Update a token with read-only access to a database
- Update a token with read-only access to multiple databases
- Update a token with mixed permissions to multiple databases
In the examples below, Replace the following:
DATABASE_NAME: your InfluxDB Clustered databaseDATABASE2_NAME: your InfluxDB Clustered databaseTOKEN ID: ID of the token to update
Update a token with read and write access to a database
influxctl token update \
--read-database DATABASE_NAME \
--write-database DATABASE_NAME \
TOKEN_ID
Update a token with read and write access to all databases
influxctl token update \
--read-database "*" \
--write-database "*" \
TOKEN_ID
Update a token with read-only access to a database
influxctl token update \
--read-database DATABASE_NAME \
TOKEN_ID
Update a token with read-only access to multiple databases
influxctl token update \
--read-database DATABASE_NAME \
--read-database DATABASE2_NAME \
TOKEN_ID
Update a token with mixed permissions to multiple databases
influxctl token update \
--read-database DATABASE_NAME \
--read-database DATABASE2_NAME \
--write-database DATABASE2_NAME \
TOKEN_ID
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, use the following resources:
Customers with an annual or support contract can contact InfluxData Support.