Creare e gestire le cache Anywhere Cache

Console

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

   Vai a Bucket

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

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

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

   Viene visualizzata la pagina Modifica configurazione per <your_bucket_name> 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 di cache, seleziona le zone in cui vuoi creare una cache. Per ogni zona selezionata, specifica un Time to live e un'opzione di importazione per la cache.

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.

Puoi anche visualizzare lo stato della cache di un bucket direttamente dalla pagina Elenco bucket. Per farlo, segui queste istruzioni:

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

   Vai a Bucket

2. Fai clic sull'icona Visualizza colonna (view_column), 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 ZONE

Sostituisci:

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

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

Imposta i seguenti flag facoltativi per avere un maggiore controllo sulla creazione della cache:

• --ttl: specifica la durata (TTL) dei dati nella cache, in secondi. Se non specificato, il valore predefinito è 86400s (24 ore).

• --admission-policy: specifica in quale momento i dati vengono inseriti nella cache. I valori possono essere ADMIT_ON_FIRST_MISS o ADMIT_ON_SECOND_MISS. Se non specificato, il valore predefinito è ADMIT_ON_FIRST_MISS.

In caso di esito positivo, il comando restituisce l'ID dell'operazione a lunga esecuzione associata all'operazione di creazione di AnywhereCache. Puoi visualizzare i dettagli dell'operazione a lunga esecuzione o annullarla per interrompere l'operazione di creazione di AnywhereCache prima che venga completata.

Librerie client

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

Consulta la documentazione di Terraform per google_storage_anywhere_cache per informazioni dettagliate su come utilizzare Anywhere Cache con Terraform.

API REST

Console

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

   Vai a Bucket

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

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

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

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

   Nel riquadro Zone di cache, puoi visualizzare i dettagli di ogni cache disponibile.

Riga di comando

Utilizza il comando gcloud storage buckets anywhere-caches describe:

gcloud storage buckets anywhere-caches describe ID

Sostituisci:

• ID con l'identificatore dell'istanza della cache, formulato come BUCKET_NAME/ANYWHERE_CACHE_ID. Ad esempio, my-bucket/us-east1-b.

Utilizza il flag facoltativo raw per restituire una risposta API non elaborata anziché una risposta API standardizzata.

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

Librerie client

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

Consulta la documentazione di Terraform per google_storage_anywhere_cache per informazioni dettagliate su come utilizzare Anywhere Cache con Terraform.

API REST

Console

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

   Vai a Bucket

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

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

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

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

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

Riga di comando

Utilizza il comando gcloud storage buckets anywhere-caches list:

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

Sostituisci:

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

In caso di esito positivo, il comando restituisce un elenco di risorse AnywhereCache.

Puoi utilizzare facoltativamente il flag --raw per restituire una risposta API non elaborata anziché una risposta standardizzata. Per saperne di più sul controllo del comportamento degli elenchi, ad esempio la paginazione dei risultati, consulta la documentazione gcloud storage ls.

Librerie client

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

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

Consulta la documentazione di Terraform per google_storage_anywhere_cache per informazioni dettagliate su come utilizzare Anywhere Cache con Terraform.

API REST

Console

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

   Vai a Bucket

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

3. Nella pagina Dettagli bucket, fai clic sulla scheda Osservabilità, quindi su Anywhere Cache nel menu di navigazione.

4. Fai clic su Modifica configurazione.

5. Nella pagina Modifica configurazione visualizzata, aggiorna le proprietà della cache, poi fai clic su Salva.

Riga di comando

Utilizza il comando gcloud storage buckets anywhere-caches update:

gcloud storage buckets anywhere-caches update ID

Sostituisci:

• ID con l'identificatore dell'istanza della cache, formulato come BUCKET_NAME/ANYWHERE_CACHE_ID. 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.

Utilizza i seguenti flag per aggiornare la configurazione della cache. Se un flag non è specificato, il valore rimane invariato.

• --ttl: specifica la durata (TTL) dei dati nella cache, in secondi.

• --admission-policy: specifica in quale momento i dati vengono inseriti nella cache. I valori possono essere ADMIT_ON_FIRST_MISS o ADMIT_ON_SECOND_MISS.

In caso di esito positivo, il comando restituisce l'ID dell'operazione a lunga esecuzione non elaborata associata all'operazione di aggiornamento di AnywhereCache. Puoi visualizzare i dettagli dell'operazione a lunga esecuzione.

Librerie client

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

Consulta la documentazione di Terraform per google_storage_anywhere_cache per informazioni dettagliate su come utilizzare Anywhere Cache con Terraform.

API REST

Console

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

   Vai a Bucket

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

3. Nella pagina Dettagli bucket, fai clic sulla scheda Osservabilità, quindi su Anywhere Cache nel menu di navigazione.

4. Fai clic su Metti in pausa/riprendi le cache.

5. Nel riquadro visualizzato, fai clic sull'icona Metti in pausa la cache (pause).

6. Fai clic su Chiudi.

Riga di comando

Utilizza il comando gcloud storage buckets anywhere-caches pause:

gcloud storage buckets anywhere-caches pause ID

Sostituisci:

• ID con l'identificatore dell'istanza della cache, formulato come BUCKET_NAME/ANYWHERE_CACHE_ID. Ad esempio, my-bucket/us-east1-b.

  Per mettere in pausa 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 un messaggio di operazione riuscita.

Librerie client

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

Consulta la documentazione di Terraform per google_storage_anywhere_cache per informazioni dettagliate su come utilizzare Anywhere Cache con Terraform.

API REST

Console

Per riprendere una cache che è stata messa in pausa:

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

   Vai a Bucket

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

3. Nella pagina Dettagli bucket, fai clic sulla scheda Osservabilità, quindi su Anywhere Cache nel menu di navigazione.

4. Fai clic su Metti in pausa/riprendi le cache.

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

6. Fai clic su Chiudi.

Per riattivare una cache disattivata, segui queste istruzioni:

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

   Vai a Bucket

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

3. Nella pagina Dettagli bucket, fai clic sulla scheda Osservabilità, quindi su Anywhere Cache nel menu di navigazione.

4. Fai clic su Disattiva/riprendi le cache.

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

6. Fai clic su Chiudi.

Riga di comando

Utilizza il comando gcloud storage buckets anywhere-caches resume:

gcloud storage buckets anywhere-caches resume ID

Sostituisci:

• ID con l'identificatore dell'istanza della cache, formulato come BUCKET_NAME/ANYWHERE_CACHE_ID. 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

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

Consulta la documentazione di Terraform per google_storage_anywhere_cache per informazioni dettagliate su come utilizzare Anywhere Cache con Terraform.

API REST

Console

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

   Vai a Bucket

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

3. Nella pagina Dettagli bucket, fai clic sulla scheda Osservabilità, quindi su Anywhere Cache nel menu di navigazione.

4. Fai clic su Disattiva/riprendi le cache.

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

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 ID

Sostituisci:

• ID con l'identificatore dell'istanza della cache, formulato come BUCKET_NAME/ANYWHERE_CACHE_ID. 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

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

Consulta la documentazione di Terraform per google_storage_anywhere_cache per informazioni dettagliate su come utilizzare Anywhere Cache con Terraform.

API REST