Questa pagina descrive come rinominare e spostare le cartelle in un bucket con lo spazio dei nomi gerarchico abilitato.
L'operazione di ridenominazione rinomina in modo ricorsivo una cartella, le relative cartelle secondarie e le risorse associate, inclusi oggetti e cartelle gestite, in un'unica azione atomica.
L'operazione di ridenominazione è atomica. L'operazione viene completata correttamente e sposta le risorse nel nuovo percorso oppure non riesce e genera un errore. In caso di errore, tutte le risorse vengono ripristinate allo stato originale.
In un bucket con lo spazio dei nomi gerarchico abilitato, la ridenominazione di una cartella è un'operazione solo di metadati. Non comporta lo spostamento o la copia fisica degli oggetti all'interno della cartella, quindi non vengono sostenuti costi di copia degli oggetti.
Tuttavia, in un bucket senza uno spazio dei nomi gerarchico abilitato, le cartelle vengono simulate. La ridenominazione o lo spostamento di una cartella simulata richiede la copia e l'eliminazione di ogni oggetto al suo interno. Se la cartella contiene molti oggetti, la procedura di ridenominazione può essere inefficiente e costosa. Anche la ridenominazione o lo spostamento di una cartella simulata non è atomico, il che significa che se la procedura non va a buon fine, il bucket potrebbe rimanere in uno stato incoerente, con solo alcuni oggetti spostati.
Durante la procedura di ridenominazione della cartella, puoi leggere ed elencare le risorse che vengono rinominate. Tuttavia, non puoi eseguire operazioni di scrittura sulle risorse interessate.
L'operazione di ridenominazione della cartella avvia un'operazione a lunga esecuzione su un bucket.
Prima di iniziare
Assicurati che lo spazio dei nomi gerarchico sia abilitato per il bucket. Per istruzioni dettagliate sull'abilitazione dello spazio dei nomi gerarchico in un bucket, vedi Creare bucket con lo spazio dei nomi gerarchico abilitato.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per rinominare o spostare le cartelle nei bucket, chiedi all'amministratore di concederti il ruolo IAM Utente oggetti Storage (roles/storage.objectUser
) sul bucket.
Per saperne di più sulla concessione dei ruoli nei progetti, consulta Gestire l'accesso ai progetti.
Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.folders.rename
- Questa autorizzazione è necessaria nella cartella di origine.
storage.folders.create
- Questa autorizzazione è necessaria nella cartella di destinazione.
Puoi anche ottenere le autorizzazioni precedenti con altri ruoli personalizzati o ruoli predefiniti. Per un ruolo più permissivo che ti consenta di gestire le cartelle oltre a rinominarle, chiedi all'amministratore di concederti uno dei seguenti ruoli:
- Storage Folder Admin (
roles/storage.folderAdmin
) - Storage Object Admin (
roles/storage.objectAdmin
) - Amministratore Storage (
roles/storage.admin
)
Per vedere quali ruoli sono associati a quali autorizzazioni, consulta Ruoli IAM per Cloud Storage.
Rinominare e spostare una cartella
Console
- Nella console Google Cloud , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket contenente la cartella da spostare o rinominare.
Nella pagina Dettagli bucket, individua la cartella che vuoi spostare o rinominare.
Se vuoi rinominare la cartella:
Fai clic sul menu Altre azioni
della cartella.Fai clic su Rinomina cartella.
Nella finestra di overlay visualizzata, inserisci un nuovo nome per la cartella.
Fai clic su Rinomina.
Se vuoi spostare la cartella in un'altra cartella, segui questi passaggi:
Fai clic sul menu Altre azioni
della cartella.Fai clic su Sposta cartella.
Nella finestra di overlay visualizzata, fai clic su Sfoglia.
Seleziona la cartella di destinazione per la cartella che stai spostando. Puoi anche fare clic su
per creare una nuova cartella prima di selezionarla come cartella di destinazione.Fai clic su Seleziona.
Fai clic su Sposta.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni di Cloud Storage non riuscite nella console Google Cloud , consulta Risoluzione dei problemi.
Riga di comando
Per rinominare o spostare le cartelle all'interno di un bucket con spazio dei nomi gerarchico, esegui il comando gcloud storage mv
:
gcloud storage mv gs://BUCKET_NAME/FOLDER1 gs://BUCKET_NAME/FOLDER2
Dove:
BUCKET_NAME
è il nome del bucket che contiene la cartella che vuoi rinominare o spostare. Ad esempio,my-bucket
.FOLDER1
è il nome della cartella originale che vuoi rinominare o spostare. Ad esempio,my-src-folder
.FOLDER2
è il nuovo nome della cartella di destinazione. Ad esempio,my-dest-folder
. Se il nuovo nome scelto è già utilizzato da una cartella esistente, la cartella originale viene spostata all'interno di quella esistente, diventando una cartella secondaria. Ad esempio, se rinominimy-dest-folder
inmy-dest-folder1
(emy-dest-folder1
esiste già), il risultato èmy-dest-folder1/my-dest-folder/
. Se il nuovo nome scelto non esiste già, la cartella originale viene rinominata in modo che corrisponda al nuovo nome.
La risposta è simile al seguente esempio:
Copying gs://my-bucket/my-src-folder to gs://my-bucket/my-dest-folder...
Librerie client
C++
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
C#
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage C#.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Go
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Go.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Java
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Node.js
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Node.js.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
PHP
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage PHP.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Python
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Python.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
Ruby
Per maggiori informazioni, consulta la documentazione di riferimento dell'API Cloud Storage Ruby.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configurare l'autenticazione per le librerie client.
API REST
API JSON
Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiesta di rinomina delle cartelle:curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/folders/SOURCE_PATH/renameTo/folders/DESTINATION_PATH"
Dove:
BUCKET_NAME
è il nome del bucket che contiene la cartella che vuoi rinominare o spostare. Ad esempio,my-bucket
.SOURCE_PATH
è il percorso con codifica URL della cartella di origine. Ad esempio,my-src-folder/
con codifica URL comemy-src-folder%2F
.DESTINATION_PATH
è il percorso codificato tramite URL della cartella di destinazione. Ad esempio,my-dest-folder/
con codifica URL comemy-dest-folder%2F
.
Passaggi successivi
Provalo
Se non conosci Google Cloud, crea un account per valutare le prestazioni di Cloud Storage in scenari reali. I nuovi clienti ricevono anche 300 $ di crediti senza addebiti per l'esecuzione, il test e il deployment dei workload.
Prova Cloud Storage gratuitamente