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 appliance 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.
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
To list all the buckets that you have access to in a given object storage
tenant, complete the following steps:
[[["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-09-04 UTC."],[[["\u003cp\u003eThis guide outlines the process for listing Google Distributed Cloud (GDC) air-gapped appliance storage buckets within a project.\u003c/p\u003e\n"],["\u003cp\u003eA project namespace is required to manage bucket resources, and users must have appropriate permissions to work with buckets and objects.\u003c/p\u003e\n"],["\u003cp\u003eYou can list all accessible buckets within an object storage tenant using the \u003ccode\u003ekubectl get buckets --all-namespaces\u003c/code\u003e or \u003ccode\u003ekubectl get buckets --namespace NAMESPACE_NAME\u003c/code\u003e commands.\u003c/p\u003e\n"],["\u003cp\u003eTo view configuration details for a specific bucket, use either \u003ccode\u003ekubectl describe buckets/BUCKET_NAME --namespace NAMESPACE_NAME\u003c/code\u003e or \u003ccode\u003ekubectl get buckets/BUCKET_NAME --namespace NAMESPACE_NAME -o yaml\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# View and list storage bucket configurations\n\nThis page guides you through how to list storage buckets within a Google Distributed Cloud (GDC) air-gapped appliance 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.\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/appliance/platform/pa-user/create-a-project) to work\nwith 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/appliance/platform/pa-user/grant-obtain-storage-access#grant_bucket_access).\n\nList storage buckets\n--------------------\n\nTo list all the buckets that you have access to in a given object storage\ntenant, complete the following steps:\n\n1. Run the following commands to list all buckets:\n\n kubectl get buckets --all-namespaces\n kubectl get buckets --namespace \u003cvar translate=\"no\"\u003eNAMESPACE_NAME\u003c/var\u003e\n\n### View bucket configuration\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"]]
