ls

List objects and prefixes or all buckets

Usage

Windows
Linux
macOS
Windows
./uplink.exe ls [sj://BUCKET[/PREFIX]] [flags]
Linux
uplink ls [sj://BUCKET[/PREFIX]] [flags]
macOS
uplink ls [sj://BUCKET[/PREFIX]] [flags]

Flags

Flag

Description

--access string

the serialized access, or name of the access to use

--encrypted

if true, show paths as base64-encoded encrypted paths

--help, -h

help for ls

--recursive

if true, list recursively

Examples

We consider the following object hierarchy throughout these examples:

We assume the cakes/very-secret-recipe.txt object has been uploaded using a different encryption key than the other objects in the project.

List buckets

Windows
Linux
macOS
Windows
./uplink.exe ls
Linux
uplink ls
macOS
uplink ls

List objects in bucket

Windows
Linux
macOS
Windows
./uplink.exe ls sj://images
Linux
uplink ls sj://images
macOS
uplink ls sj://images

List by prefix

Windows
Linux
macOS
Windows
./uplink.exe ls sj://images/cakes
Linux
uplink ls sj://images/cakes
macOS
uplink ls sj://images/cakes

List recursively

Windows
Linux
macOS
Windows
./uplink.exe ls --recursive
Linux
uplink ls --recursive
macOS
uplink ls --recursive

List encrypted paths of all objects in bucket

Windows
Linux
macOS
Windows
./uplink.exe ls sj://recipes --encrypted --recursive
Linux
uplink ls sj://recipes --encrypted
macOS
uplink ls sj://recipes --encrypted