ti fs list-file-systems

Lists every Filesystem that the selected TiDB Cloud credentials can access in the effective region. Results include authoritative display metadata, quota and usage, and has_local_token, which indicates whether this machine has a matching data-plane token. Tokens are never returned.

Syntax

ti fs list-file-systems
  [--display-name <string>]
  [--help]
  [--label <string>]
  [--version]

Options

• --display-name <string>: Filter by a case-sensitive display-name substring. This is not an exact resource lookup.
• --help: Display help information.
• --label <string>: Filter by one exact key=value label.
• --version: Display version information.

For options shared by all commands, see Global options.

Examples

• List remotely managed Filesystems:

  # Return the remote inventory for the profile's region without exposing tokens.
  ti fs list-file-systems
  

• Filter Filesystems by display metadata:

  # Match a display-name substring and one exact organization-visible label.
  ti fs list-file-systems \
    --display-name workspace \
    --label environment=production
  

Related documentation

• TiDB Cloud Filesystem CLI Command Reference