Anywhere Cache-Caches erstellen und verwalten

Console

1. Wechseln Sie in der Google Cloud 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 Bereich Anywhere Cache auf Cache konfigurieren.

   Die Seite Konfiguration für <your_bucket_name> bearbeiten wird für Ihren Bucket angezeigt.

5. Klicken Sie im Bereich 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. Geben Sie für jede ausgewählte Zone eine Gültigkeitsdauer und eine Aufnahme-Option für den Cache an.

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

8. Klicken Sie im angezeigten Dialogfeld auf Zulassen.

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

Sie können den Status des Caches eines Buckets auch direkt auf der Seite Bucket-Liste ansehen. Führen Sie dazu die folgenden Schritte aus:

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

   Buckets aufrufen

2. Klicken Sie auf das Symbol Spalte ansehen (view_column), 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 ZONE

Ersetzen Sie:

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

• Ersetzen Sie 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

Mit den folgenden optionalen Flags können Sie das Erstellen des Cache noch genauer steuern:

• --ttl: Geben Sie die Gültigkeitsdauer (TTL) der Daten im Cache in Sekunden an. Wenn nicht angegeben, lautet die Standardeinstellung 86400s (24 Stunden).

• --admission-policy: Gibt an, wann Daten in den Cache aufgenommen werden. Mögliche Werte sind ADMIT_ON_FIRST_MISS und ADMIT_ON_SECOND_MISS. Wenn nicht angegeben, lautet die Standardeinstellung ADMIT_ON_FIRST_MISS.

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

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";
}

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());
    }
  }
}

Terraform

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

REST APIs

Console

1. Wechseln Sie in der Google Cloud 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 Anywhere Cache (Anywhere-Cache) neben dem Feld Cache auf edit Bearbeiten.

5. Wählen Sie auf der Seite Konfiguration bearbeiten, die angezeigt wird, 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 ansehen.

Befehlszeile

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

gcloud storage buckets anywhere-caches describe ID

Ersetzen Sie:

• ID mit der Kennung der Cache-Instanz, formuliert als BUCKET_NAME/ANYWHERE_CACHE_ID. Beispiel: my-bucket/us-east1-b.

Mit dem optionalen Flag raw können Sie eine Roh-API-Antwort anstelle einer standardisierten API-Antwort ausgeben.

Bei Erfolg gibt der Befehl eine AnywhereCache-Ressource zurück.

Clientbibliotheken

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";
}

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());
    }
  }
}

Terraform

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

REST APIs

Console

1. Wechseln Sie in der Google Cloud 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 Anywhere Cache (Anywhere-Cache) neben dem Feld Cache auf edit 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.

Bei Erfolg gibt der Befehl eine Liste von AnywhereCache-Ressourcen zurück.

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

Clientbibliotheken

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";
  }
}

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());
      }
    }
  }
}

Terraform

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

REST APIs

Console

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

   Buckets aufrufen

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

3. Klicken Sie auf der Seite Bucket-Details auf den Tab Beobachtbarkeit und dann im Navigationsmenü auf Anywhere Cache.

4. Klicken Sie auf Konfiguration bearbeiten.

5. Aktualisieren Sie auf der Seite Konfiguration bearbeiten, die angezeigt wird, die Eigenschaften des Cache und klicken Sie dann auf Speichern.

Befehlszeile

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

gcloud storage buckets anywhere-caches update ID

Ersetzen Sie:

• ID mit der Kennung der Cache-Instanz, formuliert als BUCKET_NAME/ANYWHERE_CACHE_ID. 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.

Mit den folgenden Flags können Sie die Konfiguration des Cache aktualisieren. Wenn kein Flag angegeben ist, bleibt der Wert unverändert.

• --ttl: Geben Sie die Gültigkeitsdauer (TTL) der Daten im Cache in Sekunden an.

• --admission-policy: Gibt an, wann Daten in den Cache aufgenommen werden. Mögliche Werte sind ADMIT_ON_FIRST_MISS und ADMIT_ON_SECOND_MISS.

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

namespace storagecontrol = google::cloud::storagecontrol_v2;
[](storagecontrol::StorageControlClient client, std::string const& cache_name,
   std::string const& admission_policy) {
  google::storage::control::v2::AnywhereCache cache;
  google::protobuf::FieldMask field_mask;
  field_mask.add_paths("admission_policy");
  cache.set_name(cache_name);
  cache.set_admission_policy(admission_policy);
  // 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";
}

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());
    }
  }
}

Terraform

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

REST APIs

Console

1. Wechseln Sie in der Google Cloud 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 pausieren möchten.

3. Klicken Sie auf der Seite Bucket-Details auf den Tab Beobachtbarkeit und dann im Navigationsmenü auf Anywhere Cache.

4. Klicken Sie auf Caches pausieren/fortsetzen.

5. Klicken Sie im angezeigten Bereich auf das Symbol Cache pausieren (pause).

6. Klicken Sie auf Schließen.

Befehlszeile

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

gcloud storage buckets anywhere-caches pause ID

Ersetzen Sie:

• ID mit der Kennung der Cache-Instanz, formuliert als BUCKET_NAME/ANYWHERE_CACHE_ID. Beispiel: my-bucket/us-east1-b.

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

Wenn der Vorgang erfolgreich war, wird eine Erfolgsmeldung zurückgegeben.

Clientbibliotheken

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

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

public final class AnywhereCachePause {

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

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

      AnywhereCache anywhereCache = storageControl.pauseAnywhereCache(request);

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

Terraform

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

REST APIs

Console

So setzen Sie einen pausierten Cache fort:

1. Wechseln Sie in der Google Cloud 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 Beobachtbarkeit und dann im Navigationsmenü auf Anywhere Cache.

4. Klicken Sie auf Caches pausieren/fortsetzen.

5. Klicken Sie im angezeigten Bereich auf das Symbol Cache fortsetzen (play_arrow).

6. Klicken Sie auf Schließen.

So reaktivieren Sie einen deaktivierten Cache:

1. Wechseln Sie in der Google Cloud 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 Beobachtbarkeit und dann im Navigationsmenü auf Anywhere Cache.

4. Klicken Sie auf Caches deaktivieren/fortsetzen.

5. Klicken Sie im angezeigten Bereich auf das Symbol Cache fortsetzen (play_arrow).

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 ID

Ersetzen Sie:

• ID mit der Kennung der Cache-Instanz, formuliert als BUCKET_NAME/ANYWHERE_CACHE_ID. 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

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";
}

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());
    }
  }
}

Terraform

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

REST APIs

Console

1. Wechseln Sie in der Google Cloud 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 Beobachtbarkeit und dann im Navigationsmenü auf Anywhere Cache.

4. Klicken Sie auf Caches deaktivieren/fortsetzen.

5. Klicken Sie im angezeigten Bereich auf das Symbol Cache deaktivieren (delete).

6. Klicken Sie im angezeigten Dialogfeld auf Zulassen.

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 ID

Ersetzen Sie:

• ID mit der Kennung der Cache-Instanz, formuliert als BUCKET_NAME/ANYWHERE_CACHE_ID. 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

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";
}

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());
    }
  }
}

Terraform

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

REST APIs