Membatalkan validasi konten yang di-cache

Halaman ini menjelaskan cara membatalkan validasi konten yang di-cache Cloud CDN.

Misalnya, jika file yang terletak di /images/file.jpg telah di-cache dan perlu dibuat tidak valid, Anda dapat menggunakan beberapa metode untuk membuatnya tidak valid, bergantung pada apakah Anda ingin memengaruhi hanya file tersebut atau cakupan yang lebih luas. Dalam setiap kasus, Anda dapat membatalkan validasi untuk semua nama host atau hanya untuk satu nama host.

Untuk mempelajari pembatalan cache lebih lanjut, lihat Ringkasan pembatalan cache.

Sebelum memulai

Anda dapat menggunakan Google Cloud CLI atau Konsol Google Cloud untuk melakukan pembatalan validasi.

Anda dapat mengakses Google Cloud CLI dengan dua cara:

• Instal Google Cloud CLI dengan mengikuti petunjuk di bagian Menginstal dengan apt-get. Jika Anda belum menggunakan Google Cloud CLI sebelumnya, jalankan gcloud init terlebih dahulu untuk melakukan autentikasi.

• Gunakan Cloud Shell, yang sudah dilengkapi dengan gcloud.

Izin yang diperlukan untuk langkah ini

Untuk menjalankan tugas ini, Anda harus diberi izin berikut atau peran IAM berikut.

Izin

• compute.urlMaps.get
• compute.urlMaps.invalidateCache

Peran

• roles/compute.networkAdmin
• roles/compute.loadBalancerAdmin

Untuk membuat peran khusus dengan izin yang diperlukan, lihat Membuat dan mengelola peran khusus.

Untuk menambahkan peran bawaan, gunakan panduan awal IAM.

Catatan: Jika Anda menggunakan Load Balancer Aplikasi eksternal global dengan referensi layanan lintas project VPC Bersama, lihat Pembatalan validasi dengan referensi layanan lintas project VPC Bersama.

Membatalkan validasi hanya satu file

Konsol

1. Di konsol Google Cloud, buka halaman Cloud CDN.

   Buka halaman Cloud CDN

2. Di bagian Load balancer terkait, klik nama load balancer.
3. Klik tab Pembatalan validasi cache.
4. Masukkan jalur ke file.
   • Jika Anda ingin membatalkan validasi jalur untuk semua nama host, hanya masukkan jalur (misalnya: /images/file.jpg).
   • Jika Anda ingin membatalkan validasi jalur hanya untuk satu nama host, tentukan nama host sebagai bagian dari jalur (misalnya: host1.com/images/file.jpg).
5. Klik Batalkan validasi.

gcloud

Gunakan perintah gcloud compute url-maps invalidate-cdn-cache.

Untuk hanya menentukan satu file untuk pembatalan validasi, gunakan flag --path dengan nama file.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --path "/images/file.jpg"

Ganti URL_MAP_NAME dengan nama peta URL Anda. Untuk mencantumkan peta URL, gunakan perintah gcloud compute url-maps list.

Untuk membatalkan validasi hanya untuk satu host, tambahkan flag --host—misalnya, --host host1.com.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host host1.com \
    --path "/images/file.jpg"

Secara default, Google Cloud CLI menunggu hingga pembatalan validasi selesai. Untuk melakukan pembatalan validasi di latar belakang, tambahkan --async ke command line.

API

Gunakan panggilan API metode urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Ganti kode berikut:

• PROJECT_ID: project ID konsol Google Cloud Anda
• URL_MAP_NAME: nama peta URL

Untuk menentukan file yang akan dibatalkan validasinya, gunakan contoh isi permintaan JSON berikut:

{
  "path": "/images/file.jpg"
}

Untuk membatalkan validasi file hanya untuk satu host, gunakan contoh isi permintaan JSON berikut:

{
  "host": "host1.com",
  "path": "/images/file.jpg"
}

Membatalkan seluruh direktori

Konsol

1. Di konsol Google Cloud, buka halaman Cloud CDN.

   Buka halaman Cloud CDN

2. Di bagian Load balancer terkait, klik nama load balancer.
3. Klik tab Pembatalan validasi cache.
4. Masukkan jalur direktori dan karakter pengganti (/path/to/file/*).
   • Jika Anda ingin membatalkan validasi seluruh direktori untuk semua nama host, masukkan hanya jalur dan karakter pengganti (misalnya: /images/*).
   • Jika Anda ingin membatalkan validasi seluruh direktori hanya untuk satu nama host, tentukan nama host sebagai bagian dari jalur (misalnya: host1.com/images/*).
5. Klik Batalkan validasi.

gcloud

Gunakan perintah gcloud compute url-maps invalidate-cdn-cache.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --path "/images/*"

Ganti URL_MAP_NAME dengan nama peta URL Anda.

Untuk membatalkan validasi hanya untuk satu host, tambahkan flag --host—misalnya, --host host1.com.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host host1.com \
    --path "/images/*"

API

Gunakan panggilan API metode urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Ganti kode berikut:

• PROJECT_ID: project ID konsol Google Cloud Anda
• URL_MAP_NAME: nama peta URL

Untuk menentukan direktori untuk pembatalan validasi, gunakan contoh isi permintaan JSON berikut:

{
  "path": "/images/*"
}

Untuk membatalkan validasi direktori hanya untuk satu host, gunakan contoh isi permintaan JSON berikut:

{
  "host": "host1.com",
  "path": "/images/*"
}

Membatalkan validasi menurut tag cache

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

Konsol

Penggunaan tag cache untuk pembatalan validasi tidak didukung di Konsol Google Cloud.

gcloud

Gunakan perintah gcloud beta compute url-maps invalidate-cdn-cache.

gcloud beta compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --tags=TAGS

Ganti kode berikut:

• URL_MAP_NAME: nama peta URL
• TAGS: tag atau daftar tag yang dipisahkan koma; sebagai alternatif, Anda dapat menentukan tanda ini hingga 10 kali

Misalnya, jika respons backend menyertakan header Cache-Tag dengan ID pengguna buram, seperti UUID4 atau bentuk GUID lainnya, Anda dapat membatalkan semua konten untuk pengguna tertentu menggunakan tanda tag. Selain itu, untuk membatalkan validasi konten hanya untuk satu host, seperti untuk lingkungan staging, tambahkan tanda --host.

gcloud beta compute url-maps invalidate-cdn-cache url_map_1 \
    --tags="1115b8f4-f804-4861-9629-8cb9aecdeeb3" \
    --host="host1.com"

API

Gunakan panggilan API metode urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Ganti kode berikut:

• PROJECT_ID: project ID konsol Google Cloud Anda
• URL_MAP_NAME: nama peta URL

Untuk menentukan tag cache untuk pembatalan validasi, gunakan contoh isi permintaan JSON berikut:

{
  "tags": "tag1,tag2"
}

Anda dapat menentukan satu tag atau daftar tag yang dipisahkan koma.

Untuk membatalkan validasi berdasarkan tag cache hanya untuk satu host, gunakan contoh isi permintaan JSON berikut:

{
  "host": "host1.com",
  "path": "tag1,tag2"
}

Membatalkan validasi semua

Konsol

1. Di konsol Google Cloud, buka halaman Cloud CDN.

   Buka halaman Cloud CDN

2. Di bagian Load balancer terkait, klik nama load balancer.
3. Klik tab Pembatalan validasi cache.
4. Hanya masukkan root dan karakter pengganti (/*).
   • Jika Anda ingin membatalkan validasi semuanya untuk semua nama host, hanya masukkan /* ke dalam kolom.
   • Jika Anda ingin membatalkan semuanya hanya untuk satu nama host, tentukan nama host sebagai bagian dari jalur (misalnya: host1.com/*).
5. Klik Batalkan validasi.

gcloud

Gunakan perintah gcloud compute url-maps invalidate-cdn-cache.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --path "/*"

Ganti kode berikut:

• URL_MAP_NAME: nama peta URL
• /*: jalur URL yang ingin Anda batalkan validasinya; tidak menyertakan nama host; jalur dapat menggunakan nama file eksplisit atau karakter pengganti

Untuk membatalkan validasi hanya untuk satu host, tambahkan flag --host—misalnya, --host host1.com.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host host1.com \
    --path "/*"

API

Gunakan panggilan API metode urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Ganti kode berikut:

• PROJECT_ID: project ID konsol Google Cloud Anda
• URL_MAP_NAME: nama peta URL

Untuk menentukan jalur URL untuk pembatalan validasi, gunakan contoh isi permintaan JSON berikut:

{
  "path": "/*"
}

Untuk membatalkan validasi jalur URL hanya untuk satu host, gunakan contoh isi permintaan JSON berikut:

{
  "host": "host1.com",
  "path": "/*"
}

Melihat status permintaan pembatalan validasi

Cloud CDN memunculkan dua baris log per pembatalan validasi, satu saat pembatalan validasi diterima dan satu lagi saat selesai. Yang pertama memiliki informasi host dan jalur.

Untuk melihat status permintaan pembatalan validasi atau menemukan daftar lengkap permintaan yang baru saja dikirim, Anda dapat menggunakan Cloud Logging atau Cloud Monitoring.

Berikut adalah contoh perintah yang menggunakan Logging:

gcloud logging read 'protoPayload.methodName="v1.compute.urlMaps.invalidateCache"' \
    --limit=10

Berikut adalah contoh kueri yang menggunakan Pemantauan:

protoPayload.serviceName="compute.googleapis.com"
protoPayload.methodName="v1.compute.urlMaps.invalidateCache"

Langkah berikutnya

• Untuk memeriksa apakah Cloud CDN menayangkan respons dari cache, lihat Melihat log.
• Untuk mempelajari konten yang dapat di-cache atau tidak dapat di-cache, lihat Ringkasan penyimpanan dalam cache.