ti fs move-file

Moves or renames a remote path. The command alias is ti fs mv.

Syntax

ti fs move-file
  --from-remote <string>
  --to-remote <string>
  [--dry-run]
  [--file-system-id <string>]
  [--fs-token <string>]
  [--help]
  [--overwrite]
  [--version]

Options

• --from-remote <string>: Source file path. [required]
• --to-remote <string>: Destination file path. [required]
• --dry-run: Validate the request without applying changes.
• --file-system-id <string>: Select the file system. You can also set TI_FS_FILE_SYSTEM_ID.
• --fs-token <string>: Set the file system user token. If omitted, uses TI_FS_TOKEN.
• --help: Display help information.
• --overwrite: Replace an existing destination file.
• --version: Display version information.

For options shared by all commands, see Global options.

Examples

• Move a remote file:

  # Rename or relocate an object entirely within the selected Filesystem.
  ti fs move-file --file-system-id <file-system-id> --from-remote /draft.md --to-remote /reports/final.md
  

Related documentation

• TiDB Cloud Filesystem CLI Command Reference