Skip to main content

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: Bucket or SignaloidCloudStorage
  • Location - Mount path of the resource relative to the drive's mount point (e.g., data/inputs). If the drive is mounted at myDrive, the task sees this resource at myDrive/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​

CodeDescription
0Success
1Error (invalid parameters, drive not found, API error)

See Also​