Halaman ini menunjukkan cara membuat dan mengelola instance cache Anywhere Cache.
Untuk mengetahui informasi tentang cara menggunakan dan mengelola operasi yang berjalan lama yang dimulai dari operasi cache asinkron Anywhere Cache, lihat Menggunakan operasi yang berjalan lama.
Sebelum menggunakan Anywhere Cache, tinjau Batasan dan pembatasan.
Sebelum memulai
Untuk mendapatkan izin yang
diperlukan untuk membuat dan mengelola cache Anywhere Cache,
minta administrator Anda untuk memberi Anda
peran IAM Storage Admin (roles/storage.admin
)
di bucket yang ingin Anda buat cache-nya.
Peran bawaan ini berisi izin yang diperlukan untuk membuat dan mengelola cache Anywhere Cache. Untuk melihat izin yang benar-benar diperlukan, luaskan bagian Izin yang diperlukan:
Izin yang diperlukan
Izin berikut diperlukan untuk membuat dan mengelola cache Anywhere Cache:
-
storage.anywhereCaches.disable
(diperlukan untuk menonaktifkan cache) -
storage.anywhereCaches.get
(diperlukan untuk mendapatkan cache) -
storage.anywhereCaches.create
(diperlukan untuk membuat cache) -
storage.anywhereCaches.list
(diperlukan untuk mencantumkan cache) -
storage.anywhereCaches.pause
(diperlukan untuk menjeda cache) -
storage.anywhereCaches.resume
(diperlukan untuk melanjutkan cache) -
storage.anywhereCaches.update
(diperlukan untuk mengupdate cache)
Anda juga bisa mendapatkan izin ini dengan peran khusus.
Untuk mengetahui informasi tentang cara memberikan peran pada bucket, lihat Menggunakan IAM dengan bucket.
Untuk mengelola operasi yang berjalan lama yang dimulai dari metode Anywhere Cache, Anda mungkin memerlukan peran dan izin tambahan. Lihat peran yang diperlukan untuk operasi yang berjalan lama untuk mempelajari lebih lanjut.
Membuat cache
Konsol
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket yang datanya ingin Anda simpan dalam cache.
Di halaman Detail bucket, klik tab Konfigurasi.
Di bagian Anywhere Cache, klik Konfigurasi cache.
Halaman Edit configuration for <your_bucket_name> akan muncul untuk bucket Anda.
Di bagian Cache regions, klik region yang berisi zona tempat Anda ingin membuat cache.
Di bagian Cache zones, pilih zona tempat Anda ingin membuat cache. Untuk setiap zona yang Anda pilih, tentukan Waktu aktif dan opsi Penyerapan untuk cache.
Klik Simpan konfigurasi.
Pada dialog yang muncul, klik Konfirmasi.
Tab Operasi di halaman Detail bucket akan terbuka, yang menunjukkan status tugas operasi pembuatan cache Anda.
Anda juga dapat melihat status cache bucket secara langsung dari halaman Daftar bucket. Untuk melakukannya, selesaikan petunjuk berikut:
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Klik ikon Lihat Kolom (
), pilih Cache, lalu klik OK.
Command line
Gunakan perintah gcloud storage buckets anywhere-caches create
:
gcloud storage buckets anywhere-caches create gs://BUCKET_NAME ZONE
Ganti:
BUCKET_NAME
dengan nama bucket yang datanya ingin Anda simpan dalam cache. Contoh,my-bucket
.ZONE
dengan zona tempat cache akan berjalan. Contoh,us-east1-b
.Untuk membuat beberapa cache sekaligus, Anda dapat menentukan beberapa zona. Contoh,
us-east1-b us-east1-c us-east1-d
Tetapkan flag opsional berikut untuk memiliki kontrol yang lebih besar atas pembuatan cache:
--ttl
: Tentukan time to live (TTL) data dalam cache, dalam hitungan detik. Jika tidak ditentukan, defaultnya adalah86400s
(24 jam).--admission-policy
: Tentukan pada titik mana data akan di-ingest ke dalam cache. Nilai dapat berupaADMIT_ON_FIRST_MISS
atauADMIT_ON_SECOND_MISS
. Jika tidak ditentukan, setelan defaultnya adalahADMIT_ON_FIRST_MISS
.
Jika berhasil, perintah akan menampilkan ID operasi yang berjalan lama yang terkait dengan operasi Pembuatan AnywhereCache. Anda dapat mendapatkan detail tentang operasi yang berjalan lama atau membatalkan operasi yang berjalan lama untuk menghentikan operasi Pembuatan AnywhereCaches sebelum selesai.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
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.
Terraform
Lihat
dokumentasi Terraform google_storage_anywhere_cache
untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization
.Buat file JSON yang berisi informasi berikut:
{ "zone": "ZONE", "ttl": "TIME_TO_LIVE", "admissionPolicy": "ADMISSION_POLICY" }
Ganti:
ZONE
dengan zona tempat cache akan berjalan. Contoh,us-east1-b
.TIME_TO_LIVE
dengan time to live (TTL) data dalam cache. Nilainya dapat berkisar antara 1 jam hingga 7 hari, yang ditentukan dalam detik. Jika tidak ditentukan, default-nya adalah86400s
(24 jam).ADMISSION_POLICY
dengan kebijakan penerimaan cache, yang menentukan kapan data diserap. Nilai dapat berupaadmit-on-first-miss
atauadmit-on-second-miss
. Jika tidak ditentukan, setelan defaultnya adalahadmit-on-first-miss
.
Gunakan
cURL
untuk memanggil JSON API dengan permintaan untuk membuat cache:curl -X POST --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches"
Ganti:
JSON_FILE_NAME
dengan nama file JSON yang Anda buat di Langkah 2.BUCKET_NAME
dengan nama bucket yang datanya ingin Anda simpan dalam cache. Contoh,my-bucket
.
Jika berhasil, operasi akan menampilkan google.longrunning.Operation
.
Anda dapat mendapatkan detail tentang operasi yang berjalan lama atau
membatalkan operasi yang berjalan lama untuk menghentikan operasi Pembuatan AnywhereCaches
sebelum selesai.
Melihat cache
Konsol
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda lihat.
Di halaman Detail bucket, klik tab Konfigurasi.
Di bagian Cache di Mana Saja, klik
Edit di samping kolom Cache.Di halaman Edit konfigurasi yang muncul, pilih region untuk melihat semua cache dalam zona region tersebut.
Di panel Zona cache, Anda dapat melihat detail tentang setiap cache yang tersedia.
Command line
Gunakan perintah gcloud storage buckets anywhere-caches describe
:
gcloud storage buckets anywhere-caches describe ID
Ganti:
ID
dengan ID instance cache, yang dirumuskan sebagaiBUCKET_NAME/ANYWHERE_CACHE_ID
. Contohnya,my-bucket/us-east1-b
.
Gunakan tanda raw
opsional untuk menampilkan respons API mentah, bukan respons API standar.
Jika berhasil, perintah akan menampilkan resource AnywhereCache.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
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.
Terraform
Lihat
dokumentasi Terraform google_storage_anywhere_cache
untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization
.Gunakan
cURL
untuk memanggil JSON API dengan permintaan untuk mendapatkan cache:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID"
Ganti:
BUCKET_NAME
dengan nama bucket yang terkait dengan cache yang ingin Anda ambil. Contoh,my-bucket
.ANYWHERE_CACHE_ID
dengan zona tempat cache berada. Contoh,us-east1-b
.
Jika berhasil, operasi ini akan menampilkan resource AnywhereCache.
Mencantumkan cache
Konsol
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda lihat.
Di halaman Detail bucket, klik tab Konfigurasi.
Di bagian Cache di Mana Saja, klik
Edit di samping kolom Cache.Di halaman Edit konfigurasi yang muncul, pilih region untuk melihat semua cache dalam zona region tersebut.
Semua cache yang tersedia untuk zona dalam region muncul di panel Zona cache.
Command line
Gunakan perintah gcloud storage buckets anywhere-caches list
:
gcloud storage buckets anywhere-caches list gs://BUCKET_NAME
Ganti:
BUCKET_NAME
dengan nama bucket yang terkait dengan cache yang ingin Anda cantumkan. Contoh,my-bucket
.
Jika berhasil, perintah akan menampilkan daftar resource AnywhereCache.
Anda dapat secara opsional menggunakan tanda --raw
untuk menampilkan respons API mentah, bukan respons standar. Untuk mengetahui informasi selengkapnya tentang
mengontrol perilaku listingan, seperti membuat hasil berhalaman, lihat
dokumentasi gcloud storage ls
.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
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.
Terraform
Lihat
dokumentasi Terraform google_storage_anywhere_cache
untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization
.Gunakan
cURL
untuk memanggil JSON API dengan permintaan untuk mencantumkan cache:curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches"
Ganti:
BUCKET_NAME
dengan nama bucket yang terkait dengan cache yang ingin Anda ambil. Contoh,my-bucket
.
Saat mencantumkan beberapa cache, Anda dapat membuat hasil berhalaman.
Jika berhasil, operasi ini akan menampilkan daftar resource AnywhereCache. Untuk mengetahui detail struktur respons ini, lihat respons dalam dokumentasi Daftar AnywhereCaches.
Memperbarui cache
Konsol
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda perbarui.
Di halaman Bucket details, klik tab Observability, lalu klik Anywhere Cache di menu navigasi.
Klik Edit configuration.
Di halaman Edit konfigurasi yang muncul, perbarui properti cache, lalu klik Simpan.
Command line
Gunakan perintah gcloud storage buckets anywhere-caches update
:
gcloud storage buckets anywhere-caches update ID
Ganti:
ID
dengan ID instance cache, yang dirumuskan sebagaiBUCKET_NAME/ANYWHERE_CACHE_ID
. Contohnya,my-bucket/us-east1-b
.Untuk memperbarui beberapa cache sekaligus, Anda dapat menentukan beberapa ID. Misalnya,
my-bucket/us-east1-b my-bucket/us-east1-c
.
Gunakan tanda berikut untuk memperbarui konfigurasi cache. Jika flag tidak ditentukan, nilai tidak berubah.
--ttl
: Tentukan time to live (TTL) data dalam cache, dalam hitungan detik.--admission-policy
: Tentukan pada titik mana data akan di-ingest ke dalam cache. Nilai dapat berupaADMIT_ON_FIRST_MISS
atauADMIT_ON_SECOND_MISS
.
Jika berhasil, perintah akan menampilkan ID operasi yang berjalan lama dan belum diproses yang terkait dengan operasi Update AnywhereCache. Anda dapat mendapatkan detail tentang operasi yang berjalan lama.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
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.
Terraform
Lihat
dokumentasi Terraform google_storage_anywhere_cache
untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization
.Buat file JSON yang menyertakan perubahan pada properti cache yang ingin Anda perbarui.
{ "ttl": "TIME_TO_LIVE", "admissionPolicy": "ADMISSION_POLICY" }
Ganti:
TIME_TO_LIVE
dengan TTL data dalam cache. Nilainya dapat berkisar antara 1 jam hingga 7 hari, yang ditentukan dalam detik. Jika tidak ditentukan, nilai saat ini akan tetap digunakan.ADMISSION_POLICY
dengan kebijakan penerimaan cache, yang menentukan kapan data diserap. Nilai dapat berupaadmit-on-first-miss
atauadmit-on-second-miss
. Jika tidak ditentukan, nilai saat ini akan tetap digunakan.
Contoh berikut memperbarui TTL cache menjadi 2 hari dan kebijakan penerimaannya untuk menyerap data pada kegagalan kedua:
{ "ttl": "172800s", "admissionPolicy": "admit-on-second-miss" }
Untuk menerapkan properti baru, gunakan
cURL
untuk memanggil JSON API dengan permintaan untuk memperbarui cache:curl -X PATCH --data-binary @JSON_FILE_NAME \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID"
Ganti:
JSON_FILE_NAME
dengan nama file JSON yang Anda buat di Langkah 2.BUCKET_NAME
dengan nama bucket yang terkait dengan cache yang ingin Anda perbarui. Contoh,my-bucket
.ANYWHERE_CACHE_ID
dengan ID cache. Contoh,us-east1-b
.
Jika berhasil, operasi akan menampilkan google.longrunning.Operation
.
Anda dapat mendapatkan detail tentang operasi yang berjalan lama.
Menjeda cache
Konsol
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda jeda.
Di halaman Bucket details, klik tab Observability, lalu klik Anywhere Cache di menu navigasi.
Klik Jeda/lanjutkan cache.
Di panel yang muncul, klik ikon Jeda cache (
).Klik Close.
Command line
Gunakan perintah gcloud storage buckets anywhere-caches pause
:
gcloud storage buckets anywhere-caches pause ID
Ganti:
ID
dengan ID instance cache, yang dirumuskan sebagaiBUCKET_NAME/ANYWHERE_CACHE_ID
. Contohnya,my-bucket/us-east1-b
.Untuk menjeda beberapa cache sekaligus, Anda dapat menentukan beberapa ID. Misalnya,
my-bucket/us-east1-b my-bucket/us-east1-c
.
Jika berhasil, perintah akan menampilkan pesan keberhasilan.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
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.
Terraform
Lihat
dokumentasi Terraform google_storage_anywhere_cache
untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization
.Gunakan
cURL
untuk memanggil JSON API dengan permintaan untuk menjeda cache:curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/pause"
Ganti:
BUCKET_NAME
dengan nama bucket yang terkait dengan cache yang ingin Anda jeda. Contoh,my-bucket
.ANYWHERE_CACHE_ID
dengan ID cache. Contoh,us-east1-b
.
Jika berhasil, operasi akan menampilkan resource AnywhereCache yang diformat.
Melanjutkan cache
Konsol
Untuk melanjutkan cache yang telah dijeda, selesaikan petunjuk berikut:
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda lanjutkan.
Di halaman Bucket details, klik tab Observability, lalu klik Anywhere Cache di menu navigasi.
Klik Jeda/lanjutkan cache.
Di panel yang muncul, klik ikon Lanjutkan cache (
).Klik Close.
Untuk melanjutkan penggunaan cache yang telah dinonaktifkan, selesaikan petunjuk berikut:
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda lanjutkan.
Di halaman Bucket details, klik tab Observability, lalu klik Anywhere Cache di menu navigasi.
Klik Nonaktifkan/lanjutkan cache.
Di panel yang muncul, klik ikon Lanjutkan cache (
).Klik Close.
Command line
Gunakan perintah gcloud storage buckets anywhere-caches resume
:
gcloud storage buckets anywhere-caches resume ID
Ganti:
ID
dengan ID instance cache, yang dirumuskan sebagaiBUCKET_NAME/ANYWHERE_CACHE_ID
. Contohnya,my-bucket/us-east1-b
.Untuk melanjutkan beberapa cache sekaligus, Anda dapat menentukan beberapa ID. Misalnya,
my-bucket/us-east1-b my-bucket/us-east1-c
.
Jika berhasil, perintah akan menampilkan resource AnywhereCache yang diformat.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
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.
Terraform
Lihat
dokumentasi Terraform google_storage_anywhere_cache
untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization
.Gunakan
cURL
untuk memanggil JSON API dengan permintaan untuk melanjutkan cache:curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/resume"
Ganti:
BUCKET_NAME
dengan nama bucket yang terkait dengan cache yang ingin Anda lanjutkan. Contoh,my-bucket
.ANYWHERE_CACHE_ID
dengan ID cache. Contoh,us-east1-b
.
Jika berhasil, operasi akan menampilkan resource AnywhereCache yang diformat.
Menonaktifkan cache
Konsol
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket yang terkait dengan cache yang ingin Anda nonaktifkan.
Di halaman Bucket details, klik tab Observability, lalu klik Anywhere Cache di menu navigasi.
Klik Nonaktifkan/lanjutkan cache.
Di panel yang muncul, klik ikon Nonaktifkan cache (
).Pada dialog yang muncul, klik Konfirmasi.
Klik Close.
Command line
Gunakan perintah gcloud storage buckets anywhere-caches disable
:
gcloud storage buckets anywhere-caches disable ID
Ganti:
ID
dengan ID instance cache, yang dirumuskan sebagaiBUCKET_NAME/ANYWHERE_CACHE_ID
. Contohnya,my-bucket/us-east1-b
.Untuk menonaktifkan beberapa cache sekaligus, Anda dapat menentukan beberapa ID. Misalnya,
my-bucket/us-east1-b my-bucket/us-east1-c
.
Jika berhasil, perintah akan menampilkan resource AnywhereCache yang diformat.
Library klien
C++
Untuk mengetahui informasi selengkapnya, lihatDokumentasi referensi Cloud Storage C++ API.
Untuk melakukan autentikasi ke Cloud Storage, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk library klien.
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.
Terraform
Lihat
dokumentasi Terraform google_storage_anywhere_cache
untuk mengetahui detail tentang cara menggunakan Anywhere Cache dengan Terraform.
REST API
JSON API
Menginstal dan melakukan inisialisasi gcloud CLI, yang memungkinkan Anda membuat token akses untuk header
Authorization
.Gunakan
cURL
untuk memanggil JSON API dengan permintaan untuk menonaktifkan cache:curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ "https://storage.googleapis.com/storage/v1/b/BUCKET_NAME/anywhereCaches/ANYWHERE_CACHE_ID/disable"
Ganti:
BUCKET_NAME
dengan nama bucket yang terkait dengan cache yang ingin Anda nonaktifkan. Contoh,my-bucket
.ANYWHERE_CACHE_ID
dengan ID cache. Contoh,us-east1-b
.
Jika berhasil, perintah akan menampilkan resource AnywhereCache yang diformat.
Memantau performa cache
Bagian Cloud Storage di konsol Google Cloud menyediakan diagram pemantauan yang memungkinkan Anda melacak performa cache menggunakan metrik. Diagram pemantauan ini juga dapat dilihat menggunakan Cloud Monitoring.
Diagram yang tersedia
Diagram | Tingkat hierarki resource | Deskripsi |
---|---|---|
Rasio penggantian byte | Bucket | Kecepatan byte yang dikeluarkan dari cache, yang diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu bagi pemrosesan data setelahnya. |
Rasio penggantian byte | Project | Kecepatan byte yang dikeluarkan dari semua cache bucket, yang diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu untuk memproses data setelahnya. |
Byte dalam cache | Bucket | Kecepatan byte dalam cache, yang diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu bagi pemrosesan data setelahnya. |
Byte dalam cache | Project | Kecepatan byte ini di semua cache bucket, yang diambil sampelnya setiap jam. Data ini diperbarui lebih dari sekali dalam satu jam untuk memberikan waktu bagi pemrosesan data setelahnya. |
Manfaat throughput cache | Project | Tingkat kuota bandwidth transfer data untuk region, region ganda, atau multi-region, penggunaan kuota, dan throughput tambahan yang disalurkan oleh cache. Throughput tambahan yang ditayangkan oleh cache tidak dihitung dalam kuota, sehingga, penggunaan cache memungkinkan project melampaui throughput yang diizinkan oleh kuota. |
Operasi rasio hit | Bucket | Persentase operasi cache yang menyajikan data yang diminta dari cache relatif terhadap total operasi yang memenuhi syarat untuk cache, yang diambil sampelnya setiap 60 detik. Jika pembacaan sepenuhnya ditampilkan dari cache, operasi akan dihitung sebagai hit. Jika pembacaan tidak ditampilkan dari cache atau hanya ditampilkan sebagian dari cache, operasi dihitung sebagai kegagalan. |
Operasi rasio hit | Project | Persentase operasi cache yang menyajikan data yang diminta dari semua cache untuk bucket relatif terhadap total operasi yang memenuhi syarat untuk cache, yang diambil sampelnya selama 60 detik. Jika pembacaan sepenuhnya ditampilkan dari cache, operasi dihitung sebagai hit. Jika pembacaan tidak ditampilkan dari cache atau hanya ditampilkan sebagian dari cache, operasi dihitung sebagai tidak ada. |
Byte rasio hit | Bucket | Persentase byte yang disajikan dari cache relatif terhadap total byte yang memenuhi syarat untuk di-cache, yang diambil sampelnya setiap 60 detik. |
Byte rasio hit | Project | Persentase byte yang ditayangkan dari semua cache untuk bucket relatif terhadap total byte yang memenuhi syarat untuk di-cache, yang diambil sampelnya setiap 60 detik. |
Byte mentah kecepatan penyerapan | Bucket | Kecepatan byte mentah yang dimasukkan ke setiap cache, yang diambil sampelnya setiap 60 detik. Semua byte yang di-ingest, termasuk byte yang tidak dapat ditagih, digunakan dalam menghitung nilai metrik ini. Metrik ini dilaporkan secara real time. |
Byte mentah kecepatan penyerapan | Project | Kecepatan byte mentah yang dimasukkan ke semua cache bucket, yang diambil sampelnya setiap 60 detik. Semua byte yang di-ingest, termasuk byte yang tidak dapat ditagih, digunakan dalam menghitung nilai metrik ini. Metrik ini dilaporkan secara real time. |
Throughput - Cache ditemukan | Bucket | Throughput yang disalurkan dari cache, yang diambil sampelnya setiap 60 detik. |
Throughput - Cache ditemukan | Project | Throughput yang disajikan dari semua cache untuk bucket, yang diambil sampelnya setiap 60 detik. |
Throughput - Cache tidak ditemukan | Bucket | Throughput yang tidak ditayangkan dari cache, yang diambil sampelnya setiap 60 detik. |
Throughput - Cache tidak ditemukan | Project | Throughput yang tidak ditayangkan dari cache bucket mana pun, yang diambil sampelnya setiap 60 detik. |
Mengakses diagram
Diagram pemantauan merekam data untuk masing-masing bucket atau untuk semua bucket dalam project. Tingkat hierarki resource yang dicatat diagram menentukan tempat Anda dapat mengakses diagram.
Mengakses diagram tingkat bucket
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Dalam daftar bucket, klik nama bucket yang ingin Anda lihat diagram pemantauannya.
Di halaman Detail bucket, klik tab Observabilitas.
Di menu navigasi, pilih Anywhere Cache.
Diagram pemantauan ditampilkan.
Mengakses diagram tingkat project
- Di Google Cloud konsol, buka halaman Bucket Cloud Storage.
Di panel navigasi Cloud Storage, klik Monitoring.
Di panel menu, klik Anywhere Cache.
Diagram pemantauan ditampilkan.
Menggunakan operasi yang berjalan lama
Jika berhasil dijalankan, operasi AnywhereCaches Create dan Update akan memulai operasi yang berjalan lama. Anda dapat mengambil dan mencantumkan operasi yang berjalan lama untuk melihat detail dan status operasi AnywhereCaches yang mendasarinya, atau membatalkan operasi yang berjalan lama untuk membatalkan operasi AnywhereCaches yang mendasarinya saat sedang berlangsung.
Untuk mengetahui petunjuk tentang cara menggunakan operasi yang berjalan lama untuk Anywhere Cache, lihat Menggunakan operasi yang berjalan lama.
Contoh berikut menunjukkan operasi yang berjalan lama yang dimulai dari operasi Pembuatan AnywhereCaches:
done: false kind: storage#operation metadata: '@type': type.googleapis.com/google.storage.control.v2.CreateAnywhereCacheMetadata anywhereCacheId: us-central1-c zone: us-central1-c ttl: 172800s admissionPolicy: admit-on-first-miss commonMetadata: createTime: '2023-12-14T20:52:00.032Z' progressPercent: -1 requestedCancellation: false type: create-anywhere-cache updateTime: '2023-12-14T20:52:00.032Z' name: projects/_/buckets/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig selfLink: https://www.googleapis.com/storage/v1/b/my-bucket/operations/AULf_KhQxxsWRSn56wv4jfmn3pOu_dKTz9FoYx6S0EzMw5ssR0cXIiorCvHRwqxZnQmWj9jnGpKb3Y6iCD3XM9KLc8EHBm7uig
Upaya coba lagi
API AnywhereCaches Asinkron bersifat idempotent secara default. Artinya, Anda dapat mencoba lagi panggilan API AnywhereCaches asinkron dengan aman tanpa khawatir mengubah resource secara tidak sengaja.
Misalnya, Anda melakukan operasi Pembuatan AnywhereCaches untuk membuat
cache di us-central1-a
, yang berhasil. Jika Anda melakukan operasi Pembuatan AnywhereCaches berikutnya menggunakan zona yang sama dan berhasil, permintaan akan menampilkan operasi yang berjalan lama yang sama dengan permintaan sebelumnya. Perhatikan bahwa perilaku ini hanya terjadi jika Anda menyertakan request_id
sebagai bagian dari permintaan pembuatan cache. Jika request_id
tidak disertakan, Anda akan mendapatkan error
ANYWHERE_CACHE_ALREADY_EXISTS
saat mencoba membuat cache yang sudah ada. Untuk mengetahui informasi tentang cara menyertakan request_id
, lihat
Duplikasi permintaan.
Langkah berikutnya
Dapatkan rekomendasi tentang bucket dan zona yang akan dibuat cache-nya.