Puoi creare e gestire istanze di cache con Rapid Cache per ridurre la latenza e ottimizzare l'accesso ai dati per gli oggetti archiviati in Cloud Storage. Questa soluzione di memorizzazione nella cache contribuisce a migliorare le prestazioni delle tue applicazioni accelerando il recupero dei dati.
Questa pagina mostra come creare e gestire le istanze di cache con Rapid Cache. Per informazioni su come utilizzare e gestire le operazioni a lunga esecuzione avviate dalle operazioni di cache asincrone di Rapid Cache, consulta Utilizza le operazioni a lunga esecuzione.
Prima di utilizzare Rapid Cache, consulta le limitazioni e restrizioni.
Prima di iniziare
Prima di iniziare a creare e gestire le cache, completa le sezioni seguenti.
Ottieni i ruoli richiesti
Per ottenere le autorizzazioni necessarie per creare e gestire le cache di Rapid Cache, chiedi all'amministratore di concederti il ruolo IAM Storage Admin (roles/storage.admin) nel bucket per cui vuoi creare le cache.
Questo ruolo predefinito contiene le autorizzazioni necessarie per creare e gestire le cache di Rapid Cache. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per creare e gestire le cache di Rapid Cache sono necessarie le seguenti autorizzazioni:
-
storage.anywhereCaches.create(obbligatorio per la creazione di cache) -
storage.anywhereCaches.disable(obbligatorio per la disattivazione delle cache) -
storage.anywhereCaches.get(obbligatorio per ottenere le cache) -
storage.anywhereCaches.list(obbligatorio per elencare le cache) -
storage.anywhereCaches.resume(obbligatorio per riprendere le cache) -
storage.anywhereCaches.update(obbligatorio per l'aggiornamento delle cache) -
storage.managedFolders.create(obbligatorio solo per abilitare il comportamento di importazione in scrittura per una cache) -
storage.managedFolders.update(obbligatorio solo per aggiornare il comportamento di importazione in scrittura di una cache)
Puoi anche ottenere queste autorizzazioni con ruoli personalizzati.
Per informazioni sulla concessione di ruoli sui bucket, consulta Imposta e gestisci le policy IAM sui bucket.
Per gestire le operazioni a lunga esecuzione avviate dai metodi Rapid Cache, potresti aver bisogno di ruoli e autorizzazioni aggiuntivi. Per saperne di più, consulta Ruoli richiesti per le operazioni a lunga esecuzione.
Informazioni sulle impostazioni di importazione in scrittura
Quando crei o aggiorni una cache, puoi facoltativamente abilitarla per importare i dati nel momento in cui vengono scritti nel bucket. Questa funzionalità è nota come "ingestione in scrittura". Se prevedi di attivare l'importazione in scrittura utilizzando l'API JSON, ti consigliamo di comprendere innanzitutto i comportamenti delle impostazioni configurate utilizzate per l'importazione in scrittura.
Crea una cache
Console
Crea una cache per un bucket esistente
- Nella console Cloud de Confiance , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket per cui vuoi memorizzare i dati nella cache.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Nella sezione Rapid Cache, fai clic su Configura cache.
Viene visualizzata la pagina Configura cache per il tuo bucket.
Nella sezione Regioni cache, fai clic sulla regione che contiene le zone in cui vuoi creare una cache.
Nella sezione Zone cache, seleziona le zone in cui vuoi creare una cache. Per ogni cache creata in una zona, facoltativamente completa i seguenti passaggi:
(Facoltativo) Puoi impostare una durata (TTL) personalizzata che determina quando i dati vengono rimossi dalla cache dall'ultima lettura. Per impostazione predefinita, il TTL di una cache è impostato su un giorno.
Per impostare un TTL personalizzato:
Nella colonna Durata, specifica un valore di durata (ad esempio:
48) e un'unità di tempo (ad esempio:hours).Fai clic su Save configuration (Salva configurazione).
(Facoltativo) Puoi abilitare la cache per l'importazione dei dati in scrittura, oltre che per l'importazione dei dati alla prima lettura. Per impostazione predefinita, le cache sono configurate solo per l'importazione dei dati alla prima lettura.
Per consentire alla cache di importare i dati in scrittura:
Nella colonna Criteri di importazione, fai clic su Modifica criteri di importazione della cache edit.
Viene visualizzata la pagina Imposta criteri di importazione.
Seleziona la casella di controllo Importa i dati alla scrittura.
Per abilitare l'importazione in scrittura per tutti gli oggetti appena scritti nel bucket, fai clic su Intero bucket.
Per attivare l'importazione in scrittura solo per gli oggetti appena scritti che hanno un prefisso specifico nel nome, fai clic su Cartelle selezionate, quindi inserisci il prefisso del nome dell'oggetto. Il prefisso del nome dell'oggetto viene anche chiamato "percorso della cartella".
Puoi inserire più prefissi dei nomi degli oggetti facendo clic su Aggiungi add.
Per rimuovere un prefisso, fai clic su Elimina elemento delete.
Fai clic su Fine.
Fai clic su Save configuration (Salva configurazione).
Nella finestra di dialogo visualizzata, fai clic su Conferma.
Si apre la scheda Operazioni nella pagina Dettagli bucket, che mostra lo stato del job dell'operazione di creazione della cache.
Crea una cache per un nuovo bucket
Per creare una cache nell'ambito della creazione di un nuovo bucket, segui le istruzioni riportate in Crea un nuovo bucket.
Per visualizzare lo stato della cache di un bucket dalla pagina Elenco bucket:
- Nella console Cloud de Confiance , vai alla pagina Bucket in Cloud Storage.
Fai clic sull'icona Visualizza colonna (), seleziona Cache e poi fai clic su Ok.
Riga di comando
Utilizza il comando gcloud storage buckets anywhere-caches create:
gcloud storage buckets anywhere-caches create gs://BUCKET_NAME CACHE_ZONE \ [--ttl=TTL] [--enable-ingest-on-write]
Sostituisci:
BUCKET_NAMEcon il nome del bucket per cui vuoi memorizzare i dati nella cache. Ad esempio,my-bucket.CACHE_ZONEcon la zona in cui verrà eseguita la cache. Ad esempio,us-east1-b.Per creare più cache contemporaneamente, puoi specificare più zone. Ad esempio,
us-east1-b us-east1-c us-east1-d.TTL(facoltativo) con la durata (TTL) dei dati nella cache. Il valore può essere compreso tra 1 e 7 giorni (inclusi). Il valore può essere espresso in secondi, minuti, ore e giorni. Ad esempio:86400sper 86.400 secondi1440mper 1440 minuti24hper 24 ore1dper 1 giorno
Se non specificato, il valore predefinito è
86400s(1 giorno).
Per configurare la cache in modo che acquisisca i dati nel momento in cui vengono scritti nel bucket, specifica il flag facoltativo --enable-ingest-on-write. Questo flag consente alla cache di importare tutti gli oggetti quando vengono scritti nel bucket.
In caso di esito positivo, il comando restituisce l'ID dell'operazione a lunga esecuzione associata all'operazione di creazione di AnywhereCache. Puoi ottenere i dettagli dell'operazione a lunga esecuzione o annullarla per interrompere l'operazione di creazione di AnywhereCaches prima che venga completata.
Librerie client
C++
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Rust
Terraform
Consulta la documentazione di Terraform per google_storage_anywhere_cache per informazioni dettagliate su come utilizzare Rapid Cache con Terraform.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, che ti consente di generare un token di accesso per l'intestazione
Authorization.Crea un file JSON che contenga le seguenti informazioni:
{ "zone": "ZONE", "ttl": "TIME_TO_LIVE", "ingestOnWrite": INGEST_SETTING }Sostituisci:
ZONEcon la zona in cui verrà eseguita la cache. Ad esempio,us-east1-b.TIME_TO_LIVEcon la durata (TTL) dei dati nella cache. Il valore deve essere espresso in secondi (ad esempio:172800sper 172.800 secondi, che equivalgono a 2 giorni).Il valore minimo è
86400s(1 giorno) e il valore massimo è604800s(7 giorni). Se non specificato, il valore predefinito è86400s.INGEST_SETTINGcontrueofalseper specificare se la cache importerà o meno i dati in scrittura.Se impostato su
true, l'importazione in scrittura è abilitata per tutti gli oggetti scritti nel bucket. Se impostato sufalse, l'importazione in scrittura può essere attivata in modo selettivo per gli oggetti scritti con un prefisso o può essere disattivata per l'intero bucket.Per scoprire le impostazioni utilizzate per configurare l'attivazione dell'importazione in scrittura, consulta i requisiti per l'attivazione dell'importazione in scrittura.
Per attivare l'importazione in scrittura a livello di bucket o di prefisso oppure per disattivare completamente l'importazione in scrittura, utilizza uno dei seguenti insiemi di istruzioni.
Abilita l'importazione in scrittura per il bucket
Per attivare l'importazione in scrittura per tutti gli oggetti scritti nel bucket, imposta il valore di
INGEST_SETTINGSsutrue.Completa la richiesta di cache seguendo il passaggio 3.
Abilita l'importazione in scrittura in modo selettivo per gli oggetti con un prefisso
Imposta il valore di
INGEST_SETTINGSsufalse.Completa la richiesta di cache seguendo il passaggio 3.
Crea una cartella gestita che utilizzi il prefisso come nome, se la cartella gestita non esiste già.
Invia una richiesta
PATCHper una cartella gestita che includa una configurazionerapidCacheConfig. Imposta i valori dei campi nella configurazione seguendo le indicazioni riportate in Informazioni su come utilizzare l'importazione in scrittura.
Per istruzioni dettagliate su come utilizzare una configurazione
rapidCacheConfig, consulta Aggiorna l'importazione in scrittura in una cartella gestita.Crea una cache senza attivare l'importazione in scrittura
Imposta il valore di
INGEST_SETTINGSsufalse.Completa la richiesta di cache seguendo il passaggio 3.
Utilizza
cURLper chiamare l'API JSON con una richiesta di creazione di una cache:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/anywhereCaches"Sostituisci:
JSON_FILE_NAMEcon il nome del file JSON che hai creato nel passaggio 2.BUCKET_NAMEcon il nome del bucket per cui vuoi memorizzare i dati nella cache. Ad esempio,my-bucket.
Se l'operazione ha esito positivo, restituisce un google.longrunning.Operation.
Puoi ottenere dettagli sull'operazione a lunga esecuzione o annullarla per interrompere l'operazione di creazione di AnywhereCache prima che venga completata.
Visualizza una cache
Console
- Nella console Cloud de Confiance , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket associato alla cache che vuoi visualizzare.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Nella sezione Rapid Cache, fai clic su Modifica accanto al campo Cache.
Nella pagina Modifica configurazione visualizzata, seleziona una regione per visualizzare tutte le cache all'interno delle zone della regione.
Nel riquadro Zone cache, puoi visualizzare i dettagli di ogni cache disponibile.
Riga di comando
Utilizza il comando gcloud storage buckets anywhere-caches describe:
gcloud storage buckets anywhere-caches describe CACHE_ID
Sostituisci:
CACHE_IDcon l'identificatore dell'istanza della cache, formulato comeBUCKET_NAME/CACHE_ZONE. Ad esempio,my-bucket/us-east1-b.
Utilizza il flag facoltativo raw per generare una risposta dell'API non elaborata anziché una risposta dell'API standardizzata.
In caso di esito positivo, il comando restituisce una risorsa AnywhereCache.
Librerie client
C++
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Rust
Terraform
Consulta la documentazione di Terraform per google_storage_anywhere_cache per informazioni dettagliate su come utilizzare Rapid Cache con Terraform.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, che ti consente di generare un token di accesso per l'intestazione
Authorization.Utilizza
cURLper chiamare l'API JSON con una richiesta per ottenere una cache:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_CACHE_ID"
Sostituisci:
BUCKET_NAMEcon il nome del bucket associato alla cache che vuoi recuperare. Ad esempio,my-bucket.RAPID_CACHE_IDcon la zona in cui si trova la cache. Ad esempio,us-east1-b.
Se l'operazione ha esito positivo, restituisce una risorsa AnywhereCache.
Elenca le cache
Console
- Nella console Cloud de Confiance , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket associato alle cache che vuoi visualizzare.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Nella sezione Rapid Cache, fai clic su Modifica accanto al campo Cache.
Nella pagina Modifica configurazione visualizzata, seleziona una regione per visualizzare tutte le cache all'interno delle zone della regione.
Tutte le cache disponibili per le zone all'interno della regione vengono visualizzate nel riquadro Zone cache.
Riga di comando
Utilizza il comando gcloud storage buckets anywhere-caches list:
gcloud storage buckets anywhere-caches list gs://BUCKET_NAME
Sostituisci:
BUCKET_NAMEcon il nome del bucket associato alle cache che vuoi elencare. Ad esempio,my-bucket.
In caso di esito positivo, il comando restituisce un elenco di risorse AnywhereCache.
Facoltativamente, puoi utilizzare il flag --raw per restituire una risposta dell'API non elaborata anziché una risposta standardizzata. Per saperne di più sul controllo dei comportamenti di elenco, ad esempio l'impaginazione dei risultati, consulta la documentazione di gcloud storage ls.
Librerie client
C++
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Rust
Terraform
Consulta la documentazione di Terraform per google_storage_anywhere_cache per informazioni dettagliate su come utilizzare Rapid Cache con Terraform.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, che ti consente di generare un token di accesso per l'intestazione
Authorization.Utilizza
cURLper chiamare l'API JSON con una richiesta di elenco delle cache:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/anywhereCaches"
Sostituisci:
BUCKET_NAMEcon il nome del bucket associato alle cache che vuoi recuperare. Ad esempio,my-bucket.
Quando elenchi più cache, puoi impaginare i risultati.
Se l'operazione ha esito positivo, restituisce un elenco di risorse AnywhereCache. Per i dettagli sulla struttura di questa risposta, consulta la risposta nella documentazione di AnywhereCaches List.
Aggiorna una cache
Console
- Nella console Cloud de Confiance , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket associato alla cache che vuoi aggiornare.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Nella sezione Rapid Cache, fai clic su Gestisci cache.
Nel riquadro Gestisci cache, fai clic su Modifica o crea cache.
Nella pagina Modifica configurazione visualizzata, aggiorna le proprietà della cache:
Per aggiornare il TTL della cache, individua la colonna Durata (TTL), quindi specifica una durata e seleziona un'unità di tempo (ad esempio, minuti).
Per configurare il comportamento di importazione in scrittura della cache, incluso se tutti gli oggetti scritti vengono memorizzati nella cache o se vengono memorizzati nella cache solo oggetti selettivi scritti con un prefisso:
Individua la colonna Criteri di importazione, quindi fai clic su Modifica i criteri di importazione della cache.
Nel riquadro Imposta criteri di importazione:
Per attivare o disattivare l'importazione in scrittura, seleziona o deseleziona la casella di controllo Importa i dati in scrittura, quindi fai clic su Fine.
Per aggiornare la cache in modo da importare tutti gli oggetti nel bucket in fase di scrittura, assicurati che la casella di controllo Importa i dati in fase di scrittura sia selezionata, quindi seleziona Intero bucket. Poi fai clic su Fine.
Per aggiornare la cache in modo che importi solo gli oggetti che contengono un prefisso specificato nel nome, assicurati che la casella di controllo Importa i dati in scrittura sia selezionata, quindi seleziona Cartelle selezionate.
Per specificare un prefisso, inserisci uno o più prefissi nel campo del percorso della cartella, quindi fai clic su Fine.
Per rimuovere un prefisso, fai clic su Elimina elemento accanto al prefisso.
Nella pagina Modifica configurazione, fai clic su Salva.
Nella finestra di dialogo visualizzata, fai clic su Conferma.
Riga di comando
Utilizza il comando gcloud storage buckets anywhere-caches update:
gcloud storage buckets anywhere-caches update CACHE_ID \ [--ttl=TTL] [--[no-]enable-ingest-on-write]
Sostituisci:
CACHE_IDcon l'identificatore dell'istanza della cache, formulato comeBUCKET_NAME/CACHE_ZONE. Ad esempio,my-bucket/us-east1-b.Per aggiornare più cache contemporaneamente, puoi specificare più identificatori. Ad esempio,
my-bucket/us-east1-b my-bucket/us-east1-c.TTL(facoltativo) con la durata (TTL) dei dati nella cache. Il valore può essere compreso tra 1 e 7 giorni (inclusi). Il valore può essere espresso in secondi, minuti, ore e giorni. Ad esempio:86400sper 86.400 secondi1440mper 1440 minuti24hper 24 ore1dper 1 giorno
Per configurare la cache in modo che acquisisca i dati nel momento in cui vengono scritti nel bucket, specifica il flag --enable-ingest-on-write. Questo flag consente alla cache di importare tutti gli oggetti quando vengono scritti nel bucket. Per impedire alla cache di importare dati in scrittura, specifica il flag --no-enable-ingest-on-write.
In caso di esito positivo, il comando restituisce l'ID dell'operazione non elaborata a lunga esecuzione associata all'operazione di aggiornamento di AnywhereCache. Puoi visualizzare i dettagli dell'operazione a lunga esecuzione.
Librerie client
C++
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Rust
Terraform
Consulta la documentazione di Terraform per google_storage_anywhere_cache per informazioni dettagliate su come utilizzare Rapid Cache con Terraform.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, che ti consente di generare un token di accesso per l'intestazione
Authorization.Crea un file JSON che includa le modifiche alle proprietà della cache che vuoi aggiornare.
{ "ttl": "TIME_TO_LIVE", "ingestOnWrite": INGEST_SETTING }Sostituisci:
TIME_TO_LIVEcon il TTL dei dati nella cache. Il valore può essere compreso tra 1 e 7 giorni (inclusi). Il valore può essere espresso in secondi, minuti, ore e giorni. Ad esempio:86400sper 86.400 secondi1440mper 1440 minuti24hper 24 ore1dper 1 giorno
INGEST_SETTINGcontrueofalseper specificare se la cache importa o meno i dati in scrittura.Se impostato su
true, l'importazione in scrittura è abilitata per tutti gli oggetti scritti nel bucket. Se impostato sufalse, l'importazione in scrittura può essere attivata in modo selettivo per gli oggetti scritti con un prefisso o può essere disattivata completamente.Per scoprire le impostazioni utilizzate per configurare l'attivazione dell'importazione in scrittura a livello di bucket o prefisso, consulta Informazioni su come attivare l'importazione in scrittura.
Per attivare l'importazione in scrittura a livello di bucket o di prefisso oppure per disattivare completamente l'importazione in scrittura, utilizza uno dei seguenti insiemi di istruzioni.
Abilita l'importazione in scrittura per il bucket
Per attivare l'importazione in scrittura per tutti gli oggetti scritti nel bucket, imposta il valore di
INGEST_SETTINGSsutrue.Completa la richiesta di cache seguendo il passaggio 3.
Se l'importazione in scrittura era stata precedentemente attivata per un prefisso, esiste una cartella gestita con una configurazione
rapidCacheConfig. Invia una richiestaPATCHper una cartella gestita che imposta la mappapoliciesnella configurazionerapidCacheConfigsunull.
Per istruzioni dettagliate su come utilizzare una configurazione
rapidCacheConfig, consulta Aggiorna l'importazione in scrittura in una cartella gestita.Abilita l'importazione in scrittura in modo selettivo per gli oggetti con un prefisso
Imposta il valore di
INGEST_SETTINGSsufalse.Completa la richiesta di cache seguendo il passaggio 3.
Crea una cartella gestita che utilizzi il prefisso come nome, se la cartella gestita non esiste già.
Invia una richiesta
PATCHper una cartella gestita che includa una configurazionerapidCacheConfig. Imposta i valori dei campi nella configurazione utilizzando le indicazioni riportate in Impostazioni e comportamenti di importazione in scrittura.
La mappa
policiesdi una configurazionerapidCacheConfigpuò contenere uno o più ID cache (ad esempious-east1-aeus-east1-b). Per abilitare l'importazione in scrittura per determinate cache, imposta l'impostazioneingestOnWritedella singola cache suenabled. Per disattivare l'importazione in scrittura per determinate cache, imposta l'impostazioneingestOnWritedella singola cache suunspecified. Leggi attentamente la sezione sull'ereditarietà dell'importazione in scrittura per capire in che modo la policy di importazione in scrittura di una cache può essere influenzata quando l'impostazioneingestOnWriteper la cache è impostata suunspecified.Per istruzioni dettagliate su come utilizzare una configurazione
rapidCacheConfig, consulta Aggiorna l'importazione in scrittura in una cartella gestita.Disabilita l'importazione in scrittura
Imposta il valore di
INGEST_SETTINGSsufalse. Questa impostazione disattiva l'importazione in scrittura a livello di bucket.Completa la richiesta di cache seguendo il passaggio 3.
Per disattivare l'importazione in scrittura a livello di prefisso, individua la cartella gestita in cui è configurata l'importazione in scrittura a livello di prefisso. Invia una richiesta
PATCHper la cartella gestita che imposta la mappapoliciesnella configurazionerapidCacheConfigsunull. In alternativa, elimina la configurazionerapidCacheConfigdalla risorsa della cartella gestita in una richiestaPATCH.
Per istruzioni dettagliate su come utilizzare una configurazione
rapidCacheConfig, consulta Aggiorna l'importazione in scrittura in una cartella gestita.
L'esempio seguente aggiorna il TTL della cache a 2 giorni e attiva l'importazione in scrittura per tutti gli oggetti scritti nel bucket:
{ "ttl": "172800s", "ingestOnWrite": true }-
curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_CACHE_ID"Sostituisci:
JSON_FILE_NAMEcon il nome del file JSON che hai creato nel passaggio 2.BUCKET_NAMEcon il nome del bucket associato alla cache che vuoi aggiornare. Ad esempio,my-bucket.RAPID_CACHE_IDcon l'identificatore della cache. Ad esempio,us-east1-b.
Se l'operazione ha esito positivo, restituisce un google.longrunning.Operation.
Puoi visualizzare i dettagli dell'operazione a lunga esecuzione.
Riprendi una cache
Console
Per riprendere una cache che è stata messa in pausa o disattivata, completa le seguenti istruzioni:
- Nella console Cloud de Confiance , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket associato alla cache che vuoi riprendere.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Nella sezione Rapid Cache, fai clic su Gestisci cache.
Nel riquadro Gestisci cache, fai clic sull'icona Riprendi cache ().
Fai clic su Chiudi.
Riga di comando
Utilizza il comando gcloud storage buckets anywhere-caches resume:
gcloud storage buckets anywhere-caches resume CACHE_ID
Sostituisci:
CACHE_IDcon l'identificatore dell'istanza della cache, formulato comeBUCKET_NAME/CACHE_ZONE. Ad esempio,my-bucket/us-east1-b.Per riprendere più cache contemporaneamente, puoi specificare più identificatori. Ad esempio,
my-bucket/us-east1-b my-bucket/us-east1-c.
In caso di esito positivo, il comando restituisce una risorsa AnywhereCache formattata.
Librerie client
C++
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Rust
Terraform
Consulta la documentazione di Terraform per google_storage_anywhere_cache per informazioni dettagliate su come utilizzare Rapid Cache con Terraform.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, che ti consente di generare un token di accesso per l'intestazione
Authorization.Utilizza
cURLper chiamare l'API JSON con una richiesta di ripristino di una cache:curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_CACHE_ID/resume"
Sostituisci:
BUCKET_NAMEcon il nome del bucket associato alla cache che vuoi riprendere. Ad esempio,my-bucket.RAPID_CACHE_IDcon l'identificatore della cache. Ad esempio,us-east1-b.
Se l'operazione ha esito positivo, restituisce una risorsa AnywhereCache formattata.
Disabilita una cache
Console
- Nella console Cloud de Confiance , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket associato alla cache che vuoi disattivare.
Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.
Nella sezione Rapid Cache, fai clic su Gestisci cache.
Nel riquadro Gestisci cache, fai clic sull'icona Disattiva cache ().
Nella finestra di dialogo visualizzata, fai clic su Conferma.
Fai clic su Chiudi.
Riga di comando
Utilizza il comando gcloud storage buckets anywhere-caches disable:
gcloud storage buckets anywhere-caches disable CACHE_ID
Sostituisci:
CACHE_IDcon l'identificatore dell'istanza della cache, formulato comeBUCKET_NAME/CACHE_ZONE. Ad esempio,my-bucket/us-east1-b.Per disattivare più cache contemporaneamente, puoi specificare più identificatori. Ad esempio,
my-bucket/us-east1-b my-bucket/us-east1-c.
In caso di esito positivo, il comando restituisce una risorsa AnywhereCache formattata.
Librerie client
C++
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage C++.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Cloud Storage Java.
Per eseguire l'autenticazione in Cloud Storage, configura le Credenziali predefinite dell'applicazione. Per saperne di più, vedi Configura l'autenticazione per le librerie client.
Prima di eseguire gli esempi di codice, imposta la variabile di ambiente
GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.
Rust
Terraform
Consulta la documentazione di Terraform per google_storage_anywhere_cache per informazioni dettagliate su come utilizzare Rapid Cache con Terraform.
API REST
API JSON
Avere gcloud CLI installato e inizializzato, che ti consente di generare un token di accesso per l'intestazione
Authorization.Utilizza
cURLper chiamare l'API JSON con una richiesta di disattivazione di una cache:curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.s3nsapis.fr/storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_CACHE_ID/disable"
Sostituisci:
BUCKET_NAMEcon il nome del bucket associato alla cache che vuoi disattivare. Ad esempio,my-bucket.RAPID_CACHE_IDcon l'identificatore della cache. Ad esempio,us-east1-b.
In caso di esito positivo, il comando restituisce una risorsa AnywhereCache formattata.
Monitora le prestazioni della cache
La sezione Cloud Storage della console Cloud de Confiance fornisce grafici di monitoraggio che ti consentono di monitorare le prestazioni delle tue cache utilizzando le metriche. Questi grafici di monitoraggio possono essere visualizzati anche utilizzando Cloud Monitoring.
Grafici disponibili
| Grafico | Livello della gerarchia delle risorse | Descrizione |
|---|---|---|
| Tasso di eliminazione dei byte | Bucket | La frequenza dei byte eliminati dalla cache, campionata ogni ora. Questi dati vengono aggiornati più di una volta all'ora per consentire il tempo necessario per la post-elaborazione dei dati. |
| Tasso di eliminazione dei byte | Progetto | La frequenza dei byte eliminati da tutte le cache di un bucket, campionata ogni ora. Questi dati vengono aggiornati più di una volta all'ora per consentire il tempo necessario per la post-elaborazione dei dati. |
| Byte nella cache | Bucket | Il numero di byte nella cache, campionati ogni ora. Questi dati vengono aggiornati più di una volta all'ora per consentire il tempo necessario per la post-elaborazione dei dati. |
| Byte nella cache | Progetto | Il numero di byte in tutte le cache di un bucket, campionati ogni ora. Questi dati vengono aggiornati più di una volta all'ora per consentire il tempo necessario per la post-elaborazione dei dati. |
| Vantaggio del throughput della cache | Progetto | La frequenza della quota di larghezza di banda per il trasferimento di dati per la regione, a due regioni o multiregione, l'utilizzo della quota e il throughput aggiuntivo erogato dalla cache. Il throughput aggiuntivo fornito dalla cache non viene conteggiato ai fini della quota, pertanto l'utilizzo della cache abilita i progetti a superare il throughput consentito dalla quota. |
| Operazioni di % successi della cache | Bucket | La percentuale di operazioni di cache che pubblicano i dati richiesti dalla cache in relazione al totale delle operazioni idonee della cache, campionata ogni 60 secondi. Se una lettura viene restituita completamente dalla cache, l'operazione viene conteggiata come hit. Se la lettura non viene restituita dalla cache o viene restituita solo parzialmente, l'operazione viene conteggiata come una fallimento della cache. |
| Operazioni di % successi della cache | Progetto | La percentuale di operazioni di cache che pubblicano i dati richiesti da tutte le cache per un bucket in relazione al totale delle operazioni idonee della cache, campionate ogni 60 secondi. Se una lettura viene restituita completamente dalla cache, l'operazione viene conteggiata come hit. Se la lettura non viene restituita dalla cache o viene restituita solo parzialmente, l'operazione viene conteggiata come una fallimento della cache. |
| Byte % successi della cache | Bucket | La percentuale di byte erogati dalla cache rispetto al totale dei byte idonei per la cache, con campionamento ogni 60 secondi. |
| Byte % successi della cache | Progetto | La percentuale di byte erogati da tutte le cache per un bucket in relazione al totale dei byte idonei per la cache, con campionamento ogni 60 secondi. |
| Byte non elaborati della frequenza di importazione | Bucket | La frequenza di byte non elaborati importati in ogni cache, con campionamento ogni 60 secondi. Tutti i byte importati, inclusi quelli non fatturabili, vengono utilizzati per calcolare il valore di questa metrica. Questa metrica viene registrata in tempo reale. |
| Byte non elaborati della frequenza di importazione | Progetto | La frequenza di byte non elaborati importati in tutte le cache di un bucket, con campionamento ogni 60 secondi. Tutti i byte importati, inclusi quelli non fatturabili, vengono utilizzati per calcolare il valore di questa metrica. Questa metrica viene registrata in tempo reale. |
| Throughput - Successo della cache | Bucket | Il throughput erogato dalla cache, con campionamento ogni 60 secondi. |
| Throughput - Successo della cache | Progetto | Il throughput erogato da tutte le cache per un bucket, con campionamento ogni 60 secondi. |
| Throughput - Fallimento della cache | Bucket | Il throughput non fornito dalla cache, con campionamento ogni 60 secondi. |
| Throughput - Fallimento della cache | Progetto | Il throughput non erogato da nessuna delle cache di un bucket, con campionamento ogni 60 secondi. |
Accedi ai grafici
I grafici di monitoraggio acquisiscono i dati per singoli bucket o per tutti i bucket all'interno di un progetto. Il livello della gerarchia delle risorse acquisito da un grafico determina dove puoi accedere al grafico.
Accedi ai grafici a livello di bucket
- Nella console Cloud de Confiance , vai alla pagina Bucket in Cloud Storage.
Nell'elenco dei bucket, fai clic sul nome del bucket per cui vuoi visualizzare i grafici di monitoraggio.
Nella pagina Dettagli bucket, fai clic sulla scheda Osservabilità.
Nel menu di navigazione, seleziona Rapid Cache.
Vengono visualizzati i grafici di monitoraggio.
Accedi ai grafici a livello di progetto
- Nella console Cloud de Confiance , vai alla pagina Bucket in Cloud Storage.
Nel riquadro di navigazione di Cloud Storage, fai clic su Monitoring.
Nella barra dei menu, fai clic su Rapid Cache.
Vengono visualizzati i grafici di monitoraggio.
Utilizza operazioni a lunga esecuzione
Se eseguite correttamente, le operazioni AnywhereCaches Create e Update avviano un'operazione a lunga esecuzione. Puoi ottenere ed elencare le operazioni a lunga esecuzione per visualizzare i dettagli e lo stato dell'operazione AnywhereCaches sottostante o annullare un'operazione a lunga esecuzione per annullare l'operazione AnywhereCaches sottostante mentre è in corso.
Per istruzioni sull'utilizzo delle operazioni a lunga esecuzione per Rapid Cache, consulta Utilizza le operazioni a lunga esecuzione.
L'esempio seguente mostra un'operazione a lunga esecuzione avviata da un'operazione di creazione di AnywhereCaches:
done: false kind: storage#operation metadata: '@type': type.googleapis.com/google.storage.control.v2.CreateAnywhereCacheMetadata anywhereCacheId: us-central1-c zone: us-central1-c ttl: 172800s commonMetadata: createTime: '2023-12-14T20:52:00.032Z' progressPercent: -1 requestedCancellation: false type: create-anywhere-cache updateTime: '2023-12-14T20:52:00.032Z' name: projects/_/buckets/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig selfLink: https://www.googleapis.com/storage/v1/b/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig
Nuovi tentativi
Le API AnywhereCache asincrone sono idempotenti per impostazione predefinita. Ciò significa che puoi riprovare in sicurezza le chiamate API AnywhereCaches asincrone senza preoccuparti di modificare involontariamente le risorse.
Ad esempio, supponiamo che tu esegua un'operazione di creazione di AnywhereCache per creare una cache in us-central1-a e che l'operazione vada a buon fine. Se esegui una successiva operazione di creazione di AnywhereCache utilizzando la stessa zona, la richiesta restituisce la stessa operazione a lunga esecuzione della richiesta precedente. Tieni presente che questo comportamento si verifica solo se includi un request_id nella richiesta di creazione della cache. Se non è incluso un request_id, ricevi un errore ANYWHERE_CACHE_ALREADY_EXISTS quando tenti di creare una cache già esistente. Per informazioni su come includere un request_id, consulta Identificazione della richiesta.
Passaggi successivi
Ricevi suggerimenti su quali bucket e zone creare una cache.