Membuat dan mengelola cache Anywhere Cache

Halaman ini menunjukkan cara membuat dan mengelola instance cache Anywhere Cache.

Untuk mengetahui informasi tentang cara menggunakan dan mengelola operasi yang berjalan lama yang dimulai dari operasi cache asinkron Anywhere Cache, lihat Menggunakan operasi yang berjalan lama.

Sebelum menggunakan Anywhere Cache, tinjau Batasan dan pembatasan.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan untuk membuat dan mengelola cache Anywhere Cache, minta administrator Anda untuk memberi Anda peran IAM Storage Admin (roles/storage.admin) di bucket yang ingin Anda buat cache-nya.

Peran bawaan ini berisi izin yang diperlukan untuk membuat dan mengelola cache Anywhere Cache. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk membuat dan mengelola cache Anywhere Cache:

  • storage.anywhereCaches.disable (diperlukan untuk menonaktifkan cache)
  • storage.anywhereCaches.get (diperlukan untuk mendapatkan cache)
  • storage.anywhereCaches.create (diperlukan untuk membuat cache)
  • storage.anywhereCaches.list (diperlukan untuk mencantumkan cache)
  • storage.anywhereCaches.pause (diperlukan untuk menjeda cache)
  • storage.anywhereCaches.resume (diperlukan untuk melanjutkan cache)
  • storage.anywhereCaches.update (diperlukan untuk mengupdate cache)

Anda juga bisa mendapatkan izin ini dengan peran khusus.

Untuk mengetahui informasi tentang cara memberikan peran pada bucket, lihat Menggunakan IAM dengan bucket.

Untuk mengelola operasi yang berjalan lama yang dimulai dari metode Anywhere Cache, Anda mungkin memerlukan peran dan izin tambahan. Lihat peran yang diperlukan untuk operasi yang berjalan lama untuk mempelajari lebih lanjut.

Membuat cache

Konsol

  1. Di Google Cloud konsol, buka halaman Bucket Cloud Storage.

    Buka Buckets

  2. Dalam daftar bucket, klik nama bucket yang datanya ingin Anda simpan dalam cache.

  3. Di halaman Detail bucket, klik tab Konfigurasi.

  4. Di bagian Anywhere Cache, klik Konfigurasi cache.

    Halaman Edit configuration for <your_bucket_name> akan muncul untuk bucket Anda.

  5. Di bagian Cache regions, klik region yang berisi zona tempat Anda ingin membuat cache.

  6. Di bagian Cache zones, pilih zona tempat Anda ingin membuat cache. Untuk setiap zona yang Anda pilih, tentukan Waktu aktif dan opsi Penyerapan untuk cache.

  7. Klik Simpan konfigurasi.

  8. Pada dialog yang muncul, klik Konfirmasi.

    Tab Operasi di halaman Detail bucket akan terbuka, yang menunjukkan status tugas operasi pembuatan cache Anda.

Anda juga dapat melihat status cache bucket secara langsung dari halaman Daftar bucket. Untuk melakukannya, selesaikan petunjuk berikut:

  1. Di Google Cloud konsol, buka halaman Bucket Cloud Storage.

    Buka Buckets

  2. Klik ikon Lihat Kolom (), pilih Cache, lalu klik OK.

Command line

Gunakan perintah gcloud storage buckets anywhere-caches create:

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

Ganti:

  • BUCKET_NAME dengan nama bucket yang datanya ingin Anda simpan dalam cache. Contoh, my-bucket.

  • ZONE dengan zona tempat cache akan berjalan. Contoh, us-east1-b.

    Untuk membuat beberapa cache sekaligus, Anda dapat menentukan beberapa zona. Contoh, us-east1-b us-east1-c us-east1-d

Tetapkan flag opsional berikut untuk memiliki kontrol yang lebih besar atas pembuatan cache:

  • --ttl: Tentukan time to live (TTL) data dalam cache, dalam hitungan detik. Jika tidak ditentukan, defaultnya adalah 86400s (24 jam).

  • --admission-policy: Tentukan pada titik mana data akan di-ingest ke dalam cache. Nilai dapat berupa ADMIT_ON_FIRST_MISS atau ADMIT_ON_SECOND_MISS. Jika tidak ditentukan, setelan defaultnya adalah ADMIT_ON_FIRST_MISS.

Jika berhasil, perintah akan menampilkan ID operasi yang berjalan lama yang terkait dengan operasi Pembuatan AnywhereCache. Anda dapat mendapatkan detail tentang operasi yang berjalan lama atau membatalkan operasi yang berjalan lama untuk menghentikan operasi Pembuatan AnywhereCaches sebelum selesai.

Library klien

C++

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

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

Java

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

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

Lihat dokumentasi Terraform google_storage_anywhere_cache untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.

REST API

JSON API

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Buat file JSON yang berisi informasi berikut:

    {
       "zone": "ZONE",
       "ttl": "TIME_TO_LIVE",
       "admissionPolicy": "ADMISSION_POLICY"
    }

    Ganti:

    • ZONE dengan zona tempat cache akan berjalan. Contoh, us-east1-b.

    • TIME_TO_LIVE dengan time to live (TTL) data dalam cache. Nilainya dapat berkisar antara 1 jam hingga 7 hari, yang ditentukan dalam detik. Jika tidak ditentukan, default-nya adalah 86400s (24 jam).

    • ADMISSION_POLICY dengan kebijakan penerimaan cache, yang menentukan kapan data diserap. Nilai dapat berupa admit-on-first-miss atau admit-on-second-miss. Jika tidak ditentukan, setelan defaultnya adalah admit-on-first-miss.

  3. Gunakan cURL untuk memanggil JSON API dengan permintaan untuk membuat cache:

    curl -X POST --data-binary @JSON_FILE_NAME \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches"

    Ganti:

    • JSON_FILE_NAME dengan nama file JSON yang Anda buat di Langkah 2.

    • BUCKET_NAME dengan nama bucket yang datanya ingin Anda simpan dalam cache. Contoh, my-bucket.

Jika berhasil, operasi akan menampilkan google.longrunning.Operation. Anda dapat mendapatkan detail tentang operasi yang berjalan lama atau membatalkan operasi yang berjalan lama untuk menghentikan operasi Pembuatan AnywhereCaches sebelum selesai.

Melihat cache

Konsol

  1. Di Google Cloud konsol, buka halaman Bucket Cloud Storage.

    Buka Buckets

  2. Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda lihat.

  3. Di halaman Detail bucket, klik tab Konfigurasi.

  4. Di bagian Cache di Mana Saja, klik Edit di samping kolom Cache.

  5. Di halaman Edit konfigurasi yang muncul, pilih region untuk melihat semua cache dalam zona region tersebut.

    Di panel Zona cache, Anda dapat melihat detail tentang setiap cache yang tersedia.

Command line

Gunakan perintah gcloud storage buckets anywhere-caches describe:

gcloud storage buckets anywhere-caches describe ID

Ganti:

  • ID dengan ID instance cache, yang dirumuskan sebagai BUCKET_NAME/ANYWHERE_CACHE_ID. Contohnya, my-bucket/us-east1-b.

Gunakan tanda raw opsional untuk menampilkan respons API mentah, bukan respons API standar.

Jika berhasil, perintah akan menampilkan resource AnywhereCache.

Library klien

C++

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

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

Java

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.


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

Lihat dokumentasi Terraform google_storage_anywhere_cache untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.

REST API

JSON API

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Gunakan cURL untuk memanggil JSON API dengan permintaan untuk mendapatkan cache:

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID"

    Ganti:

    • BUCKET_NAME dengan nama bucket yang terkait dengan cache yang ingin Anda ambil. Contoh, my-bucket.

    • ANYWHERE_CACHE_ID dengan zona tempat cache berada. Contoh, us-east1-b.

Jika berhasil, operasi ini akan menampilkan resource AnywhereCache.

Mencantumkan cache

Konsol

  1. Di Google Cloud konsol, buka halaman Bucket Cloud Storage.

    Buka Buckets

  2. Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda lihat.

  3. Di halaman Detail bucket, klik tab Konfigurasi.

  4. Di bagian Cache di Mana Saja, klik Edit di samping kolom Cache.

  5. Di halaman Edit konfigurasi yang muncul, pilih region untuk melihat semua cache dalam zona region tersebut.

    Semua cache yang tersedia untuk zona dalam region muncul di panel Zona cache.

Command line

Gunakan perintah gcloud storage buckets anywhere-caches list:

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

Ganti:

  • BUCKET_NAME dengan nama bucket yang terkait dengan cache yang ingin Anda cantumkan. Contoh, my-bucket.

Jika berhasil, perintah akan menampilkan daftar resource AnywhereCache.

Anda dapat secara opsional menggunakan tanda --raw untuk menampilkan respons API mentah, bukan respons standar. Untuk mengetahui informasi selengkapnya tentang mengontrol perilaku listingan, seperti membuat hasil berhalaman, lihat dokumentasi gcloud storage ls.

Library klien

C++

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

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

Java

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.


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

Lihat dokumentasi Terraform google_storage_anywhere_cache untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.

REST API

JSON API

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Gunakan cURL untuk memanggil JSON API dengan permintaan untuk mencantumkan cache:

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches"

    Ganti:

    • BUCKET_NAME dengan nama bucket yang terkait dengan cache yang ingin Anda ambil. Contoh, my-bucket.

    Saat mencantumkan beberapa cache, Anda dapat membuat hasil berhalaman.

Jika berhasil, operasi ini akan menampilkan daftar resource AnywhereCache. Untuk mengetahui detail struktur respons ini, lihat respons dalam dokumentasi Daftar AnywhereCaches.

Memperbarui cache

Konsol

  1. Di Google Cloud konsol, buka halaman Bucket Cloud Storage.

    Buka Buckets

  2. Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda perbarui.

  3. Di halaman Bucket details, klik tab Observability, lalu klik Anywhere Cache di menu navigasi.

  4. Klik Edit configuration.

  5. Di halaman Edit konfigurasi yang muncul, perbarui properti cache, lalu klik Simpan.

Command line

Gunakan perintah gcloud storage buckets anywhere-caches update:

gcloud storage buckets anywhere-caches update ID

Ganti:

  • ID dengan ID instance cache, yang dirumuskan sebagai BUCKET_NAME/ANYWHERE_CACHE_ID. Contohnya, my-bucket/us-east1-b.

    Untuk memperbarui beberapa cache sekaligus, Anda dapat menentukan beberapa ID. Misalnya, my-bucket/us-east1-b my-bucket/us-east1-c.

Gunakan tanda berikut untuk memperbarui konfigurasi cache. Jika flag tidak ditentukan, nilai tidak berubah.

  • --ttl: Tentukan time to live (TTL) data dalam cache, dalam hitungan detik.

  • --admission-policy: Tentukan pada titik mana data akan di-ingest ke dalam cache. Nilai dapat berupa ADMIT_ON_FIRST_MISS atau ADMIT_ON_SECOND_MISS.

Jika berhasil, perintah akan menampilkan ID operasi yang berjalan lama dan belum diproses yang terkait dengan operasi Update AnywhereCache. Anda dapat mendapatkan detail tentang operasi yang berjalan lama.

Library klien

C++

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

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

Java

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.


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

Lihat dokumentasi Terraform google_storage_anywhere_cache untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.

REST API

JSON API

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Buat file JSON yang menyertakan perubahan pada properti cache yang ingin Anda perbarui.

    {
       "ttl": "TIME_TO_LIVE",
       "admissionPolicy": "ADMISSION_POLICY"
    }

    Ganti:

    • TIME_TO_LIVE dengan TTL data dalam cache. Nilainya dapat berkisar antara 1 jam hingga 7 hari, yang ditentukan dalam detik. Jika tidak ditentukan, nilai saat ini akan tetap digunakan.

    • ADMISSION_POLICY dengan kebijakan penerimaan cache, yang menentukan kapan data diserap. Nilai dapat berupa admit-on-first-miss atau admit-on-second-miss. Jika tidak ditentukan, nilai saat ini akan tetap digunakan.

    Contoh berikut memperbarui TTL cache menjadi 2 hari dan kebijakan penerimaannya untuk menyerap data pada kegagalan kedua:

    {
       "ttl": "172800s",
       "admissionPolicy": "admit-on-second-miss"
    }
  3. Untuk menerapkan properti baru, gunakan cURL untuk memanggil JSON API dengan permintaan untuk memperbarui cache:

    curl -X PATCH --data-binary @JSON_FILE_NAME \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        -H "Content-Type: application/json" \
        "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID"

    Ganti:

    • JSON_FILE_NAME dengan nama file JSON yang Anda buat di Langkah 2.

    • BUCKET_NAME dengan nama bucket yang terkait dengan cache yang ingin Anda perbarui. Contoh, my-bucket.

    • ANYWHERE_CACHE_ID dengan ID cache. Contoh, us-east1-b.

Jika berhasil, operasi akan menampilkan google.longrunning.Operation. Anda dapat mendapatkan detail tentang operasi yang berjalan lama.

Menjeda cache

Konsol

  1. Di Google Cloud konsol, buka halaman Bucket Cloud Storage.

    Buka Buckets

  2. Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda jeda.

  3. Di halaman Bucket details, klik tab Observability, lalu klik Anywhere Cache di menu navigasi.

  4. Klik Jeda/lanjutkan cache.

  5. Di panel yang muncul, klik ikon Jeda cache ().

  6. Klik Close.

Command line

Gunakan perintah gcloud storage buckets anywhere-caches pause:

gcloud storage buckets anywhere-caches pause ID

Ganti:

  • ID dengan ID instance cache, yang dirumuskan sebagai BUCKET_NAME/ANYWHERE_CACHE_ID. Contohnya, my-bucket/us-east1-b.

    Untuk menjeda beberapa cache sekaligus, Anda dapat menentukan beberapa ID. Misalnya, my-bucket/us-east1-b my-bucket/us-east1-c.

Jika berhasil, perintah akan menampilkan pesan keberhasilan.

Library klien

C++

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

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

Java

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.


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

Lihat dokumentasi Terraform google_storage_anywhere_cache untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.

REST API

JSON API

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Gunakan cURL untuk memanggil JSON API dengan permintaan untuk menjeda cache:

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/pause"

    Ganti:

    • BUCKET_NAME dengan nama bucket yang terkait dengan cache yang ingin Anda jeda. Contoh, my-bucket.

    • ANYWHERE_CACHE_ID dengan ID cache. Contoh, us-east1-b.

Jika berhasil, operasi akan menampilkan resource AnywhereCache yang diformat.

Melanjutkan cache

Konsol

Untuk melanjutkan cache yang telah dijeda, selesaikan petunjuk berikut:

  1. Di Google Cloud konsol, buka halaman Bucket Cloud Storage.

    Buka Buckets

  2. Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda lanjutkan.

  3. Di halaman Bucket details, klik tab Observability, lalu klik Anywhere Cache di menu navigasi.

  4. Klik Jeda/lanjutkan cache.

  5. Di panel yang muncul, klik ikon Lanjutkan cache ().

  6. Klik Close.

Untuk melanjutkan penggunaan cache yang telah dinonaktifkan, selesaikan petunjuk berikut:

  1. Di Google Cloud konsol, buka halaman Bucket Cloud Storage.

    Buka Buckets

  2. Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda lanjutkan.

  3. Di halaman Bucket details, klik tab Observability, lalu klik Anywhere Cache di menu navigasi.

  4. Klik Nonaktifkan/lanjutkan cache.

  5. Di panel yang muncul, klik ikon Lanjutkan cache ().

  6. Klik Close.

Command line

Gunakan perintah gcloud storage buckets anywhere-caches resume:

gcloud storage buckets anywhere-caches resume ID

Ganti:

  • ID dengan ID instance cache, yang dirumuskan sebagai BUCKET_NAME/ANYWHERE_CACHE_ID. Contohnya, my-bucket/us-east1-b.

    Untuk melanjutkan beberapa cache sekaligus, Anda dapat menentukan beberapa ID. Misalnya, my-bucket/us-east1-b my-bucket/us-east1-c.

Jika berhasil, perintah akan menampilkan resource AnywhereCache yang diformat.

Library klien

C++

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

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

Java

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.


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

Lihat dokumentasi Terraform google_storage_anywhere_cache untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.

REST API

JSON API

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Gunakan cURL untuk memanggil JSON API dengan permintaan untuk melanjutkan cache:

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/resume"

    Ganti:

    • BUCKET_NAME dengan nama bucket yang terkait dengan cache yang ingin Anda lanjutkan. Contoh, my-bucket.

    • ANYWHERE_CACHE_ID dengan ID cache. Contoh, us-east1-b.

Jika berhasil, operasi akan menampilkan resource AnywhereCache yang diformat.

Menonaktifkan cache

Konsol

  1. Di Google Cloud konsol, buka halaman Bucket Cloud Storage.

    Buka Buckets

  2. Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda nonaktifkan.

  3. Di halaman Bucket details, klik tab Observability, lalu klik Anywhere Cache di menu navigasi.

  4. Klik Nonaktifkan/lanjutkan cache.

  5. Di panel yang muncul, klik ikon Nonaktifkan cache ().

  6. Pada dialog yang muncul, klik Konfirmasi.

  7. Klik Close.

Command line

Gunakan perintah gcloud storage buckets anywhere-caches disable:

gcloud storage buckets anywhere-caches disable ID

Ganti:

  • ID dengan ID instance cache, yang dirumuskan sebagai BUCKET_NAME/ANYWHERE_CACHE_ID. Contohnya, my-bucket/us-east1-b.

    Untuk menonaktifkan beberapa cache sekaligus, Anda dapat menentukan beberapa ID. Misalnya, my-bucket/us-east1-b my-bucket/us-east1-c.

Jika berhasil, perintah akan menampilkan resource AnywhereCache yang diformat.

Library klien

C++

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.

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

Java

Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage Java API.

Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.


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

Lihat dokumentasi Terraform google_storage_anywhere_cache untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.

REST API

JSON API

  1. Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header Authorization.

  2. Gunakan cURL untuk memanggil JSON API dengan permintaan untuk menonaktifkan cache:

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/disable"

    Ganti:

    • BUCKET_NAME dengan nama bucket yang terkait dengan cache yang ingin Anda nonaktifkan. Contoh, my-bucket.

    • ANYWHERE_CACHE_ID dengan ID cache. Contoh, us-east1-b.

Jika berhasil, perintah akan menampilkan resource AnywhereCache yang diformat.

Memantau performa cache

Bagian Cloud Storage di konsol Google Cloud menyediakan diagram pemantauan yang memungkinkan Anda melacak performa cache menggunakan metrik. Diagram pemantauan ini juga dapat dilihat menggunakan Cloud Monitoring.

Diagram yang tersedia

Diagram Tingkat hierarki resource Deskripsi
Rasio penggantian byte Bucket Kecepatan byte yang dikeluarkan dari cache, yang diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu bagi pemrosesan data setelahnya.
Rasio penggantian byte Project Kecepatan byte yang dikeluarkan dari semua cache bucket, yang diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu untuk memproses data setelahnya.
Byte dalam cache Bucket Kecepatan byte dalam cache, yang diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu bagi pemrosesan data setelahnya.
Byte dalam cache Project Kecepatan byte ini di semua cache bucket, yang diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu bagi pemrosesan data setelahnya.
Manfaat throughput cache Project Tingkat kuota bandwidth transfer data untuk region, region ganda, atau multi-region, penggunaan kuota, dan throughput tambahan yang disalurkan oleh cache. Throughput tambahan yang ditayangkan oleh cache tidak dihitung dalam kuota, sehingga, penggunaan cache memungkinkan project melampaui throughput yang diizinkan oleh kuota.
Operasi rasio hit Bucket Persentase operasi cache yang menyajikan data yang diminta dari cache relatif terhadap total operasi yang memenuhi syarat untuk cache, yang diambil sampelnya setiap 60 detik. Jika pembacaan sepenuhnya ditampilkan dari cache, operasi akan dihitung sebagai hit. Jika pembacaan tidak ditampilkan dari cache atau hanya ditampilkan sebagian dari cache, operasi dihitung sebagai kegagalan.
Operasi rasio hit Project Persentase operasi cache yang menyajikan data yang diminta dari semua cache untuk bucket relatif terhadap total operasi yang memenuhi syarat untuk cache, yang diambil sampelnya selama 60 detik. Jika pembacaan sepenuhnya ditampilkan dari cache, operasi dihitung sebagai hit. Jika pembacaan tidak ditampilkan dari cache atau hanya ditampilkan sebagian dari cache, operasi dihitung sebagai tidak ada.
Byte rasio hit Bucket Persentase byte yang disajikan dari cache relatif terhadap total byte yang memenuhi syarat untuk di-cache, yang diambil sampelnya setiap 60 detik.
Byte rasio hit Project Persentase byte yang ditayangkan dari semua cache untuk bucket relatif terhadap total byte yang memenuhi syarat untuk di-cache, yang diambil sampelnya setiap 60 detik.
Byte mentah kecepatan penyerapan Bucket Kecepatan byte mentah yang dimasukkan ke setiap cache, yang diambil sampelnya setiap 60 detik. Semua byte yang di-ingest, termasuk byte yang tidak dapat ditagih, digunakan dalam menghitung nilai metrik ini. Metrik ini dilaporkan secara real time.
Byte mentah kecepatan penyerapan Project Kecepatan byte mentah yang dimasukkan ke semua cache bucket, yang diambil sampelnya setiap 60 detik. Semua byte yang di-ingest, termasuk byte yang tidak dapat ditagih, digunakan dalam menghitung nilai metrik ini. Metrik ini dilaporkan secara real time.
Throughput - Cache ditemukan Bucket Throughput yang disalurkan dari cache, yang diambil sampelnya setiap 60 detik.
Throughput - Cache ditemukan Project Throughput yang disajikan dari semua cache untuk bucket, yang diambil sampelnya setiap 60 detik.
Throughput - Cache tidak ditemukan Bucket Throughput yang tidak ditayangkan dari cache, yang diambil sampelnya setiap 60 detik.
Throughput - Cache tidak ditemukan Project Throughput yang tidak ditayangkan dari cache bucket mana pun, yang diambil sampelnya setiap 60 detik.

Mengakses diagram

Diagram pemantauan merekam data untuk masing-masing bucket atau untuk semua bucket dalam project. Tingkat hierarki resource yang dicatat diagram menentukan tempat Anda dapat mengakses diagram.

Mengakses diagram tingkat bucket

  1. Di Google Cloud konsol, buka halaman Bucket Cloud Storage.

    Buka Buckets

  2. Dalam daftar bucket, klik nama bucket yang ingin Anda lihat diagram pemantauannya.

  3. Di halaman Detail bucket, klik tab Observabilitas.

  4. Di menu navigasi, pilih Anywhere Cache.

    Diagram pemantauan ditampilkan.

Mengakses diagram tingkat project

  1. Di Google Cloud konsol, buka halaman Bucket Cloud Storage.

    Buka Buckets

  2. Di panel navigasi Cloud Storage, klik Monitoring.

  3. Di panel menu, klik Anywhere Cache.

    Diagram pemantauan ditampilkan.

Menggunakan operasi yang berjalan lama

Jika berhasil dijalankan, operasi AnywhereCaches Create dan Update akan memulai operasi yang berjalan lama. Anda dapat mengambil dan mencantumkan operasi yang berjalan lama untuk melihat detail dan status operasi AnywhereCaches yang mendasarinya, atau membatalkan operasi yang berjalan lama untuk membatalkan operasi AnywhereCaches yang mendasarinya saat sedang berlangsung.

Untuk mengetahui petunjuk tentang cara menggunakan operasi yang berjalan lama untuk Anywhere Cache, lihat Menggunakan operasi yang berjalan lama.

Contoh berikut menunjukkan operasi yang berjalan lama yang dimulai dari operasi Pembuatan AnywhereCaches:

done: false
kind: storage#operation
metadata:
  '@type': type.googleapis.com/google.storage.control.v2.CreateAnywhereCacheMetadata
  anywhereCacheId: us-central1-c
  zone: us-central1-c
  ttl: 172800s
  admissionPolicy: admit-on-first-miss
  commonMetadata:
    createTime: '2023-12-14T20:52:00.032Z'
    progressPercent: -1
    requestedCancellation: false
    type: create-anywhere-cache
    updateTime: '2023-12-14T20:52:00.032Z'
name: projects/_/buckets/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig
selfLink: https://www.googleapis.com/storage/v1/b/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig

Upaya coba lagi

API AnywhereCaches Asinkron bersifat idempotent secara default. Artinya, Anda dapat mencoba lagi panggilan API AnywhereCaches asinkron dengan aman tanpa khawatir mengubah resource secara tidak sengaja.

Misalnya, Anda melakukan operasi Pembuatan AnywhereCaches untuk membuat cache di us-central1-a, yang berhasil. Jika Anda melakukan operasi Pembuatan AnywhereCaches berikutnya menggunakan zona yang sama dan berhasil, permintaan akan menampilkan operasi yang berjalan lama yang sama dengan permintaan sebelumnya. Perhatikan bahwa perilaku ini hanya terjadi jika Anda menyertakan request_id sebagai bagian dari permintaan pembuatan cache. Jika request_id tidak disertakan, Anda akan mendapatkan error ANYWHERE_CACHE_ALREADY_EXISTS saat mencoba membuat cache yang sudah ada. Untuk mengetahui informasi tentang cara menyertakan request_id, lihat Duplikasi permintaan.

Langkah berikutnya

Dapatkan rekomendasi tentang bucket dan zona yang akan dibuat cache-nya.