Spostare e rinominare i bucket

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 di cui fa parte. Tuttavia, puoi spostare o rinominare il bucket:

  • Se non ci sono dati nel vecchio bucket, elimina il bucket e creane un altro con le proprietà che preferisci.

  • Se hai dati nel vecchio bucket, crea un nuovo bucket con le proprietà che vuoi, copia i dati dal vecchio bucket al nuovo ed elimina il vecchio bucket e i relativi contenuti. I passaggi descritti in questa pagina illustrano questa procedura.

    • Se vuoi che il nuovo bucket abbia lo stesso nome di quello precedente, devi spostare temporaneamente i dati in un bucket con un nome diverso. In questo modo puoi eliminare il bucket originale per riutilizzare il nome del 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 posizione del bucket di destinazione. Per maggiori informazioni, consulta Prezzi di Cloud Storage.

Autorizzazioni obbligatorie

Console

Per completare questa guida utilizzando la consoleGoogle Cloud , devi disporre delle autorizzazioni IAM appropriate. Se i bucket a cui vuoi accedere esistono in un progetto che non hai creato, potrebbe essere necessario che il proprietario del progetto ti assegni un ruolo che contenga le autorizzazioni necessarie.

Per un elenco delle autorizzazioni richieste per azioni specifiche, vedi Autorizzazioni IAM per la console Google Cloud .

Per un elenco dei ruoli pertinenti, consulta la pagina Ruoli Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.

Riga di comando

Per completare questa guida utilizzando un'utilità a riga di comando, devi disporre delle autorizzazioni IAM appropriate. Se i bucket a cui vuoi accedere esistono in un progetto che non hai creato, potrebbe essere necessario 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 comandi gcloud storage.

Per un elenco dei ruoli pertinenti, consulta la pagina Ruoli 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 corrette. 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 la pagina Ruoli Cloud Storage. In alternativa, puoi creare un ruolo personalizzato con autorizzazioni specifiche e limitate.

Spostare i dati da un bucket a un altro

Console

Utilizza Storage Transfer Service dalla console Google Cloud :

  1. Se non hai ancora un bucket di destinazione, crealo.

  2. Apri la pagina Trasferimento nella console Google Cloud .

    Apri la pagina Trasferimento

  3. Fai clic su Crea job di trasferimento.

  4. Segui la procedura passo passo e fai clic su Passaggio successivo man mano che completi ogni passaggio:

    • Scegli un'origine: utilizza Bucket Google Cloud Storage come tipo di origine e inserisci direttamente il nome del bucket che ti interessa oppure fai clic su Sfoglia per trovare e selezionare il bucket che vuoi.

    • Scegli una destinazione: inserisci direttamente il nome del bucket che ti interessa 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.

  5. Dopo aver completato la procedura dettagliata, fai clic su Crea.

    Inizia la procedura di copia degli oggetti dal vecchio bucket a quello nuovo. Questo processo potrebbe richiedere del tempo, ma dopo aver fatto clic su Crea, puoi uscire dalla console Google Cloud .

    Per visualizzare l'avanzamento del trasferimento:

    Apri la pagina Trasferimento nella console Google Cloud .

    Apri la pagina Trasferimento

    Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud , consulta Risoluzione dei problemi.

  6. Una volta completato il 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 bucket precedente, che devi fare separatamente.

Riga di comando

  1. Se non ne hai ancora uno, crea un bucket di destinazione.

  2. Per copiare in modo ricorsivo i contenuti del bucket di origine nel bucket di destinazione, utilizza il comando gcloud storage cp con l'opzione --recursive:

    gcloud storage cp --recursive gs://SOURCE_BUCKET/* gs://DESTINATION_BUCKET

    Dove:

    • SOURCE_BUCKET è il nome del tuo bucket originale. Ad esempio, old-bucket.

    • DESTINATION_BUCKET è il nome del bucket in cui sposti i dati. Ad esempio, my-bucket.

    Se il bucket utilizza cartelle gestite e uno spazio dei nomi piatto, devi includere il flag --include-managed-folders nel comando per copiare le cartelle gestite.

  3. Per eliminare in modo ricorsivo i contenuti dal bucket di origine, insieme al bucket di origine stesso, utilizza il comando gcloud storage rm con l'opzione --recursive:

    gcloud storage rm --recursive gs://SOURCE_BUCKET

    Dove SOURCE_BUCKET è il nome del tuo 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 rm con il flag --all-versions e il carattere jolly **:

    gcloud storage rm --all-versions gs://SOURCE_BUCKET/**

    Dove SOURCE_BUCKET è il nome del tuo bucket originale. Ad esempio, old-bucket.

API REST

API JSON

  1. Se non hai ancora un bucket di destinazione, crealo.

  2. Copia ogni oggetto dal bucket di origine a quello di destinazione.

  3. Elimina ogni oggetto nel bucket di origine.

  4. Elimina il bucket di origine.

API XML

  1. Se non hai ancora un bucket di destinazione, crealo.

  2. Copia ogni oggetto dal bucket di origine a quello di destinazione.

  3. Elimina ogni oggetto nel bucket di origine.

  4. Elimina il bucket di origine.

Passaggi successivi