Crea y administra carpetas

En esta página, se describe cómo crear y administrar carpetas en buckets con el espacio de nombres jerárquico habilitado. Específicamente, en esta página, se muestra cómo crear, enumerar y borrar tus carpetas, así como obtener los metadatos de una carpeta.

Para obtener más información sobre estas operaciones de carpetas, consulta Operaciones de carpetas.

Antes de comenzar

Para seguir estas instrucciones, tu bucket debe tener habilitado el espacio de nombres jerárquico. Si necesitas crear un bucket con esta función, consulta Crea buckets con espacio de nombres jerárquico habilitado.

Crear una carpeta

En esta sección, se describe cómo crear una carpeta nueva en tu bucket.

Console

  1. En la consola de Google Cloud , ve a la página Buckets de Cloud Storage.

    Ir a Buckets

  2. En la lista de buckets, haz clic en el nombre del bucket en el que deseas crear la carpeta.
  3. En la página Detalles del bucket, haz clic en Crear carpeta para crear una carpeta vacía.
  4. En el campo Nombre, escribe el nombre de tu carpeta. Para obtener consideraciones sobre los nombres, consulta Consideraciones.
  5. Haz clic en Crear.

    La carpeta que acabas de crear aparecerá en el panel Navegador de carpetas.

Línea de comandos

  1. En la consola de Google Cloud , activa Cloud Shell.

    Activa Cloud Shell

    En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

  2. En tu entorno de desarrollo, ejecuta el comando gcloud storage folders create:

    gcloud storage folders create --recursive gs://BUCKET_NAME/FOLDER_NAME

    Aquí:

    • BUCKET_NAME es el nombre de tu depósito. Por ejemplo, my-bucket.
    • FOLDER_NAME es el nombre de la carpeta que deseas crear. Por ejemplo, my-folder/ Para obtener información sobre los nombres de las carpetas, consulta la documentación de la descripción general de las carpetas.
    • --recursive es una marca que crea automáticamente todas las carpetas superiores que no existen junto con la carpeta. Este parámetro de configuración es opcional cuando ya existen carpetas superiores.

    Si la solicitud se realiza correctamente, el comando mostrará el siguiente mensaje:

    Completed 1/1

Bibliotecas cliente

C++

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

namespace storagecontrol = google::cloud::storagecontrol_v2;
[](storagecontrol::StorageControlClient client,
   std::string const& bucket_name, std::string const& folder_id) {
  auto const parent = std::string{"projects/_/buckets/"} + bucket_name;
  auto folder = client.CreateFolder(
      parent, google::storage::control::v2::Folder{}, folder_id);
  if (!folder) throw std::move(folder).status();

  std::cout << "Created folder: " << folder->name() << "\n";
}

C#

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

Para autenticarte en Cloud Storage, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

using Google.Cloud.Storage.Control.V2;
using System;

public class StorageControlCreateFolderSample
{
    public Folder StorageControlCreateFolder(string