Cómo transferir buckets con espacios de nombres jerárquicos de Cloud Storage

El espacio de nombres jerárquico de Cloud Storage almacena datos en una estructura lógica de sistema de archivos, con carpetas para organizar los objetos. Para obtener más información, consulta Espacio de nombres jerárquico.

El Servicio de transferencia de almacenamiento puede transferir datos hacia y desde buckets de Cloud Storage que usan un espacio de nombres jerárquico. Para transferir correctamente las carpetas y los metadatos de las carpetas, se deben otorgar permisos adicionales al agente de servicio del Servicio de transferencia de almacenamiento.

Permisos necesarios

Además de los permisos estándar necesarios para una transferencia, se deben otorgar los siguientes permisos de IAM al agente de servicio del Servicio de transferencia de almacenamiento.

Cuando la fuente es un bucket con espacio de nombres jerárquico, se aplica lo siguiente:

  • storage.folders.list en el bucket de origen. Este permiso se incluye en el rol de visualizador de objetos de Storage (roles/storage.objectViewer) que se requiere en el bucket de origen. No se requiere ningún rol adicional.

Cuando el destino es un bucket con espacio de nombres jerárquico, se aplica lo siguiente:

  • storage.folders.create en el bucket de destino. Este permiso se incluye en el rol de Usuario de objetos de almacenamiento (roles/storage.objectUser) que se requiere en el bucket de destino. No se requiere ningún rol adicional.

Para obtener instrucciones sobre cómo agregar roles al agente de servicio, consulta los siguientes vínculos:

Comportamiento de transferencia

Cuando se transfieren datos entre dos buckets con espacios de nombres jerárquicos, se aplica lo siguiente:

  • Se transfieren los objetos y sus metadatos.
  • Se transfieren las carpetas y sus metadatos.
  • No se admite la eliminación de carpetas en el origen o el receptor.

Cuando transfieres de un bucket con espacio de nombres jerárquico a un bucket con espacio de nombres plano, ocurre lo siguiente:

  • Se transfieren los objetos y sus metadatos.
  • Las carpetas se transfieren como prefijos de objetos. Por ejemplo, object1 en folderA se transfiere al destino como folderA/object1.
  • No se transfieren los metadatos de las carpetas.
  • No se admite la eliminación de carpetas en la fuente.

Cuando transfieres de un bucket con espacio de nombres plano a un bucket con espacio de nombres jerárquico, ten en cuenta lo siguiente:

  • Se transfieren los objetos y sus metadatos.
  • Los prefijos de objeto se usan para crear las carpetas que falten. Por ejemplo, cuando transfiere folderA/object1, el Servicio de transferencia de almacenamiento crea una carpeta nueva llamada folderA y transfiere object1 a esa carpeta.
  • No se admite la eliminación de carpetas en el receptor.