Menulis ulang parameter dalam URL permintaan pengambilan asal - CDN

Jika parameter dalam URL permintaan asli berbeda dari yang dibutuhkan oleh server origin Anda, Anda dapat menggunakan fitur Parameter Rewrite untuk menulis ulang parameter dalam URL permintaan origin fetch. Fitur ini memungkinkan Anda menambahkan, menghapus, menyimpan, memodifikasi, atau mengabaikan parameter.

Format parameter URL

Parameter URL adalah satu atau beberapa pasangan name/value yang ditambahkan ke URL setelah karakter ?, dengan format name=value. Beberapa parameter dipisahkan oleh karakter &.
URL juga dapat berisi karakter # dan teks yang mengikutinya. Karakter # mengarahkan browser ke lokasi tertentu pada halaman web.

Misalnya, dalam http://www.example.com/index.html#segment, bagian #segment mengarah ke lokasi segment pada halaman index.html. Setelah browser memuat halaman tersebut, browser secara otomatis menggulir ke lokasi itu.

Prioritas operasi

Parameter Rewrite memungkinkan Anda mengonfigurasi beberapa operasi penulisan ulang untuk parameter kueri dalam URL permintaan origin fetch. Urutan prioritasnya adalah Add > Delete > Reserve Only > Modify. Jika operasi berbeda menargetkan parameter yang sama, hanya operasi dengan prioritas tertinggi yang diterapkan.
Jika Ignore Parameters diaktifkan, Add adalah satu-satunya operasi lain yang berlaku.

Konflik dengan fitur lain

Parameter Rewrite mungkin bertentangan dengan aturan enhance break dari Rewrite Origin Fetch URL dan fitur Ignore Parameters. Jika terjadi konflik, fitur yang dikonfigurasi terakhir akan didahulukan.

Dampak terhadap kunci cache

Fitur Parameter Rewrite dijalankan pada POP origin fetch. Fitur ini tidak memengaruhi perutean internal CDN dan tidak menulis ulang kunci cache.
Fitur Ignore Parameters dijalankan pada edge node. Fitur ini memengaruhi perutean internal CDN dan menulis ulang kunci cache.

Penting

Jika suatu konfigurasi menggunakan kondisi aturan dari mesin aturan, prioritas kondisi tersebut menentukan urutan eksekusi, mengesampingkan urutan konfigurasi fitur.

Prosedur

Masuk ke CDN console.
Di panel navigasi kiri, klik Domain Names.
Pada halaman Domain Names, temukan nama domain target lalu klik Manage di kolom Actions.
Di panel navigasi kiri untuk nama domain tersebut, klik Origin Fetch.
Klik tab Parameter Rewrite.
Aktifkan Feature Switch.
Konfigurasikan parameter yang akan ditulis ulang.

Konfigurasikan operasi penulisan ulang sesuai kebutuhan. Anda juga dapat menambahkan beberapa parameter dalam kotak teks untuk setiap jenis operasi. Untuk informasi lebih lanjut, lihat Contoh konfigurasi.
Klik OK untuk menerapkan konfigurasi.

Anda juga dapat mengklik Modify pada halaman Parameter Rewrite untuk memodifikasi aturan yang sudah ada.

Contoh konfigurasi

Contoh 1: Mengabaikan semua parameter

Parameter	Nilai
Ignore Parameters	Diaktifkan
Add	Tidak ada
Delete	Tidak ada
Reserve Only	Tidak ada
Modify	Tidak ada
Rule Condition	Tidak digunakan
Hasil	Permintaan asli: `http://example.com/index.html?code1=1&code2=2&code3=3` Permintaan origin fetch setelah ditulis ulang: `http://example.com/index.html`

Contoh 2: Menyimpan parameter tertentu

Parameter	Value
Ignore Parameters	Disabled
Add	None
Delete	None
Reserve Only	code2
Modify	None
Rule Condition	Not used
Result	Permintaan asli: `http://example.com/index.html?code1=1&code2=2&code3=3` Permintaan pengambilan asal yang ditulis ulang: `http://example.com/index.html?code2=2`

Contoh 3: Menambahkan, menghapus, dan memodifikasi parameter

Parameter	Nilai
Ignore Parameters	Nonaktif
Add	code4=4
Delete	code2
Reserve Only	Tidak ada
Modify	code3=0
Rule Condition	Tidak digunakan
Hasil	Permintaan asli: `http://example.com/index.html?code1=1&code2=2&code3=3` Permintaan origin fetch setelah ditulis ulang: `http://example.com/index.html?code1=1&code3=0&code4=4`