Las carpetas administradas de Cloud Storage proporcionan un control de acceso detallado a los objetos en los buckets de Cloud Storage. Los permisos se pueden establecer a nivel de carpeta dentro de los buckets que usan el acceso uniforme a nivel de bucket. Cuando se transfieren objetos entre buckets de Cloud Storage con el Servicio de transferencia de almacenamiento, se pueden conservar estos permisos de carpetas administradas.
Limitaciones
Se aplican las siguientes limitaciones a las transferencias de carpetas administradas:
- Tanto el buckets de origen como el de destino deben usar el acceso uniforme a nivel de bucket.
- Las transferencias de carpetas administradas no admiten las opciones
deleteObjectsUniqueInSinknideleteObjectsFromSourceAfterTransfer. - No debe haber condiciones de IAM en el
bucket de destino ni en su proyecto que
usen el tipo de recurso bucket (
storage.googleapis.com/Bucket) o el tipo de recurso objeto (storage.googleapis.com/Object). Si algún bucket dentro de un proyecto tiene una condición de IAM que usa cualquiera de estos tipos de recursos, las carpetas administradas no se pueden transferir a ninguno de los buckets dentro de ese proyecto, incluso si la condición se quita más adelante. - No se admiten las transferencias controladas por eventos.
- No se admiten las transferencias de manifiestos.
Permisos de IAM
El agente de servicio del Servicio de transferencia de almacenamiento requiere los siguientes permisos de Identity and Access Management (IAM) de Google Cloud .
Tanto para el origen como para el destino, los permisos se pueden establecer a nivel del bucket o se pueden establecer en la carpeta administrada. Para establecer permisos en una carpeta administrada de destino, esa carpeta ya debe existir.
No recomendamos establecer permisos de carpetas administradas a nivel de proyecto. Consulta Consideraciones de seguridad para obtener más información.
En el bucket o la carpeta administrada de origen, haz lo siguiente:
storage.managedFolders.getIamPolicystorage.managedFolders.liststorage.managedFolders.get
En el bucket o la carpeta administrada de destino, haz lo siguiente:
storage.managedFolders.setIamPolicystorage.managedFolders.liststorage.managedFolders.create
Estos se suman a los permisos estándar que requiere el Servicio de transferencia de almacenamiento:
Para otorgar los permisos de carpeta administrada necesarios, crea un rol personalizado solo con los permisos necesarios.
Crea una transferencia de carpetas administradas
Para crear una transferencia que contenga una carpeta administrada, especifica
managedFolderTransferEnabled: true en tu transferSpec. De manera opcional, puedes
especificar un valor path para transferir solo una carpeta administrada específica.
POST https://storagetransfer./v1/transferJobs { "name": "transferJobs/NAME", "projectId": "PROJECT_ID", "transferSpec": { "gcsDataSource": { "bucketName": "SOURCE_BUCKET", "path": "SOURCE_PATH", "managedFolderTransferEnabled": true }, "gcsDataSink": { "bucketName": "DESTINATION_BUCKET", "path": "DESTINATION_PATH" } }, "status": "ENABLED" }
Si no se configuran los permisos de transferencia administrada correctos en el origen y el destino, la transferencia fallará.
Consulta Crea transferencias
para obtener detalles sobre cómo crear una transferencia con la API de REST o consulta la
referencia de transferJobs.create.
Consideraciones de seguridad
Otorgar permisos de carpeta administrada a un agente de servicio permite que la cuenta modifique las políticas de IAM en las carpetas de destino o en todas las carpetas si el rol se otorga a nivel del proyecto. Esto representa un riesgo de seguridad: un usuario con permisos de edición de trabajos podría aprovecharlo para otorgar privilegios a un agente malicioso. Para mitigar este riesgo, considera aislar las transferencias de carpetas administradas dentro de un proyecto de Google Cloud dedicado.
Cloud Logging
Cloud Logging registra las acciones de las carpetas administradas. Consulta Cloud Logging para el Servicio de transferencia de almacenamiento para obtener más detalles.
Soluciona problemas
Si deseas obtener ayuda para crear y administrar carpetas administradas, consulta la página de solución de problemas.