Caches mit Rapid Cache erstellen und verwalten

Sie können Cache-Instanzen mit Rapid Cache erstellen und verwalten, um die Latenz zu reduzieren und den Datenzugriff für in Cloud Storage gespeicherte Objekte zu optimieren. Diese Caching-Lösung trägt dazu bei, die Leistung Ihrer Anwendungen zu verbessern, indem der Datenabruf beschleunigt wird.

Auf dieser Seite erfahren Sie, wie Sie Cache-Instanzen mit Rapid Cache erstellen und verwalten. Informationen zur Verwendung und Verwaltung von Vorgängen mit langer Ausführungszeit, die von asynchronen Cache-Vorgängen in Rapid Cache initiiert werden, finden Sie unter Vorgänge mit langer Ausführungszeit verwenden.

Lesen Sie sich die Einschränkungen durch, bevor Sie Rapid Cache verwenden.

Hinweis

Bevor Sie mit dem Erstellen und Verwalten von Caches beginnen, lesen Sie die folgenden Abschnitte.

Erforderliche Rollen abrufen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Storage-Administrator (roles/storage.admin) für den Bucket zuzuweisen, für den Sie Caches erstellen möchten, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Verwalten von Rapid Cache-Caches benötigen.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Erstellen und Verwalten von Rapid Cache-Caches erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Rapid Cache-Caches zu erstellen und zu verwalten:

  • storage.anywhereCaches.create (erforderlich zum Erstellen von Caches)
  • storage.anywhereCaches.disable (erforderlich zum Deaktivieren von Caches)
  • storage.anywhereCaches.get (erforderlich, um Caches abzurufen)
  • storage.anywhereCaches.list (erforderlich für das Auflisten von Caches)
  • storage.anywhereCaches.resume (erforderlich, um Caches fortzusetzen)
  • storage.anywhereCaches.update (erforderlich zum Aktualisieren von Caches)
  • storage.managedFolders.create (nur erforderlich, um das Ingest-on-Write-Verhalten für einen Cache zu aktivieren)
  • storage.managedFolders.update (nur erforderlich, um das Ingest-on-Write-Verhalten eines Caches zu aktualisieren)

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen erhalten.

Informationen zum Zuweisen von Rollen für Buckets finden Sie unter IAM-Richtlinien für Buckets festlegen und verwalten.

Um Vorgänge mit langer Ausführungszeit zu verwalten, die über Rapid Cache-Methoden initiiert werden, benötigen Sie möglicherweise zusätzliche Rollen und Berechtigungen. Weitere Informationen finden Sie unter Erforderliche Rollen für Vorgänge mit langer Ausführungszeit.

Einstellungen für die Aufnahme beim Schreiben

Wenn Sie einen Cache erstellen oder aktualisieren, können Sie optional festlegen, dass der Cache Daten aufnimmt, sobald sie in den Bucket geschrieben werden. Diese Funktion wird als „Ingest-on-Write“ bezeichnet. Wenn Sie die Aufnahme beim Schreiben mithilfe der JSON API aktivieren möchten, sollten Sie sich zuerst mit dem Verhalten der konfigurierten Einstellungen für die Aufnahme beim Schreiben vertraut machen.

Cache erstellen

Console

Cache für einen vorhandenen Bucket erstellen

  1. Wechseln Sie in der Cloud de Confiance Console unter „Cloud Storage“ zur Seite Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, für den Sie Daten im Cache speichern möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.

  4. Klicken Sie im Abschnitt Rapid Cache auf Cache konfigurieren.

    Die Seite Cache konfigurieren wird für Ihren Bucket angezeigt.

  5. Klicken Sie im Abschnitt Cache-Regionen auf die Region, die die Zonen enthält, in denen Sie einen Cache erstellen möchten.

  6. Wählen Sie im Abschnitt Cache-Zonen die Zonen aus, in denen Sie einen Cache erstellen möchten. Führen Sie für jeden Cache, den Sie in einer Zone erstellen, optional die folgenden Schritte aus:

    • Optional: Sie können eine benutzerdefinierte Gültigkeitsdauer (TTL) festlegen, die bestimmt, wann Daten nach dem letzten Lesevorgang aus dem Cache entfernt werden. Standardmäßig ist die TTL eines Cache auf einen Tag festgelegt.

      So legen Sie eine benutzerdefinierte TTL fest:

      1. Geben Sie in der Spalte Gültigkeitsdauer einen Wert für die Dauer (z. B. 48) und eine Zeiteinheit (z. B. hours) an.

      2. Klicken Sie auf Save configuration (Konfiguration speichern).

    • Optional: Sie können den Cache so aktivieren, dass Daten beim Schreiben zusätzlich zum ersten Lesen aufgenommen werden. Standardmäßig sind Caches so konfiguriert, dass Daten nur beim ersten Lesen aufgenommen werden.

      So aktivieren Sie den Cache, um Daten beim Schreiben aufzunehmen:

      1. Klicken Sie in der Spalte Aufnahmekriterien auf Kriterien für die Cache-Aufnahme bearbeiten Bearbeiten.

        Die Seite Kriterien für Datenaufnahme festlegen wird angezeigt.

      2. Klicken Sie das Kästchen Daten beim Schreiben aufnehmen an.

        • Klicken Sie auf Gesamter Bucket, um die Aufnahme beim Schreiben für alle Objekte zu aktivieren, die neu in den Bucket geschrieben werden.

        • Wenn Sie die Aufnahme beim Schreiben nur für neu geschriebene Objekte aktivieren möchten, die ein bestimmtes Präfix im Namen haben, klicken Sie auf Ausgewählte Ordner und geben Sie das Objektnamenspräfix ein. Das Präfix des Objektnamens wird auch als „Ordnerpfad“ bezeichnet.

        Sie können mehrere Objektnamenpräfixe eingeben, indem Sie auf Hinzufügen add klicken.

        Wenn Sie ein Präfix entfernen möchten, klicken Sie auf Element löschen delete.

      3. Klicken Sie auf Fertig.

  7. Klicken Sie auf Save configuration (Konfiguration speichern).

  8. Klicken Sie im angezeigten Dialogfeld auf Bestätigen.

    Der Tab Vorgänge auf der Seite Bucket-Details wird geöffnet. Dort sehen Sie den Jobstatus des Vorgangs zum Erstellen des Cache.

Cache für einen neuen Bucket erstellen

Wenn Sie einen Cache im Rahmen der Erstellung eines neuen Buckets erstellen möchten, folgen Sie der Anleitung unter Neuen Bucket erstellen.

So rufen Sie den Status des Caches eines Buckets auf der Seite Bucket-Liste auf:

  1. Wechseln Sie in der Cloud de Confiance Console unter „Cloud Storage“ zur Seite Buckets.

    Buckets aufrufen

  2. Klicken Sie auf das Symbol Spalte ansehen (), wählen Sie Cache aus und klicken Sie dann auf OK.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets anywhere-caches create aus:

gcloud storage buckets anywhere-caches create gs://BUCKET_NAME CACHE_ZONE \
[--ttl=TTL] [--enable-ingest-on-write]

Ersetzen Sie:

  • BUCKET_NAME durch den Namen des Buckets, für den Sie Daten im Cache speichern möchten. Beispiel: my-bucket.

  • CACHE_ZONE durch die Zone, in der der Cache ausgeführt wird. Beispiel: us-east1-b.

    Wenn Sie mehrere Caches gleichzeitig erstellen möchten, können Sie mehrere Zonen angeben. Beispiel: us-east1-b us-east1-c us-east1-d

  • TTL (optional) mit der Gültigkeitsdauer (TTL) der Daten im Cache. Der Wert kann zwischen 1 Tag und 7 Tagen liegen. Der Wert kann in Sekunden, Minuten, Stunden und Tagen angegeben werden. Beispiel:

    • 86400s für 86.400 Sekunden
    • 1440m für 1.440 Minuten
    • 24h für 24 Stunden
    • 1d für 1 Tag

    Wenn nicht angegeben, wird standardmäßig 86400s (1 Tag) verwendet.

Wenn Sie den Cache so konfigurieren möchten, dass Daten aufgenommen werden, sobald sie in den Bucket geschrieben werden, geben Sie das optionale Flag --enable-ingest-on-write an. Mit diesem Flag kann der Cache alle Objekte aufnehmen, wenn sie in den Bucket geschrieben werden.

Bei Erfolg gibt der Befehl die ID des Vorgangs mit langer Ausführungszeit zurück, der dem AnywhereCache-Erstellungsvorgang zugeordnet ist. Sie können Details zum Vorgang mit langer Ausführungszeit abrufen oder den Vorgang mit langer Ausführungszeit abbrechen, um den AnywhereCaches-Erstellungsvorgang zu beenden, bevor er abgeschlossen ist.

Clientbibliotheken

C++

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.

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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.

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

Weitere Informationen zur Verwendung von Rapid Cache mit Terraform finden Sie in der google_storage_anywhere_cache-Terraform-Dokumentation.

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.

  2. Erstellen Sie eine JSON-Datei, die folgende Informationen enthält:

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

    Ersetzen Sie:

    • ZONE durch die Zone, in der der Cache ausgeführt wird. Beispiel: us-east1-b.

    • TIME_TO_LIVE durch die Gültigkeitsdauer (TTL) der Daten im Cache. Der Wert muss in Sekunden angegeben werden (z. B. 172800s für 172.800 Sekunden, was 2 Tagen entspricht).

      Der Mindestwert ist 86400s (1 Tag) und der Höchstwert ist 604800s (7 Tage). Wenn nicht angegeben, lautet die Standardeinstellung 86400s.

    • INGEST_SETTING mit true oder false, um anzugeben, ob der Cache beim Schreiben Daten aufnimmt.

      Wenn der Wert auf true gesetzt ist, ist die Aufnahme beim Schreiben für alle Objekte aktiviert, die in den Bucket geschrieben werden. Wenn der Wert auf false gesetzt ist, kann die Aufnahme beim Schreiben selektiv für Objekte aktiviert werden, die unter einem Präfix geschrieben werden, oder sie kann für den gesamten Bucket deaktiviert werden.

      Informationen zu den Einstellungen, die zum Konfigurieren der Aktivierung von „Ingest-on-Write“ verwendet werden, finden Sie unter Anforderungen für die Aktivierung von „Ingest-on-Write“.

      Wenn Sie die Aufnahme beim Schreiben auf Bucket- oder Präfixebene aktivieren oder die Aufnahme beim Schreiben vollständig deaktivieren möchten, verwenden Sie eine der folgenden Anleitungen.

      Ingest-on-Write für den Bucket aktivieren

      1. Wenn Sie die Aufnahme beim Schreiben für alle Objekte aktivieren möchten, die in den Bucket geschrieben werden, setzen Sie den Wert von INGEST_SETTINGS auf true.

      2. Führen Sie Schritt 3 aus, um Ihre Cache-Anfrage abzuschließen.

      Ingest-on-Write selektiv für Objekte unter einem Präfix aktivieren

      1. Legen Sie für INGEST_SETTINGS den Wert false fest.

      2. Führen Sie Schritt 3 aus, um Ihre Cache-Anfrage abzuschließen.

      3. Erstellen Sie einen verwalteten Ordner, der das Präfix als Namen verwendet, falls der verwaltete Ordner noch nicht vorhanden ist.

      4. Senden Sie eine PATCH-Anfrage für einen verwalteten Ordner, die eine rapidCacheConfig-Konfiguration enthält. Legen Sie Feldwerte in der Konfiguration fest. Folgen Sie dazu der Anleitung unter Informationen zur Verwendung von Ingest-on-Write.

      Eine detaillierte Anleitung zur Verwendung einer rapidCacheConfig-Konfiguration finden Sie unter „Ingest-on-Write“ für einen verwalteten Ordner aktualisieren.

      Cache ohne Aktivierung von „Ingest-on-Write“ erstellen

      1. Legen Sie für INGEST_SETTINGS den Wert false fest.

      2. Führen Sie Schritt 3 aus, um Ihre Cache-Anfrage abzuschließen.

  3. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum Erstellen eines Cache aufzurufen:

    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"

    Ersetzen Sie:

    • JSON_FILE_NAME durch den Namen der JSON-Datei, die Sie in Schritt 2 erstellt haben.

    • BUCKET_NAME durch den Namen des Buckets, für den Sie Daten im Cache speichern möchten. Beispiel: my-bucket.

Wenn der Vorgang erfolgreich ist, wird ein google.longrunning.Operation zurückgegeben. Sie können Details zum Vorgang mit langer Ausführungszeit abrufen oder den Vorgang mit langer Ausführungszeit abbrechen, um den AnywhereCaches-Erstellungsvorgang zu beenden, bevor er abgeschlossen ist.

Cache ansehen

Console

  1. Wechseln Sie in der Cloud de Confiance Console unter „Cloud Storage“ zur Seite Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie aufrufen möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.

  4. Klicken Sie im Bereich Rapid Cache neben dem Feld Cache auf Bearbeiten.

  5. Wählen Sie auf der Seite Konfiguration bearbeiten eine Region aus, um alle Caches in den Zonen der Region aufzurufen.

    Im Bereich Cache-Zonen können Sie dann Details zu jedem verfügbaren Cache aufrufen.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets anywhere-caches describe aus:

gcloud storage buckets anywhere-caches describe CACHE_ID

Ersetzen Sie:

  • CACHE_ID durch die Kennung der Cache-Instanz, formuliert als BUCKET_NAME/CACHE_ZONE. Beispiel: my-bucket/us-east1-b.

Verwenden Sie das optionale Flag raw, um eine API-Rohantwort anstelle einer standardisierten API-Antwort auszugeben.

Wenn der Vorgang erfolgreich war, gibt der Befehl eine AnywhereCache-Ressource zurück.

Clientbibliotheken

C++

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.

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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.


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

Weitere Informationen zur Verwendung von Rapid Cache mit Terraform finden Sie in der google_storage_anywhere_cache-Terraform-Dokumentation.

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.

  2. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum Abrufen eines Cache aufzurufen:

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

    Ersetzen Sie:

    • BUCKET_NAME durch den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie abrufen möchten. Beispiel: my-bucket

    • RAPID_CACHE_ID durch die Zone, in der sich der Cache befindet. Beispiel: us-east1-b.

Wenn der Vorgang erfolgreich ist, wird eine AnywhereCache-Ressource zurückgegeben.

Caches auflisten

Console

  1. Wechseln Sie in der Cloud de Confiance Console unter „Cloud Storage“ zur Seite Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der mit den Caches verknüpft ist, die Sie aufrufen möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.

  4. Klicken Sie im Bereich Rapid Cache neben dem Feld Cache auf Bearbeiten.

  5. Wählen Sie auf der Seite Konfiguration bearbeiten eine Region aus, um alle Caches in den Zonen dieser Region aufzurufen.

    Alle verfügbaren Caches für Zonen innerhalb der Region werden im Bereich Cache-Zonen angezeigt.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets anywhere-caches list aus:

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

Ersetzen Sie:

  • BUCKET_NAME durch den Namen des Buckets, der mit den Caches verknüpft ist, die Sie auflisten möchten. Beispiel: my-bucket.

Wenn der Vorgang erfolgreich ist, gibt der Befehl eine Liste von AnywhereCache-Ressourcen zurück.

Sie können optional das Flag --raw verwenden, um eine API-Rohantwort anstelle einer standardisierten Antwort zurückzugeben. Weitere Informationen zum Steuern des Auflistungsverhaltens, z. B. zum Paginieren von Ergebnissen, finden Sie in der Dokumentation zu gcloud storage ls.

Clientbibliotheken

C++

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.

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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.


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

Weitere Informationen zur Verwendung von Rapid Cache mit Terraform finden Sie in der google_storage_anywhere_cache-Terraform-Dokumentation.

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.

  2. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum Auflisten von Caches aufzurufen:

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

    Ersetzen Sie:

    • BUCKET_NAME durch den Namen des Buckets, der mit den Caches verknüpft ist, die Sie abrufen möchten. Beispiel: my-bucket

    Wenn Sie mehrere Caches auflisten, können Sie die Ergebnisse paginieren.

Bei erfolgreicher Ausführung gibt dieser Vorgang eine Liste von AnywhereCache-Ressourcen zurück. Weitere Informationen zur Struktur dieser Antwort finden Sie in der Antwort in der AnywhereCaches-Listendokumentation.

Cache aktualisieren

Console

  1. Wechseln Sie in der Cloud de Confiance Console unter „Cloud Storage“ zur Seite Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie aktualisieren möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.

  4. Klicken Sie im Abschnitt Rapid Cache auf Caches verwalten.

  5. Klicken Sie im Bereich Caches verwalten auf Caches bearbeiten oder erstellen.

  6. Aktualisieren Sie auf der Seite Konfiguration bearbeiten die Attribute des Cache:

    • Wenn Sie die TTL des Cache aktualisieren möchten, suchen Sie die Spalte Gültigkeitsdauer, geben Sie eine Zeitdauer an und wählen Sie eine Zeiteinheit aus (z. B. Minuten).

    • So konfigurieren Sie das Verhalten des Caches beim Schreiben, einschließlich der Frage, ob alle geschriebenen Objekte oder nur ausgewählte Objekte, die unter einem Präfix geschrieben wurden, im Cache gespeichert werden:

      1. Suchen Sie die Spalte Aufnahmekriterien und klicken Sie dann auf Cache-Aufnahmekriterien bearbeiten.

      2. Im Bereich Kriterien für Datenaufnahme festlegen:

      • Wenn Sie die Aufnahme beim Schreiben aktivieren oder deaktivieren möchten, aktivieren oder deaktivieren Sie das Kästchen Daten beim Schreiben aufnehmen und klicken Sie dann auf Fertig.

      • Wenn Sie den Cache so aktualisieren möchten, dass alle Objekte im Bucket beim Schreiben aufgenommen werden, muss das Kästchen Daten beim Schreiben aufnehmen angeklickt sein. Wählen Sie dann Gesamter Bucket aus. Klicken Sie dann auf Fertig.

      • Wenn Sie den Cache so aktualisieren möchten, dass nur Objekte aufgenommen werden, die ein bestimmtes Präfix im Namen enthalten, muss das Kästchen Daten beim Schreiben aufnehmen aktiviert sein. Wählen Sie dann Ausgewählte Ordner aus.

        • Wenn Sie ein Präfix angeben möchten, geben Sie ein oder mehrere Präfixe in das Feld für den Ordnerpfad ein und klicken Sie dann auf Fertig.

        • Wenn Sie ein Präfix entfernen möchten, klicken Sie neben dem Präfix auf Element löschen .

  7. Klicken Sie auf der Seite Konfiguration bearbeiten auf Speichern.

  8. Klicken Sie im angezeigten Dialogfeld auf Bestätigen.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets anywhere-caches update aus:

gcloud storage buckets anywhere-caches update CACHE_ID \
[--ttl=TTL] [--[no-]enable-ingest-on-write]

Ersetzen Sie:

  • CACHE_ID durch die Kennung der Cache-Instanz, formuliert als BUCKET_NAME/CACHE_ZONE. Beispiel: my-bucket/us-east1-b.

    Wenn Sie mehrere Caches gleichzeitig aktualisieren möchten, können Sie mehrere Kennungen angeben. Beispiel: my-bucket/us-east1-b my-bucket/us-east1-c

  • TTL (optional) mit der Gültigkeitsdauer (TTL) der Daten im Cache. Der Wert kann zwischen 1 Tag und 7 Tagen liegen. Der Wert kann in Sekunden, Minuten, Stunden und Tagen angegeben werden. Beispiel:

    • 86400s für 86.400 Sekunden
    • 1440m für 1.440 Minuten
    • 24h für 24 Stunden
    • 1d für 1 Tag

Wenn Sie den Cache so konfigurieren möchten, dass Daten aufgenommen werden, sobald sie in den Bucket geschrieben werden, geben Sie das Flag --enable-ingest-on-write an. Mit diesem Flag kann der Cache alle Objekte aufnehmen, wenn sie in den Bucket geschrieben werden. Wenn Sie verhindern möchten, dass der Cache beim Schreiben Daten aufnimmt, geben Sie das Flag --no-enable-ingest-on-write an.

Bei Erfolg gibt der Befehl die ID des Rohvorgangs mit langer Ausführungszeit zurück, der dem AnywhereCache-Aktualisierungsvorgang zugeordnet ist. Sie können Details zum Vorgang mit langer Ausführungszeit abrufen.

Clientbibliotheken

C++

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.

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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.


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

Weitere Informationen zur Verwendung von Rapid Cache mit Terraform finden Sie in der google_storage_anywhere_cache-Terraform-Dokumentation.

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.

  2. Erstellen Sie eine JSON-Datei, die Änderungen an den Cache-Attributen enthält, die Sie aktualisieren möchten.

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

    Ersetzen Sie:

    • TIME_TO_LIVE durch die TTL der Daten im Cache. Der Wert kann zwischen 1 Tag und 7 Tagen liegen. Der Wert kann in Sekunden, Minuten, Stunden und Tagen angegeben werden. Beispiel:

      • 86400s für 86.400 Sekunden
      • 1440m für 1.440 Minuten
      • 24h für 24 Stunden
      • 1d für 1 Tag
    • INGEST_SETTING mit true oder false, um anzugeben, ob der Cache Daten beim Schreiben aufnimmt.

      Wenn der Wert auf true gesetzt ist, ist die Aufnahme beim Schreiben für alle Objekte aktiviert, die in den Bucket geschrieben werden. Wenn der Wert auf false gesetzt ist, kann die Aufnahme beim Schreiben selektiv für Objekte aktiviert werden, die unter einem Präfix geschrieben werden, oder sie kann vollständig deaktiviert werden.

      Informationen zu den Einstellungen, mit denen die Aktivierung von „Ingest-on-Write“ auf Bucket- oder Präfixebene konfiguriert wird, finden Sie unter Ingest-on-Write aktivieren.

      Wenn Sie die Aufnahme beim Schreiben auf Bucket- oder Präfixebene aktivieren oder die Aufnahme beim Schreiben vollständig deaktivieren möchten, verwenden Sie eine der folgenden Anleitungen.

      Ingest-on-Write für den Bucket aktivieren

      1. Wenn Sie die Aufnahme beim Schreiben für alle Objekte aktivieren möchten, die in den Bucket geschrieben werden, setzen Sie den Wert von INGEST_SETTINGS auf true.

      2. Führen Sie Schritt 3 aus, um Ihre Cache-Anfrage abzuschließen.

      3. Wenn die Aufnahme beim Schreiben zuvor für ein Präfix aktiviert war, ist ein verwalteter Ordner mit einer rapidCacheConfig-Konfiguration vorhanden. Senden Sie eine PATCH-Anfrage für einen verwalteten Ordner, die die policies-Zuordnung in der rapidCacheConfig-Konfiguration auf null setzt.

      Eine detaillierte Anleitung zur Verwendung einer rapidCacheConfig-Konfiguration finden Sie unter „Ingest-on-Write“ für einen verwalteten Ordner aktualisieren.

      Ingest-on-Write selektiv für Objekte unter einem Präfix aktivieren

      1. Legen Sie für INGEST_SETTINGS den Wert false fest.

      2. Führen Sie Schritt 3 aus, um Ihre Cache-Anfrage abzuschließen.

      3. Erstellen Sie einen verwalteten Ordner, der das Präfix als Namen verwendet, falls der verwaltete Ordner noch nicht vorhanden ist.

      4. Senden Sie eine PATCH-Anfrage für einen verwalteten Ordner, die eine rapidCacheConfig-Konfiguration enthält. Legen Sie Feldwerte in der Konfiguration fest. Folgen Sie dazu der Anleitung unter Einstellungen und Verhalten für die Aufnahme beim Schreiben.

      Die policies-Zuordnung einer rapidCacheConfig-Konfiguration kann eine oder mehrere Cache-IDs enthalten (z. B. us-east1-a und us-east1-b). Wenn Sie die Aufnahme beim Schreiben für bestimmte Caches aktivieren möchten, setzen Sie die Einstellung ingestOnWrite des jeweiligen Cache auf enabled. Wenn Sie die Aufnahme beim Schreiben für bestimmte Caches deaktivieren möchten, setzen Sie die Einstellung ingestOnWrite des einzelnen Cache auf unspecified. Lesen Sie sich die Informationen zur Ingest-on-Write-Übernahme sorgfältig durch, um zu verstehen, wie sich die Ingest-on-Write-Richtlinie eines Caches auswirken kann, wenn die Einstellung ingestOnWrite für den Cache auf unspecified festgelegt ist.

      Eine detaillierte Anleitung zur Verwendung einer rapidCacheConfig-Konfiguration finden Sie unter „Ingest-on-Write“ für einen verwalteten Ordner aktualisieren.

      Ingest-on-Write deaktivieren

      1. Legen Sie für INGEST_SETTINGS den Wert false fest. Mit dieser Einstellung wird die Aufnahme beim Schreiben auf Bucket-Ebene deaktiviert.

      2. Führen Sie Schritt 3 aus, um Ihre Cache-Anfrage abzuschließen.

      3. Wenn Sie die Aufnahme beim Schreiben auf Präfixebene deaktivieren möchten, suchen Sie den verwalteten Ordner, für den die Aufnahme beim Schreiben auf Präfixebene konfiguriert ist. Senden Sie eine PATCH-Anfrage für einen verwalteten Ordner, die die policies-Zuordnung in der rapidCacheConfig-Konfiguration auf null setzt. Alternativ können Sie die rapidCacheConfig-Konfiguration aus der Ressource des verwalteten Ordners in einer PATCH-Anfrage löschen.

      Eine detaillierte Anleitung zur Verwendung einer rapidCacheConfig-Konfiguration finden Sie unter „Ingest-on-Write“ für einen verwalteten Ordner aktualisieren.

    Im folgenden Beispiel wird die TTL des Caches auf 2 Tage aktualisiert und die Aufnahme beim Schreiben für alle Objekte aktiviert, die in den Bucket geschrieben werden:

    {
       "ttl": "172800s",
       "ingestOnWrite": true
    }
  3. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum Aktualisieren des Cache aufzurufen und die neuen Attribute anzuwenden:

    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"

    Ersetzen Sie:

    • JSON_FILE_NAME durch den Namen der JSON-Datei, die Sie in Schritt 2 erstellt haben.

    • BUCKET_NAME durch den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie aktualisieren möchten. Beispiel: my-bucket

    • RAPID_CACHE_ID durch die Kennung des Cache. Beispiel: us-east1-b.

Wenn der Vorgang erfolgreich ist, wird ein google.longrunning.Operation zurückgegeben. Sie können Details zum Vorgang mit langer Ausführungszeit abrufen.

Cache fortsetzen

Console

So setzen Sie einen Cache fort, der pausiert oder deaktiviert wurde:

  1. Wechseln Sie in der Cloud de Confiance Console unter „Cloud Storage“ zur Seite Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie fortsetzen möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.

  4. Klicken Sie im Bereich Rapid Cache auf Caches verwalten.

  5. Klicken Sie im Bereich Caches verwalten auf das Symbol Cache fortsetzen ().

  6. Klicken Sie auf Schließen.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets anywhere-caches resume aus:

gcloud storage buckets anywhere-caches resume CACHE_ID

Ersetzen Sie:

  • CACHE_ID durch die Kennung der Cache-Instanz, formuliert als BUCKET_NAME/CACHE_ZONE. Beispiel: my-bucket/us-east1-b.

    Wenn Sie mehrere Caches gleichzeitig fortsetzen möchten, können Sie mehrere Kennungen angeben. Beispiel: my-bucket/us-east1-b my-bucket/us-east1-c

Wenn der Vorgang erfolgreich ist, gibt der Befehl eine formatierte AnywhereCache-Ressource zurück.

Clientbibliotheken

C++

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.

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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.


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

Weitere Informationen zur Verwendung von Rapid Cache mit Terraform finden Sie in der google_storage_anywhere_cache-Terraform-Dokumentation.

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.

  2. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum Fortsetzen eines Cache aufzurufen:

    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"

    Ersetzen Sie:

    • BUCKET_NAME durch den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie fortsetzen möchten. Beispiel: my-bucket

    • RAPID_CACHE_ID durch die Kennung des Cache. Beispiel: us-east1-b.

Bei erfolgreicher Ausführung gibt der Vorgang eine formatierte AnywhereCache-Ressource zurück.

Cache deaktivieren

Console

  1. Wechseln Sie in der Cloud de Confiance Console unter „Cloud Storage“ zur Seite Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie deaktivieren möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Konfiguration.

  4. Klicken Sie im Abschnitt Rapid Cache auf Caches verwalten.

  5. Klicken Sie im Bereich Caches verwalten auf das Symbol Cache deaktivieren ().

  6. Klicken Sie im angezeigten Dialogfeld auf Bestätigen.

  7. Klicken Sie auf Schließen.

Befehlszeile

Führen Sie den Befehl gcloud storage buckets anywhere-caches disable aus:

gcloud storage buckets anywhere-caches disable CACHE_ID

Ersetzen Sie:

  • CACHE_ID durch die Kennung der Cache-Instanz, formuliert als BUCKET_NAME/CACHE_ZONE. Beispiel: my-bucket/us-east1-b.

    Wenn Sie mehrere Caches gleichzeitig deaktivieren möchten, können Sie mehrere Kennungen angeben. Beispiel: my-bucket/us-east1-b my-bucket/us-east1-c

Wenn der Vorgang erfolgreich ist, gibt der Befehl eine formatierte AnywhereCache-Ressource zurück.

Clientbibliotheken

C++

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage C++ API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.

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

Weitere Informationen finden Sie in der Referenzdokumentation zur Cloud Storage Java API.

Richten Sie die Standardanmeldedaten für Anwendungen ein, um sich bei Cloud Storage zu authentifizieren. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Legen Sie vor dem Ausführen von Codebeispielen die Umgebungsvariable GOOGLE_CLOUD_UNIVERSE_DOMAIN auf s3nsapis.fr fest.


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

Weitere Informationen zur Verwendung von Rapid Cache mit Terraform finden Sie in der google_storage_anywhere_cache-Terraform-Dokumentation.

REST APIs

JSON-API

  1. Installieren und initialisieren Sie die gcloud CLI, um ein Zugriffstoken für den Authorization-Header zu generieren.

  2. Verwenden Sie cURL, um die JSON API mit einer Anfrage zum Deaktivieren eines Cache aufzurufen:

    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"

    Ersetzen Sie:

    • BUCKET_NAME durch den Namen des Buckets, der mit dem Cache verknüpft ist, den Sie deaktivieren möchten. Beispiel: my-bucket

    • RAPID_CACHE_ID durch die Kennung des Cache. Beispiel: us-east1-b.

Wenn der Vorgang erfolgreich ist, gibt der Befehl eine formatierte AnywhereCache-Ressource zurück.

Cache-Leistung überwachen

Der Cloud Storage-Bereich der Cloud de Confiance Console bietet Monitoring-Diagramme, mit denen Sie die Leistung Ihrer Caches anhand von Messwerten verfolgen können. Diese Monitoring-Diagramme können auch mit Cloud Monitoring aufgerufen werden.

Verfügbare Diagramme

Diagramm Ebene der Ressourcenhierarchie Beschreibung
Entfernungsrate der Bytes Bucket Die Rate der aus dem Cache entfernten Bytes, stündlich erfasst. Diese Daten werden mehr als einmal pro Stunde aktualisiert, um Zeit für die Nachbearbeitung der Daten zu lassen.
Entfernungsrate der Bytes Projekt Die Rate der aus allen Caches eines Buckets entfernten Bytes, stündlich erfasst. Diese Daten werden mehr als einmal pro Stunde aktualisiert, um Zeit für die Nachbearbeitung der Daten zu lassen.
Byte im Cache Bucket Die Anzahl der Byte im Cache, die jede Stunde erfasst wird. Diese Daten werden mehr als einmal pro Stunde aktualisiert, um Zeit für die Nachbearbeitung der Daten zu lassen.
Byte im Cache Projekt Die Anzahl der Byte in allen Caches eines Buckets, die jede Stunde erfasst wird. Diese Daten werden mehr als einmal pro Stunde aktualisiert, um Zeit für die Nachbearbeitung der Daten zu lassen.
Vorteil durch Cache-Durchsatz Projekt Die Rate des Bandbreitenkontingents für die Datenübertragung für die Region, die Dual-Region oder die Multi-Region, die Nutzung des Kontingents und der vom Cache bereitgestellte zusätzliche Durchsatz. Letzterer wird nicht auf das Kontingent angerechnet. Projekte können also durch Nutzung des Cache den durch das Kontingent zulässigen Durchsatz überschreiten.
Trefferratenvorgänge Bucket Der Prozentsatz der Cache-Vorgänge, die die angeforderten Daten aus dem Cache bereitstellen, im Verhältnis zu den insgesamt cache-fähigen Vorgängen, alle 60 Sekunden erfasst. Wenn ein Lesevorgang vollständig aus dem Cache zurückgegeben wird, gilt der Vorgang als Treffer. Wenn der Lesevorgang nicht oder nur teilweise aus dem Cache zurückgegeben wird, gilt der Vorgang als Fehler.
Trefferratenvorgänge Projekt Der Prozentsatz der Cache-Vorgänge, die die angeforderten Daten aus allen Caches für einen Bucket bereitstellen, im Verhältnis zu den gesamten cache-fähigen Vorgängen, gemessen über 60 Sekunden. Wenn ein Lesevorgang vollständig aus dem Cache zurückgegeben wird, gilt der Vorgang als Treffer. Wenn der Lesevorgang nicht oder nur teilweise aus dem Cache zurückgegeben wird, gilt der Vorgang als Fehler.
Bytes der Trefferquote Bucket Der Prozentsatz der Bytes, die aus dem Cache bereitgestellt wurden, im Verhältnis zu den gesamten Cache-fähigen Bytes. Alle 60 Sekunden wird eine Stichprobe erstellt.
Bytes der Trefferquote Projekt Der Prozentsatz der Bytes, die aus allen Caches für einen Bucket bereitgestellt wurden, im Verhältnis zu den gesamten Cache-fähigen Bytes. Alle 60 Sekunden wird eine Stichprobe erstellt.
Aufnahmerate (Rohbytes) Bucket Die Rate der in jeden Cache aufgenommenen Rohbyte, alle 60 Sekunden gemessen. Alle aufgenommenen Byte, einschließlich nicht abrechenbarer Byte, werden zur Berechnung des Werts dieses Messwerts verwendet. Dieser Messwert wird in Echtzeit erfasst.
Aufnahmerate (Rohbytes) Projekt Die Rate der in alle Caches eines Buckets aufgenommenen Rohbyte, die alle 60 Sekunden erfasst wird. Alle aufgenommenen Byte, einschließlich nicht abrechenbarer Byte, werden zur Berechnung des Werts dieses Messwerts verwendet. Dieser Messwert wird in Echtzeit erfasst.
Durchsatz – Cache-Treffer Bucket Der Durchsatz, der vom Cache bereitgestellt wird. Die Stichprobenerhebung erfolgt alle 60 Sekunden.
Durchsatz – Cache-Treffer Projekt Der Durchsatz, der von allen Caches für einen Bucket bereitgestellt wurde. Die Stichprobenerhebung erfolgt alle 60 Sekunden.
Durchsatz – Cache-Fehler Bucket Der Durchsatz, der nicht aus dem Cache bereitgestellt wird. Die Stichprobenerhebung erfolgt alle 60 Sekunden.
Durchsatz – Cache-Fehler Projekt Der Durchsatz, der nicht von einem der Caches eines Buckets bereitgestellt wird. Die Stichprobenerhebung erfolgt alle 60 Sekunden.

Auf Diagramme zugreifen

Monitoring-Diagramme erfassen Daten entweder für einzelne Buckets oder für alle Buckets in einem Projekt. Die Ebene der Ressourcenhierarchie, die ein Diagramm erfasst, bestimmt, wo Sie auf das Diagramm zugreifen können.

Auf Diagramme auf Bucket-Ebene zugreifen

  1. Wechseln Sie in der Cloud de Confiance Console unter „Cloud Storage“ zur Seite Buckets.

    Buckets aufrufen

  2. Klicken Sie in der Liste der Buckets auf den Namen des Buckets, für den Sie Monitoring-Diagramme aufrufen möchten.

  3. Klicken Sie auf der Seite Bucket-Details auf den Tab Beobachtbarkeit.

  4. Wählen Sie im Navigationsmenü Rapid Cache aus.

    Monitoring-Diagramme werden angezeigt.

Auf Diagramme auf Projektebene zugreifen

  1. Wechseln Sie in der Cloud de Confiance Console unter „Cloud Storage“ zur Seite Buckets.

    Buckets aufrufen

  2. Klicken Sie im Navigationsbereich von Cloud Storage auf Monitoring.

  3. Klicken Sie in der Menüleiste auf Rapid Cache.

    Monitoring-Diagramme werden angezeigt.

Vorgänge mit langer Ausführungszeit verwenden

Wenn die Vorgänge AnywhereCaches Create und Update erfolgreich ausgeführt werden, wird ein Vorgang mit langer Ausführungszeit initiiert. Sie können Vorgänge mit langer Ausführungszeit abrufen und auflisten, um Details und Status des zugrunde liegenden AnywhereCaches-Vorgangs anzusehen, oder einen Vorgang mit langer Ausführungszeit abbrechen, um den zugrunde liegenden AnywhereCaches-Vorgang während der Ausführung abzubrechen.

Eine Anleitung zur Verwendung von Vorgängen mit langer Ausführungszeit für Rapid Cache finden Sie unter Vorgänge mit langer Ausführungszeit verwenden.

Das folgende Beispiel zeigt einen Vorgang mit langer Ausführungszeit, der von einem AnywhereCaches-Erstellungsvorgang initiiert wird:

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

Wiederholungsversuche

Asynchrone AnywhereCaches APIs sind standardmäßig idempotent. Das bedeutet, dass Sie asynchrone AnywhereCaches API-Aufrufe sicher wiederholen können, ohne sich Gedanken über unbeabsichtigte Änderungen zu machen.

Angenommen, Sie führen einen AnywhereCaches-Erstellungsvorgang aus, um einen Cache in us-central1-a zu erstellen, und dieser Vorgang ist erfolgreich. Wenn Sie einen nachfolgenden AnywhereCaches-Erstellungsvorgang mit derselben Zone ausführen, der erfolgreich ist, gibt die Anfrage denselben Vorgang mit langer Ausführungszeit wie die vorherige Anfrage zurück. Dieses Verhalten tritt nur auf, wenn Sie in Ihrer Anfrage zum Erstellen eines Cache einen request_id angeben. Wenn kein request_id enthalten ist, erhalten Sie beim Versuch, einen bereits vorhandenen Cache zu erstellen, den Fehler ANYWHERE_CACHE_ALREADY_EXISTS. Informationen zum Einfügen einer request_id finden Sie unter Anfrageidentifikation.

Nächste Schritte

Empfehlungen dazu erhalten, für welche Buckets und Zonen ein Cache erstellt werden soll.