In questa pagina viene descritto come utilizzare le archiviazioni a fini legali, inclusa l'impostazione predefinita delle archiviazioni a fini legali. su nuovi oggetti e l'aggancio a singoli oggetti.
Autorizzazioni obbligatorie
Prima di utilizzare questa funzionalità in Cloud Storage, devi disporre di dati sufficienti per visualizzare e aggiornare bucket e oggetti in Cloud Storage:
Se possiedi il progetto che contiene il bucket, probabilmente le autorizzazioni necessarie.
Se utilizzi IAM, dovresti avere
storage.buckets.update
,storage.buckets.get
,storage.objects.update
estorage.objects.get
autorizzazioni per il bucket pertinente. Consulta Utilizzo delle autorizzazioni IAM per istruzioni su come ottenere un ruolo, ad esempio Storage Admin, con questi autorizzazioni aggiuntive.Se utilizzi gli ACL, devi disporre dell'autorizzazione OWNER per il bucket pertinente e sugli oggetti al suo interno. Per le istruzioni, consulta Impostazione degli ACL questo.
Utilizza la proprietà di blocco basata su eventi predefinita
Le attività riportate di seguito mostrano come impostare e visualizzare proprietà di blocco predefinita basata su eventi su un bucket. Quando questa proprietà è abilitato, i nuovi oggetti aggiunti al bucket ricevono automaticamente un blocco basato su eventi su di essi.
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 che vuoi imposta la proprietà predefinita di blocco basato su eventi.
Seleziona la scheda Protezione nella parte superiore della pagina.
Lo stato attuale del bucket viene visualizzato nella sezione opzione di blocco.
Nella sezione Opzione di blocco predefinito basato su eventi, fai clic sul pulsante per modificarlo.
Lo stato visualizzato è Attivato o Disattivato.
Scopri come ottenere informazioni dettagliate sugli errori relativi a Cloud Storage non riusciti nella console Google Cloud, vedi Risoluzione dei problemi.
Riga di comando
Utilizza il comando gcloud storage buckets update
con
flag appropriato:
gcloud storage buckets update gs://BUCKET_NAME FLAG
Dove:
BUCKET_NAME
è il nome del di sincronizzare la directory di una VM con un bucket. Ad esempio,my-bucket
.FLAG
è--default-event-based-hold
a abilitare blocchi degli oggetti basati su eventi predefiniti--no-default-event-based-hold
per disattivarle.
Librerie client
C++
Per ulteriori informazioni, consulta API Cloud Storage C++ documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Storage C# documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Storage Go documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Storage Java documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Storage Node.js documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Storage PHP documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Storage Python documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 API Cloud Storage Ruby documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo 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 un bucketPATCH
richiesta: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 nel passaggio 2.BUCKET_NAME
è il nome del di sincronizzare la directory di una VM con un bucket. Ad esempio,my-bucket
.
API XML
L'API XML non può essere utilizzata per lavorare con i blocchi degli oggetti. Utilizza uno dei seguenti con 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 che vuoi per controllare lo stato predefinito basato sugli eventi.
Seleziona la scheda Protezione nella parte superiore della pagina.
Lo stato viene visualizzato nella sezione Opzione di blocco predefinito basato su eventi.
Scopri come ottenere informazioni dettagliate sugli errori relativi a Cloud Storage non riusciti nella console Google Cloud, vedi Risoluzione dei problemi.
Riga di comando
Utilizza il comando gcloud storage buckets describe
con
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 API Cloud Storage C++ documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
C#
Per ulteriori informazioni, consulta API Cloud Storage C# documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Go
Per ulteriori informazioni, consulta API Cloud Storage Go documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per ulteriori informazioni, consulta API Cloud Storage Java documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per ulteriori informazioni, consulta API Cloud Storage Node.js documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
PHP
Per ulteriori informazioni, consulta API Cloud Storage PHP documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per ulteriori informazioni, consulta API Cloud Storage Python documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Ruby
Per ulteriori informazioni, consulta API Cloud Storage Ruby documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Utilizza
cURL
per chiamare l'API JSON con un bucketGET
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 del bucket pertinente. Ad esempio,my-bucket
.Se nel bucket è abilitato un blocco predefinito basato su eventi, come mostrato nell'esempio seguente:
{ "defaultEventBasedHold": true }
API XML
L'API XML non può essere utilizzata per lavorare con i blocchi degli oggetti. Utilizza uno dei seguenti con altri strumenti di Cloud Storage, come gcloud CLI, .
Gestire singoli blocchi di oggetti
Le seguenti attività mostrano come modificare e visualizzare le conservazioni su singole di oggetti strutturati.
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 con gli oggetti che desideri applicare o rimuovere i blocchi.
Seleziona la casella di controllo accanto ai nomi degli oggetti che vuoi posizionare o e rimuovere le sospensioni.
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.
Scopri come ottenere informazioni dettagliate sugli errori relativi a Cloud Storage non riusciti nella console Google Cloud, vedi Risoluzione dei problemi.
Riga di comando
Utilizza il comando gcloud storage objects update
con
flag appropriato:
gcloud storage objects update gs://BUCKET_NAME/OBJECT_NAME FLAG
Dove:
BUCKET_NAME
è il nome del di sincronizzare la directory di una VM con un bucket. Ad esempio,my-bucket
.OBJECT_NAME
è il nome del . 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 disattivare qualsiasi blocco basato su eventi sulla .--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 API Cloud Storage C++ documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 per 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 API Cloud Storage C# documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 per 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 API Cloud Storage Go documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 per 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 API Cloud Storage Java documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 per 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 API Cloud Storage Node.js documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 per 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 API Cloud Storage PHP documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 per 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 API Cloud Storage Python documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 per 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 API Cloud Storage Ruby documentazione di riferimento.
Per eseguire l'autenticazione su Cloud Storage, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura 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 per 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
Avere gcloud CLI installato e inizializzato, per generare un token di accesso per l'intestazione
Authorization
.In alternativa, puoi creare un token di accesso utilizzando il metodo OAuth 2.0 Playground e includilo nell'intestazione
Authorization
.Crea un file JSON contenente le seguenti informazioni:
{ "HOLD_TYPE": STATE }
Dove:
HOLD_TYPE
è il tipo di archiviazione a fini legali che vuoi impostare o rilasciare sull'oggetto. Ad esempio,temporaryHold
oeventBasedHold
. Per ulteriori informazioni, consulta Blocchi di oggetti tipi di archiviazione a fini legali.STATE
ètrue
per applicare la sospensione ofalse
per rilasciare la sospensione.
Utilizza
cURL
per chiamare l'API JSON con una chiamata RichiestaPATCH
oggetto: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 nel passaggio 2.BUCKET_NAME
è il nome del di sincronizzare la directory di una VM con un bucket. Ad esempio,my-bucket
.OBJECT_NAME
è il nome codificato nell'URL del 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 uno dei seguenti con altri strumenti di Cloud Storage, come gcloud CLI, .
Recuperare lo stato di blocco di un oggetto
Per visualizzare gli eventuali blocchi presenti in un oggetto, segui le istruzioni generali per visualizzare i 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.