List storage objects

This page shows you how to list objects within Google Distributed Cloud (GDC) air-gapped 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

Console

  1. In the navigation menu, click Object Storage.
  2. Click the name of the bucket containing the objects.
  3. Wait to be redirected to the Bucket details page with objects listed in a table.
  4. Click on an object's name and select either the Live Object tab or Version history tab to view further details.

CLI

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>/