Apa yang perlu Anda ketahui saat membatalkan file - Amazon CloudFront

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Apa yang perlu Anda ketahui saat membatalkan file

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 tersebut mengubah URI file yang diminta, sebaiknya Anda membatalkan kedua URI untuk menghapus file dari cache tepi: CloudFront

  • 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 mengonfigurasi CloudFront untuk meneruskan cookie ke asal Anda, cache CloudFront edge mungkin berisi beberapa versi file. Saat Anda membatalkan file, CloudFront membatalkan setiap versi file yang di-cache terlepas dari cookie yang 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 mengonfigurasi CloudFront untuk meneruskan daftar header ke asal Anda dan ke cache berdasarkan nilai header, cache CloudFront tepi mungkin berisi beberapa versi file. Saat Anda membatalkan file, CloudFront membatalkan setiap versi file yang di-cache 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, CloudFront jangan cache file Anda.) 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 logging. Untuk informasi selengkapnya, lihat Konfigurasikan dan gunakan log standar (log akses).

Maksimum yang diizinkan

Untuk informasi selengkapnya tentang jumlah maksimum pembatalan yang diizinkan, lihat. Permintaan pembatalan bersamaan maksimum

File Microsoft Smooth Streaming

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

Karakter Non-ASCII atau tidak aman di jalur

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

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 CloudFrontkonsol, 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.

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

contoh Contoh: Jalur pembatalan

  • Untuk membatalkan semua file dalam direktori:

    /jalur direktori/*

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

    /jalur direktori*

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

    /jalur direktori/nama file.*

  • Untuk menginvalidasi 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:

    //initial-characters-in-filedirektori-jalur -nama *

  • Saat Anda mengonfigurasi CloudFront ke cache berdasarkan parameter string kueri dan Anda ingin membatalkan setiap versi file:

    /jalur direktori/nama file.file-name-extension*

  • Untuk membatalkan semua file dalam distribusi:

    /*

Panjang maksimal sebuah jalur adalah 4.000 karakter. Anda tidak dapat menggunakan wildcard di dalam jalur. Itu hanya bisa ditambahkan di ujung jalan.

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 (?).