Yang perlu Anda ketahui saat menginvalidasi jalur

Saat Anda menentukan file yang akan dibatalkan, lihat informasi berikut:

Sensitivitas kasus

Jalur pembatalan peka huruf besar/kecil. Misalnya, /images/image.jpg dan /images/Image.jpg tentukan dua file yang berbeda.

Mengubah URI dengan menggunakan fungsi Lambda

Jika CloudFront distribusi Anda memicu fungsi Lambda pada peristiwa permintaan penampil, dan jika fungsi mengubah URI file yang diminta, sebaiknya Anda membatalkan kedua URI untuk menghapus file dari CloudFront cache tepi:

• URI dalam permintaan penampil

• URI setelah fungsi mengubahnya

contoh Contoh

Misalkan fungsi Lambda Anda mengubah URI untuk file dari:

https://d111111abcdef8.cloudfront.net/index.html

Ke URI yang menyertakan direktori bahasa:

https://d111111abcdef8.cloudfront.net/en/index.html

Untuk menginvalidasi file, Anda harus menentukan jalur berikut:

• /index.html

• /en/index.html

Untuk informasi selengkapnya, lihat Invalidation paths.

Objek akar default

Untuk menginvalidasi objek akar default (file), tentukan jalur dengan cara yang sama dengan Anda menentukan jalur untuk file lain. Untuk informasi selengkapnya, lihat Cara kerja objek root default.

Meneruskan cookie

Jika Anda mengon CloudFront figurasi untuk meneruskan cookie ke asal Anda, cache CloudFront tepi mungkin berisi beberapa versi file. Ketika Anda membatalkan file, mem CloudFront batalkan setiap versi file yang di-cache terlepas dari cookie terkait. Anda tidak dapat menginvalidasi beberapa versi secara selektif dan tidak lainnya berdasarkan cookie terkait. Untuk informasi selengkapnya, lihat Konten cache berdasarkan cookie.

Meneruskan header

Jika Anda CloudFront mengonfigurasi untuk meneruskan daftar header ke asal Anda dan menyimpan cache berdasarkan nilai header, cache CloudFront tepi mungkin berisi beberapa versi file. Saat Anda membuat file tidak valid, CloudFront mengvalidasi setiap versi file yang disimpan, terlepas dari nilai header. Anda tidak dapat menginvalidasi beberapa versi secara selektif dan tidak lainnya berdasarkan nilai header. (Jika Anda mengonfigurasi CloudFront untuk meneruskan semua header ke asal Anda, file Anda CloudFront tidak akan di-cache.) Untuk informasi selengkapnya, lihat Konten cache berdasarkan header permintaan.

Meneruskan string kueri

Jika Anda mengonfigurasi CloudFront untuk meneruskan string kueri ke asal Anda, Anda harus menyertakan string kueri saat membatalkan file, seperti yang ditunjukkan dalam contoh berikut:

• /images/image.jpg?parameter1=a

• /images/image.jpg?parameter1=b

Jika permintaan klien mencakup lima string kueri berbeda untuk file yang sama, Anda dapat membuat file tidak valid sebanyak lima kali, satu kali untuk setiap string kueri, atau Anda dapat menggunakan * wildcard di jalur tidak valid, seperti yang ditunjukkan dalam contoh berikut:

/images/image.jpg*

Untuk informasi lebih lanjut tentang penggunaan wildcard di jalur ketidakvalidan, lihat Invalidation paths.

Untuk informasi lebih lanjut tentang string pencarian, lihat Konten cache berdasarkan parameter string kueri.

Untuk menentukan string kueri mana yang sedang digunakan, Anda dapat mengaktifkan CloudFront log. Untuk informasi selengkapnya, lihat Log akses (log standar).

Maksimum yang diizinkan

Untuk informasi lebih lanjut tentang jumlah maksimum pembatalan yang diizinkan, lihat. Kuotas pada invalidasi

File Microsoft Smooth Streaming

Anda tidak dapat membatalkan file media dalam format Microsoft Smooth Streaming jika Anda telah mengaktifkan Streaming Halus untuk perilaku cache yang sesuai.

Non-ASCII atau karakter yang tidak aman di jalur

Jika jalur menyertakan karakter non-ASCII atau karakter tidak aman seperti yang didefinisikan dalam RFC 1738, karakter tersebut. URL-encode Jangan gunakan karakter URL-encode lain di jalur, atau tidak CloudFront akan membatalkan versi lama dari file yang diperbarui.

penting

Jangan gunakan ~ karakter di jalan Anda. CloudFront tidak mendukung karakter ini untuk pembatalan, apakah itu URL-encoded atau tidak.

Jalur pembatalan

Jalurnya relatif terhadap distribusi. Misalnya, untuk membatalkan file dihttps://d111111abcdef8.cloudfront.net/images/image2.jpg, Anda akan menentukan/images/image2.jpg.

catatan

Di CloudFront konsol, Anda dapat menghilangkan garis miring di jalur, seperti ini:. images/image2.jpg Saat Anda menggunakan CloudFront API secara langsung, jalur pembatalan harus dimulai dengan garis miring di depan.

Anda juga dapat menginvalidasi beberapa file sekaligus dengan menggunakan * wildcard. *, yang menggantikan 0 karakter atau lebih, harus menjadi karakter terakhir di jalur ketidakvalidan.

penting

Untuk menggunakan wildcard (*) dalam invalidasi, Anda harus meletakkan wildcard di akhir jalur. Tanda bintang (*) yang disisipkan di posisi lain akan diperlakukan sebagai kecocokan karakter literal, bukan invalidasi wildcard.

Jika Anda menggunakan AWS Command Line Interface (AWS CLI) untuk membatalkan file dan Anda menentukan jalur yang menyertakan * wildcard, Anda harus menggunakan tanda kutip ( ") di sekitar jalur seperti. "/*"

Panjang maksimal sebuah jalur adalah 4.000 karakter.

contoh Contoh: Jalur pembatalan

• Untuk membatalkan semua file dalam direktori, semua subdirektori, dan semua file di direktori dan subdirektori:

  / directory-path /*

• Untuk membatalkan direktori, semua subdirektori, dan semua file di direktori dan subdirektori:

  / directory-path *

• Untuk mengvalidasi semua file yang memiliki nama yang sama tetapi memiliki ekstensi nama file yang berbeda, seperti logo.jpg, logo.png, dan logo.gif:

  / directory-path / file-name .*

• Untuk membatalkan semua file dalam direktori di mana nama file dimulai dengan karakter yang sama (seperti semua file untuk video dalam format HLS), terlepas dari ekstensi nama file:

  / directory-path / initial-characters-in-file-name *

• Ketika Anda mengkonfigurasi CloudFront untuk cache berdasarkan parameter string kueri dan Anda ingin membatalkan setiap versi file:

  / directory-path / file-name . file-name-extension *

• Untuk membatalkan semua file dalam distribusi:

  /*

Untuk informasi tentang mendevalidasi file jika Anda menggunakan fungsi Lambda untuk mengubah URI, lihat Changing the URI Using a Lambda Function.

Jika alur ketidakabsahan adalah direktori dan jika Anda belum menstandarkan metode untuk menentukan direktori—dengan atau tanpa garis miring yang menyimpang (/)—kami menyarankan Anda untuk menginvalidasi direktori dengan dan tanpa garis miring, misalnya, /images dan /images/.

URL yang ditandatangani

Jika Anda menggunakan URL yang ditandatangani, batalkan file hanya dengan menyertakan bagian URL sebelum tanda tanya (?).