Información acerca de las carpetas en buckets con espacio de nombres jerárquico habilitado

En esta página, se proporciona información sobre las carpetas de los buckets con el espacio de nombres jerárquico habilitado.

Descripción general

Las carpetas existen como un recurso en buckets con el espacio de nombres jerárquico habilitado. Puedes organizar objetos dentro de carpetas en una estructura similar a un sistema de archivos. Cloud Storage proporciona APIs de administración de carpetas que permiten realizar operaciones como crear, borrar, cambiar el nombre de las carpetas, enumerarlas, además de recuperar metadatos de carpetas.

Metadatos de la carpeta

Los metadatos de una carpeta contienen información estructurada sobre ella. Para obtener información detallada sobre los metadatos de las carpetas, consulta el recurso Folder en la documentación de referencia de la API de Cloud Storage JSON.

Los componentes clave de los metadatos de una carpeta son los siguientes:

  • bucket: El nombre del bucket en el que reside la carpeta. Por ejemplo, my-bucket
  • id: Un identificador único para la carpeta dentro del bucket. Por ejemplo, hns-bucket/dir1/
  • kind: El tipo de recurso Para una carpeta, este valor siempre es storage#folder.
  • name: El nombre de la carpeta. Por ejemplo, dir1/
  • selfLink: Es una URL que hace referencia a la carpeta en la API de Cloud Storage.
  • timeCreated: La marca de tiempo en la que se creó la carpeta. Por ejemplo, 2023-05-05T16:32:08.878000+00:00
  • updated: la marca de tiempo cuando se actualizó el recurso por última vez. Por ejemplo, 2024-05-06T16:32:08.878000+00:00

Consideraciones

Cuando crees carpetas, ten en cuenta lo siguiente:

  • Nombres de objetos y carpetas: los buckets con espacio de nombres jerárquico habilitado admiten todos los nombres de objetos válidos, lo que incluye los que tienen barras iniciales finales (/) o barras consecutivas. Cada barra diagonal (/) en el nombre de un objeto representa una carpeta. En la siguiente tabla, se muestran ejemplos de la relación entre los nombres de objetos y su ubicación correspondiente en la jerarquía de carpetas:

    Nombre del objeto Ubicación en la jerarquía de carpetas
    foo.txt Cada bucket incluye una carpeta raíz. El objeto foo.txt reside en la carpeta raíz del bucket.
    dir1/foo.txt El objeto foo.txt reside dentro de una carpeta de nivel superior llamada dir1/. La carpeta de nivel superior es distinta de la carpeta raíz.
    dir1/ La barra final en los nombres de objetos como dir1/ indica que el objeto reside dentro de la carpeta. En este ejemplo, el nombre del objeto dir1/ es el mismo que el nombre de la carpeta superior dir1/.
    dir1//foo.txt El objeto foo.txt reside en una carpeta de segundo nivel llamada dir1//, que es una carpeta secundaria de dir1/.

  • Profundidad máxima de las carpetas: Los buckets con espacio de nombres jerárquico habilitado admiten una profundidad máxima de carpetas de 50. Como resultado, los nombres de objetos no pueden tener más de 50 barras (/).

  • Tamaño máximo del nombre de la carpeta: 512 bytes (codificación UTF-8)

  • Creación automática de carpetas: Cuando creas un objeto nuevo, se crean automáticamente todas las carpetas inexistentes especificadas en la ruta de acceso del objeto. Por ejemplo: Cuando creas un objeto llamado dir1/foo.txt, se crea automáticamente la carpeta dir1/ si aún no existe.

¿Qué sigue?

Pruébalo tú mismo

Si es la primera vez que usas Google Cloud, crea una cuenta para evaluar el rendimiento de Cloud Storage en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

Probar Cloud Storage gratis