Creare e gestire cache con Rapid Cache

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 il rendimento delle tue applicazioni accelerando il recupero dei dati.

Questa pagina mostra come creare e gestire le istanze della cache con Rapid Cache. Per informazioni su come utilizzare e gestire le operazioni a lunga esecuzione avviate da Rapid Cache operazioni di cache asincrone, consulta Utilizzare le operazioni a lunga esecuzione.

Prima di utilizzare Rapid Cache, consulta le limitazioni e le restrizioni.

Prima di iniziare

Prima di iniziare a creare e gestire le cache, completa le sezioni seguenti.

Ottenere i ruoli richiesti

Per ottenere le autorizzazioni necessarie per creare e gestire le cache Rapid Cache, chiedi all'amministratore di concederti il ruolo IAM Storage Admin (roles/storage.admin) sul bucket per cui vuoi creare le cache.

Questo ruolo predefinito contiene le autorizzazioni necessarie per creare e gestire le cache Rapid Cache. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per creare e gestire le cache Rapid Cache sono necessarie le seguenti autorizzazioni:

  • storage.anywhereCaches.create (obbligatorio per la creazione di cache)
  • storage.anywhereCaches.disable (necessario per disattivare le cache)
  • storage.anywhereCaches.get (obbligatorio per ottenere le cache)
  • storage.anywhereCaches.list (obbligatorio per le cache delle schede)
  • storage.anywhereCaches.resume (obbligatorio per riprendere le cache)
  • storage.anywhereCaches.update (obbligatorio per l'aggiornamento delle cache)
  • storage.managedFolders.create (richiesto solo per abilitare il comportamento di inserimento durante la scrittura per una cache)
  • storage.managedFolders.update (richiesto solo per aggiornare il comportamento di inserimento durante la scrittura di una cache)

Puoi anche ottenere queste autorizzazioni con ruoli personalizzati.

Per informazioni sulla concessione dei ruoli sui bucket, consulta Impostare e gestire 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 durante la scrittura

Quando crei o aggiorni una cache, puoi facoltativamente abilitare la cache per importare i dati nel momento in cui vengono scritti nel bucket. Questa funzionalità è nota come "ingest-on-write". Se prevedi di attivare l'importazione durante la scrittura utilizzando l'API JSON, ti consigliamo di comprendere prima i comportamenti delle impostazioni configurate utilizzate per l'importazione durante la scrittura.

Creare una cache

Console

Crea una cache per un bucket esistente

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

    Vai a Bucket

  2. Nell'elenco dei bucket, fai clic sul nome del bucket per cui vuoi memorizzare i dati nella cache.

  3. Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.

  4. Nella sezione Rapid Cache, fai clic su Configura cache.

    Viene visualizzata la pagina Configura cache per il bucket.

  5. Nella sezione Regioni cache, fai clic sulla regione che contiene le zone in cui vuoi creare una cache.

  6. Nella sezione Zone di cache, seleziona le zone in cui vuoi creare una cache. Per ogni cache creata in una zona, completa facoltativamente 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:

      1. Nella colonna Durata, specifica un valore di durata (ad esempio: 48) e un'unità di tempo (ad esempio: hours).

      2. Fai clic su Save configuration (Salva configurazione).

    • (Facoltativo) Puoi abilitare la cache per importare i dati in scrittura oltre a importarli alla prima lettura. Per impostazione predefinita, le cache sono configurate solo per importare i dati alla prima lettura.

      Per consentire alla cache di importare i dati in scrittura:

      1. Nella colonna Criteri di importazione, fai clic su Modifica criteri di importazione della cache Modifica.

        Viene visualizzata la pagina Imposta criteri di importazione.

      2. Seleziona la casella di controllo Importa i dati alla scrittura.

        • Per attivare l'importazione durante la 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 è chiamato anche "percorso della cartella".

        Puoi inserire più prefissi del nome dell'oggetto facendo clic su Aggiungi Aggiungi.

        Per rimuovere un prefisso, fai clic su Elimina elemento Elimina.

      3. Fai clic su Fine.

  7. Fai clic su Save configuration (Salva configurazione).

  8. 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 durante la creazione di un nuovo bucket, segui le istruzioni in Crea un nuovo bucket.

Per visualizzare lo stato della cache di un bucket dalla pagina Elenco bucket:

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

    Vai a Bucket

  2. 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_NAME con il nome del bucket per cui vuoi memorizzare i dati nella cache. Ad esempio, my-bucket.

  • CACHE_ZONE con 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:

    • 86400s per 86.400 secondi
    • 1440m per 1440 minuti
    • 24h per 24 ore
    • 1d per 1 giorno

    Se non specificato, il valore predefinito è 86400s (1 giorno).

Per configurare la cache in modo da importare 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 visualizzare i dettagli dell'operazione a lunga esecuzione o annullarla per interrompere l'operazione di creazione di AnywhereCache 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. 

namespace storagecontrol = google::cloud::storagecontrol_v2;
[](storagecontrol::StorageControlClient client,
   std::string const& bucket_name, std::string const& cache_name,
   std::string const& zone_name) {
  google::storage::control::v2::AnywhereCache cache;
  cache.set_name(cache_name);
  cache.set_zone(zone_name);

  google::storage::control::v2::CreateAnywhereCacheRequest request;
  request.set_parent(std::string{"projects/_/buckets/"} + bucket_name);
  *request.mutable_anywhere_cache() = cache;

  // Start a create operation and block until it completes. Real applications
  // may want to setup a callback, wait on a coroutine, or poll until it
  // completes.
  auto anywhere_cache = client.CreateAnywhereCache(request).get();
  if (!anywhere_cache) throw std::move(anywhere_cache).status();
  std::cout << "Created anywhere cache: " << anywhere_cache->name() << "\n";
}

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. 

import com.google.api.gax.longrunning.OperationFuture;
import com.google.storage.control.v2.AnywhereCache;
import com.google.storage.control.v2.BucketName;
import com.google.storage.control.v2.CreateAnywhereCacheMetadata;
import com.google.storage.control.v2.CreateAnywhereCacheRequest;
import com.google.storage.control.v2.StorageControlClient;
import java.io.IOException;
import java.util.concurrent.ExecutionException;

public final class AnywhereCacheCreate {

  public static void anywhereCacheCreate(String bucketName, String cacheName, String zoneName)
      throws InterruptedException, ExecutionException, IOException {
    try (StorageControlClient storageControl = StorageControlClient.create()) {

      CreateAnywhereCacheRequest request =
          CreateAnywhereCacheRequest.newBuilder()
              // Set project to "_" to signify globally scoped bucket
              .setParent(BucketName.format("_", bucketName))
              .setAnywhereCache(
                  AnywhereCache.newBuilder().setName(cacheName).setZone(zoneName).build())
              .build();

      // Start a long-running operation (LRO).
      OperationFuture<AnywhereCache, CreateAnywhereCacheMetadata> operation =
          storageControl.createAnywhereCacheAsync(request);

      // Await the LROs completion.
      AnywhereCache anywhereCache = operation.get();
      System.out.printf("Created anywhere cache: %s%n", anywhereCache.getName());
    }
  }
}

Rust

use google_cloud_lro::Poller;
use google_cloud_storage::client::StorageControl;
use google_cloud_storage::model::AnywhereCache;

pub async fn sample(client: &StorageControl, bucket_id: &str, zone: &str) -> anyhow::Result<()> {
    let cache = client
        .create_anywhere_cache()
        .set_parent(format!("projects/_/buckets/{bucket_id}"))
        .set_anywhere_cache(AnywhereCache::new().set_zone(zone).set_name(format!(
            "projects/_/buckets/{bucket_id}/anywhereCaches/{zone}"
        )))
        .poller()
        .until_done()
        .await?;
    println!("Created anywhere cache: {cache:?}");
    Ok(())
}

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

  1. Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione Authorization.

  2. Crea un file JSON contenente le seguenti informazioni:

    {
   "zone": "ZONE",
   "ttl": "TIME_TO_LIVE",
   "ingestOnWrite": INGEST_SETTING
}

    Sostituisci:

    • ZONE con la zona in cui verrà eseguita la cache. Ad esempio, us-east1-b.

    • TIME_TO_LIVE con la durata (TTL) dei dati nella cache. I valori possono essere espressi in secondi, minuti, ore e giorni. Ad esempio:

      • 86400s per 86.400 secondi
      • 1440m per 1440 minuti
      • 24h per 24 ore
      • 1d per 1 giorno

      Se non specificato, il valore predefinito è 86400s (1 giorno). Il valore massimo è 7 giorni.

    • INGEST_SETTING con true o false per specificare se la cache inserirà i dati in scrittura.

      Se impostato su true, l'importazione durante la scrittura è abilitata per tutti gli oggetti scritti nel bucket. Se impostato su false, l'importazione in scrittura può essere abilitata selettivamente per gli oggetti scritti con un prefisso oppure può essere disabilitata per l'intero bucket.

      Per informazioni sulle impostazioni utilizzate per configurare l'attivazione dell'importazione durante la scrittura, consulta i requisiti per l'attivazione dell'importazione durante la scrittura.

      Per attivare l'importazione durante la scrittura a livello di bucket o di prefisso oppure per disattivarla completamente, utilizza uno dei seguenti set di istruzioni.

      Attiva l'inserimento durante la scrittura per il bucket

      1. Per attivare l'importazione in scrittura per tutti gli oggetti scritti nel bucket, imposta il valore di INGEST_SETTINGS su true.

      2. Completa la richiesta di cache seguendo il passaggio 3.

      Attivare l'importazione durante la scrittura in modo selettivo per gli oggetti con un prefisso

      1. Imposta il valore di INGEST_SETTINGS su false.

      2. Completa la richiesta di cache seguendo il passaggio 3.

      3. Crea una cartella gestita che utilizza il prefisso come nome, se la cartella gestita non esiste già.

      4. Invia una richiesta PATCH di cartella gestita che includa una configurazione rapidCacheConfig. Imposta i valori dei campi nella configurazione seguendo le indicazioni riportate in Informazioni sull'utilizzo dell'importazione in scrittura.

      Per istruzioni dettagliate su come utilizzare una configurazione rapidCacheConfig, vedi Aggiornare l'inserimento durante la scrittura in una cartella gestita.

      Crea una cache senza attivare l'inserimento durante la scrittura

      1. Imposta il valore di INGEST_SETTINGS su false.

      2. Completa la richiesta di cache seguendo il passaggio 3.

  3. Utilizza cURL per 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.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches"

    Sostituisci:

    • JSON_FILE_NAME con il nome del file JSON che hai creato nel passaggio 2.

    • BUCKET_NAME con il nome del bucket per cui vuoi memorizzare i dati nella cache. Ad esempio, my-bucket.

Se l'operazione ha esito positivo, viene restituito un google.longrunning.Operation. Puoi visualizzare i dettagli dell'operazione a lunga esecuzione o annullarla per interrompere l'operazione di creazione di AnywhereCache prima che venga completata.

Visualizzare una cache

Console

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

    Vai a Bucket

  2. Nell'elenco dei bucket, fai clic sul nome del bucket associato alla cache che vuoi visualizzare.

  3. Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.

  4. Nella sezione Rapid Cache, fai clic su Modifica accanto al campo Cache.

  5. Nella pagina Modifica configurazione visualizzata, seleziona una regione per visualizzare tutte le cache all'interno delle zone della regione.

    Nel riquadro Zone di 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_ID con l'identificatore dell'istanza della cache, formulato come BUCKET_NAME/CACHE_ZONE. Ad esempio, my-bucket/us-east1-b.

Utilizza il flag facoltativo raw per restituire una risposta API non elaborata anziché una risposta 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. 

namespace storagecontrol = google::cloud::storagecontrol_v2;
[](storagecontrol::StorageControlClient client,
   std::string const& cache_name) {
  auto anywhere_cache = client.GetAnywhereCache(cache_name);
  if (!anywhere_cache) throw std::move(anywhere_cache).status();
  std::cout << "Got anywhere cache: " << anywhere_cache->name() << "\n";
}

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. 


import com.google.storage.control.v2.AnywhereCache;
import com.google.storage.control.v2.GetAnywhereCacheRequest;
import com.google.storage.control.v2.StorageControlClient;
import java.io.IOException;

public final class AnywhereCacheGet {

  public static void anywhereCacheGet(String cacheName) throws IOException {
    try (StorageControlClient storageControl = StorageControlClient.create()) {

      GetAnywhereCacheRequest request =
          GetAnywhereCacheRequest.newBuilder().setName(cacheName).build();

      AnywhereCache anywhereCache = storageControl.getAnywhereCache(request);

      System.out.printf("Got anywhere cache: %s%n", anywhereCache.getName());
    }
  }
}

Rust

use google_cloud_storage::client::StorageControl;

pub async fn sample(
    client: &StorageControl,
    bucket_id: &str,
    cache_id: &str,
) -> anyhow::Result<()> {
    let cache = client
        .get_anywhere_cache()
        .set_name(format!(
            "projects/_/buckets/{bucket_id}/anywhereCaches/{cache_id}"
        ))
        .send()
        .await?;
    println!("Got anywhere cache: {:?}", cache);
    Ok(())
}

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

  1. Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione Authorization.

  2. Utilizza cURL per chiamare l'API JSON con una richiesta per ottenere una cache:

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

    Sostituisci:

    • BUCKET_NAME con il nome del bucket associato alla cache che vuoi recuperare. Ad esempio, my-bucket.

    • RAPID_CACHE_ID con la zona in cui si trova la cache. Ad esempio, us-east1-b.

In caso di esito positivo, questa operazione restituisce una risorsa AnywhereCache.

Elenco delle cache

Console

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

    Vai a Bucket

  2. Nell'elenco dei bucket, fai clic sul nome del bucket associato alle cache che vuoi visualizzare.

  3. Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.

  4. Nella sezione Rapid Cache, fai clic su Modifica accanto al campo Cache.

  5. Nella pagina Modifica configurazione visualizzata, seleziona una regione per visualizzare tutte le cache all'interno delle zone di quella regione.

    Tutte le cache disponibili per le zone all'interno della regione vengono visualizzate nel riquadro Zone di cache.

Riga di comando

Utilizza il comando gcloud storage buckets anywhere-caches list:

gcloud storage buckets anywhere-caches list gs://BUCKET_NAME

Sostituisci:

  • BUCKET_NAME con 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.

Puoi utilizzare facoltativamente il flag --raw per restituire una risposta API non elaborata anziché una risposta standardizzata. Per saperne di più sul controllo dei comportamenti di elenco, ad esempio la paginazione 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. 

namespace storagecontrol = google::cloud::storagecontrol_v2;
[](storagecontrol::StorageControlClient client,
   std::string const& bucket_name) {
  auto const parent = std::string{"projects/_/buckets/"} + bucket_name;
  for (auto anywhere_cache : client.ListAnywhereCaches(parent)) {
    if (!anywhere_cache) throw std::move(anywhere_cache).status();
    std::cout << anywhere_cache->name() << "\n";
  }
}

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. 


import com.google.storage.control.v2.AnywhereCache;
import com.google.storage.control.v2.BucketName;
import com.google.storage.control.v2.ListAnywhereCachesRequest;
import com.google.storage.control.v2.StorageControlClient;
import com.google.storage.control.v2.StorageControlClient.ListAnywhereCachesPagedResponse;
import java.io.IOException;

public final class AnywhereCacheList {

  public static void anywhereCacheList(String bucketName) throws IOException {
    try (StorageControlClient storageControl = StorageControlClient.create()) {

      ListAnywhereCachesRequest request =
          ListAnywhereCachesRequest.newBuilder()
              .setParent(BucketName.format("_", bucketName))
              .build();

      ListAnywhereCachesPagedResponse page = storageControl.listAnywhereCaches(request);
      for (AnywhereCache anywhereCache : page.iterateAll()) {
        System.out.println(anywhereCache.getName());
      }
    }
  }
}

Rust

use google_cloud_gax::paginator::ItemPaginator;
use google_cloud_storage::client::StorageControl;

pub async fn sample(client: &StorageControl, bucket_id: &str) -> anyhow::Result<()> {
    let mut stream = client
        .list_anywhere_caches()
        .set_parent(format!("projects/_/buckets/{}", bucket_id))
        .by_item();
    while let Some(cache) = stream.next().await {
        println!("Found cache: {:?}", cache?);
    }
    Ok(())
}

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

  1. Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione Authorization.

  2. Utilizza cURL per chiamare l'API JSON con una richiesta di elenco delle cache:

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

    Sostituisci:

    • BUCKET_NAME con il nome del bucket associato alle cache che vuoi recuperare. Ad esempio, my-bucket.

    Quando elenchi più cache, puoi impaginare i risultati.

In caso di esito positivo, questa operazione restituisce un elenco di risorse AnywhereCache. Per informazioni dettagliate sulla struttura di questa risposta, consulta la risposta nella documentazione dell'elenco AnywhereCaches.

Aggiornare una cache

Console

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

    Vai a Bucket

  2. Nell'elenco dei bucket, fai clic sul nome del bucket associato alla cache da aggiornare.

  3. Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.

  4. Nella sezione Rapid Cache, fai clic su Gestisci cache.

  5. Nel riquadro Gestisci cache, fai clic su Modifica o crea cache.

  6. Nella pagina Modifica configurazione visualizzata, aggiorna le proprietà della cache:

    • Per aggiornare la durata (TTL) della cache, individua la colonna Durata, quindi specifica una durata e seleziona un'unità di tempo (ad esempio, minuti).

    • Per configurare il comportamento di inserimento durante la scrittura della cache, incluso se tutti gli oggetti scritti vengono memorizzati nella cache o solo gli oggetti selettivi scritti con un prefisso:

      1. Individua la colonna Criteri di importazione, quindi fai clic su Modifica criteri di importazione della cache.

      2. Nel riquadro Imposta criteri di importazione:

      • Per attivare o disattivare l'importazione durante la scrittura, seleziona o deseleziona la casella di controllo Importa dati durante la scrittura, poi fai clic su Fine.

      • Per aggiornare la cache in modo da importare tutti gli oggetti nel bucket durante la scrittura, assicurati che la casella di controllo Importa dati durante la scrittura sia selezionata, poi seleziona Intero bucket. Poi fai clic su Fine.

      • Per aggiornare la cache in modo da importare solo gli oggetti che contengono un prefisso specificato nel nome, assicurati che la casella di controllo Importa dati in scrittura sia selezionata, quindi seleziona Cartelle selezionate.

        • Per specificare un prefisso, inseriscine uno o più nel campo del percorso della cartella, quindi fai clic su Fine.

        • Per rimuovere un prefisso, fai clic su Elimina elemento accanto al prefisso.

  7. Nella pagina Modifica configurazione, fai clic su Salva.

  8. 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_ID con l'identificatore dell'istanza della cache, formulato come BUCKET_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:

    • 86400s per 86.400 secondi
    • 1440m per 1440 minuti
    • 24h per 24 ore
    • 1d per 1 giorno

Per configurare la cache in modo da importare 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 disattivare l'importazione di dati nella cache in scrittura, specifica il flag --no-enable-ingest-on-write.

In caso di esito positivo, il comando restituisce l'ID dell'operazione a lunga esecuzione non elaborata 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. 

namespace storagecontrol = google::cloud::storagecontrol_v2;
[](storagecontrol::StorageControlClient client,
   std::string const& cache_name) {
  google::storage::control::v2::AnywhereCache cache;
  google::protobuf::FieldMask field_mask;
  field_mask.add_paths("ttl");
  cache.set_name(cache_name);
  cache.mutable_ttl()->set_seconds(86400);
  // Start an update operation and block until it completes. Real applications
  // may want to setup a callback, wait on a coroutine, or poll until it
  // completes.
  auto anywhere_cache = client.UpdateAnywhereCache(cache, field_mask).get();
  if (!anywhere_cache) throw std::move(anywhere_cache).status();
  std::cout << "Updated anywhere cache: " << anywhere_cache->name() << "\n";
}

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. 


import com.google.api.gax.longrunning.OperationFuture;
import com.google.protobuf.FieldMask;
import com.google.storage.control.v2.AnywhereCache;
import com.google.storage.control.v2.StorageControlClient;
import com.google.storage.control.v2.UpdateAnywhereCacheMetadata;
import com.google.storage.control.v2.UpdateAnywhereCacheRequest;
import java.io.IOException;
import java.util.concurrent.ExecutionException;

public final class AnywhereCacheUpdate {

  public static void anywhereCacheUpdate(String cacheName, String admissionPolicy)
      throws InterruptedException, ExecutionException, IOException {
    try (StorageControlClient storageControl = StorageControlClient.create()) {

      AnywhereCache pendingUpdate =
          AnywhereCache.newBuilder().setName(cacheName).setAdmissionPolicy(admissionPolicy).build();

      UpdateAnywhereCacheRequest request =
          UpdateAnywhereCacheRequest.newBuilder()
              .setAnywhereCache(pendingUpdate)
              .setUpdateMask(FieldMask.newBuilder().addPaths("admission_policy").build())
              .build();

      // Start a long-running operation (LRO).
      OperationFuture<AnywhereCache, UpdateAnywhereCacheMetadata> operation =
          storageControl.updateAnywhereCacheAsync(request);

      // Await the LROs completion.
      AnywhereCache updatedAnywhereCache = operation.get();
      System.out.printf("Updated anywhere cache: %s%n", updatedAnywhereCache.getName());
    }
  }
}

Rust

use google_cloud_lro::Poller;
use google_cloud_storage::client::StorageControl;
use google_cloud_storage::model::AnywhereCache;
use google_cloud_wkt::FieldMask;

pub async fn sample(
    client: &StorageControl,
    bucket_id: &str,
    cache_id: &str,
) -> anyhow::Result<()> {
    let anywhere_cache = AnywhereCache::new()
        .set_name(format!(
            "projects/_/buckets/{}/anywhereCaches/{}",
            bucket_id, cache_id
        ))
        .set_admission_policy("ADMIT_ON_SECOND_MISS".to_string());
    let operation = client
        .update_anywhere_cache()
        .set_anywhere_cache(anywhere_cache)
        .set_update_mask(FieldMask::default().set_paths(["admission_policy"]))
        .poller()
        .until_done()
        .await?;
    println!("Updated anywhere cache: {:?}", operation);
    Ok(())
}

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

  1. Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione Authorization.

  2. 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_LIVE con 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:

      • 86400s per 86.400 secondi
      • 1440m per 1440 minuti
      • 24h per 24 ore
      • 1d per 1 giorno

    • INGEST_SETTING con true o false per specificare se la cache importa i dati in scrittura.

      Se impostato su true, l'importazione durante la scrittura è abilitata per tutti gli oggetti scritti nel bucket. Se impostato su false, l'importazione durante la scrittura può essere abilitata selettivamente per gli oggetti scritti con un prefisso oppure può essere disabilitata completamente.

      Per informazioni sulle impostazioni utilizzate per configurare l'attivazione dell'inserimento durante la scrittura a livello di bucket o prefisso, consulta Informazioni su come attivare l'inserimento durante la scrittura.

      Per attivare l'importazione durante la scrittura a livello di bucket o di prefisso oppure per disattivarla completamente, utilizza uno dei seguenti set di istruzioni.

      Attiva l'inserimento durante la scrittura per il bucket

      1. Per attivare l'importazione in scrittura per tutti gli oggetti scritti nel bucket, imposta il valore di INGEST_SETTINGS su true.

      2. Completa la richiesta di cache seguendo il passaggio 3.

      3. Se l'inserimento durante la scrittura è stato precedentemente attivato per un prefisso, esiste una cartella gestita con una configurazione rapidCacheConfig. Invia una richiesta PATCH per la cartella gestita che imposta la mappa policies nella configurazione rapidCacheConfig su null.

      Per istruzioni dettagliate su come utilizzare una configurazione rapidCacheConfig, vedi Aggiornare l'inserimento durante la scrittura in una cartella gestita.

      Attivare l'importazione durante la scrittura in modo selettivo per gli oggetti con un prefisso

      1. Imposta il valore di INGEST_SETTINGS su false.

      2. Completa la richiesta di cache seguendo il passaggio 3.

      3. Crea una cartella gestita che utilizza il prefisso come nome, se la cartella gestita non esiste già.

      4. Invia una richiesta PATCH di cartella gestita che includa una configurazione rapidCacheConfig. Imposta i valori dei campi nella configurazione seguendo le indicazioni riportate in Impostazioni e comportamenti di inserimento durante la scrittura.

      La mappa policies di una configurazione rapidCacheConfig può contenere uno o più ID cache (ad esempio us-east1-a e us-east1-b). Per attivare l'inserimento durante la scrittura per determinate cache, imposta l'impostazione ingestOnWrite della singola cache su enabled. Per disattivare l'inserimento durante la scrittura per determinate cache, imposta l'impostazione ingestOnWrite della singola cache su unspecified. Leggi attentamente la sezione relativa all'ereditarietà dell'inserimento durante la scrittura per capire in che modo i criteri di inserimento durante la scrittura di una cache possono essere interessati quando l'impostazione ingestOnWrite per la cache è impostata su unspecified.

      Per istruzioni dettagliate su come utilizzare una configurazione rapidCacheConfig, vedi Aggiornare l'inserimento durante la scrittura in una cartella gestita.

      Disattiva l'importazione durante la scrittura

      1. Imposta il valore di INGEST_SETTINGS su false. Questa impostazione disattiva l'inserimento durante la scrittura a livello di bucket.

      2. Completa la richiesta di cache seguendo il passaggio 3.

      3. Per disattivare l'importazione durante la scrittura a livello di prefisso, individua la cartella gestita in cui è configurata l'importazione durante la scrittura a livello di prefisso. Invia una richiesta PATCH per la cartella gestita che imposta la mappa policies nella configurazione rapidCacheConfig su null. In alternativa, elimina la configurazione rapidCacheConfig dalla risorsa cartella gestita in una richiesta PATCH.

      Per istruzioni dettagliate su come utilizzare una configurazione rapidCacheConfig, vedi Aggiornare l'inserimento durante la scrittura in una cartella gestita.

    L'esempio seguente aggiorna il TTL della cache a 2 giorni e attiva l'inserimento durante la scrittura per tutti gli oggetti scritti nel bucket:

    {
   "ttl": "172800s",
   "ingestOnWrite": true
}

  3. Per applicare le nuove proprietà, utilizza cURL per chiamare l'API JSON con una richiesta di aggiornamento della cache:

    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/anywhereCaches/RAPID_CACHE_ID"

    Sostituisci:

    • JSON_FILE_NAME con il nome del file JSON che hai creato nel passaggio 2.

    • BUCKET_NAME con il nome del bucket associato alla cache che vuoi aggiornare. Ad esempio, my-bucket.

    • RAPID_CACHE_ID: l'identificatore della cache. Ad esempio, us-east1-b.

Se l'operazione ha esito positivo, viene restituito un google.longrunning.Operation. Puoi visualizzare i dettagli dell'operazione a lunga esecuzione.

Riprendere una cache

Console

Per ripristinare una cache che è stata messa in pausa o disattivata, completa le seguenti istruzioni:

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

    Vai a Bucket

  2. Nell'elenco dei bucket, fai clic sul nome del bucket associato alla cache che vuoi riprendere.

  3. Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.

  4. Nella sezione Rapid Cache, fai clic su Gestisci cache.

  5. Nel riquadro Gestisci cache, fai clic sull'icona Riprendi cache ().

  6. 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_ID con l'identificatore dell'istanza della cache, formulato come BUCKET_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. 

namespace storagecontrol = google::cloud::storagecontrol_v2;
[](storagecontrol::StorageControlClient client,
   std::string const& cache_name) {
  auto anywhere_cache = client.ResumeAnywhereCache(cache_name);
  if (!anywhere_cache) throw std::move(anywhere_cache).status();
  std::cout << "Resumed anywhere cache: " << anywhere_cache->name() << "\n";
}

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. 


import com.google.storage.control.v2.AnywhereCache;
import com.google.storage.control.v2.ResumeAnywhereCacheRequest;
import com.google.storage.control.v2.StorageControlClient;
import java.io.IOException;

public final class AnywhereCacheResume {

  public static void anywhereCacheResume(String cacheName) throws IOException {
    try (StorageControlClient storageControl = StorageControlClient.create()) {

      ResumeAnywhereCacheRequest request =
          ResumeAnywhereCacheRequest.newBuilder().setName(cacheName).build();

      AnywhereCache anywhereCache = storageControl.resumeAnywhereCache(request);

      System.out.printf("Resumed anywhere cache: %s%n", anywhereCache.getName());
    }
  }
}

Rust

use google_cloud_storage::client::StorageControl;

pub async fn sample(
    client: &StorageControl,
    bucket_id: &str,
    cache_id: &str,
) -> anyhow::Result<()> {
    let cache = client
        .resume_anywhere_cache()
        .set_name(format!(
            "projects/_/buckets/{}/anywhereCaches/{}",
            bucket_id, cache_id
        ))
        .send()
        .await?;
    println!("Resumed anywhere cache: {:?}", cache);
    Ok(())
}

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

  1. Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione Authorization.

  2. Utilizza cURL per 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.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_CACHE_ID/resume"

    Sostituisci:

    • BUCKET_NAME con il nome del bucket associato alla cache che vuoi riprendere. Ad esempio, my-bucket.

    • RAPID_CACHE_ID: l'identificatore della cache. Ad esempio, us-east1-b.

In caso di esito positivo, l'operazione restituisce una risorsa AnyWhereCache formattata.

Disattivare una cache

Console

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

    Vai a Bucket

  2. Nell'elenco dei bucket, fai clic sul nome del bucket associato alla cache che vuoi disattivare.

  3. Nella pagina Dettagli bucket, fai clic sulla scheda Configurazione.

  4. Nella sezione Rapid Cache, fai clic su Gestisci cache.

  5. Nel riquadro Gestisci cache, fai clic sull'icona Disattiva cache ().

  6. Nella finestra di dialogo visualizzata, fai clic su Conferma.

  7. 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_ID con l'identificatore dell'istanza della cache, formulato come BUCKET_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. 

namespace storagecontrol = google::cloud::storagecontrol_v2;
[](storagecontrol::StorageControlClient client,
   std::string const& cache_name) {
  auto anywhere_cache = client.DisableAnywhereCache(cache_name);
  if (!anywhere_cache) throw std::move(anywhere_cache).status();
  std::cout << "Disabled anywhere cache: " << anywhere_cache->name() << "\n";
}

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. 


import com.google.storage.control.v2.AnywhereCache;
import com.google.storage.control.v2.DisableAnywhereCacheRequest;
import com.google.storage.control.v2.StorageControlClient;
import java.io.IOException;

public final class AnywhereCacheDisable {

  public static void anywhereCacheDisable(String cacheName) throws IOException {
    try (StorageControlClient storageControl = StorageControlClient.create()) {

      DisableAnywhereCacheRequest request =
          DisableAnywhereCacheRequest.newBuilder().setName(cacheName).build();

      AnywhereCache anywhereCache = storageControl.disableAnywhereCache(request);

      System.out.printf("Disabled anywhere cache: %s%n", anywhereCache.getName());
    }
  }
}

Rust

use google_cloud_storage::client::StorageControl;

pub async fn sample(
    client: &StorageControl,
    bucket_id: &str,
    cache_id: &str,
) -> anyhow::Result<()> {
    let cache = client
        .disable_anywhere_cache()
        .set_name(format!(
            "projects/_/buckets/{}/anywhereCaches/{}",
            bucket_id, cache_id
        ))
        .send()
        .await?;
    println!("Disabled anywhere cache: {:?}", cache);
    Ok(())
}

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

  1. Avere gcloud CLI installata e inizializzata, il che ti consente di generare un token di accesso per l'intestazione Authorization.

  2. Utilizza cURL per 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.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_CACHE_ID/disable"

    Sostituisci:

    • BUCKET_NAME con il nome del bucket associato alla cache che vuoi disattivare. Ad esempio, my-bucket.

    • RAPID_CACHE_ID: l'identificatore della cache. Ad esempio, us-east1-b.

In caso di esito positivo, il comando restituisce una risorsa AnywhereCache formattata.

Monitorare le prestazioni della cache

La sezione Cloud Storage della console Google Cloud fornisce grafici di monitoraggio che ti consentono di monitorare le prestazioni delle 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, campionato 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 Il tasso della quota di larghezza di banda per il trasferimento dei dati per la regione, la configurazione a due regioni o multiregionale, l'utilizzo della quota e il throughput aggiuntivo fornito 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 un mancato hit.
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 un mancato hit.
Byte % successi della cache Bucket La percentuale di byte erogati dalla cache rispetto al totale dei byte idonei per la cache, campionata ogni 60 secondi.
Byte % successi della cache Progetto La percentuale di byte erogati da tutte le cache per un bucket rispetto al totale dei byte idonei per la cache, campionata ogni 60 secondi.
Byte non elaborati della frequenza di importazione Bucket Frequenza di byte non elaborati importati in ogni cache, campionamento ogni 60 secondi. Tutti i byte importati, inclusi quelli non fatturabili, vengono utilizzati per calcolare il valore di questa metrica. Questa metrica viene segnalata 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, campionati 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 erogato dalla cache, con campionamento ogni 60 secondi.
Throughput - Fallimento della cache Progetto Il throughput non erogato da nessuna delle cache di un bucket, campionato ogni 60 secondi.

Accedere 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.

Accedere ai grafici a livello di bucket

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

    Vai a Bucket

  2. Nell'elenco dei bucket, fai clic sul nome del bucket per cui vuoi visualizzare i grafici di monitoraggio.

  3. Nella pagina Dettagli bucket, fai clic sulla scheda Osservabilità.

  4. Nel menu di navigazione, seleziona Rapid Cache.

    Vengono visualizzati i grafici di monitoraggio.

Accedere ai grafici a livello di progetto

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

    Vai a Bucket

  2. Nel riquadro di navigazione Cloud Storage, fai clic su Monitoring.

  3. Nella barra dei menu, fai clic su Rapid Cache.

    Vengono visualizzati i grafici di monitoraggio.

Utilizzare le operazioni a lunga esecuzione

Se vengono eseguite correttamente, le operazioni AnywhereCaches Create e Update avviano un'operazione a lunga esecuzione. Puoi recuperare ed elencare le operazioni a lunga esecuzione per visualizzare i dettagli e lo stato dell'operazione AnywhereCaches sottostante oppure 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 Utilizzare 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 AnywhereCaches asincrone sono idempotenti per impostazione predefinita. Ciò significa che puoi riprovare in sicurezza le chiamate API AnywhereCaches asincrone senza preoccuparti di modificare le risorse involontariamente.

Ad esempio, supponi di eseguire un'operazione AnywhereCaches Create per creare una cache in us-central1-a, che ha esito positivo. Se esegui un'operazione AnywhereCaches Create successiva utilizzando la stessa zona che ha esito positivo, 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 come parte della richiesta di creazione della cache. Se un request_id non è incluso, riceverai un errore ANYWHERE_CACHE_ALREADY_EXISTS quando tenti di creare una cache già esistente. Per informazioni su come includere un request_id, consulta Richiedere l'identificazione.

Passaggi successivi

Ricevi consigli su quali bucket e zone creare una cache.