Ketika parameter URL dalam permintaan pengguna berbeda dari yang diharapkan oleh server origin Anda, gunakan Parameter Rewrite untuk mengontrol parameter mana yang diteruskan oleh CDN. Anda dapat menambahkan, menghapus, menyimpan, atau memodifikasi parameter dalam URL permintaan pengambilan asal—tanpa mengubah kunci cache CDN Anda.
Kasus penggunaan
Hapus parameter pelacakan: Hilangkan parameter analitik (seperti
utm_sourceataufbclid) dari permintaan pengambilan asal untuk mengurangi beban yang tidak perlu pada server origin Anda.Sisipkan identifikasi versi: Tambahkan parameter tetap (seperti
version=2) ke setiap permintaan pengambilan asal agar origin Anda dapat menyajikan varian konten yang tepat.Normalize parameters: Mempertahankan hanya parameter yang dibutuhkan oleh origin Anda dan membuang sisanya guna menyederhanakan penanganan permintaan di sisi origin.
Cara kerja
Parameter Rewrite dijalankan di titik keberadaan (POPs) pengambilan asal CDN dan hanya menulis ulang parameter kueri dalam URL permintaan pengambilan asal. Fitur ini tidak memengaruhi routing internal CDN atau mengubah kunci cache—sehingga perubahan parameter yang mencapai origin Anda tidak berdampak pada tingkat hit cache CDN Anda.
Perilaku ini berbeda dengan Ignore Parameters, yang juga dijalankan di POPs CDN tetapi memengaruhi routing internal dan menulis ulang kunci cache.
Format parameter URL
Parameter URL terdiri atas satu atau beberapa pasangan name/value yang ditambahkan ke URL setelah karakter ?, dalam format name=value. Beberapa parameter dipisahkan oleh &.
URL juga dapat berisi karakter # diikuti oleh pengenal fragmen, yang mengarahkan browser ke lokasi tertentu pada halaman. Misalnya, dalam http://www.example.com/index.html#segment, #segment mengarah ke lokasi segment pada index.html.
Jenis operasi
Parameter Rewrite mendukung lima jenis operasi:
| Operasi | Apa yang dilakukan | Contoh (input → output) |
|---|---|---|
| Ignore Parameters | Menghapus semua parameter dari URL pengambilan asal | ?code1=1&code2=2 → _(tidak ada parameter)_ |
| Add | Menambahkan parameter baru ke URL pengambilan asal | _(tidak ada code4)_ → ?code4=4 |
| Delete | Menghapus parameter tertentu dari URL pengambilan asal | ?code1=1&code2=2 → ?code1=1 |
| Reserve Only | Hanya menyimpan parameter yang terdaftar; menghapus semua parameter lainnya | ?code1=1&code2=2&code3=3 → ?code2=2 |
| Modify | Mengubah nilai parameter yang sudah ada | ?code3=3 → ?code3=0 |
Prioritas operasi
Ketika beberapa operasi berlaku untuk parameter yang sama, hanya operasi dengan prioritas tertinggi yang diterapkan. Urutan prioritas, dari tertinggi ke terendah:
Add > Delete > Reserve Only > Modify
Ketika Ignore Parameters diaktifkan, hanya operasi Add yang tetap berlaku.
Konflik dengan fitur lain
Parameter Rewrite, aturan enhance break dari Rewrite Origin Fetch URL, dan Ignore Parameters dapat saling bertentangan. Jika terjadi konflik, fitur yang dikonfigurasi terakhir akan mengambil alih.
Jika Anda perlu memodifikasi kunci cache selain menulis ulang parameter origin, gunakan Ignore Parameters sebagai gantinya.
Konfigurasikan aturan penulisan ulang parameter
Prasyarat
Sebelum memulai, pastikan Anda telah memiliki:
Nama domain yang dipercepat Alibaba Cloud CDN
Akses ke Konsol CDN
Prosedur
Masuk ke Konsol CDN.
Di panel navigasi kiri, klik Domain Names.
Pada halaman Domain Names, temukan nama domain target dan klik Manage di kolom Actions.
Di panel navigasi untuk nama domain tersebut, klik Origin Fetch.
Klik tab Parameter Rewrite.
Nyalakan sakelar Feature Switch.
Konfigurasikan operasi penulisan ulang. Untuk setiap jenis operasi (Add, Delete, Reserve Only, Modify), masukkan parameter yang akan diterapkan. Anda dapat menambahkan beberapa parameter untuk setiap jenis operasi. Lihat Contoh konfigurasi sebagai referensi.
Klik OK. Operasi penulisan ulang langsung berlaku.
Untuk memperbarui aturan yang sudah ada, klik Modify di halaman Parameter Rewrite.
Contoh konfigurasi
Contoh 1: Abaikan semua parameter
Konfigurasi ini menghapus semua parameter dari URL pengambilan asal.
| Item konfigurasi | Nilai |
|---|---|
| Ignore Parameters | Diaktifkan |
| Add | Tidak ada |
| Delete | Tidak ada |
| Reserve Only | Tidak ada |
| Modify | Tidak ada |
| Rule Condition | Tidak digunakan |
| Hasil | Asli: http://example.com/index.html?code1=1&code2=2&code3=3 → Ditulis ulang: http://example.com/index.html |
Contoh 2: Simpan parameter tertentu
Konfigurasi ini hanya menyimpan code2 dan menghapus semua parameter lainnya.
| Item konfigurasi | Nilai |
|---|---|
| Ignore Parameters | Dinonaktifkan |
| Add | Tidak ada |
| Delete | Tidak ada |
| Reserve Only | code2 |
| Modify | Tidak ada |
| Rule Condition | Tidak digunakan |
| Hasil | Asli: http://example.com/index.html?code1=1&code2=2&code3=3 → Ditulis ulang: http://example.com/index.html?code2=2 |
Contoh 3: Tambahkan, hapus, dan modifikasi parameter
Konfigurasi ini menggabungkan tiga operasi: menambahkan code4=4, menghapus code2, dan mengubah code3 menjadi 0.
| Item konfigurasi | Nilai |
|---|---|
| Ignore Parameters | shutdown |
| Add | code4=4 |
| Delete | code2 |
| Reserve Only | Tidak ada |
| Modify | code3=0 |
| Rule Condition | Tidak digunakan |
| Hasil | Asli: http://example.com/index.html?code1=1&code2=2&code3=3 → Ditulis ulang: http://example.com/index.html?code1=1&code3=0&code4=4 |