Skip to main content

signaloid-cli files ls

List files in storage.

Note: This command is an alias for signaloid-cli files list. Both command names work interchangeably.

Synopsis​

signaloid-cli files ls [options]
signaloid-cli files list [options]

Description​

List files and directories in your Signaloid cloud storage. Returns a JSON object whose Files array holds the path, size, etag, and last modification time of each entry.

Options​

OptionDescription
--path <path>Directory path to list (optional)
--start-key <token>Pagination cursor token
--count <n>Number of items to fetch using pagination
--format <type>Output format:json or table (default: json)
--columns <cols>Columns to display (comma-separated) or 'help' to see available columns. The CLI ignores --columns unless you also pass --format table, and ignores unknown column names without an error.

Examples​

List All Files​

signaloid-cli files ls

List Files in Specific Directory​

signaloid-cli files ls --path datasets/

Output​

{
  "Files": [
    {
      "path": "datasets/data.csv",
      "last_modified": 1736769600000,
      "size": 1024,
      "etag": "\"3c41b0823f05cf86da0d560b0e033c03\""
    },
    {
      "path": "datasets/results/",
      "last_modified": 1736771400000,
      "size": 0,
      "etag": "\"d41d8cd98f00b204e9800998ecf8427e\""
    }
  ]
}

Extract File Paths​

signaloid-cli files ls --path datasets/ | jq -r '.Files[].path'

Notes​

  • Results are returned in JSON format
  • Use jq for parsing and filtering output
  • Directory paths end with / and have a size of 0
  • The listing includes the contents of subdirectories and the entry of the listed directory itself
  • Use --start-key for paginating through large result sets

See Also​

Last updated on