Membuat dan mengelola cache dengan Rapid Cache

Anda dapat membuat dan mengelola instance cache dengan Rapid Cache untuk mengurangi latensi dan mengoptimalkan akses data untuk objek yang disimpan di Cloud Storage. Solusi penyimpanan dalam cache ini membantu meningkatkan performa aplikasi Anda dengan mempercepat pengambilan data.

Halaman ini menunjukkan cara membuat dan mengelola instance cache dengan Rapid Cache. Untuk mengetahui informasi tentang cara menggunakan dan mengelola operasi yang berjalan lama yang dimulai dari Rapid Cache operasi cache asinkron, lihat Menggunakan operasi yang berjalan lama.

Sebelum menggunakan Cache Cepat, tinjau Batasan dan pembatasan.

Sebelum memulai

Sebelum Anda mulai membuat dan mengelola cache, selesaikan bagian berikut.

Mendapatkan peran yang diperlukan

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

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

Izin yang diperlukan

Izin berikut diperlukan untuk membuat dan mengelola cache Rapid Cache:

  • storage.anywhereCaches.create (diperlukan untuk membuat cache)
  • storage.anywhereCaches.disable (diperlukan untuk menonaktifkan cache)
  • storage.anywhereCaches.get (diperlukan untuk mendapatkan cache)
  • storage.anywhereCaches.list (diperlukan untuk mencantumkan cache)
  • storage.anywhereCaches.resume (diperlukan untuk melanjutkan cache)
  • storage.anywhereCaches.update (diperlukan untuk mengupdate cache)
  • storage.managedFolders.create (hanya diperlukan untuk mengaktifkan perilaku penyerapan saat penulisan untuk cache)
  • storage.managedFolders.update (hanya diperlukan untuk memperbarui perilaku penyerapan saat penulisan cache)

Anda juga bisa mendapatkan izin ini dengan peran khusus.

Untuk mengetahui informasi tentang cara memberikan peran pada bucket, lihat Menetapkan dan mengelola kebijakan IAM pada bucket.

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

Memahami setelan penyerapan saat penulisan

Saat membuat atau memperbarui cache, Anda dapat mengaktifkan cache secara opsional untuk menerima data saat data ditulis ke bucket. Kemampuan ini dikenal sebagai "penyerapan saat penulisan". Jika Anda berencana mengaktifkan penyerapan saat penulisan menggunakan JSON API, sebaiknya Anda memahami terlebih dahulu perilaku setelan yang dikonfigurasi yang digunakan untuk penyerapan saat penulisan.

Membuat cache

Konsol

Membuat cache untuk bucket yang ada

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

    Buka Buckets

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

  3. Di halaman Bucket details, klik tab Configuration.

  4. Di bagian Rapid Cache, klik Configure cache.

    Halaman Configure cache akan muncul untuk bucket Anda.

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

  6. Di bagian Zona cache, pilih zona tempat Anda ingin membuat cache. Untuk setiap cache yang Anda buat di zona, selesaikan langkah-langkah berikut secara opsional:

    • Opsional: Anda dapat menetapkan Time to Live (TTL) kustom yang menentukan kapan data dikeluarkan dari cache sejak terakhir kali dibaca. Secara default, TTL cache ditetapkan ke satu hari.

      Untuk menetapkan TTL kustom:

      1. Di kolom Time to live, tentukan nilai durasi (misalnya: 48) dan satuan waktu (misalnya: hours).

      2. Klik Simpan konfigurasi.

    • Opsional: Anda dapat mengaktifkan cache untuk menyerap data saat penulisan selain menyerap data saat pembacaan pertama. Secara default, cache hanya dikonfigurasi untuk menyerap data pada pembacaan pertama.

      Untuk mengaktifkan cache agar menyerap data saat penulisan:

      1. Di kolom Kriteria penyerapan, klik Edit kriteria penyerapan cache edit.

        Halaman Setel kriteria penyerapan akan muncul.

      2. Centang kotak Ingest data on write.

        • Untuk mengaktifkan penyerapan saat penulisan untuk semua objek yang baru ditulis ke bucket, klik Seluruh bucket.

        • Untuk mengaktifkan penyerapan saat penulisan hanya untuk objek yang baru ditulis yang memiliki awalan tertentu dalam namanya, klik Folder yang dipilih, lalu masukkan awalan nama objek. Awalan nama objek juga disebut sebagai "jalur folder".

        Anda dapat memasukkan beberapa awalan nama objek dengan mengklik Tambahkan Tambahkan.

        Untuk menghapus awalan, klik Hapus item hapus.

      3. Klik Done.

  7. Klik Simpan konfigurasi.

  8. Pada dialog yang muncul, klik Konfirmasi.

    Tab Operations di halaman Bucket details akan terbuka, yang menunjukkan status tugas operasi pembuatan cache Anda.

Membuat cache untuk bucket baru

Untuk membuat cache sebagai bagian dari pembuatan bucket baru, ikuti petunjuk di Membuat bucket baru.

Untuk melihat status cache bucket dari halaman Daftar bucket:

  1. Di konsol Google Cloud , buka halaman Buckets 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 CACHE_ZONE \
[--ttl=TTL] [--enable-ingest-on-write]

Ganti:

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

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

  • TTL (opsional) dengan time to live (TTL) data dalam cache. Nilainya dapat berkisar antara 1 hari dan 7 hari, inklusif. Nilai dapat dinyatakan dalam detik, menit, jam, dan hari. Misalnya:

    • 86400s selama 86.400 detik
    • 1440m selama 1.440 menit
    • 24h selama 24 jam
    • 1d selama 1 hari

    Jika tidak ditentukan, defaultnya adalah 86400s (1 hari).

Untuk mengonfigurasi cache agar menyerap data saat data ditulis ke bucket, tentukan flag --enable-ingest-on-write opsional. Flag ini memungkinkan cache untuk menyerap semua objek saat ditulis ke bucket.

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());
    }
  }
}

Rust

use google_cloud_lro::Poller;
use google_cloud_storage::client::StorageControl;
use google_cloud_storage::model::AnywhereCache;

pub async fn sample(client: &StorageControl, bucket_id: &str, zone: &str) -> anyhow::Result<()> {
    let cache = client
        .create_anywhere_cache()
        .set_parent(format!("projects/_/buckets/{bucket_id}"))
        .set_anywhere_cache(AnywhereCache::new().set_zone(zone).set_name(format!(
            "projects/_/buckets/{bucket_id}/anywhereCaches/{zone}"
        )))
        .poller()
        .until_done()
        .await?;
    println!("Created anywhere cache: {cache:?}");
    Ok(())
}

Terraform

Lihat google_storage_anywhere_cache dokumentasi Terraform untuk mengetahui detail tentang cara menggunakan Rapid 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",
   "ingestOnWrite": INGEST_SETTING
}

    Ganti:

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

    • TIME_TO_LIVE dengan time to live (TTL) data dalam cache. Nilai dapat dinyatakan dalam detik, menit, jam, dan hari. Contoh:

      • 86400s selama 86.400 detik
      • 1440m selama 1.440 menit
      • 24h selama 24 jam
      • 1d selama 1 hari

      Jika tidak ditentukan, defaultnya adalah 86400s (1 hari). Nilai maksimumnya adalah 7 hari.

    • INGEST_SETTING dengan true atau false untuk menentukan apakah cache akan memproses data saat penulisan.

      Jika disetel ke true, penyerapan saat tulis diaktifkan untuk semua objek yang ditulis ke bucket. Jika disetel ke false, penyerapan saat penulisan dapat diaktifkan secara selektif untuk objek yang ditulis di bawah awalan, atau dapat dinonaktifkan untuk seluruh bucket.

      Untuk mempelajari setelan yang digunakan untuk mengonfigurasi pengaktifan penyerapan saat penulisan, lihat persyaratan untuk mengaktifkan penyerapan saat penulisan.

      Untuk mengaktifkan penyerapan saat penulisan di tingkat bucket atau tingkat awalan, atau untuk menonaktifkan penyerapan saat penulisan sepenuhnya, gunakan salah satu set petunjuk berikut.

      Aktifkan penyerapan saat penulisan untuk bucket

      1. Untuk mengaktifkan penyerapan saat penulisan untuk semua objek yang ditulis ke bucket, tetapkan nilai INGEST_SETTINGS ke true.

      2. Selesaikan permintaan cache Anda dengan mengikuti langkah 3.

      Mengaktifkan penyerapan saat penulisan secara selektif untuk objek di bawah awalan

      1. Tetapkan nilai INGEST_SETTINGS ke false.

      2. Selesaikan permintaan cache Anda dengan mengikuti langkah 3.

      3. Buat folder terkelola yang menggunakan awalan sebagai nama, jika folder terkelola belum ada.

      4. Kirim permintaan PATCH folder terkelola yang menyertakan konfigurasi rapidCacheConfig. Tetapkan nilai kolom dalam konfigurasi menggunakan panduan di Memahami cara menggunakan penyerapan saat penulisan.

      Untuk mengetahui petunjuk mendetail tentang cara menggunakan konfigurasi rapidCacheConfig, lihat Memperbarui penyerapan saat penulisan di folder terkelola.

      Membuat cache tanpa mengaktifkan penyerapan saat penulisan

      1. Tetapkan nilai INGEST_SETTINGS ke false.

      2. Selesaikan permintaan cache Anda dengan mengikuti langkah 3.

  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./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 konsol Google Cloud , buka halaman Buckets Cloud Storage.

    Buka Buckets

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

  3. Di halaman Bucket details, klik tab Configuration.

  4. Di bagian Rapid Cache, 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 Cache zones, 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 CACHE_ID

Ganti:

  • CACHE_ID dengan ID instance cache, yang dirumuskan sebagai BUCKET_NAME/CACHE_ZONE. Contoh, 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());
    }
  }
}

Rust

use google_cloud_storage::client::StorageControl;

pub async fn sample(
    client: &StorageControl,
    bucket_id: &str,
    cache_id: &str,
) -> anyhow::Result<()> {
    let cache = client
        .get_anywhere_cache()
        .set_name(format!(
            "projects/_/buckets/{bucket_id}/anywhereCaches/{cache_id}"
        ))
        .send()
        .await?;
    println!("Got anywhere cache: {:?}", cache);
    Ok(())
}

Terraform

Lihat google_storage_anywhere_cache dokumentasi Terraform untuk mengetahui detail tentang cara menggunakan Rapid 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./storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_CACHE_ID"

    Ganti:

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

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

Jika berhasil, operasi ini akan menampilkan resource AnywhereCache.

Mencantumkan cache

Konsol

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

    Buka Buckets

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

  3. Di halaman Bucket details, klik tab Configuration.

  4. Di bagian Rapid Cache, klik Edit di samping kolom Cache.

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

    Semua cache yang tersedia untuk zona dalam region akan 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 buat daftarnya. 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());
      }
    }
  }
}

Rust

use google_cloud_gax::paginator::ItemPaginator;
use google_cloud_storage::client::StorageControl;

pub async fn sample(client: &StorageControl, bucket_id: &str) -> anyhow::Result<()> {
    let mut stream = client
        .list_anywhere_caches()
        .set_parent(format!("projects/_/buckets/{}", bucket_id))
        .by_item();
    while let Some(cache) = stream.next().await {
        println!("Found cache: {:?}", cache?);
    }
    Ok(())
}

Terraform

Lihat google_storage_anywhere_cache dokumentasi Terraform untuk mengetahui detail tentang cara menggunakan Rapid 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./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 konsol Google Cloud , buka halaman Buckets 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 Configuration.

  4. Di bagian Rapid Cache, klik Kelola cache.

  5. Di panel Kelola cache, klik Edit atau buat cache.

  6. Di halaman Edit konfigurasi yang muncul, perbarui properti cache:

    • Untuk memperbarui TTL cache, cari kolom Time to live, lalu tentukan durasi waktu dan pilih satuan waktu (misalnya, menit).

    • Untuk mengonfigurasi perilaku penyerapan saat penulisan cache, termasuk apakah semua objek yang ditulis di-cache atau hanya objek selektif yang ditulis di bawah awalan yang di-cache:

      1. Cari kolom Kriteria penyerapan, lalu klik Edit kriteria penyerapan cache.

      2. Di panel Setel kriteria penyerapan:

      • Untuk mengaktifkan atau menonaktifkan penyerapan saat penulisan, centang atau hapus centang pada kotak Serap data saat penulisan, lalu klik Selesai.

      • Untuk memperbarui cache guna menyerap semua objek dalam bucket saat penulisan, pastikan kotak Serap data saat penulisan dicentang, lalu pilih Seluruh bucket. Kemudian, klik Selesai.

      • Untuk memperbarui cache agar hanya menyerap objek yang berisi awalan tertentu dalam namanya, pastikan kotak centang Serap data saat penulisan dicentang, lalu pilih Folder yang dipilih.

        • Untuk menentukan awalan, masukkan satu atau beberapa awalan di kolom jalur folder, lalu klik Selesai.

        • Untuk menghapus awalan, klik Hapus item di samping awalan.

  7. Di halaman Edit konfigurasi, klik Simpan.

  8. Pada dialog yang muncul, klik Konfirmasi.

Command line

Gunakan perintah gcloud storage buckets anywhere-caches update.

gcloud storage buckets anywhere-caches update CACHE_ID \
[--ttl=TTL] [--[no-]enable-ingest-on-write]

Ganti:

  • CACHE_ID dengan ID instance cache, yang dirumuskan sebagai BUCKET_NAME/CACHE_ZONE. Contoh, 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.

  • TTL (opsional) dengan time to live (TTL) data dalam cache. Nilainya dapat berkisar antara 1 hari dan 7 hari, inklusif. Nilai dapat dinyatakan dalam detik, menit, jam, dan hari. Misalnya:

    • 86400s selama 86.400 detik
    • 1440m selama 1.440 menit
    • 24h selama 24 jam
    • 1d selama 1 hari

Untuk mengonfigurasi cache agar menyerap data saat data ditulis ke bucket, tentukan flag --enable-ingest-on-write. Flag ini memungkinkan cache untuk menyerap semua objek saat ditulis ke bucket. Untuk menonaktifkan cache dari penyerapan data saat penulisan, tentukan flag --no-enable-ingest-on-write.

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) {
  google::storage::control::v2::AnywhereCache cache;
  google::protobuf::FieldMask field_mask;
  field_mask.add_paths("ttl");
  cache.set_name(cache_name);
  cache.mutable_ttl()->set_seconds(86400);
  // 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());
    }
  }
}

Rust

use google_cloud_lro::Poller;
use google_cloud_storage::client::StorageControl;
use google_cloud_storage::model::AnywhereCache;
use google_cloud_wkt::FieldMask;

pub async fn sample(
    client: &StorageControl,
    bucket_id: &str,
    cache_id: &str,
) -> anyhow::Result<()> {
    let anywhere_cache = AnywhereCache::new()
        .set_name(format!(
            "projects/_/buckets/{}/anywhereCaches/{}",
            bucket_id, cache_id
        ))
        .set_admission_policy("ADMIT_ON_SECOND_MISS".to_string());
    let operation = client
        .update_anywhere_cache()
        .set_anywhere_cache(anywhere_cache)
        .set_update_mask(FieldMask::default().set_paths(["admission_policy"]))
        .poller()
        .until_done()
        .await?;
    println!("Updated anywhere cache: {:?}", operation);
    Ok(())
}

Terraform

Lihat google_storage_anywhere_cache dokumentasi Terraform untuk mengetahui detail tentang cara menggunakan Rapid 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",
   "ingestOnWrite": INGEST_SETTING
}

    Ganti:

    • TIME_TO_LIVE dengan TTL data dalam cache. Nilainya dapat berkisar antara 1 hari dan 7 hari, inklusif. Nilai dapat dinyatakan dalam detik, menit, jam, dan hari. Contoh:

      • 86400s selama 86.400 detik
      • 1440m selama 1.440 menit
      • 24h selama 24 jam
      • 1d selama 1 hari

    • INGEST_SETTING dengan true atau false untuk menentukan apakah cache menyerap data saat penulisan atau tidak.

      Jika disetel ke true, penyerapan saat tulis diaktifkan untuk semua objek yang ditulis ke bucket. Jika disetel ke false, penyerapan saat penulisan dapat diaktifkan secara selektif untuk objek yang ditulis di bawah awalan, atau dapat dinonaktifkan sepenuhnya.

      Untuk mempelajari setelan yang digunakan untuk mengonfigurasi pengaktifan penyerapan saat penulisan di tingkat bucket atau awalan, lihat Memahami cara mengaktifkan penyerapan saat penulisan.

      Untuk mengaktifkan penyerapan saat penulisan di tingkat bucket atau tingkat awalan, atau untuk menonaktifkan penyerapan saat penulisan sepenuhnya, gunakan salah satu set petunjuk berikut.

      Aktifkan penyerapan saat penulisan untuk bucket

      1. Untuk mengaktifkan penyerapan saat penulisan untuk semua objek yang ditulis ke bucket, tetapkan nilai INGEST_SETTINGS ke true.

      2. Selesaikan permintaan cache Anda dengan mengikuti langkah 3.

      3. Jika penyerapan saat penulisan sebelumnya diaktifkan untuk awalan, folder terkelola dengan konfigurasi rapidCacheConfig akan ada. Buat permintaan PATCH folder terkelola yang menetapkan peta policies dalam konfigurasi rapidCacheConfig ke null.

      Untuk mengetahui petunjuk mendetail tentang cara menggunakan konfigurasi rapidCacheConfig, lihat Memperbarui penyerapan saat penulisan di folder terkelola.

      Mengaktifkan penyerapan saat penulisan secara selektif untuk objek di bawah awalan

      1. Tetapkan nilai INGEST_SETTINGS ke false.

      2. Selesaikan permintaan cache Anda dengan mengikuti langkah 3.

      3. Buat folder terkelola yang menggunakan awalan sebagai nama, jika folder terkelola belum ada.

      4. Kirim permintaan PATCH folder terkelola yang menyertakan konfigurasi rapidCacheConfig. Tetapkan nilai kolom dalam konfigurasi dengan menggunakan panduan di setelan dan perilaku penyerapan saat penulisan.

      Peta policies dari konfigurasi rapidCacheConfig dapat berisi satu atau beberapa ID cache (misalnya, us-east1-a dan us-east1-b). Untuk mengaktifkan penyerapan saat penulisan untuk cache tertentu, tetapkan setelan ingestOnWrite masing-masing cache ke enabled. Untuk menonaktifkan penyerapan saat penulisan untuk cache tertentu, tetapkan setelan ingestOnWrite setiap cache ke unspecified. Baca dengan cermat tentang pewarisan penyerapan saat penulisan untuk memahami cara kebijakan penyerapan saat penulisan cache dapat terpengaruh saat setelan ingestOnWrite untuk cache disetel ke unspecified.

      Untuk mengetahui petunjuk mendetail tentang cara menggunakan konfigurasi rapidCacheConfig, lihat Memperbarui penyerapan saat penulisan di folder terkelola.

      Menonaktifkan penyerapan saat penulisan

      1. Tetapkan nilai INGEST_SETTINGS ke false. Setelan ini menonaktifkan penyerapan saat penulisan di tingkat bucket.

      2. Selesaikan permintaan cache Anda dengan mengikuti langkah 3.

      3. Untuk menonaktifkan penyerapan saat penulisan di tingkat awalan, temukan folder terkelola tempat penyerapan saat penulisan tingkat awalan dikonfigurasi. Buat permintaan PATCH folder terkelola yang menetapkan peta policies dalam konfigurasi rapidCacheConfig ke null. Atau, hapus konfigurasi rapidCacheConfig dari resource folder terkelola dalam permintaan PATCH.

      Untuk mengetahui petunjuk mendetail tentang cara menggunakan konfigurasi rapidCacheConfig, lihat Memperbarui penyerapan saat penulisan di folder terkelola.

    Contoh berikut memperbarui TTL cache menjadi 2 hari dan mengaktifkan penyerapan saat penulisan untuk semua objek yang ditulis ke bucket:

    {
   "ttl": "172800s",
   "ingestOnWrite": true
}

  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./storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_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.

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

Melanjutkan cache

Konsol

Untuk melanjutkan cache yang telah dijeda atau dinonaktifkan, selesaikan petunjuk berikut:

  1. Di konsol Google Cloud , buka halaman Buckets 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 Configuration.

  4. Di bagian Rapid Cache, klik Kelola cache.

  5. Di panel Kelola cache, klik ikon Lanjutkan cache ().

  6. Klik Close.

Command line

Gunakan perintah gcloud storage buckets anywhere-caches resume.

gcloud storage buckets anywhere-caches resume CACHE_ID

Ganti:

  • CACHE_ID dengan ID instance cache, yang dirumuskan sebagai BUCKET_NAME/CACHE_ZONE. Contoh, 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());
    }
  }
}

Rust

use google_cloud_storage::client::StorageControl;

pub async fn sample(
    client: &StorageControl,
    bucket_id: &str,
    cache_id: &str,
) -> anyhow::Result<()> {
    let cache = client
        .resume_anywhere_cache()
        .set_name(format!(
            "projects/_/buckets/{}/anywhereCaches/{}",
            bucket_id, cache_id
        ))
        .send()
        .await?;
    println!("Resumed anywhere cache: {:?}", cache);
    Ok(())
}

Terraform

Lihat google_storage_anywhere_cache dokumentasi Terraform untuk mengetahui detail tentang cara menggunakan Rapid 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./storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_CACHE_ID/resume"

    Ganti:

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

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

Jika berhasil, operasi akan menampilkan resource AnywhereCache yang diformat.

Menonaktifkan cache

Konsol

  1. Di konsol Google Cloud , buka halaman Buckets 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 Configuration.

  4. Di bagian Rapid Cache, klik Kelola cache.

  5. Di panel Kelola cache, 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 CACHE_ID

Ganti:

  • CACHE_ID dengan ID instance cache, yang dirumuskan sebagai BUCKET_NAME/CACHE_ZONE. Contoh, 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());
    }
  }
}

Rust

use google_cloud_storage::client::StorageControl;

pub async fn sample(
    client: &StorageControl,
    bucket_id: &str,
    cache_id: &str,
) -> anyhow::Result<()> {
    let cache = client
        .disable_anywhere_cache()
        .set_name(format!(
            "projects/_/buckets/{}/anywhereCaches/{}",
            bucket_id, cache_id
        ))
        .send()
        .await?;
    println!("Disabled anywhere cache: {:?}", cache);
    Ok(())
}

Terraform

Lihat google_storage_anywhere_cache dokumentasi Terraform untuk mengetahui detail tentang cara menggunakan Rapid 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./storage/v1/b/BUCKET_NAME/anywhereCaches/RAPID_CACHE_ID/disable"

    Ganti:

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

    • RAPID_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 disampel setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu untuk memproses data setelahnya.
Byte dalam cache Bucket Jumlah 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 Jumlah byte 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 Kecepatan kuota bandwidth transfer data untuk region, region ganda, atau multi-region, penggunaan kuota, dan throughput tambahan yang disajikan 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 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 sebagian ditampilkan 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 disajikan 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, 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 disajikan 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 disajikan dari cache, yang diambil sampelnya setiap 60 detik.
Throughput - Cache tidak ditemukan Project Throughput yang tidak disajikan dari cache bucket mana pun, 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 oleh diagram menentukan tempat Anda dapat mengakses diagram.

Mengakses diagram tingkat bucket

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

    Buka Buckets

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

  3. Di halaman Bucket details, klik tab Observability.

  4. Di menu navigasi, pilih Rapid Cache.

    Diagram pemantauan ditampilkan.

Mengakses diagram tingkat project

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

    Buka Buckets

  2. Di panel navigasi Cloud Storage, klik Monitoring.

  3. Di panel menu, klik Rapid 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 penggunaan operasi yang berjalan lama untuk Rapid 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
  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 AnywhereCache 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 Permintaan identifikasi.

Langkah berikutnya

Mendapatkan rekomendasi tentang bucket dan zona yang akan dibuatkan cache-nya.