signaloid-cli drives delete

Delete a virtual drive.

Synopsis

signaloid-cli drives delete --drive-id <id>

Description

Permanently deletes a virtual drive. This removes the drive configuration but does not delete the underlying data sources (buckets, gateways, or storage).

Options

Option	Description
`--drive-id <id>`	Drive ID to delete (required)

Output

Returns a confirmation message:

{
  "DriveID": "drive-abc123",
  "Status": "Deleted",
  "Message": "Drive deleted successfully"
}

Examples

Delete a Drive

signaloid-cli drives delete --drive-id drive-abc123

Exit Codes

Code	Description
`0`	Success
`1`	Failed to delete drive (drive not found, permission denied, API error)

Important Notes

What Gets Deleted

✅ Drive configuration
✅ Drive metadata
✅ Drive-resource associations

What Stays Intact

❌ Underlying buckets
❌ Gateway configurations
❌ Signaloid cloud storage
❌ Actual data in resources

Cannot Be Undone

Warning: This operation cannot be undone. Once a drive is deleted:

The drive ID becomes invalid
Associated tasks/builds may lose drive references
You must recreate the drive configuration if needed

Before Deletion Checklist

Backup Configuration: Save drive details for future reference
```
signaloid-cli drives get --drive-id $DRIVE_ID > backup.json
```

Check Dependencies: Ensure no active tasks/builds depend on this drive

# Check if drive is referenced in tasks
signaloid-cli tasks list --format json | \
  jq --arg drive "$DRIVE_ID" \
    '.Tasks[] | select(.DriveID == $drive)'

Verify Drive ID: Double-check you're deleting the correct drive

signaloid-cli drives get --drive-id $DRIVE_ID | jq '{DriveID, Name}'

Synopsis​

Description​

Options​

Output​

Examples​

Delete a Drive​

Exit Codes​

Important Notes​

What Gets Deleted​

What Stays Intact​

Cannot Be Undone​

Before Deletion Checklist​

See Also​