influxdb3 create token --permission

The influxdb3 create token command with the --permission option creates a database token with fine-grained access permissions for specific resources in InfluxDB 3 Cloud.

Fine-grained access permissions let you specify the exact actions, such as read and write, that a token can perform on a specific resource, such as a database.

Usage

influxdb3 create token --permission <PERMISSION> --name <NAME> [OPTIONS]

Options

Permission format

The --permission option takes a value in the format RESOURCE_TYPE:RESOURCE_NAMES:ACTIONS.

• RESOURCE_TYPE: Use db for databases.
• RESOURCE_NAMES: A specific database name, a comma-separated list of names, or * to grant access to all databases.
• ACTIONS: A list of actions—read, write, or both.

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 access to multiple databases
• Create a token with access to all databases
• Create a token that expires in seven days

Create a token with read and write access to a database

influxdb3 create token \
  --permission "db:my_database:read,write" \
  --name "Read/write token for my_database"

Create a token with read-only access to a database

influxdb3 create token \
  --permission "db:my_database:read" \
  --name "Read-only token for my_database"

Create a token with access to multiple databases

influxdb3 create token \
  --permission "db:database1,database2:read,write" \
  --name "Multi-database token"

Create a token with access to all databases

influxdb3 create token \
  --permission "db:*:read,write" \
  --name "All databases token"

Create a token that expires in seven days

influxdb3 create token \
  --permission "db:my_database:read,write" \
  --name "Expiring token" \
  --expiry 7d