website logo
Create accountLogin
Home
DCS
Node
Resources
Help center
Navigate through spaces
Home
DCS
Node
Resources
Help center
⌘K
Storj DCS
Get Started
AWS CLI and Hosted Gateway MT
AWS SDK and Hosted Gateway MT
Uplink CLI
Satellite Admin Console
Object Browser
Downloads
Download Uplink CLI
Download Self-hosted S3 Compatible Gateway
Download Storj Client Libraries
SDKs & Reference
Tutorial
How-to Guides
Concepts
Support
Support Overview
FAQ
Community Forum
Status Page
Help Desk
Billing, Payment & Accounts
Resources
Moved Documents
Docs powered by archbee 
21min

ls

List objects and prefixes or all buckets

Usage

Windows
Linux
MacOS
|

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
--expanded, -x
Use expanded output, showing object expiration times and whether there is custom metadata attached
--help, -h
help for ls
--pending
if true, list incomplete objects instead
--recursive, -r
if true, list recursively

Examples

We consider the following object hierarchy throughout these examples:

Document image

We assume the object has been uploaded using a different encryption key than the other objects in the project.

List buckets

Windows
Linux
MacOS
|
Document image

List objects in a bucket

Windows
Linux
MacOS
|
Document image

List by prefix

Windows
Linux
MacOS
|
Document image

List recursively

Windows
Linux
MacOS
|
Document image

List encrypted paths of all objects in a bucket

Windows
Linux
MacOS
|
Document image

Notice that since sj://recipes/cakes/very-secret-recipe.txt was encrypted with a different key, we cannot view it using regular ls and the default access, but with --encrypted we can see that it is indeed stored in sj://recipes

Updated 01 Sep 2022
Did this page help you?
Yes
No
UP NEXT
mb
Docs powered by archbee 
TABLE OF CONTENTS
Usage
Flags
Examples
List buckets
List objects in a bucket
List by prefix
List recursively
List encrypted paths of all objects in a bucket