Skip to main content
Manage storage volumes with the tp storage command group.

​
Commands

  • tp storage create - Create a new storage volume
  • tp storage list (ls) - List storage volumes
  • tp storage info - Get detailed information about a storage volume
  • tp storage edit - Edit storage volume properties
  • tp storage destroy (rm) - Delete a storage volume
To attach or detach storage volumes from clusters, use tp cluster attach and tp cluster detach. See Cluster Commands.

​
tp storage create

Create a new storage volume. 
tp storage create <size> [--name NAME] [--deletion-protection] [--wait]
Arguments:
  • size - Size of the volume in GB (required, positional)
  • --name NAME - Custom volume name (optional)
  • --deletion-protection - Enable deletion protection (optional)
  • --wait - Wait for the storage volume to be fully created (optional)
Examples: 
# Create a 500GB storage volume with a custom name
tp storage create 500 --name training-data

# Create a volume with deletion protection and wait for it to be ready
tp storage create 1000 --name important-data --deletion-protection --wait

​
tp storage list

List your storage volumes. Alias: tp storage ls. 
tp storage list [--org]
Arguments:
  • --org, --organization - List all volumes in your organization (optional)
Examples: 
# List your volumes
tp storage list

# List all organization volumes
tp storage ls --org

​
tp storage info

Get detailed information about a storage volume. 
tp storage info <storage_id>
Arguments:
  • storage_id - The ID of the storage volume to inspect
Example: 
tp storage info s-abc123

​
tp storage edit

Edit storage volume properties. 
tp storage edit <storage_id> [options]
Arguments:
  • storage_id - The ID of the storage volume to edit
Optional Arguments:
  • --name NAME - New name for the storage volume
  • --deletion-protection DELETION_PROTECTION - Enable/disable deletion protection (true/false)
  • -s, --size SIZE - New size for the storage volume in GB (size can only be increased)
Examples: 
tp storage edit s-abc123 --name "new-volume-name"
tp storage edit s-abc123 --deletion-protection true
tp storage edit s-abc123 -s 2000

​
tp storage destroy

Delete a storage volume permanently. Alias: tp storage rm. 
tp storage destroy <storage_id> [--no-input] [--wait]
Arguments:
  • storage_id - ID of the storage volume to destroy
  • --no-input - Skip confirmation prompts and destroy immediately (optional)
  • --wait - Wait for the storage volume to be fully destroyed (optional)
Examples: 
# Destroy a storage volume (will prompt for confirmation)
tp storage destroy s-abc123

# Destroy without confirmation prompt
tp storage rm s-abc123 --no-input

# Destroy and wait for completion
tp storage destroy s-abc123 --wait
This action is irreversible. Back up important data before destroying a volume.

​
Workflow Example

# 1. Create a 1TB storage volume
tp storage create 1000 --name shared-datasets --wait

# 2. Attach to a cluster (see tp cluster attach)
tp cluster attach c-xyz789 s-abc123

# 3. Detach from the cluster (see tp cluster detach)
tp cluster detach c-xyz789 s-abc123

# 4. Destroy when done
tp storage destroy s-abc123

​
Next Steps