Enumera depósitos

En esta página, se muestra cómo realizar una lista de los depósitos de Cloud Storage de un proyecto, que están ordenados en la lista de forma lexicográfica por nombre. Para obtener una descripción general de los depósitos, consulta los términos clave.

Para enumerar los depósitos de un proyecto, haz lo siguiente:

Console

Abre el navegador de Cloud Storage en Google Cloud Console.
Abrir el navegador de Cloud Storage

Los depósitos que forman parte del proyecto que se encuentra seleccionado aparecen en la lista del navegador.

gsutil

Usa el comando gsutil ls:

gsutil ls

La respuesta se ve como el siguiente ejemplo:

gs://[BUCKET_NAME1]/
gs://[BUCKET_NAME2]/
gs://[BUCKET_NAME3]/
...

Ejemplos de código

C++

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C++.

namespace gcs = google::cloud::storage;
using ::google::cloud::StatusOr;
[](gcs::Client client) {
  int count = 0;
  gcs::ListBucketsReader bucket_list = client.ListBuckets();
  for (auto&& bucket_metadata : bucket_list) {
    if (!bucket_metadata) {
      throw std::runtime_error(bucket_metadata.status().message());
    }

    std::cout << bucket_metadata->name() << "\n";
    ++count;
  }

  if (count == 0) {
    std::cout << "No buckets in default project\n";
  }
}

C#

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para C#.

private void ListBuckets()
{
    var storage = StorageClient.Create();
    foreach (var bucket in storage.ListBuckets(s_projectId))
    {
        Console.WriteLine(bucket.Name);
    }
}

Go

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Go.

var buckets []string
it := client.Buckets(ctx, projectID)
for {
	battrs, err := it.Next()
	if err == iterator.Done {
		break
	}
	if err != nil {
		return nil, err
	}
	buckets = append(buckets, battrs.Name)
}

Java

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Java.

// Include a prefix of bucket-name to reduce search space.
// For more information read https://cloud.google.com/storage/docs/json_api/v1/buckets/list
Page<Bucket> buckets =
    storage.list(BucketListOption.pageSize(100), BucketListOption.prefix(prefix));
for (Bucket bucket : buckets.iterateAll()) {
  // do something with the bucket
}

Node.js

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Node.js.

// Imports the Google Cloud client library
const {Storage} = require('@google-cloud/storage');

// Creates a client
const storage = new Storage();

// Lists all buckets in the current project
const [buckets] = await storage.getBuckets();
console.log('Buckets:');
buckets.forEach(bucket => {
  console.log(bucket.name);
});

PHP

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para PHP.

use Google\Cloud\Storage\StorageClient;

/**
 * List all Cloud Storage buckets for the current project.
 *
 * @return void
 */
function list_buckets()
{
    $storage = new StorageClient();
    foreach ($storage->buckets() as $bucket) {
        printf('Bucket: %s' . PHP_EOL, $bucket->name());
    }
}

Python

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Python.

def list_buckets():
    """Lists all buckets."""
    storage_client = storage.Client()
    buckets = storage_client.list_buckets()

    for bucket in buckets:
        print(bucket.name)

Ruby

Si deseas obtener más información, consulta la documentación de referencia de la API de Cloud Storage para Ruby.

# project_id = "Your Google Cloud project ID"

require "google/cloud/storage"

storage = Google::Cloud::Storage.new project_id: project_id

storage.buckets.each do |bucket|
  puts bucket.name
end

API de REST

API de JSON

  1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.
  2. Usa cURL para llamar a la API de JSON con una solicitud de servicio GET:

    curl -X GET -H "Authorization: Bearer [OAUTH2_TOKEN]" \
      "https://storage.googleapis.com/storage/v1/b?project=[PROJECT_NAME]"

    Donde:

    • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
    • [PROJECT_NAME] es el nombre del proyecto que contiene los depósitos que deseas enumerar. Por ejemplo, my-project.

    Puedes usar un parámetro de string de consulta prefix=[PREFIX] para limitar los resultados a los depósitos que tienen el prefijo especificado.

API de XML

  1. Obtén un token de autorización de acceso de OAuth 2.0 Playground. Configura Playground para usar tus propias credenciales de OAuth.
  2. Usa cURL para llamar a la API de XML con una solicitud de servicio GET:

    curl -X GET -H "Authorization: Bearer [OAUTH2_TOKEN]" \
      -H "x-goog-project-id: [PROJECT_NAME]" \
      "https://storage.googleapis.com"

    Donde:

    • [OAUTH2_TOKEN] es el token de acceso que generaste en el paso 1.
    • [PROJECT_NAME] es el nombre del proyecto que contiene los depósitos que deseas enumerar. Por ejemplo, my-project.

    Puedes usar un parámetro de string de consulta prefix=[PREFIX] para limitar los resultados a los depósitos que tienen el prefijo especificado.

Próximos pasos