[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThis guide details the process of listing objects within Google Distributed Cloud (GDC) air-gapped storage buckets.\u003c/p\u003e\n"],["\u003cp\u003eA project namespace is required for managing bucket resources, and proper bucket permissions are needed to list objects.\u003c/p\u003e\n"],["\u003cp\u003eYou can list objects via the console by navigating to the Object Storage section and selecting the specific bucket, or via the CLI using the \u003ccode\u003egdcloud storage ls\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eThe CLI allows you to list objects in the top level directory, as well as view all versions of objects, and list objects with a specified prefix.\u003c/p\u003e\n"]]],[],null,["# List storage objects in projects\n\nThis page shows you how to list objects within Google Distributed Cloud (GDC) air-gapped storage buckets.\n\nBefore you begin\n----------------\n\nA project namespace manages bucket resources in the Management API server. You\nmust have a [project](/distributed-cloud/hosted/docs/latest/gdch/platform/pa-user/project-management) to work with buckets and objects.\n\nYou must also have the appropriate bucket permissions to perform the following\noperation. See [Grant bucket access](/distributed-cloud/hosted/docs/latest/gdch/application/ao-user/grant-obtain-storage-access#grant_bucket_access).\n\nList objects in storage buckets\n-------------------------------\n\n### Console\n\n1. In the navigation menu, click **Object Storage**.\n2. Click the name of the bucket containing the objects.\n3. Wait to be redirected to the **Bucket details** page with objects listed in a table.\n4. Click on an object's name and select either the **Live Object** tab or **Version history** tab to view further details.\n\n### CLI\n\nList the objects in the top level directory of a bucket: \n\n gdcloud storage ls s3://\u003cvar translate=\"no\"\u003eFULLY_QUALIFIED_BUCKET_NAME\u003c/var\u003e\n\nList all versions of objects in the top level directory of a bucket: \n\n\n gdcloud storage ls --all-versions s3://\u003cvar translate=\"no\"\u003eFULLY_QUALIFIED_BUCKET_NAME\u003c/var\u003e\n\nList the objects in a bucket with a prefix: \n\n gdcloud storage ls s3://\u003cvar translate=\"no\"\u003eFULLY_QUALIFIED_BUCKET_NAME\u003c/var\u003e/\u003cPrefix\u003e/\n\nList all versions of objects in a bucket with a prefix: \n\n gdcloud storage ls --all-versions s3://\u003cvar translate=\"no\"\u003eFULLY_QUALIFIED_BUCKET_NAME\u003c/var\u003e/\u003cPrefix\u003e/"]]
