Créer et gérer des caches Anywhere Cache

Console

1. Dans la console Google Cloud , accédez à la page Buckets de Cloud Storage.
   

   Accéder à la page "Buckets"

2. Dans la liste des buckets, cliquez sur le nom du bucket pour lequel vous souhaitez mettre en cache les données.

3. Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.

4. Dans la section Cache Anywhere, cliquez sur Configurer le cache.

   La page Modifier la configuration pour <your_bucket_name> s'affiche pour votre bucket.

5. Dans la section Régions du cache, cliquez sur la région contenant les zones dans lesquelles vous souhaitez créer un cache.

6. Dans la section Zones de cache, sélectionnez les zones dans lesquelles vous souhaitez créer un cache. Pour chaque zone sélectionnée, spécifiez une durée de vie et une option d'ingestion pour le cache.

7. Cliquez sur Enregistrer la configuration.

8. Dans la boîte de dialogue qui s'affiche, cliquez sur Autoriser.

   L'onglet Opérations de la page Détails du bucket s'ouvre. Il affiche l'état de la tâche de création du cache.

Vous pouvez également afficher l'état du cache d'un bucket directement sur la page Liste des buckets. Pour ce faire, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Buckets de Cloud Storage.
   

   Accéder à la page "Buckets"

2. Cliquez sur l'icône Afficher la colonne (view_column), sélectionnez Cache, puis cliquez sur OK.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches create :

gcloud storage buckets anywhere-caches create gs://BUCKET_NAME ZONE

Remplacez :

• BUCKET_NAME par le nom du bucket pour lequel vous souhaitez mettre en cache les données. Exemple :my-bucket

• ZONE par la zone dans laquelle le cache s'exécutera. Exemple :us-east1-b

  Pour créer plusieurs caches à la fois, vous pouvez spécifier plusieurs zones. (par exemple, us-east1-b us-east1-c us-east1-d)

Définissez les options facultatives suivantes pour mieux contrôler la création du cache :

• --ttl : spécifiez la valeur TTL (Time To Live) des données dans le cache, en secondes. Si aucune valeur n'est spécifiée, la valeur par défaut est 86400s (24 heures).

• --admission-policy : spécifiez à quel moment les données sont ingérées dans le cache. Les valeurs peuvent être ADMIT_ON_FIRST_MISS ou ADMIT_ON_SECOND_MISS. Si aucune valeur n'est spécifiée, la valeur par défaut est ADMIT_ON_FIRST_MISS.

Si l'opération réussit, la commande renvoie l'ID de l'opération de longue durée associée à l'opération de création AnywhereCache. Vous pouvez obtenir des détails sur l'opération de longue durée ou bien l'annuler, afin d'interrompre l'opération de création AnywhereCaches avant qu'elle n'arrive à son terme.

Bibliothèques clientes

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

Consultez la documentation Terraform google_storage_anywhere_cache pour savoir comment utiliser Anywhere Cache avec Terraform.

API REST

Console

1. Dans la console Google Cloud , accédez à la page Buckets de Cloud Storage.
   

   Accéder à la page "Buckets"

2. Dans la liste des buckets, cliquez sur le nom du bucket associé au cache que vous souhaitez afficher.

3. Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.

4. Dans la section Cache Anywhere, cliquez sur edit Modifier à côté du champ Cache.

5. Sur la page Modifier la configuration qui s'affiche, sélectionnez une région pour afficher tous les caches dans les zones de la région.

   Dans le volet Zones de cache, vous pouvez ensuite afficher des informations sur chaque cache disponible.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches describe :

gcloud storage buckets anywhere-caches describe ID

Remplacez :

• ID avec l'identifiant de l'instance de cache, formulé comme BUCKET_NAME/ANYWHERE_CACHE_ID. Exemple : my-bucket/us-east1-b.

Utilisez l'indicateur facultatif raw pour générer une réponse d'API brute au lieu d'une réponse d'API standardisée.

Si l'opération réussit, la commande renvoie une ressource AnywhereCache.

Bibliothèques clientes

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

Consultez la documentation Terraform google_storage_anywhere_cache pour savoir comment utiliser Anywhere Cache avec Terraform.

API REST

Console

1. Dans la console Google Cloud , accédez à la page Buckets de Cloud Storage.
   

   Accéder à la page "Buckets"

2. Dans la liste des buckets, cliquez sur le nom du bucket associé aux caches que vous souhaitez afficher.

3. Sur la page Informations sur le bucket, cliquez sur l'onglet Configuration.

4. Dans la section Cache Anywhere, cliquez sur edit Modifier à côté du champ Cache.

5. Sur la page Modifier la configuration qui s'affiche, sélectionnez une région pour afficher tous les caches dans les zones de cette région.

   Tous les caches disponibles pour les zones de la région s'affichent dans le volet Zones de cache.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches list :

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

Remplacez :

• BUCKET_NAME par le nom du bucket associé aux caches que vous souhaitez répertorier. Exemple :my-bucket

Si l'opération réussit, la commande renvoie une liste de ressources AnywhereCache.

Vous pouvez également utiliser l'indicateur --raw pour renvoyer une réponse d'API brute au lieu d'une réponse standardisée. Pour en savoir plus sur le contrôle des comportements de liste, comme la pagination des résultats, consultez la documentation gcloud storage ls.

Bibliothèques clientes

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

Consultez la documentation Terraform google_storage_anywhere_cache pour savoir comment utiliser Anywhere Cache avec Terraform.

API REST

Console

1. Dans la console Google Cloud , accédez à la page Buckets de Cloud Storage.
   

   Accéder à la page "Buckets"

2. Dans la liste des buckets, cliquez sur le nom du bucket associé au cache que vous souhaitez mettre à jour.

3. Sur la page Informations sur le bucket, cliquez sur l'onglet Observabilité, puis sur Anywhere Cache dans le menu de navigation.

4. Cliquez sur Modifier la configuration.

5. Sur la page Modifier la configuration qui s'affiche, mettez à jour les propriétés du cache, puis cliquez sur Enregistrer.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches update :

gcloud storage buckets anywhere-caches update ID

Remplacez :

• ID avec l'identifiant de l'instance de cache, formulé comme BUCKET_NAME/ANYWHERE_CACHE_ID. Exemple : my-bucket/us-east1-b.

  Pour mettre à jour plusieurs caches à la fois, vous pouvez spécifier plusieurs identifiants. Par exemple, my-bucket/us-east1-b my-bucket/us-east1-c.

Utilisez les indicateurs suivants pour mettre à jour la configuration du cache. Si aucun indicateur n'est spécifié, la valeur reste inchangée.

• --ttl : spécifiez la valeur TTL (Time To Live) des données dans le cache, en secondes.

• --admission-policy : spécifiez à quel moment les données sont ingérées dans le cache. Les valeurs peuvent être ADMIT_ON_FIRST_MISS ou ADMIT_ON_SECOND_MISS.

Si l'opération réussit, la commande renvoie l'ID de l'opération de longue durée brute associée à l'opération de mise à jour AnywhereCache. Vous pouvez obtenir des détails sur l'opération de longue durée.

Bibliothèques clientes

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

Consultez la documentation Terraform google_storage_anywhere_cache pour savoir comment utiliser Anywhere Cache avec Terraform.

API REST

Console

1. Dans la console Google Cloud , accédez à la page Buckets de Cloud Storage.
   

   Accéder à la page "Buckets"

2. Dans la liste des buckets, cliquez sur le nom du bucket associé au cache que vous souhaitez suspendre.

3. Sur la page Informations sur le bucket, cliquez sur l'onglet Observabilité, puis sur Anywhere Cache dans le menu de navigation.

4. Cliquez sur Suspendre/Réactiver les caches.

5. Dans le volet qui s'affiche, cliquez sur l'icône Mettre en veille le cache (pause).

6. Cliquez sur Fermer.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches pause :

gcloud storage buckets anywhere-caches pause ID

Remplacez :

• ID avec l'identifiant de l'instance de cache, formulé comme BUCKET_NAME/ANYWHERE_CACHE_ID. Exemple : my-bucket/us-east1-b.

  Pour mettre en veille plusieurs caches à la fois, vous pouvez spécifier plusieurs identifiants. Par exemple, my-bucket/us-east1-b my-bucket/us-east1-c.

Si l'opération réussit, la commande renvoie un message de confirmation.

Bibliothèques clientes

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

Consultez la documentation Terraform google_storage_anywhere_cache pour savoir comment utiliser Anywhere Cache avec Terraform.

API REST

Console

Pour reprendre un cache suspendu, suivez les instructions ci-dessous :

1. Dans la console Google Cloud , accédez à la page Buckets de Cloud Storage.
   

   Accéder à la page "Buckets"

2. Dans la liste des buckets, cliquez sur le nom du bucket associé au cache que vous souhaitez reprendre.

3. Sur la page Informations sur le bucket, cliquez sur l'onglet Observabilité, puis sur Anywhere Cache dans le menu de navigation.

4. Cliquez sur Suspendre/Réactiver les caches.

5. Dans le volet qui s'affiche, cliquez sur l'icône Reprendre le cache (play_arrow).

6. Cliquez sur Fermer.

Pour réactiver un cache désactivé, procédez comme suit :

1. Dans la console Google Cloud , accédez à la page Buckets de Cloud Storage.
   

   Accéder à la page "Buckets"

2. Dans la liste des buckets, cliquez sur le nom du bucket associé au cache que vous souhaitez reprendre.

3. Sur la page Informations sur le bucket, cliquez sur l'onglet Observabilité, puis sur Anywhere Cache dans le menu de navigation.

4. Cliquez sur Désactiver/Réactiver les caches.

5. Dans le volet qui s'affiche, cliquez sur l'icône Reprendre le cache (play_arrow).

6. Cliquez sur Fermer.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches resume :

gcloud storage buckets anywhere-caches resume ID

Remplacez :

• ID avec l'identifiant de l'instance de cache, formulé comme BUCKET_NAME/ANYWHERE_CACHE_ID. Exemple : my-bucket/us-east1-b.

  Pour reprendre plusieurs caches à la fois, vous pouvez spécifier plusieurs identifiants. Par exemple, my-bucket/us-east1-b my-bucket/us-east1-c.

Si l'opération réussit, la commande renvoie une ressource AnywhereCache mise en forme.

Bibliothèques clientes

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

Consultez la documentation Terraform google_storage_anywhere_cache pour savoir comment utiliser Anywhere Cache avec Terraform.

API REST

Console

1. Dans la console Google Cloud , accédez à la page Buckets de Cloud Storage.
   

   Accéder à la page "Buckets"

2. Dans la liste des buckets, cliquez sur le nom du bucket associé au cache que vous souhaitez désactiver.

3. Sur la page Informations sur le bucket, cliquez sur l'onglet Observabilité, puis sur Anywhere Cache dans le menu de navigation.

4. Cliquez sur Désactiver/Réactiver les caches.

5. Dans le volet qui s'affiche, cliquez sur l'icône Désactiver le cache (delete).

6. Dans la boîte de dialogue qui s'affiche, cliquez sur Autoriser.

7. Cliquez sur Fermer.

Ligne de commande

Exécutez la commande gcloud storage buckets anywhere-caches disable :

gcloud storage buckets anywhere-caches disable ID

Remplacez :

• ID avec l'identifiant de l'instance de cache, formulé comme BUCKET_NAME/ANYWHERE_CACHE_ID. Exemple : my-bucket/us-east1-b.

  Pour désactiver plusieurs caches à la fois, vous pouvez spécifier plusieurs identifiants. Par exemple, my-bucket/us-east1-b my-bucket/us-east1-c.

Si l'opération réussit, la commande renvoie une ressource AnywhereCache mise en forme.

Bibliothèques clientes

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

Consultez la documentation Terraform google_storage_anywhere_cache pour savoir comment utiliser Anywhere Cache avec Terraform.

API REST