Skip to main content

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​

OptionDescription
--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​

CodeDescription
0Success
1Failed 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​

  1. Backup Configuration: Save drive details for future reference

    signaloid-cli drives get --drive-id $DRIVE_ID > backup.json

  2. 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)'

  3. Verify Drive ID: Double-check you are deleting the correct drive

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

See Also​

Last updated on