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

  1. Nella console Cloud de Confiance , 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 tuo bucket.

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

  6. 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:

      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 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:

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

        Viene visualizzata la pagina Imposta criteri di importazione.

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

      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 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:

  1. Nella console Cloud de Confiance , 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 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.

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.

Prima di eseguire gli esempi di codice, imposta la variabile di ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.

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 installato e inizializzato, che ti consente di generare un token di accesso per l'intestazione Authorization.

  2. Crea un file JSON che contenga 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. Il valore deve essere espresso in secondi (ad esempio: 172800s per 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_SETTING con true o false per 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 su false, 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

      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.

      Abilita l'importazione in 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 utilizzi il prefisso come nome, se la cartella gestita non esiste già.

      4. Invia una richiesta PATCH per una cartella gestita che includa una configurazione rapidCacheConfig. 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

      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.s3nsapis.fr/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, 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

  1. Nella console Cloud de Confiance , 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 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 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.

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.

Prima di eseguire gli esempi di codice, imposta la variabile di ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.


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 installato e inizializzato, 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.s3nsapis.fr/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.

Se l'operazione ha esito positivo, restituisce una risorsa AnywhereCache.

Elenca le cache

Console

  1. Nella console Cloud de Confiance , 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 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_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.

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.

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.

Prima di eseguire gli esempi di codice, imposta la variabile di ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.


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 installato e inizializzato, 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.s3nsapis.fr/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.

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

  1. Nella console Cloud de Confiance , 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 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 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:

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

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

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

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.

Prima di eseguire gli esempi di codice, imposta la variabile di ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.


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 installato e inizializzato, 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 o meno i dati in scrittura.

      Se impostato su true, l'importazione in scrittura è abilitata per tutti gli oggetti scritti nel bucket. Se impostato su false, 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

      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'importazione in scrittura era stata precedentemente attivata per un prefisso, esiste una cartella gestita con una configurazione rapidCacheConfig. Invia una richiesta PATCH per una cartella gestita che imposta la mappa policies nella configurazione rapidCacheConfig su null.

      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

      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 utilizzi il prefisso come nome, se la cartella gestita non esiste già.

      4. Invia una richiesta PATCH per una cartella gestita che includa una configurazione rapidCacheConfig. Imposta i valori dei campi nella configurazione utilizzando le indicazioni riportate in Impostazioni e comportamenti di importazione in 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 abilitare l'importazione in scrittura per determinate cache, imposta l'impostazione ingestOnWrite della singola cache su enabled. Per disattivare l'importazione in scrittura per determinate cache, imposta l'impostazione ingestOnWrite della singola cache su unspecified. 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'impostazione ingestOnWrite per la cache è impostata su unspecified.

      Per istruzioni dettagliate su come utilizzare una configurazione rapidCacheConfig, consulta Aggiorna l'importazione in scrittura in una cartella gestita.

      Disabilita l'importazione in scrittura

      1. Imposta il valore di INGEST_SETTINGS su false. Questa impostazione disattiva l'importazione in scrittura a livello di bucket.

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

      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 PATCH per la cartella gestita che imposta la mappa policies nella configurazione rapidCacheConfig su null. In alternativa, elimina la configurazione rapidCacheConfig dalla risorsa della cartella gestita in una richiesta PATCH.

      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
    }
  3. cURL

    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_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 con 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:

  1. Nella console Cloud de Confiance , 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.

Prima di eseguire gli esempi di codice, imposta la variabile di ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.

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.

Prima di eseguire gli esempi di codice, imposta la variabile di ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.


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 installato e inizializzato, 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.s3nsapis.fr/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 con l'identificatore della cache. Ad esempio, us-east1-b.

Se l'operazione ha esito positivo, restituisce una risorsa AnywhereCache formattata.

Disabilita una cache

Console

  1. Nella console Cloud de Confiance , 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.

Prima di eseguire gli esempi di codice, imposta la variabile di ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.

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.

Prima di eseguire gli esempi di codice, imposta la variabile di ambiente GOOGLE_CLOUD_UNIVERSE_DOMAIN su s3nsapis.fr.


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 installato e inizializzato, 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.s3nsapis.fr/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 con 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

  1. Nella console Cloud de Confiance , 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.

Accedi ai grafici a livello di progetto

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

    Vai a Bucket

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

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