ti fs delete-layer

Logically abandons a layer. The command does not physically erase layer history and never enables cascade implicitly.

Syntax

ti fs delete-layer
  --layer-ref <string>
  [--cascade]
  [--dry-run]
  [--file-system-id <string>]
  [--fs-token <string>]
  [--help]
  [--version]

Options

• --layer-ref <string>: Layer ID, unique name, or supported tag reference. [required]
• --cascade: Abandon live descendants before abandoning the selected layer.
• --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.
• --version: Display version information.

For options shared by all commands, see Global options.

Examples

• Abandon a rejected leaf timeline:

  # Deletion fails when the selected layer still has live descendants.
  ti fs delete-layer --file-system-id <file-system-id> --layer-ref experiment-a
  

• Abandon a test-owned subtree:

  # Cascade is explicit and abandons descendants before the selected layer.
  ti fs delete-layer --file-system-id <file-system-id> --layer-ref experiment-root --cascade
  

Related documentation

• TiDB Cloud Filesystem CLI Command Reference
• ti fs list-layer-chain