Documentation

influxctl management create

The influxctl management create command creates a management token to be used with an InfluxDB cluster. Management tokens authorize a user to perform administrative tasks on the InfluxDB instance such as creating and deleting databases, managing users, and other administrative tasks.

Management tokens do not provide access to databases or data in databases. Only database tokens with “read” or “write” permissions can access data in databases.

The optional --expires-at flag defines the token expiration date and time. Provide an RFC3999 date string–for example: 2025-01-15T00:00:00Z. If not set, the token does not expire until revoked.

The --format flag lets you print the output in other formats. The json format is available for programmatic parsing by other tooling. Default: table.

Store secure tokens in a secret store

Management token strings are returned only on token creation. We recommend storing management tokens in a secure secret store.

Usage

influxctl management create [flags]

Flags

FlagDescription
--descriptionManagement token description
--expires-atToken expiration date
--formatOutput format (table (default) or json)
-h--helpOutput command help

Examples

Create a management token with no expiration

influxctl management create

Create a management token with an expiration and description

influxctl management create \
  --expires-at 
RFC3339_EXPIRATION
\
--description "
TOKEN_DESCRIPTION
"

Replace the following:

  • RFC3339_EXPIRATION: An RFC3339 date string to expire the token at–for example: 2025-01-15T00:00:00Z.
  • TOKEN_DESCRIPTION: Management token description.

Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

InfluxDB 3 Open Source Now in Public Alpha

InfluxDB 3 Open Source is now available for alpha testing, licensed under MIT or Apache 2 licensing.

We are releasing two products as part of the alpha.

InfluxDB 3 Core, is our new open source product. It is a recent-data engine for time series and event data. InfluxDB 3 Enterprise is a commercial version that builds on Core’s foundation, adding historical query capability, read replicas, high availability, scalability, and fine-grained security.

For more information on how to get started, check out: