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.)
• Gateways - IoT device gateways
• 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, gateway ID, etc.)
• ResourceType - Type of resource: Gateway, Bucket, or SignaloidCloudStorage
• Location - Path within the resource (e.g., /data/inputs/)

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": "gateway-sensors",
    "ResourceType": "Gateway",
    "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

To page through the drive list:

# Get the first page of drives
signaloid-cli drives list

# Get next page
signaloid-cli drives list --start-key <continuation-key>

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