All Products
Search
Document Center

ApsaraVideo VOD:Penyaringan parameter

Last Updated:Sep 16, 2026

Saat Anda mengaktifkan penyaringan parameter, titik keberadaan (POPs) Alibaba Cloud CDN menghapus parameter yang mengikuti tanda tanya (?) dalam URL permintaan. Parameter tersebut dapat mencakup informasi seperti identitas pengguna dan saluran akses. CDN kemudian menggunakan URL hasil tersebut untuk menghasilkan kunci hash cache. Proses ini meningkatkan rasio hit cache dan mempercepat pengiriman konten. Topik ini menjelaskan cara mengonfigurasi penyaringan parameter.

Perbandingan fitur

  • Custom Cache Key bertentangan dengan pengabaian parameter. Jika Anda mengonfigurasi pengabaian parameter dan Custom Cache Key secara bersamaan, pengabaian parameter tidak berlaku.

  • Custom Cache Key dapat menggantikan pengabaian parameter dalam konfigurasi kunci cache dan menawarkan fungsionalitas yang lebih komprehensif. Kami merekomendasikan untuk menggunakannya terlebih dahulu. Berikut perbandingan konfigurasinya:

    Skenario

    Pengabaian parameter

    Custom Cache Key

    Abaikan semua parameter permintaan dalam kunci cache

    Atur Ignore Parameters ke Yes dan biarkan Retain Specified Parameters kosong.

    Tambahkan aturan penanganan parameter permintaan:

    • Action: Retain

    • Parameter name: Atur ke nama parameter apa pun yang tidak ada, seperti example-argument.

    Hanya pertahankan parameter permintaan key1 dalam kunci cache

    Atur Ignore Parameters ke Yes dan atur Retain Specified Parameters ke key1.

    Tambahkan aturan penanganan parameter permintaan:

    • Action: Retain

    • Parameter name: key1

    Hapus hanya parameter permintaan key1 dari kunci cache

    Hapus pengaturan parameter untuk key1.

    Tambahkan aturan penanganan parameter permintaan:

    • Action: Delete

    • Parameter name: key1

  • Rewrite Origin Parameters dapat menggantikan pengabaian parameter dalam penulisan ulang permintaan asal dan menawarkan fungsionalitas yang lebih komprehensif. Kami merekomendasikan untuk menggunakannya terlebih dahulu.

Ikhtisar fitur

Abaikan parameter

Fungsi

Skenario

Menghapus parameter kueri (bagian setelah ?) dari URL permintaan sehingga permintaan dengan parameter berbeda mengenai file cache yang sama. Hal ini meningkatkan rasio hit cache dan mengurangi lalu lintas kembali ke asal.

Aktifkan pengabaian parameter ketika parameter URL tidak terkait dengan konten resource (seperti UID pengguna, sumber referral, atau kode promo). Misalnya, dua permintaan berikut mengakses resource yang sama tetapi membawa UID berbeda:

Pengguna A: http://example.com/1.jpg?uid=123***

Pengguna B: http://example.com/1.jpg?uid=654***

Tanpa pengabaian parameter, node edge CDN memperlakukan ini sebagai resource berbeda dan tidak dapat berbagi cache yang sama, sehingga memerlukan pengambilan asal untuk setiap permintaan. Dengan pengabaian parameter diaktifkan, node edge CDN menghilangkan parameter dan menggunakan http://example.com/1.jpg untuk mencocokkan cache.

Catatan

Penandatanganan URL memiliki prioritas lebih tinggi daripada pengabaian parameter. Penandatanganan Tipe A menyertakan parameter URL dalam signature-nya. CDN melakukan otentikasi terlebih dahulu dan hanya menyimpan replika ke cache setelah validasi berhasil.

Pertahankan parameter asal

Fungsi

Skenario

Mempertahankan semua parameter URL asli selama pengambilan asal untuk memastikan server asal menerima informasi pengguna penting.

Saat pengabaian parameter diaktifkan, node edge CDN secara default menggunakan URL tanpa parameter untuk pengambilan asal. Pada contoh di atas, baik Pengguna A maupun Pengguna B akan memicu permintaan asal ke http://example.com/1.jpg, sehingga kehilangan informasi penting seperti UID. Mengaktifkan Retain Origin Parameters memastikan CDN menggunakan URL asli untuk pengambilan asal, sehingga mempertahankan parameter seperti UID untuk server asal.

Prosedur

  1. Masuk ke ApsaraVideo VOD console.

  2. Di panel navigasi sebelah kiri, pilih Configuration Management > CDN Configuration > Domain Names.

  3. Pada halaman Domain Names, temukan nama domain yang ingin Anda kelola dan klik Configure di kolom Actions.

  4. Di panel navigasi sebelah kiri, klik Performance Optimization.

  5. Pada bagian Ignore Parameters, klik Modify.

  6. Konfigurasikan item konfigurasi yang diperlukan, seperti pola penyaringan dan parameter penyaringan.

    Tabel berikut menjelaskan parameter-parameter tersebut.

    Penting

    Mengganti pola filter akan menghapus konfigurasi saat ini.

    • Filter Pattern: Retain Specified Parameters

      Parameter

      Deskripsi

      Contoh

      Ignore Parameters

      • Yes: Mengaktifkan penyaringan parameter. Untuk permintaan pengambilan asal, parameter yang mengikuti tanda tanya (?) dalam URL dihapus.

        Catatan

        Jika Anda mengaktifkan Ignore Parameters tetapi membiarkan Retain specified parameters kosong, semua parameter yang mengikuti tanda tanya (?) dihapus.

      • No: Menonaktifkan fitur ignore parameters.

      Asumsikan URL aslinya adalah http://example.com/1.jpg?key1=1&key2=2&key3=3. Contoh berikut menunjukkan cara CDN memproses URL berdasarkan konfigurasi berbeda:

      • Contoh 1: Filter semua parameter + Gunakan URL hasil pemrosesan untuk pengambilan asal:

        • Konfigurasi: Atur Ignore Parameters ke Yes, biarkan Retain specified parameters kosong, dan atur Retain back-to-origin parameters ke No.

        • Kunci cache: http://example.com/1.jpg

        • URL pengambilan asal: http://example.com/1.jpg

      • Contoh 2: Pertahankan parameter tertentu + Gunakan URL hasil pemrosesan untuk pengambilan asal:

        • Konfigurasi: Atur Ignore Parameters ke Yes, atur Retain specified parameters ke key1, dan atur Retain origin parameters ke No.

        • Kunci cache: http://example.com/1.jpg?key1=1

        • URL pengambilan asal: http://example.com/1.jpg?key1=1

      • Contoh 3: Filter semua parameter + Gunakan URL asli untuk pengambilan asal:

        • Konfigurasi: Atur Ignore Parameters ke Yes, biarkan Retain specified parameters kosong, dan atur Retain back-to-origin parameters ke Yes.

        • Kunci cache: http://example.com/1.jpg

        • URL pengambilan asal: http://example.com/1.jpg?key1=1&key2=2&key3=3

      • Contoh 4: Pertahankan parameter tertentu + Gunakan URL asli untuk pengambilan asal:

        • Konfigurasi: Atur Ignore Parameters ke Yes, atur Retain specified parameters ke key1, dan atur Retain origin parameters ke Yes.

        • Kunci cache: http://example.com/1.jpg?key1=1

        • URL pengambilan asal: http://example.com/1.jpg?key1=1&key2=2&key3=3

      Retain Specified Parameters

      Tentukan parameter yang ingin dipertahankan. Anda dapat menentukan hingga 10 parameter. Pisahkan beberapa parameter dengan koma (,).

      Retain Origin Parameters

      • Yes: Mempertahankan semua parameter dari URL permintaan asli dalam permintaan kembali ke asal.

      • No: Parameter dalam permintaan kembali ke asal sama dengan parameter dalam kunci hash cache. Artinya hanya parameter yang ditentukan yang dipertahankan.

    • Filter Pattern: Delete Specified Parameters

      Parameter

      Deskripsi

      Contoh

      Delete specified parameters

      Tentukan parameter yang ingin dihapus. Anda dapat menentukan hingga 10 parameter. Pisahkan beberapa parameter dengan spasi.

      Asumsikan URL aslinya adalah http://example.com/1.jpg?key1=1&key2=2&key3=3. Contoh berikut menunjukkan cara CDN memproses URL berdasarkan konfigurasi berbeda:

      • Contoh 1: Hapus parameter tertentu + Gunakan URL hasil pemrosesan untuk pengambilan asal:

        • Konfigurasi: Atur Delete specified parameters ke key1 dan atur Retain origin parameters ke No.

        • Kunci cache: http://example.com/1.jpg?key2=2&key3=3

        • URL pengambilan asal: http://example.com/1.jpg?key2=2&key3=3

      • Contoh 2: Hapus parameter tertentu + Gunakan URL asli untuk pengambilan asal:

        • Konfigurasi: Atur Delete specified parameters ke key1 dan atur Retain origin parameters ke Yes.

        • Kunci cache: http://example.com/1.jpg?key2=2&key3=3

        • URL pengambilan asal: http://example.com/1.jpg?key1=1&key2=2&key3=3

      Retain Origin Parameters

      • Yes: Mempertahankan semua parameter dari URL permintaan asli dalam permintaan kembali ke asal.

      • No: Parameter dalam permintaan kembali ke asal sama dengan parameter dalam kunci hash cache. Artinya parameter yang ditentukan dihapus.

  7. Klik OK.