View and list storage bucket configurations

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.

Required IAM roles

Contact your IAM Project Admin to request the following roles in your project namespace:

  • Project Bucket Admin (project-bucket-admin): create, update, and delete storage buckets.
  • Project Bucket Object Viewer (project-bucket-object-viewer): view and check details of storage buckets and objects.

For more information, see Grant bucket access.

Prepare your environment

To run commands against the management API server or the global API server, do the following:

  1. Sign in and generate the kubeconfig file for the zonal management API server if you don't have one.
  2. For dual-zone buckets, do the following:
    • Verify with your Infrastructure Operator (IO) that the BucketLocationConfig custom resource has been created for your paired zones.
    • Generate the kubeconfig file for the global API server.

List storage buckets

Console

  1. In the navigation menu, click Object Storage. All buckets you have access to are listed in a table.

kubectl

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:

    kubectl get buckets --all-namespaces

  • Run the following command to list all buckets in a namespace:

    kubectl get buckets --namespace NAMESPACE_NAME

View bucket configurations

Console

  1. In the navigation menu, click Object Storage.
  2. Click the name of the bucket of which you want to view the details.
  3. Wait to be redirected to a detailed view page.

kubectl

Use either command to view the configuration details for a bucket:

kubectl describe buckets/BUCKET_NAME --namespace NAMESPACE_NAME

kubectl get buckets/BUCKET_NAME --namespace NAMESPACE_NAME -o yaml