Questa pagina mostra come eliminare oggetti dai bucket in Cloud Storage.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per eliminare gli oggetti, chiedi all'amministratore di concederti il ruolo IAM Utente oggetti Storage (roles/storage.objectUser
) per il bucket che contiene gli oggetti che vuoi eliminare.
Se prevedi di utilizzare la console Google Cloud per completare le attività in questa pagina, chiedi all'amministratore di concederti il ruolo Amministratore Storage (roles/storage.admin
) anziché il ruolo Utente oggetti Storage (roles/storage.objectUser
) o Visualizzatore (roles/viewer
) di base oltre al ruolo Utente oggetti Storage (roles/storage.objectUser
).
Questi ruoli contengono le autorizzazioni necessarie per eliminare gli oggetti. Per visualizzare esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
storage.objects.delete
storage.objects.list
- Questa autorizzazione è necessaria solo quando si utilizza la console Google Cloud o
quando si utilizzano il flag
--recursive
o i caratteri jolly in Google Cloud CLI.
- Questa autorizzazione è necessaria solo quando si utilizza la console Google Cloud o
quando si utilizzano il flag
storage.buckets.list
- Questa autorizzazione è necessaria solo quando utilizzi la console Google Cloud per eseguire le istruzioni in questa pagina.
Puoi ottenere queste autorizzazioni anche con altri ruoli predefiniti o ruoli personalizzati.
Per informazioni sulla concessione dei ruoli sui bucket, consulta Utilizzare IAM con i bucket.
Elimina un oggetto
Completa i seguenti passaggi per eliminare gli oggetti da uno dei bucket Cloud Storage:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket che contiene gli oggetti da eliminare.
Si apre la pagina Dettagli bucket, con la scheda Oggetti selezionata.
Accedi agli oggetti che potrebbero trovarsi in una cartella.
Fai clic sulla casella di controllo di ogni oggetto che vuoi eliminare.
Puoi anche fare clic sulla casella di controllo delle cartelle, per eliminare tutti gli oggetti contenuti al loro interno.
Fai clic sul pulsante Elimina.
Fai clic su Elimina nella finestra di dialogo visualizzata.
Se elimini più oggetti contemporaneamente, puoi tenere traccia dell'avanzamento dell'eliminazione facendo clic sull'icona Notifiche nella console Google Cloud. La console Google Cloud può eliminare collettivamente fino a diversi milioni di oggetti in background.
Per scoprire come ottenere informazioni dettagliate sugli errori relativi alle operazioni Cloud Storage non riuscite nella console Google Cloud, consulta la pagina Risoluzione dei problemi.
Riga di comando
Utilizza il comando Google Cloud CLI gcloud storage rm
:
gcloud storage rm gs://BUCKET_NAME/OBJECT_NAME
Dove:
BUCKET_NAME
è il nome del bucket che contiene l'oggetto da eliminare. Ad esempio,my-bucket
.OBJECT_NAME
è il nome dell'oggetto che vuoi eliminare. Ad esempio,pets/dog.png
.
Se l'esito è positivo, la risposta è simile al seguente esempio:
Removing objects: Removing gs://example-bucket/file.txt... Completed 1/1
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.
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 richiestaDELETE
:curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Dove:
BUCKET_NAME
è il nome del bucket che contiene l'oggetto che vuoi eliminare. Ad esempio,my-bucket
.OBJECT_NAME
è il nome con codifica URL dell'oggetto che vuoi eliminare. Ad esempio,pets/dog.png
, con codifica URLpets%2Fdog.png
.
API XML
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 XML con una richiestaDELETE Object
:curl -X DELETE \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/BUCKET_NAME/OBJECT_NAME"
Dove:
BUCKET_NAME
è il nome del bucket che contiene l'oggetto che vuoi eliminare. Ad esempio,my-bucket
.OBJECT_NAME
è il nome con codifica URL dell'oggetto che vuoi eliminare. Ad esempio,pets/dog.png
, con codifica URLpets%2Fdog.png
.
Eliminare gli oggetti collettivamente
Se vuoi eliminare in blocco un centinaio di migliaia o più oggetti, evita di utilizzare gcloud storage
, poiché il completamento del processo richiede molto tempo.
Prendi invece in considerazione una delle seguenti opzioni:
La funzionalità Gestione del ciclo di vita degli oggetti può eliminare un numero qualsiasi di oggetti. Per eliminare in blocco gli oggetti dal bucket utilizzando questa funzionalità, imposta una regola di configurazione del ciclo di vita sul tuo bucket in cui la condizione sia
Age
impostata su 0 giorni e l'azione sia impostata sudelete
. Dopo aver impostato la regola, Cloud Storage esegue l'eliminazione collettiva in modo asincrono.La console Google Cloud è un'opzione consigliata anche per l'eliminazione di massimo un milione di oggetti. Una volta avviata la richiesta di eliminazione, il processo avviene in background. Puoi controllare lo stato dell'eliminazione collettiva facendo clic sul pulsante Notifiche (notifications) nell'intestazione della console Google Cloud.
Quando utilizzi determinate librerie client o direttamente l'API JSON, puoi raggruppare le richieste di eliminazione in batch per ridurre il numero di connessioni HTTP da stabilire.
Passaggi successivi
- Scopri di più sulla funzionalità di controllo delle versioni degli oggetti.
- Scopri di più sulla funzionalità Gestione del ciclo di vita degli oggetti.
- Scopri come eliminare un bucket.