Crea y administra cachés de Anywhere Cache

Console

1. En la consola de Google Cloud , ve a la página Buckets de Cloud Storage.
   

   Ir a Buckets

2. En la lista de buckets, haz clic en el nombre del bucket para el que deseas almacenar datos en caché.

3. En la página de detalles del bucket haz clic en la pestaña Configuración.

4. En la sección Anywhere Cache, haz clic en Configurar caché.

   Aparecerá la página Editar configuración para <your_bucket_name> de tu bucket.

5. En la sección Regiones de caché, haz clic en la región que contiene las zonas en las que deseas crear una caché.

6. En la sección Zonas de caché, selecciona las zonas en las que deseas crear una caché. Para cada zona que selecciones, especifica un Tiempo de actividad y una opción de Ingestión para la caché.

7. Haga clic en Guardar configuración.

8. En el cuadro de diálogo que aparece, haz clic en Permitir.

   Se abrirá la pestaña Operaciones en la página Detalles del bucket, en la que se muestra el estado del trabajo de la operación de creación de caché.

También puedes ver el estado de la caché de un bucket directamente desde la página Lista de buckets. Para ello, completa los siguientes pasos:

1. En la consola de Google Cloud , ve a la página Buckets de Cloud Storage.
   

   Ir a Buckets

2. Haz clic en el ícono de Ver columna (view_column), selecciona Caché y, luego, haz clic en Aceptar.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches create:

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

Reemplaza lo siguiente:

• BUCKET_NAME por el nombre del bucket para el que deseas almacenar datos en caché. Por ejemplo, my-bucket

• ZONE por la zona en la que se ejecutará la caché. Por ejemplo, us-east1-b

  Para crear varias cachés a la vez, puedes especificar varias zonas. Por ejemplo, us-east1-b us-east1-c us-east1-d.

Configura las siguientes marcas opcionales para tener un mayor control sobre la creación de la caché:

• --ttl: Especifica el tiempo de actividad (TTL) de los datos en la caché, en segundos. Si no se especifica, el valor predeterminado es 86400s (24 horas).

• --admission-policy: Especifica en qué momento se transfieren los datos a la caché. Los valores pueden ser ADMIT_ON_FIRST_MISS o ADMIT_ON_SECOND_MISS. Si no se especifica, el valor predeterminado es ADMIT_ON_FIRST_MISS.

Si se ejecuta correctamente, el comando devuelve el ID de la operación de larga duración asociada con la operación de creación de AnywhereCache. Puedes obtener detalles sobre la operación de larga duración o cancelarla para detener la operación de creación de AnywhereCaches antes de que se complete.

Bibliotecas cliente

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 documentación de google_storage_anywhere_cache de Terraform para obtener detalles sobre cómo usar Anywhere Cache con Terraform.

API de REST

Console

1. En la consola de Google Cloud , ve a la página Buckets de Cloud Storage.
   

   Ir a Buckets

2. En la lista de buckets, haz clic en el nombre del bucket asociado con la caché que deseas ver.

3. En la página de detalles del bucket haz clic en la pestaña Configuración.

4. En la sección Anywhere Cache, haz clic en edit Editar junto al campo Caché.

5. En la página Editar configuración que aparece, selecciona una región para ver todas las memorias caché dentro de las zonas de la región.

   En el panel Zonas de caché, puedes ver detalles sobre cada caché disponible.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches describe:

gcloud storage buckets anywhere-caches describe ID

Reemplaza lo siguiente:

• ID con el identificador de la instancia de caché, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por ejemplo, my-bucket/us-east1-b.

Usa la marca opcional raw para generar una respuesta sin procesar de la API en lugar de una respuesta estandarizada de la API.

Si se completa correctamente, el comando devuelve un recurso de AnywhereCache.

Bibliotecas cliente

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 documentación de google_storage_anywhere_cache de Terraform para obtener detalles sobre cómo usar Anywhere Cache con Terraform.

API de REST

Console

1. En la consola de Google Cloud , ve a la página Buckets de Cloud Storage.
   

   Ir a Buckets

2. En la lista de buckets, haz clic en el nombre del bucket asociado con las cachés que deseas ver.

3. En la página de detalles del bucket haz clic en la pestaña Configuración.

4. En la sección Anywhere Cache, haz clic en edit Editar junto al campo Caché.

5. En la página Editar configuración que aparece, selecciona una región para ver todas las memorias caché dentro de las zonas de esa región.

   Todas las memorias caché disponibles para las zonas dentro de la región aparecen en el panel Zonas de caché.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches list:

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

Reemplaza lo siguiente:

• BUCKET_NAME con el nombre del bucket asociado con los cachés que deseas enumerar. Por ejemplo, my-bucket

Si se ejecuta correctamente, el comando devuelve una lista de recursos de AnywhereCache.

De manera opcional, puedes usar la marca --raw para devolver una respuesta sin procesar de la API en lugar de una respuesta estandarizada. Para obtener más información sobre el control del comportamiento de las listas, como la paginación de los resultados, consulta la documentación de gcloud storage ls.

Bibliotecas cliente

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 documentación de google_storage_anywhere_cache de Terraform para obtener detalles sobre cómo usar Anywhere Cache con Terraform.

API de REST

Console

1. En la consola de Google Cloud , ve a la página Buckets de Cloud Storage.
   

   Ir a Buckets

2. En la lista de buckets, haz clic en el nombre del bucket asociado con la caché que deseas actualizar.

3. En la página Detalles del bucket, haz clic en la pestaña Observabilidad y, luego, en Anywhere Cache en el menú de navegación.

4. Haz clic en Editar configuración.

5. En la página Editar configuración que aparece, actualiza las propiedades de la caché y, luego, haz clic en Guardar.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches update:

gcloud storage buckets anywhere-caches update ID

Reemplaza lo siguiente:

• ID con el identificador de la instancia de caché, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por ejemplo, my-bucket/us-east1-b.

  Para actualizar varias cachés a la vez, puedes especificar varios identificadores. Por ejemplo, my-bucket/us-east1-b my-bucket/us-east1-c.

Usa las siguientes marcas para actualizar la configuración de la caché. Si no se especifica una marca, el valor no se modifica.

• --ttl: Especifica el tiempo de actividad (TTL) de los datos en la caché, en segundos.

• --admission-policy: Especifica en qué momento se transfieren los datos a la caché. Los valores pueden ser ADMIT_ON_FIRST_MISS o ADMIT_ON_SECOND_MISS.

Si se ejecuta correctamente, el comando devuelve el ID de la operación sin procesar de larga duración asociada con la operación de actualización de Anywhere Cache. Puedes obtener detalles sobre la operación de larga duración.

Bibliotecas cliente

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 documentación de google_storage_anywhere_cache de Terraform para obtener detalles sobre cómo usar Anywhere Cache con Terraform.

API de REST

Console

1. En la consola de Google Cloud , ve a la página Buckets de Cloud Storage.
   

   Ir a Buckets

2. En la lista de buckets, haz clic en el nombre del bucket asociado con la caché que deseas pausar.

3. En la página Detalles del bucket, haz clic en la pestaña Observabilidad y, luego, en Anywhere Cache en el menú de navegación.

4. Haz clic en Pausar o reanudar cachés.

5. En el panel que aparece, haz clic en el ícono de Pausar caché (pause).

6. Haz clic en Cerrar.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches pause:

gcloud storage buckets anywhere-caches pause ID

Reemplaza lo siguiente:

• ID con el identificador de la instancia de caché, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por ejemplo, my-bucket/us-east1-b.

  Para pausar varias memorias caché a la vez, puedes especificar varios identificadores. Por ejemplo, my-bucket/us-east1-b my-bucket/us-east1-c.

Si se ejecuta correctamente, el comando mostrará un mensaje de éxito.

Bibliotecas cliente

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 documentación de google_storage_anywhere_cache de Terraform para obtener detalles sobre cómo usar Anywhere Cache con Terraform.

API de REST

Console

Para reanudar una caché que se detuvo, completa las siguientes instrucciones:

1. En la consola de Google Cloud , ve a la página Buckets de Cloud Storage.
   

   Ir a Buckets

2. En la lista de buckets, haz clic en el nombre del bucket asociado con la caché que deseas reanudar.

3. En la página Detalles del bucket, haz clic en la pestaña Observabilidad y, luego, en Anywhere Cache en el menú de navegación.

4. Haz clic en Pausar o reanudar cachés.

5. En el panel que aparece, haz clic en el ícono de Reanudar caché (play_arrow).

6. Haz clic en Cerrar.

Para reanudar una caché que se inhabilitó, completa las siguientes instrucciones:

1. En la consola de Google Cloud , ve a la página Buckets de Cloud Storage.
   

   Ir a Buckets

2. En la lista de buckets, haz clic en el nombre del bucket asociado con la caché que deseas reanudar.

3. En la página Detalles del bucket, haz clic en la pestaña Observabilidad y, luego, en Anywhere Cache en el menú de navegación.

4. Haz clic en Inhabilitar o reanudar cachés.

5. En el panel que aparece, haz clic en el ícono de Reanudar caché (play_arrow).

6. Haz clic en Cerrar.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches resume:

gcloud storage buckets anywhere-caches resume ID

Reemplaza lo siguiente:

• ID con el identificador de la instancia de caché, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por ejemplo, my-bucket/us-east1-b.

  Para reanudar varias cachés a la vez, puedes especificar varios identificadores. Por ejemplo, my-bucket/us-east1-b my-bucket/us-east1-c.

Si se completa correctamente, el comando devuelve un recurso de AnywhereCache con formato.

Bibliotecas cliente

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 documentación de google_storage_anywhere_cache de Terraform para obtener detalles sobre cómo usar Anywhere Cache con Terraform.

API de REST

Console

1. En la consola de Google Cloud , ve a la página Buckets de Cloud Storage.
   

   Ir a Buckets

2. En la lista de buckets, haz clic en el nombre del bucket asociado con la caché que deseas inhabilitar.

3. En la página Detalles del bucket, haz clic en la pestaña Observabilidad y, luego, en Anywhere Cache en el menú de navegación.

4. Haz clic en Inhabilitar o reanudar cachés.

5. En el panel que aparece, haz clic en el ícono de Inhabilitar caché (delete).

6. En el cuadro de diálogo que aparece, haz clic en Permitir.

7. Haz clic en Cerrar.

Línea de comandos

Usa el comando gcloud storage buckets anywhere-caches disable:

gcloud storage buckets anywhere-caches disable ID

Reemplaza lo siguiente:

• ID con el identificador de la instancia de caché, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por ejemplo, my-bucket/us-east1-b.

  Para inhabilitar varias memorias caché a la vez, puedes especificar varios identificadores. Por ejemplo, my-bucket/us-east1-b my-bucket/us-east1-c.

Si se completa correctamente, el comando devuelve un recurso de AnywhereCache con formato.

Bibliotecas cliente

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 documentación de google_storage_anywhere_cache de Terraform para obtener detalles sobre cómo usar Anywhere Cache con Terraform.

API de REST