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 en buckets con el espacio de nombres jerárquico habilitado.

Descripción general

Cuando creas un bucket con el espacio de nombres jerárquico habilitado, el bucket usa una estructura de sistema de archivos real en lugar de un espacio de nombres plano estándar. Las carpetas existen como un recurso en los buckets con el espacio de nombres jerárquico habilitado. Con las carpetas, puedes organizar tus objetos de manera más eficaz y obtener acceso a verdaderas capacidades de directorio, como cambios de nombre de carpetas atómicos y operaciones de metadatos eficientes.

Puedes administrar carpetas con las operaciones create, delete, rename, list y get. Para obtener información sobre cómo realizar estas operaciones, consulta Crea y administra carpetas y Cambia el nombre de una carpeta.

Las carpetas en buckets con el espacio de nombres jerárquico habilitado son diferentes de las carpetas simuladas y las carpetas administradas. Las carpetas simuladas existen en los buckets con espacio de nombres plano, y las carpetas administradas se pueden aplicar tanto en los buckets con espacio de nombres plano como en los buckets con espacio de nombres jerárquico habilitado. Las carpetas administradas se usan principalmente para otorgar permisos de IAM a grupos de objetos. Para obtener más información sobre estos otros tipos de carpetas, consulta Tipos 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 JSON de Cloud Storage.

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: Es un identificador único de 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 principal 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 (con 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.

  • Información sensible o de identificación personal (PII): Los nombres de las carpetas son más visibles que los metadatos de las carpetas. Por ejemplo, los nombres de las carpetas aparecen en las URLs y cuando se enumeran carpetas u objetos en un bucket. No incluyas información sensible ni PII en los nombres de las carpetas.

  • Interacción con carpetas administradas: En los buckets con el espacio de nombres jerárquico habilitado, puedes administrar el control de acceso con carpetas administradas en conjunto con carpetas.

¿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 e implementar cargas de trabajo.

Probar Cloud Storage gratis