cloud sources¶
NAME¶
phyware cloud sources — list and inspect registered data sources.
SYNOPSIS¶
DESCRIPTION¶
list¶
Returns all data sources registered for the active (or specified) tenant.
get¶
Returns the full descriptor for a single source, including its schema and ingestion statistics.
OPTIONS¶
| Flag | Type | Required | Default | Env |
|---|---|---|---|---|
--url | string | No | http://localhost:8000 | PHYCLOUD_URL |
--api-key | string | No | — | PHYCLOUD_API_KEY |
--output | enum | No | table | — |
| --tenant-id | string | No | (active) | — |
ARGUMENTS¶
| Name | Required | Description |
|---|---|---|
SOURCE_ID | Yes (get) | Unique source identifier |
INPUT¶
None.
OUTPUT¶
| Field | Type | Description |
|---|---|---|
id | string | Source identifier |
name | string | Human-readable name |
schema | object | JSON Schema for events |
event_count | int | Total events ingested |
EXIT CODES¶
| Code | Meaning |
|---|---|
0 | Success |
1 | Generic / connection error |
2 | Authentication / authorisation error |
3 | Resource not found |
4 | Validation error |
5 | Server-side error |
EXAMPLES¶
# List all sources
phyware cloud sources list
# List sources as JSON
phyware cloud sources list --output json
# Get a specific source
phyware cloud sources get src_xyz
# Get source as YAML
phyware cloud sources get src_xyz --output yaml
# List sources for a specific tenant
phyware cloud sources list --tenant-id ten_abc123
AGENT NOTES¶
Call sources list before events send to confirm the correct source_id. Use --output json and jq to extract source IDs programmatically. Requires read:sources scope.
SEE ALSO¶
ERRORS¶
| Code | Message | Remediation |
|---|---|---|
NOT_FOUND | Source not found | Check --source-id |
UNAUTHORIZED | Invalid API key | Run phyware auth login |