Trasferisci le cartelle gestite di Cloud Storage

Le cartelle gestite di Cloud Storage forniscono un controllo granulare dell'accesso agli oggetti nei bucket Cloud Storage. Le autorizzazioni possono essere impostate a livello di cartella all'interno dei bucket che utilizzano l'accesso uniforme a livello di bucket. Quando trasferisci oggetti tra bucket Cloud Storage con Storage Transfer Service, queste autorizzazioni per le cartelle gestite possono essere conservate.

Limitazioni

Ai trasferimenti di cartelle gestite si applicano le seguenti limitazioni:

  • Sia il bucket di origine che quello di destinazione devono utilizzare l'accesso uniforme a livello di bucket.
  • I trasferimenti di cartelle gestite non supportano le opzioni deleteObjectsUniqueInSink o deleteObjectsFromSourceAfterTransfer.
  • Non devono essere presenti condizioni IAM nel bucket di destinazione o nel relativo progetto che utilizzano il tipo di risorsa bucket (storage.googleapis.com/Bucket) o il tipo di risorsa oggetto (storage.googleapis.com/Object). Se un bucket all'interno di un progetto ha una condizione IAM che utilizza uno di questi tipi di risorse, le cartelle gestite non possono essere trasferite a nessuno dei bucket all'interno del progetto, anche se la condizione viene rimossa in un secondo momento.
  • I trasferimenti basati su eventi non sono supportati.
  • I trasferimenti di manifest non sono supportati.

Autorizzazioni IAM

Le seguenti autorizzazioni di Google Cloud Identity and Access Management (IAM) sono richieste dall'agente di servizio di Storage Transfer Service.

Sia per l'origine che per la destinazione, le autorizzazioni possono essere impostate a livello di bucket o sulla cartella gestita. Per impostare le autorizzazioni su una cartella gestita di destinazione, questa deve già esistere.

Sconsigliamo di impostare le autorizzazioni delle cartelle gestite a livello di progetto; per ulteriori informazioni, consulta Considerazioni sulla sicurezza.

Nel bucket o nella cartella gestita di origine:

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

Nel bucket o nella cartella gestita di destinazione:

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

Queste si aggiungono alle autorizzazioni standard richieste da Storage Transfer Service:

Per concedere le autorizzazioni necessarie per le cartelle gestite, crea un ruolo personalizzato solo con le autorizzazioni richieste.

Crea un trasferimento di cartelle gestite

Per creare un trasferimento contenente una cartella gestita, specifica managedFolderTransferEnabled: true in transferSpec. Se vuoi, puoi specificare un valore path per trasferire solo una cartella gestita specifica.

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"
}

Se non sono impostate le autorizzazioni di trasferimento gestito corrette nell'origine e nella destinazione, il trasferimento non va a buon fine.

Per informazioni dettagliate sulla creazione di un trasferimento utilizzando l'API REST, consulta Crea trasferimenti o fai riferimento alla documentazione di riferimento di transferJobs.create.

Considerazioni sulla sicurezza

La concessione delle autorizzazioni per le cartelle gestite a un agente di servizio consente all'account di modificare le policy IAM sulle cartelle di destinazione o su tutte le cartelle se il ruolo viene concesso a livello di progetto. Questo rappresenta un rischio per la sicurezza: un utente con autorizzazioni di modifica dei job potrebbe sfruttare questa situazione per concedere privilegi a un malintenzionato. Per mitigare questo rischio, valuta la possibilità di isolare i trasferimenti delle cartelle gestite all'interno di un progetto Google Cloud dedicato.

Cloud Logging

Le azioni sulle cartelle gestite vengono registrate da Cloud Logging. Per maggiori dettagli, consulta Cloud Logging per Storage Transfer Service.

Risoluzione dei problemi

Per assistenza sulla creazione e sulla gestione delle cartelle gestite, consulta la pagina Risoluzione dei problemi.