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 LastModified time of each entry.

Options​

OptionDescription
--path <path>Directory path to list (optional)
--cursor <cursor>Resume a listing from the Cursor value of the previous output, with the same filters
--start-key <key>Deprecated, use --cursor. Takes the ContinuationKey of the previous output.
--count <n>Number of items to fetch, across pages. The output's Cursor resumes after the last one.
--limit <n>Items per request, at most 100 (default 100)
--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",
      "LastModified": 1736769600000,
      "Size": 1024,
      "ETag": "\"3c41b0823f05cf86da0d560b0e033c03\""
    },
    {
      "Path": "datasets/results/",
      "LastModified": 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
  • Without --count, the command fetches one page. See Pagination.

See Also​

Last updated on