signaloid-cli drives
Manage virtual drives for data source integration.
Synopsis
signaloid-cli drives <command> [options]
Description
The drives command group allows you to manage virtual drives that connect data sources to your Signaloid applications. Drives provide a unified interface for accessing data from:
- Buckets - Cloud storage buckets (S3, etc.)
- Signaloid Cloud Storage - Native Signaloid storage
Commands
- list - List all drives
- get - Get details of a specific drive
- create - Create a new drive
- update - Update drive configuration
- delete - Delete a drive
Data Sources
A drive can contain multiple data sources. Each data source specifies:
- ResourceID - Identifier of the resource (bucket ID, or the Signaloid Cloud Storage path)
- ResourceType - Type of resource:
BucketorSignaloidCloudStorage - Location - Mount path of the resource relative to the drive's mount point (e.g.,
data/inputs). If the drive is mounted atmyDrive, the task sees this resource atmyDrive/data/inputs. Absolute paths are not allowed.
Data Source JSON Format
{
"ResourceID": "bucket-abc123",
"ResourceType": "Bucket",
"Location": "datasets/"
}
Common Use Cases
Multiple Data Sources
Create a drive with multiple data sources:
# Create datasources.json
cat > datasources.json <<EOF
[
{
"ResourceID": "bucket-inputs",
"ResourceType": "Bucket",
"Location": "inputs/"
},
{
"ResourceID": "bucket-sensors",
"ResourceType": "Bucket",
"Location": "sensor-data/"
}
]
EOF
signaloid-cli drives create \
--name "Multi-Source Drive" \
--ds-file datasources.json
Output Formats
Table Output
signaloid-cli drives list --format table
Shows drives in a formatted table with columns like:
- Drive ID
- Name
- Data Sources
- Created Date
JSON Output
signaloid-cli drives list --format json
Returns raw JSON for scripting and automation.
Column Customization
List available columns:
signaloid-cli drives list --columns help
Select specific columns:
signaloid-cli drives list --format table --columns DriveID,Name,CreatedAt
Pagination
drives list reads 25 drives per page by default. See drives list and Pagination.
Exit Codes
| Code | Description |
|---|---|
0 | Success |
1 | Error (invalid parameters, drive not found, API error) |
See Also
- signaloid-cli buckets - Manage storage buckets
- signaloid-cli files - File operations