Creazione e gestione delle cartelle gestite

Questa guida descrive come creare, elencare ed eliminare le cartelle gestite.

Prima di iniziare

Prima di iniziare, assicurati di disporre del ruolo Identity and Access Management (IAM) richiesto per creare e gestire le cartelle gestite e abilita l'accesso uniforme a livello di bucket.

Recupera i ruoli richiesti

Per ottenere le autorizzazioni necessarie per creare e gestire le cartelle gestite, chiedi all'amministratore di concederti il ruolo IAM Amministratore cartelle Storage (roles/storage.folderAdmin) per il bucket.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare e gestire le cartelle gestite. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

  • storage.managedfolders.create
  • storage.managedfolders.delete
  • storage.managedfolders.get
  • storage.managedfolders.list
  • storage.objects.list
    • Questa autorizzazione è necessaria solo se vuoi convalidare le cartelle gestite appena create elencandole.

Puoi ottenere queste autorizzazioni anche con altri ruoli predefiniti o ruoli personalizzati.

Per informazioni sulla concessione dei ruoli nei bucket, consulta Utilizzare IAM con i bucket.

Abilita l'accesso uniforme a livello di bucket

Se non lo hai già fatto, attiva l'accesso uniforme a livello di bucket.

Crea una cartella gestita

Console

Quando utilizzi la console Google Cloud, puoi creare cartelle gestite convertindo le cartelle simulate. I passaggi seguenti spiegano come creare una cartella simulata e convertirla in una cartella gestita.

  1. Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.

    Vai a Bucket

  2. Nell'elenco dei bucket, fai clic sul nome del bucket in cui vuoi creare le cartelle gestite.

  3. Nella pagina Dettagli bucket, fai clic su Crea cartella per creare una nuova cartella. Se la cartella che vuoi convertire in una cartella gestita esiste già, vai al passaggio che descrive come accedere al menu Altre opzioni .

  4. Nel campo Nome, inserisci un nome per la cartella. Per considerazioni sulla denominazione, vedi Nomi delle cartelle gestite.

  5. Fai clic su Crea.

    La cartella appena creata viene visualizzata nel riquadro Browser delle cartelle.

  6. Nel riquadro Browser delle cartelle, fai clic sul menu Altre opzioni accanto alla cartella da convertire in una cartella gestita e fai clic su Modifica accesso.

    Viene visualizzata la finestra di dialogo Crea cartella gestita.

  7. Fai clic su Allega cartella gestita.

    La tua cartella viene convertita in una cartella gestita. Viene visualizzato il riquadro Autorizzazioni per MANAGED_FOLDER_NAME, in cui sono visualizzati i criteri IAM sulla cartella per entità e ruolo. Per creare nuovi criteri IAM, consulta Impostare un criterio IAM su una cartella gestita.

Riga di comando

Per creare una cartella gestita, esegui il comando gcloud storage managed-folders create:

gcloud storage managed-folders create gs://BUCKET_NAME/MANAGED_FOLDER_NAME

Dove:

  • BUCKET_NAME è il nome del bucket in cui vuoi creare una cartella gestita. Ad esempio, my-bucket.

  • MANAGED_FOLDER_NAME è il nome della cartella gestita che vuoi creare. Ad esempio, my-managed-folder/.

Per confermare che la cartella gestita sia stata creata, esegui il comando gcloud storage managed-folders describe:

gcloud storage managed-folders describe gs://BUCKET_NAME/MANAGED_FOLDER_NAME

Dove:

  • BUCKET_NAME è il nome del bucket in cui hai creato una cartella gestita.

  • MANAGED_FOLDER_NAME è il nome della cartella gestita che hai creato.

API REST

API JSON

  1. Assicurati che gcloud CLI sia installato e inizializzatoper 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.

  2. Utilizza cURL per chiamare l'API JSON con una richiesta POST ManagedCartella:

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-d '{ "name": "MANAGED_FOLDER_NAME" }' \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders"

    Dove:

    • BUCKET_NAME è il nome del bucket in cui vuoi creare una cartella gestita. Ad esempio, my-bucket.

    • MANAGED_FOLDER_NAME è il nome della cartella gestita che vuoi creare. Ad esempio, my-managed-folder/.

Elenco cartelle gestite

Console

  1. Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.

    Vai a Bucket

  2. Nel riquadro Browser delle cartelle, utilizza il nodo di attivazione/disattivazione per espandere l'elenco delle cartelle all'interno del tuo bucket.

Viene visualizzato un elenco delle cartelle simulate e gestite del bucket.

Riga di comando

Per elencare le cartelle gestite, esegui il comando gcloud storage managed-folders list:

gcloud storage managed-folders list gs://BUCKET_NAME

Dove:

  • BUCKET_NAME è il nome del bucket che contiene le cartelle gestite che vuoi elencare. Ad esempio, my-bucket.

Tieni presente che puoi anche specificare un percorso della cartella invece del nome di un bucket. Ad esempio:

gcloud storage managed-folders list gs://my-bucket/folder/

API REST

API JSON

  1. Assicurati che gcloud CLI sia installato e inizializzatoper 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.

  2. Utilizza cURL per chiamare l'API JSON con una richiesta di elencare le cartelle gestite:

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders"

    Dove BUCKET_NAME è il nome del bucket che contiene le cartelle gestite che vuoi elencare. Ad esempio, my-bucket.

Spostare una cartella gestita

Console

  1. Crea una nuova cartella gestita nel bucket di destinazione.

  2. Copia i criteri IAM dalla cartella gestita originale nel bucket di origine alla nuova cartella gestita nel bucket di destinazione.

  3. Copia gli oggetti dalla cartella gestita originale nel bucket di origine alla nuova cartella gestita nel bucket di destinazione.

  4. Elimina la cartella gestita originale dal bucket di origine.

Riga di comando

Per spostare le cartelle gestite e gli oggetti che contengono, esegui il comando gcloud storage mv con l'opzione --include-managed-folders:

gcloud storage mv --include-managed-folders gs://SOURCE_BUCKET_NAME/MANAGED_FOLDER_NAME gs://DESTINATION_BUCKET_NAME/MANAGED_FOLDER_NAME

Dove:

  • SOURCE_BUCKET è il nome del bucket originale. Ad esempio, my-source-bucket".

  • DESTINATION_BUCKET è il nome del bucket in cui stai spostando la cartella gestita. Ad esempio, my-destination-bucket.

  • MANAGED_FOLDER_NAME è il nome della cartella gestita che stai spostando. Ad esempio, my-managed-folder/.

API REST

API JSON

Per spostare le cartelle gestite da un bucket all'altro:

  1. Crea una nuova cartella gestita nel bucket di destinazione.

  2. Copia i criteri IAM dalla cartella gestita originale del bucket di origine alla nuova cartella gestita nel bucket di destinazione.

  3. Copia gli oggetti dalla cartella gestita originale nel bucket di origine alla nuova cartella gestita nel bucket di destinazione.

  4. Elimina la cartella gestita originale dal bucket di origine.

Elimina una cartella gestita

Console

  1. Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.

    Vai a Bucket

  2. Nella pagina Dettagli bucket, fai clic sull'icona Altre opzioni accanto alla cartella gestita da eliminare.

  3. Fai clic su Elimina cartella.

  4. Per confermare di voler eliminare la cartella gestita, digita DELETE nel campo Elimina.

  5. Fai clic su Elimina.

    La cartella gestita e i suoi contenuti, inclusi gli oggetti archiviati e altre cartelle gestite, vengono eliminati dal bucket Cloud Storage.

Riga di comando

Per eliminare una cartella gestita e gli oggetti che contiene, esegui il comando gcloud storage rm:

gcloud storage rm -r gs://BUCKET_NAME/MANAGED_FOLDER_NAME

Dove:

  • BUCKET_NAME è il nome del bucket che contiene la cartella gestita che vuoi eliminare. Ad esempio, my-bucket.

  • MANAGED_FOLDER_NAME è il nome della cartella gestita che vuoi eliminare. Ad esempio, my-managed-folder/.

API REST

API JSON

Per eliminare una cartella gestita, devi prima eliminare gli oggetti all'interno della cartella gestita.

  1. Assicurati che gcloud CLI sia installato e inizializzatoper 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.

  2. Utilizza cURL per chiamare l'API JSON con una richiesta DELETE ManagedCartella:

    curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/managedFolders/MANAGED_FOLDER_NAME"

    Dove:

    • BUCKET_NAME è il nome del bucket che contiene la cartella gestita che vuoi eliminare. Ad esempio, my-bucket.

    • MANAGED_FOLDER_NAME è il nome della cartella gestita che vuoi eliminare. Ad esempio, my-managed-folder/.

    Per impostazione predefinita, le cartelle gestite devono essere vuote prima di poter essere eliminate. Per eliminare una cartella gestita non vuota, includi allowNonEmpty=true come parametro di query nella richiesta.

Risoluzione dei problemi

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

Passaggi successivi