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.listen 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.createen 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,
object1enfolderAse transfiere al destino comofolderA/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 llamadafolderAy transfiereobject1a esa carpeta. - No se admite la eliminación de carpetas en el receptor.