List storage objects

This page shows you how to list objects within Google Distributed Cloud (GDC) air-gapped appliance storage buckets.

Before you begin

A project namespace manages bucket resources in the Management API server. You must have a project to work with buckets and objects.

You must also have the appropriate bucket permissions to perform the following operation. See Grant bucket access.

List objects in storage buckets

List the objects in the top level directory of a bucket:

gdcloud storage ls s3://FULLY_QUALIFIED_BUCKET_NAME

List all versions of objects in the top level directory of a bucket:


gdcloud storage ls --all-versions s3://FULLY_QUALIFIED_BUCKET_NAME

List the objects in a bucket with a prefix:

gdcloud storage ls s3://FULLY_QUALIFIED_BUCKET_NAME/<Prefix>/

List all versions of objects in a bucket with a prefix:

gdcloud storage ls --all-versions s3://FULLY_QUALIFIED_BUCKET_NAME/<Prefix>/