In questa pagina viene descritto come utilizzare i blocchi degli oggetti, compresa l'impostazione predefinita di blocchi sui nuovi oggetti e l'applicazione di archiviazioni a fini legali su singoli oggetti.
Autorizzazioni obbligatorie
Prima di utilizzare questa funzionalità in Cloud Storage, devi disporre di autorizzazioni sufficienti per visualizzare e aggiornare bucket e oggetti in Cloud Storage:
Se possiedi il progetto che contiene il bucket, hai molto probabilmente le autorizzazioni necessarie.
Se utilizzi IAM, devi avere le autorizzazioni
storage.buckets.update
,storage.buckets.get
,storage.objects.update
estorage.objects.get
per il bucket pertinente. Consulta Utilizzo delle autorizzazioni IAM per le istruzioni su come ottenere un ruolo, ad esempio Storage Admin, che dispone di queste autorizzazioni.Se utilizzi gli ACL, devi disporre dell'autorizzazione OWNER per il bucket pertinente e per gli oggetti al suo interno. Per le istruzioni, consulta Impostazione degli ACL.
Utilizza la proprietà di blocco basata su eventi predefinita
Le seguenti attività mostrano come impostare e visualizzare la proprietà di blocco predefinita basata su eventi in un bucket. Quando questa proprietà è abilitata, ai nuovi oggetti aggiunti al bucket viene automaticamente applicato un blocco basato su eventi.
Impostare la proprietà predefinita di blocco basato su eventi
Per abilitare o disabilitare la proprietà di blocco predefinita basata su eventi per un bucket:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket per cui vuoi impostare la proprietà di blocco predefinita basata su eventi.
Seleziona la scheda Protezione nella parte superiore della pagina.
Lo stato attuale del bucket viene visualizzato nella sezione Opzione di blocco predefinito basata su eventi.
Nella sezione Opzione di blocco basato su eventi predefinito, fai clic sullo stato attuale per modificarlo.
Lo stato visualizzato è Attivato o Disattivato.
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 gcloud storage buckets update
con il
flag appropriato:
gcloud storage buckets update gs://BUCKET_NAME FLAG
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.FLAG
è--default-event-based-hold
per abilitare i blocchi degli oggetti predefiniti basati su eventi o--no-default-event-based-hold
per disabilitarli.
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.
Il seguente esempio abilita i blocchi predefiniti basati su eventi su un bucket:
L'esempio seguente disabilita i blocchi basati su eventi predefiniti in un bucket:
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.
Il seguente esempio abilita i blocchi predefiniti basati su eventi su un bucket:
L'esempio seguente disabilita i blocchi basati su eventi predefiniti in un bucket:
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.
Il seguente esempio abilita i blocchi predefiniti basati su eventi su un bucket:
L'esempio seguente disabilita i blocchi basati su eventi predefiniti in un bucket:
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.
Il seguente esempio abilita i blocchi predefiniti basati su eventi su un bucket:
L'esempio seguente disabilita i blocchi basati su eventi predefiniti in un bucket:
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.
Il seguente esempio abilita i blocchi predefiniti basati su eventi su un bucket:
L'esempio seguente disabilita i blocchi basati su eventi predefiniti in un bucket:
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.
Il seguente esempio abilita i blocchi predefiniti basati su eventi su un bucket:
L'esempio seguente disabilita i blocchi basati su eventi predefiniti in un bucket:
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.
Il seguente esempio abilita i blocchi predefiniti basati su eventi su un bucket:
L'esempio seguente disabilita i blocchi basati su eventi predefiniti in un bucket:
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.
Il seguente esempio abilita i blocchi predefiniti basati su eventi su un bucket:
L'esempio seguente disabilita i blocchi basati su eventi predefiniti in un bucket:
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
.Crea un file JSON contenente le seguenti informazioni:
{ "defaultEventBasedHold": STATE }
Dove STATE è
true
ofalse
.Utilizza
cURL
per chiamare l'API JSON con una richiestaPATCH
Bucket:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=defaultEventBasedHold"
Dove:
JSON_FILE_NAME
è il percorso del file creato al passaggio 2.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.
API XML
L'API XML non può essere utilizzata per lavorare con i blocchi degli oggetti. Utilizza invece uno degli altri strumenti di Cloud Storage, come gcloud CLI.
Ottieni lo stato di blocco predefinito di un bucket
Per vedere se un bucket applica blocchi basati su eventi ai nuovi oggetti per impostazione predefinita:
Console
- Nella console Google Cloud, vai alla pagina Bucket di Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket per il quale vuoi controllare lo stato predefinito basato su eventi.
Seleziona la scheda Protezione nella parte superiore della pagina.
Lo stato viene visualizzato nella sezione Opzione di blocco predefinito basato su eventi.
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 gcloud storage buckets describe
con il
flag --format
:
gcloud storage buckets describe gs://BUCKET_NAME --format="default(default_event_based_hold)"
Dove BUCKET_NAME
è il nome del bucket
di cui vuoi visualizzare lo stato. Ad esempio, my-bucket
.
Se l'esito è positivo, la risposta è simile al seguente esempio:
default_event_based_hold: true
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 richiestaGET
Bucket che includa ilfields
desiderato:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME?fields=defaultEventBasedHold"
Dove
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.Se per il bucket è abilitato un blocco predefinito basato su eventi, la risposta è simile all'esempio seguente:
{ "defaultEventBasedHold": true }
API XML
L'API XML non può essere utilizzata per lavorare con i blocchi degli oggetti. Utilizza invece uno degli altri strumenti di Cloud Storage, come gcloud CLI.
Gestire singoli blocchi di oggetti
Le seguenti attività mostrano come modificare e visualizzare i blocchi di singoli oggetti.
Posizionare o rilasciare un blocco oggetto
Per applicare o rilasciare un blocco su un oggetto del bucket:
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 su cui vuoi applicare o rimuovere i blocchi.
Seleziona la casella di controllo accanto ai nomi degli oggetti che vuoi posizionare o su cui vuoi rimuovere i blocchi.
Fai clic sul pulsante Gestisci archiviazioni a fini legali.
Viene visualizzata la finestra Gestisci archiviazioni a fini legali.
Attiva/disattiva le caselle di controllo per ogni tipo di blocco come preferisci.
Fai clic su Salva impostazioni di blocco.
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 gcloud storage objects update
con il
flag appropriato:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME FLAG
Dove:
BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.OBJECT_NAME
è il nome dell'oggetto rilevante. Ad esempio,pets/dog.png
.FLAG
corrisponde a uno dei seguenti:--event-based-hold
per attivare un blocco basato su eventi sull'oggetto.--no-event-based-hold
per disabilitare il blocco basato su eventi sull'oggetto.--temporary-hold
per attivare un blocco temporaneo sull'oggetto.--no-temporary-hold
per disattivare l'eventuale blocco temporaneo sull'oggetto.
Per ulteriori informazioni sui tipi di archiviazione a fini legali, consulta Blocchi di oggetti.
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.
L'esempio seguente imposta un blocco basato su eventi su un oggetto:
Nell'esempio seguente viene rilasciato un blocco basato su eventi su un oggetto:
Il seguente esempio imposta un blocco temporaneo su un oggetto:
Nell'esempio seguente viene rilasciata una conservazione temporanea su un oggetto:
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.
L'esempio seguente imposta un blocco basato su eventi su un oggetto:
Nell'esempio seguente viene rilasciato un blocco basato su eventi su un oggetto:
Il seguente esempio imposta un blocco temporaneo su un oggetto:
Nell'esempio seguente viene rilasciata una conservazione temporanea su un oggetto:
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.
L'esempio seguente imposta un blocco basato su eventi su un oggetto:
Nell'esempio seguente viene rilasciato un blocco basato su eventi su un oggetto:
Il seguente esempio imposta un blocco temporaneo su un oggetto:
Nell'esempio seguente viene rilasciata una conservazione temporanea su un oggetto:
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.
L'esempio seguente imposta un blocco basato su eventi su un oggetto:
Nell'esempio seguente viene rilasciato un blocco basato su eventi su un oggetto:
Il seguente esempio imposta un blocco temporaneo su un oggetto:
Nell'esempio seguente viene rilasciata una conservazione temporanea su un oggetto:
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.
L'esempio seguente imposta un blocco basato su eventi su un oggetto:
Nell'esempio seguente viene rilasciato un blocco basato su eventi su un oggetto:
Il seguente esempio imposta un blocco temporaneo su un oggetto:
Nell'esempio seguente viene rilasciata una conservazione temporanea su un oggetto:
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.
L'esempio seguente imposta un blocco basato su eventi su un oggetto:
Nell'esempio seguente viene rilasciato un blocco basato su eventi su un oggetto:
Il seguente esempio imposta un blocco temporaneo su un oggetto:
Nell'esempio seguente viene rilasciata una conservazione temporanea su un oggetto:
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.
L'esempio seguente imposta un blocco basato su eventi su un oggetto:
Nell'esempio seguente viene rilasciato un blocco basato su eventi su un oggetto:
Il seguente esempio imposta un blocco temporaneo su un oggetto:
Nell'esempio seguente viene rilasciata una conservazione temporanea su un oggetto:
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.
L'esempio seguente imposta un blocco basato su eventi su un oggetto:
Nell'esempio seguente viene rilasciato un blocco basato su eventi su un oggetto:
Il seguente esempio imposta un blocco temporaneo su un oggetto:
Nell'esempio seguente viene rilasciata una conservazione temporanea su un oggetto:
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
.Crea un file JSON contenente le seguenti informazioni:
{ "HOLD_TYPE": STATE }
Dove:
HOLD_TYPE
è il tipo di blocco che vuoi impostare o rilasciare per l'oggetto. Ad esempio,temporaryHold
oeventBasedHold
. Per ulteriori informazioni sui tipi di blocco, consulta Blocco degli oggetti.STATE
ètrue
per applicare il blocco ofalse
per rilasciarlo.
Usa
cURL
per chiamare l'API JSON con una richiesta OggettoPATCH
:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/o/OBJECT_NAME"
Dove:
JSON_FILE_NAME
è il percorso del file creato al passaggio 2.BUCKET_NAME
è il nome del bucket pertinente. Ad esempio,my-bucket
.OBJECT_NAME
è il nome codificato nell'URL dell'oggetto pertinente. Ad esempio,pets/dog.png
, con codifica URLpets%2Fdog.png
.
API XML
L'API XML non può essere utilizzata per lavorare con i blocchi degli oggetti. Utilizza invece uno degli altri strumenti di Cloud Storage, come gcloud CLI.
Recuperare lo stato di blocco di un oggetto
Per visualizzare gli eventuali blocchi presenti su un oggetto, segui le istruzioni generali per la visualizzazione dei metadati degli oggetti.
Passaggi successivi
- Scopri di più sui blocchi degli oggetti, inclusi i diversi tipi di blocchi che un oggetto può avere.
- Scopri come utilizzare i criteri di conservazione.
- Scopri come utilizzare le condizioni preliminari per le richieste per prevenire le condizioni di gara.