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 caching 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 operasi cache asinkron Rapid Cache, lihat Menggunakan operasi yang berjalan lama.

Sebelum menggunakan Rapid Cache, 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 tempat Anda ingin membuat cache.

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 menyerap data saat data ditulis ke bucket. Kemampuan ini dikenal sebagai "ingest-on-write". Jika Anda berencana mengaktifkan penyerapan saat penulisan menggunakan JSON API, sebaiknya pahami terlebih dahulu perilaku setelan yang dikonfigurasi yang digunakan untuk penyerapan saat penulisan.

Membuat cache

Konsol

Membuat cache untuk bucket yang ada

  1. Di konsol Cloud de Confiance , buka halaman Buckets Cloud Storage.

    Buka Buckets

  2. Dalam daftar bucket, klik nama bucket yang datanya ingin Anda 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 Cache zones, pilih zona tempat Anda ingin membuat cache. Untuk setiap cache yang Anda buat di zona, selesaikan langkah-langkah berikut (opsional):

    • Opsional: Anda dapat menetapkan Time to Live (TTL) kustom yang menentukan kapan data dikeluarkan dari cache sejak pembacaan terakhirnya. 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 Ingestion criteria, klik Edit cache ingestion criteria edit.

        Halaman Set ingestion criteria akan muncul.

      2. Centang kotak Ingest data on write.

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

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

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

        Untuk menghapus awalan, klik Hapus item delete.

      3. Klik Done.

  7. Klik Simpan konfigurasi.

  8. Pada dialog yang muncul, klik Konfirmasi.

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

Membuat cache untuk bucket baru

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

Untuk melihat status cache bucket dari halaman Buckets list:

  1. Di konsol Cloud de Confiance , buka halaman Buckets Cloud Storage.

    Buka Buckets

  2. Klik ikon View Column (), 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 ingin Anda cache datanya. 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. Nilai 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, setelan 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 menyerap semua objek saat ditulis ke bucket.

Jika berhasil, perintah tersebut akan menampilkan ID operasi yang berjalan lama yang terkait dengan operasi AnywhereCache Create. Anda dapat mendapatkan detail tentang operasi yang berjalan lama atau membatalkan operasi yang berjalan lama untuk menghentikan operasi AnywhereCaches Create 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.

Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.

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.

Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.

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 dokumentasi Terraform google_storage_anywhere_cache 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 harus dinyatakan dalam detik (misalnya: 172800s untuk 172.800 detik, yang setara dengan 2 hari).

      Nilai minimumnya adalah 86400s (1 hari) dan nilai maksimumnya adalah 604800s (7 hari). Jika tidak ditentukan, setelan defaultnya adalah 86400s.

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

      Jika ditetapkan ke true, penyerapan saat penulisan akan diaktifkan untuk semua objek yang ditulis ke bucket. Jika ditetapkan 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 di tingkat awalan, atau untuk menonaktifkan penyerapan saat penulisan sepenuhnya, gunakan salah satu rangkaian petunjuk berikut.

      Mengaktifkan 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 dalam 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.s3nsapis.fr/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 Create AnywhereCaches sebelum selesai.

Melihat cache

Konsol

  1. Di konsol Cloud de Confiance , 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.

    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 flag 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.

Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.

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.

Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.


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 dokumentasi Terraform google_storage_anywhere_cache 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.s3nsapis.fr/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.

Cache daftar

Konsol

  1. Di konsol Cloud de Confiance , 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 Cache zones.

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 menggunakan flag --raw secara opsional untuk menampilkan respons API mentah, bukan respons standar. Untuk mengetahui informasi selengkapnya tentang cara mengontrol perilaku listingan, seperti memberi nomor halaman pada hasil, 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.

Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.

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.

Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.


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 dokumentasi Terraform google_storage_anywhere_cache 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.s3nsapis.fr/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 memberi nomor halaman pada hasil.

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

Memperbarui cache

Konsol

  1. Di konsol Cloud de Confiance , 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 Manage caches.

  5. Di panel Manage caches, klik Edit or create caches.

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

    • Untuk memperbarui TTL cache, temukan kolom Time to live, lalu tentukan durasi waktu dan pilih unit waktu (misalnya, minutes).

    • Untuk mengonfigurasi perilaku ingest-on-write cache, termasuk apakah semua objek yang ditulis di-cache atau hanya objek tertentu yang ditulis di bawah awalan yang di-cache:

      1. Temukan kolom Ingestion criteria, lalu klik Edit cache ingestion criteria.

      2. Di panel Set ingestion criteria:

      • Untuk mengaktifkan atau menonaktifkan penyerapan saat penulisan, centang atau hapus centang pada kotak Ingest data on write, lalu klik Done.

      • Untuk memperbarui cache agar menyerap semua objek dalam bucket saat penulisan, pastikan kotak centang Ingest data on write dipilih, lalu pilih Entire bucket. Kemudian, klik Selesai.

      • Untuk memperbarui cache agar hanya menyerap objek yang berisi awalan yang ditentukan dalam namanya, pastikan kotak centang Ingest data on write dicentang, lalu pilih Selected folders.

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

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

  7. Di halaman Edit configuration, klik Save.

  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. Nilai 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 menyerap semua objek saat ditulis ke bucket. Untuk menonaktifkan cache agar tidak menyerap data saat penulisan, tentukan flag --no-enable-ingest-on-write.

Jika berhasil, perintah akan menampilkan ID operasi yang berjalan lama dan mentah 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.

Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.

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.

Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.


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 dokumentasi Terraform google_storage_anywhere_cache 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 di cache. Nilai 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 ditetapkan ke true, penyerapan saat penulisan akan diaktifkan untuk semua objek yang ditulis ke bucket. Jika ditetapkan 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 di tingkat awalan, atau untuk menonaktifkan penyerapan saat penulisan sepenuhnya, gunakan salah satu rangkaian petunjuk berikut.

      Mengaktifkan 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 menggunakan panduan dalam 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 cache individual ke enabled. Untuk menonaktifkan penyerapan saat penulisan untuk cache tertentu, tetapkan setelan ingestOnWrite cache individual ke unspecified. Baca dengan cermat tentang pewarisan penyerapan saat penulisan untuk memahami bagaimana kebijakan penyerapan saat penulisan cache dapat terpengaruh saat setelan ingestOnWrite untuk cache ditetapkan 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 di 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.s3nsapis.fr/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 bisa mendapatkan detail tentang operasi yang berjalan lama.

Melanjutkan cache

Konsol

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

  1. Di konsol Cloud de Confiance , 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 Manage caches.

  5. Di panel Manage caches, klik ikon Resume 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.

Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.

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.

Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.


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 dokumentasi Terraform google_storage_anywhere_cache 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.s3nsapis.fr/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 Cloud de Confiance , 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 Manage caches.

  5. Di panel Manage caches, klik ikon Disable 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.

Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.

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.

Sebelum menjalankan contoh kode, tetapkan variabel lingkungan GOOGLE_CLOUD_UNIVERSE_DOMAIN ke s3nsapis.fr.


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 dokumentasi Terraform google_storage_anywhere_cache 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.s3nsapis.fr/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 Cloud de Confiance 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 penghapusan byte Bucket Tingkat byte yang dihapus dari cache, diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu bagi pascapemrosesan data.
Rasio penghapusan byte Project Tingkat byte yang dikeluarkan dari semua cache bucket, yang diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu pemrosesan data pasca-pembaruan.
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 pascapemrosesan data.
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 pascapemrosesan data.
Manfaat throughput cache Project Tingkat kuota bandwidth transfer data untuk region, dual-region, atau multi-region, penggunaan kuota, dan throughput tambahan yang disajikan oleh cache. Throughput tambahan yang disajikan oleh cache tidak dihitung dalam kuota. Oleh karena itu, 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 cache, yang diambil sampelnya setiap 60 detik. Jika pembacaan sepenuhnya ditampilkan dari cache, operasi tersebut dihitung sebagai hit. Jika pembacaan tidak ditampilkan dari cache atau hanya ditampilkan sebagian dari cache, operasi akan dihitung sebagai cache miss.
Operasi rasio hit Project Persentase operasi cache yang menyajikan data yang diminta dari semua cache untuk bucket dibandingkan dengan total operasi yang memenuhi syarat cache, yang diambil sampelnya selama 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 akan dihitung sebagai cache miss.
Byte rasio hit Bucket Persentase byte yang disajikan dari cache relatif terhadap total byte yang memenuhi syarat 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 cache, yang diambil sampelnya setiap 60 detik.
Byte mentah kecepatan penyerapan Bucket Tingkat byte mentah yang diserap ke dalam setiap cache, diambil sampelnya setiap 60 detik. Semua byte yang diserap, termasuk byte yang tidak dapat ditagih, digunakan dalam menghitung nilai metrik ini. Metrik ini dilaporkan secara real time.
Byte mentah kecepatan penyerapan Project Tingkat byte mentah yang diserap ke semua cache bucket, diambil sampelnya setiap 60 detik. Semua byte yang diserap, 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, diambil sampelnya setiap 60 detik.
Throughput - Cache ditemukan Project Throughput yang disajikan dari semua cache untuk bucket, diambil sampelnya setiap 60 detik.
Throughput - Cache tidak ditemukan Bucket Throughput yang tidak disajikan dari cache, 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 mengambil data untuk masing-masing bucket atau untuk semua bucket dalam sebuah project. Tingkat hierarki resource yang dicakup oleh diagram menentukan tempat Anda dapat mengakses diagram tersebut.

Mengakses diagram tingkat bucket

  1. Di konsol Cloud de Confiance , 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 level project

  1. Di konsol Cloud de Confiance , 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 bisa mendapatkan 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 Rapid Cache, lihat Menggunakan operasi yang berjalan lama.

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

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 AnywhereCaches asinkron bersifat idempoten secara default. Artinya, Anda dapat mencoba kembali panggilan API AnywhereCaches asinkron dengan aman tanpa khawatir akan mengubah resource secara tidak sengaja.

Misalnya, Anda melakukan operasi AnywhereCaches Create untuk membuat cache di us-central1-a, yang berhasil. Jika Anda melakukan operasi AnywhereCaches Create berikutnya menggunakan zona yang sama dan berhasil, permintaan tersebut 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 Identifikasi permintaan.

Langkah berikutnya

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