Create a token

Use the influxctl token create command to create a token that grants access to databases in your InfluxDB Cloud Dedicated cluster.

1. If you haven’t already, download and install the influxctl CLI.

2. Run the influxctl token create command 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.
   • Token description

influxctl token create \
  --read-database 
DATABASE_NAME
 \
  --write-database 
DATABASE_NAME
 \
    "Read/write token for 
DATABASE_NAME
"

Replace the following:

• DATABASE_NAME: your InfluxDB Cloud Dedicated database

The command returns the token ID and the token string. This is the only time the token string is available in plain text.

InfluxDB might take some time to synchronize new tokens. If a new token doesn’t immediately work for querying or writing, wait a few seconds and try again.

Examples

• Create a token with read and write access to a database
• Create a token with read-only access to a database
• Create a token with read-only access to multiple databases
• Create a token with mixed permissions to multiple databases

In the examples below, replace the following:

• DATABASE_NAME: your InfluxDB Cloud Dedicated database
• DATABASE2_NAME: your InfluxDB Cloud Dedicated database

Create a token with read and write access to a database

influxctl token create \
  --read-database 
DATABASE_NAME
 \
  --write-database 
DATABASE_NAME
 \
  "Read/write token for 
DATABASE_NAME
"

Create a token with read-only access to a database

influxctl token create \
  --read-database 
DATABASE_NAME
 \
  "Read-only token for 
DATABASE_NAME
"

Create a token with read-only access to multiple databases

influxctl token create \
  --read-database 
DATABASE_NAME
 \
  --read-database 
DATABASE2_NAME
 \
  "Read-only token for 
DATABASE_NAME
 and 
DATABASE2_NAME
"

Create a token with mixed permissions to multiple databases

influxctl token create \
  --read-database 
DATABASE_NAME
 \
  --read-database 
DATABASE2_NAME
 \
  --write-database 
DATABASE2_NAME
 \
  "Read-only on 
DATABASE_NAME
, read/write on 
DATABASE2_NAME
"