Stay organized with collections
Save and categorize content based on your preferences.
This page describes how to generate a list of
Google Distributed Cloud (GDC) air-gapped
storage buckets within a project and the display configuration details
for each bucket. All list and view operations on dual-zone buckets should be made against the global API.
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-25 UTC."],[[["\u003cp\u003eThis guide details how to list Google Distributed Cloud (GDC) air-gapped storage buckets within a specific project.\u003c/p\u003e\n"],["\u003cp\u003eAccess to a project is required to manage buckets and objects within the Management API server.\u003c/p\u003e\n"],["\u003cp\u003eYou can list all accessible buckets using the console's Object Storage menu or via the \u003ccode\u003ekubectl\u003c/code\u003e CLI commands.\u003c/p\u003e\n"],["\u003cp\u003eBucket configuration details can be viewed through the console by selecting a specific bucket or by using \u003ccode\u003ekubectl describe\u003c/code\u003e or \u003ccode\u003ekubectl get\u003c/code\u003e commands with the bucket's name and namespace.\u003c/p\u003e\n"],["\u003cp\u003eProper bucket permissions, as detailed in the "Grant bucket access" documentation, are needed to list and view the buckets.\u003c/p\u003e\n"]]],[],null,["# View and list storage bucket configurations\n\nThis page describes how to generate a list of\nGoogle Distributed Cloud (GDC) air-gapped\nstorage buckets within a project and the display configuration details\nfor each bucket. All list and view operations on dual-zone buckets should be made against the global API.\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 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"]]
