Stay organized with collections
Save and categorize content based on your preferences.
This page guides you through how to list storage buckets within a Google Distributed Cloud (GDC) air-gapped project and view the configuration details for each bucket. Learn about the prerequisites and the steps using both the GDC console and command line interface (CLI). This information lets you gain full visibility of your object storage resources and helps you verify their configuration.
This page is for audiences such as IT admins within the infrastructure operator group or developers within the application operator group who are responsible for managing object storage resources in GDC air-gapped environments. For more information, see Audiences for GDC air-gapped documentation.
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 storage buckets
Console
In the navigation menu, click Object Storage. All buckets you have access to are listed in a table.
CLI
To list all the buckets that you have access to in a given object storage tenant, complete the following steps:
Run the following command to list all buckets:
kubectlgetbuckets--all-namespaces
Run the following command to list all buckets in a namespace:
kubectlgetbuckets--namespaceNAMESPACE_NAME
View bucket configurations
Console
In the navigation menu, click Object Storage.
Click the name of the bucket of which you want to view the details.
Wait to be redirected to a detailed view page.
CLI
Use either command to view the configuration details for a bucket:
[[["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 outlines the process for listing Google Distributed Cloud (GDC) air-gapped storage buckets within a project.\u003c/p\u003e\n"],["\u003cp\u003eYou'll need an existing project with appropriate bucket permissions to list and view buckets and objects.\u003c/p\u003e\n"],["\u003cp\u003eBuckets can be listed via the console's "Object Storage" section, or using \u003ccode\u003ekubectl\u003c/code\u003e commands through the CLI.\u003c/p\u003e\n"],["\u003cp\u003eConfiguration details for specific buckets can be viewed through the console by selecting the bucket, or via CLI using \u003ccode\u003ekubectl describe\u003c/code\u003e or \u003ccode\u003ekubectl get\u003c/code\u003e commands.\u003c/p\u003e\n"]]],[],null,["# List and view storage bucket configurations\n\nThis page guides you through how to list storage buckets within a Google Distributed Cloud (GDC) air-gapped project and view the configuration details for each bucket. Learn about the prerequisites and the steps using both the GDC console and command line interface (CLI). This information lets you gain full visibility of your object storage resources and helps you verify their configuration.\n\nThis page is for audiences such as IT admins within the infrastructure operator group or developers within the application operator group who are responsible for managing object storage resources in GDC air-gapped environments. For more information, see [Audiences for GDC air-gapped documentation](/distributed-cloud/hosted/docs/latest/gdch/resources/audiences).\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/platform/pa-user/grant-obtain-storage-access#grant_bucket_access).\n\nList storage buckets\n--------------------\n\n### Console\n\n1. In the navigation menu, click **Object Storage**. All buckets you have access to are listed in a table.\n\n### CLI\n\nTo list all the buckets that you have access to in a given object storage tenant, complete the following steps:\n\n- Run the following command to list all buckets:\n\n kubectl get buckets --all-namespaces\n\n- Run the following command to list all buckets in a namespace:\n\n kubectl get buckets --namespace \u003cvar translate=\"no\"\u003eNAMESPACE_NAME\u003c/var\u003e\n\nView bucket configurations\n--------------------------\n\n### Console\n\n1. In the navigation menu, click **Object Storage**.\n2. Click the name of the bucket of which you want to view the details.\n3. Wait to be redirected to a detailed view page.\n\n### CLI\n\nUse either command to view the configuration details for a bucket: \n\n kubectl describe buckets/\u003cvar translate=\"no\"\u003eBUCKET_NAME\u003c/var\u003e --namespace \u003cvar translate=\"no\"\u003eNAMESPACE_NAME\u003c/var\u003e\n\n kubectl get buckets/\u003cvar translate=\"no\"\u003eBUCKET_NAME\u003c/var\u003e --namespace \u003cvar translate=\"no\"\u003eNAMESPACE_NAME\u003c/var\u003e -o yaml"]]
