ti fs enable-file-system-token

Re-enables a disabled file system token. The token can take approximately 10 seconds to become usable. With owner token authentication, only scoped tokens can be enabled; TiDB Cloud API keys can enable either token kind.

Syntax

ti fs enable-file-system-token
  --token-id <string>
  [--file-system-id <string>]
  [--fs-token <string>]
  [--dry-run]
  [--help]
  [--version]

Options

• --file-system-id <string>: Specify the file system that owns the token. Required when using TiDB Cloud API credentials; optional when an owner token supplies the ID.
• --token-id <string>: Specify the immutable token ID returned by the list command. This option is required.
• --fs-token <string>: Authorize the request with a file system owner token. If omitted, the command uses the TI_FS_TOKEN environment variable. If neither is provided, the command requires TiDB Cloud API credentials and --file-system-id. It does not automatically use a locally stored owner token.
• --dry-run: Validate the request without changing remote token state.
• --help: Display help information.
• --version: Display version information.

For options shared by all commands, see Global options.

Examples

• Enable a known token:

  # Allow about 10 seconds for all authentication caches to observe the change.
  ti fs enable-file-system-token \
    --file-system-id "<file-system-id>" \
    --token-id "<token-id>"
  

• Enable a scoped token by using an owner token:

  # The owner token identifies and authorizes token management for its file system.
  TI_FS_TOKEN="<owner-fs-token>" ti fs enable-file-system-token \
    --token-id "<scoped-token-id>"
  

Related documentation

• Token-management authorization
• ti fs list-file-system-tokens
• ti fs disable-file-system-token