Transférer des dossiers gérés Cloud Storage

Les dossiers gérés Cloud Storage permettent de contrôler de manière ultraprécise l'accès aux objets dans les buckets Cloud Storage. Les autorisations peuvent être définies au niveau d'un dossier dans les buckets qui utilisent l'accès uniforme au niveau du bucket. Lorsque vous transférez des objets entre des buckets Cloud Storage avec le service de transfert de stockage, ces autorisations de dossier géré peuvent être conservées.

Limites

Les limites suivantes s'appliquent aux transferts de dossiers gérés :

  • Les buckets source et de destination doivent tous deux utiliser l'accès uniforme au niveau du bucket.
  • Les transferts de dossiers gérés ne sont pas compatibles avec les options deleteObjectsUniqueInSink ou deleteObjectsFromSourceAfterTransfer.
  • Il ne doit y avoir aucune condition IAM sur le bucket de destination ou son projet qui utilise le type de ressource bucket (storage.googleapis.com/Bucket) ou le type de ressource objet (storage.googleapis.com/Object). Si un bucket d'un projet comporte une condition IAM qui utilise l'un de ces types de ressources, les dossiers gérés ne peuvent être transférés vers aucun des buckets de ce projet, même si la condition est supprimée ultérieurement.
  • Les transferts basés sur des événements ne sont pas acceptés.
  • Les transferts de fichiers manifestes ne sont pas acceptés.

Autorisations IAM

Les autorisations Google Cloud IAM (Identity and Access Management) suivantes sont requises par l'agent de service du service de transfert de stockage .

Pour la source et la destination, les autorisations peuvent être définies au niveau du bucket ou sur le dossier géré. Pour définir des autorisations sur un dossier géré de destination, ce dossier doit déjà exister.

Nous vous déconseillons de définir des autorisations de dossier géré au niveau du projet. Pour en savoir plus, consultez Considérations de sécurité.

Sur le bucket ou le dossier géré source :

  • storage.managedFolders.getIamPolicy
  • storage.managedFolders.list
  • storage.managedFolders.get

Sur le bucket ou le dossier géré de destination :

  • storage.managedFolders.setIamPolicy
  • storage.managedFolders.list
  • storage.managedFolders.create

Ces autorisations s'ajoutent aux autorisations standards requises par le service de transfert de stockage :

Pour accorder les autorisations requises pour les dossiers gérés, créez un rôle personnalisé ne disposant que des autorisations requises.

Créer un transfert de dossier géré

Pour créer un transfert contenant un dossier géré, spécifiez managedFolderTransferEnabled: true dans votre transferSpec. Vous pouvez éventuellement spécifier une valeur path pour ne transférer qu'un dossier géré spécifique.

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 les autorisations de transfert géré appropriées ne sont pas définies au niveau de la source et de la destination, le transfert échoue.

Pour en savoir plus sur la création d'un transfert à l'aide de l'API REST, consultez la page Créer des transferts ou la documentation de référence sur transferJobs.create.

Points à noter concernant la sécurité

En accordant des autorisations de dossier géré à un agent de service, vous permettez au compte de modifier les stratégies IAM sur les dossiers de destination, ou sur tous les dossiers si le rôle est accordé au niveau du projet. Cela pose un risque de sécurité : un utilisateur disposant d'autorisations de modification de job pourrait exploiter cette faille pour accorder des droits à une personne malveillante. Pour limiter ce risque, envisagez d'isoler les transferts de dossiers gérés dans un projet Google Cloud dédié.

Cloud Logging

Les actions effectuées sur les dossiers gérés sont consignées par Cloud Logging. Pour en savoir plus, consultez Cloud Logging pour le service de transfert de stockage.

Dépannage

Pour obtenir de l'aide sur la création et la gestion des dossiers gérés, consultez la page Dépannage.