Questa pagina descrive come rinominare le cartelle in un bucket in cui è abilitato lo spazio dei nomi gerarchico.
L'operazione di ridenominazione rinomina in modo ricorsivo una cartella, le relative cartelle figlio e le risorse associate, compresi 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 o non riesce e genera un errore. In caso di errore, tutte le risorse vengono ripristinate allo stato originale.
In un bucket in cui è abilitato lo spazio dei nomi gerarchico, la ridenominazione di una cartella è un'operazione solo per i metadati. Non comporta lo spostamento o la copia fisica degli oggetti all'interno della cartella, quindi non vengono addebitati 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, il processo di ridenominazione può essere inefficiente e costoso. Anche la ridenominazione o lo spostamento di una cartella simulata non è atomico, il che significa che, se il processo non riesce, il bucket potrebbe rimanere in uno stato incoerente e spostare solo alcuni oggetti.
Durante il processo 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.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per rinominare le cartelle nei bucket, chiedi all'amministratore di concederti il ruolo IAM Utente oggetti Storage (roles/storage.objectUser
) nel bucket.
Per ulteriori informazioni sulla concessione dei ruoli nei progetti, consulta Gestire l'accesso ai progetti.
Per visualizzare esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.folders.rename
- Questa autorizzazione è necessaria per la cartella di origine.
storage.folders.create
- Questa autorizzazione è necessaria per la cartella di destinazione.
Puoi anche ottenere le autorizzazioni precedenti con altri ruoli personalizzati o ruoli predefiniti. Per un ruolo più permissivo che consenta di gestire le cartelle oltre a rinominarle, chiedi all'amministratore di concederti uno dei seguenti ruoli:
- Amministratore cartelle Storage (
roles/storage.folderAdmin
) - Amministratore oggetti Storage (
roles/storage.objectAdmin
) - Amministratore Storage (
roles/storage.admin
)
Per sapere quali ruoli sono associati a quali autorizzazioni, vedi Ruoli IAM per Cloud Storage.
Rinominare una cartella
Librerie client
C++
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API C++ di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Go di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Java di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Node.js di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
PHP
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API PHP di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Ruby di Cloud Storage.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Installa e inizializzatogcloud CLI per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando OAuth 2.0 Playground e includerlo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con una richiesta di rinominare le 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 da rinominare. Ad esempio,my-bucket
.SOURCE_PATH
è il percorso con codifica URL della cartella di origine. Ad esempio,my-src-folder/
con URL codificato comemy-src-folder%2F
.DESTINATION_PATH
è il percorso con codifica URL della cartella di destinazione. Ad esempio,my-dest-folder/
con URL codificato 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 gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
Prova Cloud Storage gratuitamente