Questa pagina descrive come spostare i contenuti di un bucket copiando gli oggetti da un bucket di origine a un bucket di destinazione.
Panoramica
Quando crei un bucket, alcune delle proprietà che imposti sono permanenti e non possono essere modificate, inclusi il nome del bucket e il progetto padre.
Se vuoi utilizzare un nuovo nome per il bucket, puoi farlo effettivamente creando un nuovo bucket con il nome che vuoi utilizzare e poi copiando i tuoi oggetti dal vecchio bucket al nuovo bucket. A questo punto puoi eliminare il vecchio bucket. Tieni presente quanto segue:
Quando elimini un bucket, il nome del bucket può essere riutilizzato.
Se il tuo obiettivo principale di spostare gli oggetti da un bucket all'altro è archiviare i dati in una località del bucket diversa, ti consigliamo di trasferire direttamente il bucket.
Lo spostamento dei dati tra le località comporta costi di utilizzo della rete. Inoltre, lo spostamento dei dati potrebbe comportare costi aggiuntivi, a seconda delle classi di archiviazione dei dati di origine e della località del bucket di destinazione. Per maggiori informazioni, consulta Prezzi di Cloud Storage.
Autorizzazioni obbligatorie
Console
Per completare questa guida utilizzando la Google Cloud console, devi disporre delle autorizzazioni IAM appropriate. Se i bucket a cui vuoi accedere esistono in un progetto che non hai creato, potresti aver bisogno che il proprietario del progetto ti assegni un ruolo che contenga le autorizzazioni necessarie.
Per un elenco delle autorizzazioni richieste per azioni specifiche, consulta Autorizzazioni IAM per la Google Cloud console.
Per un elenco dei ruoli pertinenti, consulta Ruoli di Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.
Riga di comando
Per completare questa guida utilizzando un'utilità della riga di comando, devi disporre delle autorizzazioni IAM appropriate. Se i bucket a cui vuoi accedere esistono in un progetto che non hai creato, potresti aver bisogno che il proprietario del progetto ti assegni un ruolo che contenga le autorizzazioni necessarie.
Per un elenco delle autorizzazioni richieste per azioni specifiche, consulta
Autorizzazioni
IAM per i comandigcloud storage.
Per un elenco dei ruoli pertinenti, consulta Ruoli di Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.
API REST
API JSON
Per completare questa guida utilizzando l'API JSON, devi disporre delle autorizzazioni IAM appropriate. Se i bucket a cui vuoi accedere esistono in un progetto che non hai creato, potresti aver bisogno che il proprietario del progetto ti assegni un ruolo che contenga le autorizzazioni necessarie.
Per un elenco delle autorizzazioni richieste per azioni specifiche, consulta Autorizzazioni IAM per i metodi JSON.
Per un elenco dei ruoli pertinenti, consulta Ruoli di Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.
Spostare i dati da un bucket all'altro
Console
Utilizza il Storage Transfer Service dalla Google Cloud console:
- Se non hai ancora un bucket di destinazione, crealo.
Apri la pagina Trasferimento nella Google Cloud console.
- Fai clic su Crea job di trasferimento.
Segui la procedura dettagliata passo passo e fai clic su Passaggio successivo al termine di ogni passaggio:
Scegli un'origine: utilizza Bucket Google Cloud Storage come tipo di origine e inserisci direttamente il nome del bucket desiderato oppure fai clic su Sfoglia per trovare e selezionare il bucket che vuoi.
Scegli una destinazione: inserisci direttamente il nome del bucket desiderato oppure fai clic su Sfoglia per trovare e selezionare il bucket che vuoi.
Scegli le impostazioni: seleziona l'opzione Elimina i file dall'origine dopo il trasferimento.
Opzioni di pianificazione: puoi ignorare questa sezione.
Al termine della procedura dettagliata passo passo, fai clic su Crea.
Viene avviato il processo di copia degli oggetti dal vecchio bucket a quello nuovo. Questo processo potrebbe richiedere del tempo. Tuttavia, dopo aver fatto clic su Crea, puoi uscire dalla Google Cloud console.
Per visualizzare l'avanzamento del trasferimento:
Apri la pagina Trasferimento nella Google Cloud console.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella Google Cloud console, consulta Risoluzione dei problemi.
Al termine del trasferimento, non devi fare nulla per eliminare gli oggetti dal vecchio bucket se hai selezionato la casella di controllo Elimina gli oggetti di origine al termine del trasferimento durante la configurazione. Tuttavia, potresti anche voler eliminare il vecchio bucket, ma devi farlo separatamente.
Riga di comando
Se non ne hai ancora uno, crea un bucket di destinazione.
Per copiare in modo ricorsivo i contenuti del bucket di origine nel bucket di destinazione, utilizza il
gcloud storage cpcomando con l'opzione--recursive:gcloud storage cp --recursive gs://SOURCE_BUCKET/* gs://DESTINATION_BUCKET
Dove:
SOURCE_BUCKETè il nome del bucket originale. Ad esempio,old-bucket.DESTINATION_BUCKETè il nome del bucket in cui stai spostando i dati. Ad esempio,my-bucket.
Se il bucket utilizza cartelle gestite e uno spazio dei nomi flat, devi includere il flag
--include-managed-foldersnel comando per copiare le cartelle gestite.Per eliminare in modo ricorsivo i contenuti dal bucket di origine, insieme a il bucket di origine stesso, utilizza il comando
gcloud storage rmcon l'opzione--recursive:gcloud storage rm --recursive gs://SOURCE_BUCKET
Dove
SOURCE_BUCKETè il nome del bucket originale. Ad esempio,old-bucket.In alternativa, per eliminare i contenuti dal bucket di origine senza eliminare il bucket di origine stesso, utilizza il comando
gcloud storage rmcon il flag--all-versionse il carattere jolly**:gcloud storage rm --all-versions gs://SOURCE_BUCKET/**
Dove
SOURCE_BUCKETè il nome del bucket originale. Ad esempio,old-bucket.
API REST
API JSON
Se non hai ancora un bucket di destinazione, crealo.
Copia ogni oggetto dal bucket di origine al bucket di destinazione bucket.
Elimina ogni oggetto nel bucket di origine.
API XML
Se non hai ancora un bucket di destinazione, crealo.
Copia ogni oggetto dal bucket di origine al bucket di destinazione bucket.
Elimina ogni oggetto nel bucket di origine.
Passaggi successivi
Scopri di più sulle località dei bucket disponibili e sulle linee guida per la denominazione dei bucket.
Scopri di più sulla creazione e sulla gestione dei trasferimenti di dati con la Google Cloud console.