Criar e gerenciar caches do Anywhere Cache

Console

1. No console Google Cloud , acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Na lista de buckets, clique no nome do bucket em que você quer armazenar dados em cache.

3. Na página Detalhes do bucket, clique na guia Configuração.

4. Na seção Cache em qualquer lugar, clique em Configurar cache.

   A página Editar configuração para <your_bucket_name> aparece para seu bucket.

5. Na seção Regiões de cache, clique na região que contém as zonas em que você quer criar um cache.

6. Na seção Zonas de cache, selecione as zonas em que você quer criar um cache. Para cada zona selecionada, especifique um Tempo de vida e uma opção de Ingestão para o cache.

7. Clique em Salvar configuração.

8. Na caixa de diálogo que aparece, clique em Confirmar.

   A guia Operações na página Detalhes do bucket é aberta, mostrando o status do job da operação de criação de cache.

Também é possível conferir o status do cache de um bucket diretamente na página Lista de buckets. Para isso, siga estas instruções:

1. No console Google Cloud , acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Clique no ícone Mostrar coluna (view_column), selecione Cache e clique em OK.

Linha de comando

Use o comando gcloud storage buckets anywhere-caches create:

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

Substitua:

• BUCKET_NAME com o nome do bucket para o qual você quer armazenar dados em cache. Por exemplo, my-bucket.

• ZONE pela zona em que o cache será executado. Por exemplo, us-east1-b.

  Para criar vários caches de uma só vez, especifique várias zonas. Por exemplo, us-east1-b us-east1-c us-east1-d.

Para ter mais controle sobre a criação do cache, defina as seguintes flags opcionais:

• --ttl: especifique o time to live (TTL) dos dados no cache, em segundos. Se não for especificado, o padrão será 86400s (24 horas).

• --admission-policy: especifique em que momento os dados são ingeridos no cache. Os valores podem ser ADMIT_ON_FIRST_MISS ou ADMIT_ON_SECOND_MISS. Se não for especificado, o padrão será ADMIT_ON_FIRST_MISS.

Se bem-sucedido, o comando vai retornar o ID da operação de longa duração associada à operação de criação do AnywhereCache. É possível ver detalhes sobre a operação de longa duração ou cancelar a operação de longa duração para interromper a operação de criação do AnywhereCaches antes que ela seja concluída.

Bibliotecas de 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

Consulte a documentação do Terraform google_storage_anywhere_cache para detalhes sobre como usar o Anywhere Cache com o Terraform.

APIs REST

Console

1. No console Google Cloud , acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Na lista de buckets, clique no nome do bucket associado ao cache que você quer visualizar.

3. Na página Detalhes do bucket, clique na guia Configuração.

4. Na seção Cache em qualquer lugar, clique em edit Editar ao lado do campo Cache.

5. Na página Editar configuração, selecione uma região para ver todos os caches nas zonas dela.

   No painel Zonas de cache, é possível conferir detalhes sobre cada cache disponível.

Linha de comando

Use o comando gcloud storage buckets anywhere-caches describe:

gcloud storage buckets anywhere-caches describe ID

Substitua:

• ID com o identificador da instância de cache, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por exemplo, my-bucket/us-east1-b.

Use a flag opcional raw para gerar uma resposta bruta da API em vez de uma resposta padronizada.

Se o comando for bem-sucedido, ele vai retornar um recurso AnywhereCache.

Bibliotecas de 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

Consulte a documentação do Terraform google_storage_anywhere_cache para detalhes sobre como usar o Anywhere Cache com o Terraform.

APIs REST

Console

1. No console Google Cloud , acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Na lista de buckets, clique no nome do bucket associado aos caches que você quer visualizar.

3. Na página Detalhes do bucket, clique na guia Configuração.

4. Na seção Cache em qualquer lugar, clique em edit Editar ao lado do campo Cache.

5. Na página Editar configuração, selecione uma região para conferir todos os caches nas zonas dela.

   Todos os caches disponíveis para zonas na região aparecem no painel Zonas de cache.

Linha de comando

Use o comando gcloud storage buckets anywhere-caches list:

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

Substitua:

• BUCKET_NAME com o nome do bucket associado aos caches que você quer listar. Por exemplo, my-bucket.

Se o comando for bem-sucedido, ele vai retornar uma lista de recursos do AnywhereCache.

Você pode usar a flag --raw para retornar uma resposta bruta da API em vez de uma resposta padronizada. Para mais informações sobre como controlar comportamentos de listagem, como paginação de resultados, consulte a documentação do gcloud storage ls.

Bibliotecas de 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

Consulte a documentação do Terraform google_storage_anywhere_cache para detalhes sobre como usar o Anywhere Cache com o Terraform.

APIs REST

Console

1. No console Google Cloud , acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Na lista de buckets, clique no nome do bucket associado ao cache que você quer atualizar.

3. Na página Detalhes do bucket, clique na guia Observabilidade e em Anywhere Cache no menu de navegação.

4. Clique em Editar configurações.

5. Na página Editar configuração, atualize as propriedades do cache e clique em Salvar.

Linha de comando

Use o comando gcloud storage buckets anywhere-caches update:

gcloud storage buckets anywhere-caches update ID

Substitua:

• ID com o identificador da instância de cache, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por exemplo, my-bucket/us-east1-b.

  Para atualizar vários caches de uma só vez, especifique vários identificadores. Por exemplo, my-bucket/us-east1-b my-bucket/us-east1-c

Use as flags a seguir para atualizar a configuração do cache. Se uma flag não for especificada, o valor vai permanecer inalterado.

• --ttl: especifique o time to live (TTL) dos dados no cache, em segundos.

• --admission-policy: especifique em que momento os dados são ingeridos no cache. Os valores podem ser ADMIT_ON_FIRST_MISS ou ADMIT_ON_SECOND_MISS.

Se for bem-sucedido, o comando vai retornar o ID da operação bruta de longa duração associada à operação de atualização do AnywhereCache. É possível acessar detalhes sobre a operação de longa duração.

Bibliotecas de 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

Consulte a documentação do Terraform google_storage_anywhere_cache para detalhes sobre como usar o Anywhere Cache com o Terraform.

APIs REST

Console

1. No console Google Cloud , acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Na lista de buckets, clique no nome do bucket associado ao cache que você quer pausar.

3. Na página Detalhes do bucket, clique na guia Observabilidade e em Anywhere Cache no menu de navegação.

4. Clique em Pausar/retomar caches.

5. No painel exibido, clique no ícone Pausar cache (pause).

6. Clique em Fechar.

Linha de comando

Use o comando gcloud storage buckets anywhere-caches pause:

gcloud storage buckets anywhere-caches pause ID

Substitua:

• ID com o identificador da instância de cache, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por exemplo, my-bucket/us-east1-b.

  Para pausar vários caches de uma só vez, especifique vários identificadores. Por exemplo, my-bucket/us-east1-b my-bucket/us-east1-c

Se o comando for bem-sucedido, ele vai retornar uma mensagem de sucesso.

Bibliotecas de 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

Consulte a documentação do Terraform google_storage_anywhere_cache para detalhes sobre como usar o Anywhere Cache com o Terraform.

APIs REST

Console

Para retomar um cache pausado, siga estas instruções:

1. No console Google Cloud , acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Na lista de buckets, clique no nome do bucket associado ao cache que você quer retomar.

3. Na página Detalhes do bucket, clique na guia Observabilidade e em Anywhere Cache no menu de navegação.

4. Clique em Pausar/retomar caches.

5. No painel exibido, clique no ícone Retomar cache (play_arrow).

6. Clique em Fechar.

Para retomar um cache desativado, siga estas instruções:

1. No console Google Cloud , acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Na lista de buckets, clique no nome do bucket associado ao cache que você quer retomar.

3. Na página Detalhes do bucket, clique na guia Observabilidade e em Anywhere Cache no menu de navegação.

4. Clique em Desativar/retomar caches.

5. No painel exibido, clique no ícone Retomar cache (play_arrow).

6. Clique em Fechar.

Linha de comando

Use o comando gcloud storage buckets anywhere-caches resume:

gcloud storage buckets anywhere-caches resume ID

Substitua:

• ID com o identificador da instância de cache, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por exemplo, my-bucket/us-east1-b.

  Para retomar vários caches de uma só vez, especifique vários identificadores. Por exemplo, my-bucket/us-east1-b my-bucket/us-east1-c

Se for bem-sucedido, o comando vai retornar um recurso AnywhereCache formatado.

Bibliotecas de 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

Consulte a documentação do Terraform google_storage_anywhere_cache para detalhes sobre como usar o Anywhere Cache com o Terraform.

APIs REST

Console

1. No console Google Cloud , acesse a página Buckets do Cloud Storage.
   

   Acessar buckets

2. Na lista de buckets, clique no nome do bucket associado ao cache que você quer desativar.

3. Na página Detalhes do bucket, clique na guia Observabilidade e em Anywhere Cache no menu de navegação.

4. Clique em Desativar/retomar caches.

5. No painel exibido, clique no ícone Desativar cache (delete).

6. Na caixa de diálogo que aparece, clique em Confirmar.

7. Clique em Fechar.

Linha de comando

Use o comando gcloud storage buckets anywhere-caches disable:

gcloud storage buckets anywhere-caches disable ID

Substitua:

• ID com o identificador da instância de cache, formulado como BUCKET_NAME/ANYWHERE_CACHE_ID. Por exemplo, my-bucket/us-east1-b.

  Para desativar vários caches de uma só vez, especifique vários identificadores. Por exemplo, my-bucket/us-east1-b my-bucket/us-east1-c

Se for bem-sucedido, o comando vai retornar um recurso AnywhereCache formatado.

Bibliotecas de 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

Consulte a documentação do Terraform google_storage_anywhere_cache para detalhes sobre como usar o Anywhere Cache com o Terraform.

APIs REST