Kondisi kecocokan aturan

Di seperangkat Aturan Azure Front Door, aturan terdiri dari satu atau beberapa kondisi kecocokan dan tindakan. Artikel ini memberikan deskripsi terperinci tentang kondisi yang sesuai yang dapat Anda gunakan dalam aturan Azure Front Door.

Penting

Azure Front Door (klasik) tidak mendukung pembuatan profil, onboarding domain baru, atau sertifikat terkelola dan akan dihentikan pada 31 Maret 2027. Untuk menghindari gangguan layanan, migrasi ke Azure Front Door Standard atau Premium. Untuk informasi selengkapnya, lihat penarikan Azure Front Door (klasik).

Di mesin aturan Azure Front Door (klasik), satu aturan terdiri atas satu atau beberapa kondisi kecocokan dan tindakan. Artikel ini memberikan penjelasan mendetail tentang kondisi pencocokan yang dapat Anda gunakan di mesin aturan Azure Front Door (klasik).

Aturan dimulai dengan kondisi kecocokan atau serangkaian kondisi kecocokan. Sebuah aturan dapat memiliki maksimal 10 kondisi pencocokan. Kondisi kecocokan mengidentifikasi jenis permintaan tertentu untuk tindakan tertentu yang dilakukan. Jika Anda menggunakan beberapa kondisi kecocokan, mereka dikelompokkan bersama menggunakan logika AND. Untuk kondisi kecocokan yang mendukung beberapa nilai, logika OR digunakan.

Anda dapat menggunakan kondisi kecocokan untuk:

  • Filter permintaan berdasarkan alamat IP, port, atau negara/wilayah tertentu.
  • Filter permintaan menurut informasi header.
  • Memfilter permintaan dari perangkat seluler atau perangkat desktop.
  • Filter permintaan menurut nama file permintaan dan ekstensi file.
  • Filter permintaan menurut nama host, protokol SSL, URL permintaan, protokol, jalur, string kueri, argumen posting, dan nilai lainnya.
  • Filter permintaan berdasarkan alamat IP atau negara/wilayah tertentu.
  • Filter permintaan menurut informasi header.
  • Memfilter permintaan dari perangkat seluler atau perangkat desktop.
  • Filter permintaan menurut nama file permintaan dan ekstensi file.
  • Filter permintaan menurut URL permintaan, protokol, jalur, string kueri, argumen posting, dan nilai lainnya.

Jenis perangkat

Gunakan kondisi kecocokan jenis perangkat untuk mengidentifikasi permintaan yang berasal dari perangkat seluler atau perangkat desktop.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi
  • Di portal Microsoft Azure: Equal, Not Equal
  • Dalam templat ARM: Equal; gunakan negateCondition properti untuk menentukan Tidak Sama
Nilai Mobile, Desktop

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan yang terdeteksi berasal dari perangkat seluler.

Cuplikan layar portal memperlihatkan kondisi kecocokan jenis perangkat.

Versi HTTP

Gunakan kondisi kecocokan versi HTTP untuk mengidentifikasi permintaan yang dibuat dengan menggunakan versi protokol HTTP tertentu.

Nota

Kondisi kecocokan versi HTTP hanya tersedia di Azure Front Door Standard/Premium.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi
  • Di portal Microsoft Azure: Equal, Not Equal
  • Dalam templat ARM: Equal; gunakan negateCondition properti untuk menentukan Tidak Sama
Nilai 2.0,1.1,1.0,0.9

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan yang dikirim dengan menggunakan protokol HTTP 2.0.

Cuplikan layar portal memperlihatkan kondisi kecocokan versi HTTP.

Cookie permintaan

Gunakan kondisi pencocokan cookie permintaan untuk mengidentifikasi permintaan yang menyertakan cookie tertentu.

Nota

Kondisi kecocokan cookie permintaan hanya tersedia di Azure Front Door Standard/Premium.

Karakteristik

Harta benda Nilai yang Didukung
Nama cookie Nilai string yang mewakili nama cookie.
Pengoperasi Operator apa pun dari daftar operator standar.
Nilai Satu atau beberapa nilai string atau bilangan bulat yang mewakili nilai header permintaan yang cocok. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.
Transformasi kasus Setiap transformasi dari daftar transformasi string standar.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan yang memiliki cookie bernama deploymentStampId dengan nilai 1.

Cuplikan layar portal memperlihatkan kondisi kecocokan cookie permintaan.

Pengiriman Argumen

Gunakan kondisi pencocokan arg posting untuk mengidentifikasi permintaan berdasarkan argumen yang disediakan dalam isi permintaan POST. Satu kondisi kecocokan cocok dengan satu argumen dari isi permintaan POST. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Nota

Kondisi kecocokan post args berfungsi dengan application/x-www-form-urlencoded jenis konten.

Karakteristik

Harta benda Nilai yang Didukung
Pengiriman Argumen Nilai string yang mewakili nama argumen POST.
Pengoperasi Operator apa pun dari daftar operator standar.
Nilai Satu atau beberapa nilai string atau bilangan bulat yang mewakili nilai argumen POST yang cocok. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.
Transformasi kasus Setiap transformasi dari daftar transformasi string standar.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan POST di mana customerName argumen disediakan dalam isi permintaan, dan di mana nilai customerName dimulai dengan huruf J atau K. Kami menggunakan transformasi kasus untuk mengonversi nilai input menjadi huruf besar sehingga nilai yang dimulai dengan J, , jK, dan k semuanya cocok.

Cuplikan layar portal menunjukkan kondisi kecocokan argumen pos.

Rangkaian Kueri

Gunakan kondisi kecocokan string kueri untuk mengidentifikasi permintaan yang berisi string kueri tertentu. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Nota

Seluruh kueri string dicocokkan sebagai string tunggal, tanpa awalan ?.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi Semua operator dari daftar operator standar didukung. Namun, kondisi Any mencocokkan setiap permintaan, dan kondisi Not Any tidak mencocokkan permintaan apa pun, saat digunakan dengan kondisi pencocokan query string.
Rangkaian Kueri Satu atau beberapa nilai string atau bilangan bulat yang mewakili nilai string kueri yang cocok. Jangan sertakan ? di awal string kueri. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.
Transformasi kasus Setiap transformasi dari daftar transformasi string standar.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan di mana string kueri berisi string language=en-US. Kami ingin kondisi kecocokan peka terhadap huruf besar/kecil, jadi kami tidak mengubah kasus.

Cuplikan layar portal memperlihatkan kondisi kecocokan string kueri.

Alamat jarak jauh

Kondisi kecocokan alamat jarak jauh mengidentifikasi permintaan berdasarkan lokasi atau alamat IP pemohon. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

  • Gunakan notasi CIDR saat menentukan blok alamat IP. Sintaks untuk blok alamat IP adalah alamat IP dasar diikuti dengan garis miring dan ukuran awalan. Misalnya:
    • Contoh IPv4: 5.5.5.64/26 cocok dengan permintaan apa pun yang datang dari alamat 5.5.5.64 hingga 5.5.5.127.
    • Contoh IPv6: 1:2:3:/48 cocok dengan permintaan apa pun yang berasal dari alamat 1:2:3:0:0:0:0:0:0 hingga 1:2:3: ffff:ffff:ffff:ffff.
  • Saat Anda menentukan beberapa alamat IP dan blok alamat IP, logika 'OR' diterapkan.
    • Contoh IPv4: jika Anda menambahkan dua alamat 1.2.3.4 IP dan 10.20.30.40, kondisinya cocok untuk setiap permintaan yang tiba dari alamat 1.2.3.4 atau 10.20.30.40.
    • Contoh IPv6: jika Anda menambahkan dua alamat 1:2:3:4:5:6:7:8 IP dan 10:20:30:40:50:60:70:80, kondisinya cocok untuk setiap permintaan yang datang dari alamat 1:2:3:4:5:6:7:8 atau 10:20:30:40:50:60:70:80.
  • Alamat jarak jauh mewakili IP klien asli yang berasal dari koneksi jaringan atau biasanya header permintaan X-Forwarded-For jika pengguna berada di belakang proksi. Gunakan kondisi kecocokan alamat soket (tersedia di Standar/Premium), jika Anda perlu mencocokkan berdasarkan alamat IP permintaan TCP.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi
  • Di portal Microsoft Azure: Geo Match, Geo Not Match, IP Match, atau IP Not Match
  • Dalam templat ARM: GeoMatch, IPMatch; gunakan negateCondition properti untuk menentukan Geo Not Match atau IP Not Match
Nilai
  • ** Bagi operator IP Match atau IP Not Match, tentukan satu atau beberapa rentang alamat IP. Jika beberapa rentang alamat IP ditentukan, rentang tersebut dievaluasi menggunakan logika OR.
  • Geo Match Untuk operator atau Geo Not Match : tentukan satu atau beberapa lokasi menggunakan kode negara mereka.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan di mana permintaan tidak berasal dari Amerika Serikat.

Cuplikan layar portal memperlihatkan kondisi kecocokan alamat jarak jauh.

Isi dari permintaan

Kondisi kecocokan isi permintaan mengidentifikasi permintaan berdasarkan teks tertentu yang muncul di isi permintaan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Nota

Jika isi permintaan melebihi ukuran 64KB, hanya 64KB pertama yang akan dipertimbangkan untuk kondisi pencocokan isi permintaan .

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan Semua cocok dengan setiap permintaan, sedangkan kondisi Tidak Ada Kecocokan tidak cocok dengan permintaan mana pun, ketika digunakan dengan kondisi kecocokan isi permintaan.
Nilai Satu atau beberapa nilai string atau bilangan bulat yang mewakili nilai teks isi permintaan yang cocok. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.
Transformasi kasus Setiap transformasi dari daftar transformasi string standar.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan di mana isi permintaan berisi string ERROR. Kami mengubah isi permintaan menjadi huruf besar sebelum menilai kecocokan, sehingga error dan variasi kasus lainnya juga memicu kondisi kecocokan ini.

Cuplikan layar portal memperlihatkan kondisi kecocokan isi permintaan.

Nama file yang diminta

Kondisi kecocokan nama file permintaan mengidentifikasi permintaan yang menyertakan nama file yang ditentukan dalam URL permintaan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi Semua operator dari daftar operator standar didukung. Namun, kondisi kecocokan 'Apa Saja' cocok dengan setiap permintaan, sedangkan kondisi kecocokan 'Tidak Ada' tidak cocok dengan permintaan apa pun, saat digunakan dengan kondisi kecocokan nama file permintaan.
Nilai Satu atau beberapa nilai string atau bilangan bulat yang mewakili nilai nama file permintaan yang cocok. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.
Transformasi kasus Setiap transformasi dari daftar transformasi string standar.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan di mana nama file permintaan adalah media.mp4. Kami mengubah nama file menjadi huruf kecil sebelum mengevaluasi kecocokan, sehingga variasi kasus lainnya seperti MEDIA.MP4 juga memicu kondisi kecocokan ini.

Cuplikan layar portal memperlihatkan kondisi kecocokan nama file permintaan.

Meminta ekstensi file

Kondisi kecocokan ekstensi file permintaan mengidentifikasi permintaan yang menyertakan ekstensi file yang ditentukan dalam nama file di URL permintaan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Nota

Jangan sertakan periode awal. Misalnya, gunakan html, bukan .html.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi Semua operator dari daftar operator standar didukung. Namun, kondisi Semua cocok dengan setiap permintaan, dan kondisi Tidak Semua tidak cocok dengan permintaan mana pun saat digunakan dengan kondisi kecocokan ekstensi file permintaan.
Nilai Satu atau beberapa nilai string atau bilangan bulat yang mewakili nilai ekstensi file permintaan yang cocok. Jangan sertakan periode awal. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.
Transformasi kasus Setiap transformasi dari daftar transformasi string standar.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan di mana ekstensi file permintaan adalah pdf atau docx. Kami mengubah ekstensi file permintaan menjadi huruf kecil sebelum mengevaluasi kecocokan, jadi PDF, DocX, dan variasi kasus lainnya juga memicu kondisi kecocokan ini.

Cuplikan layar portal memperlihatkan kondisi kecocokan ekstensi file permintaan.

Tajuk permintaan

Kondisi pencocokan header permintaan mengidentifikasi permintaan yang menyertakan header tertentu dalam permintaan. Anda dapat menggunakan kondisi kecocokan ini untuk memeriksa apakah header ada atau untuk memeriksa apakah header cocok dengan nilai yang ditentukan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Karakteristik

Harta benda Nilai yang Didukung
Nama Header Nilai string yang mewakili nama argumen POST.
Pengoperasi Operator apa pun dari daftar operator standar.
Nilai Satu atau beberapa nilai string atau bilangan bulat yang mewakili nilai header permintaan yang cocok. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.
Transformasi kasus Setiap transformasi dari daftar transformasi string standar.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan di mana permintaan berisi header bernama MyCustomHeader, terlepas dari nilainya.

Cuplikan layar portal menunjukkan kondisi pencocokan header permintaan.

Metode permintaan

Kondisi kecocokan metode permintaan mengidentifikasi permintaan yang menggunakan metode permintaan HTTP yang ditentukan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi
  • Di portal Microsoft Azure: Equal, Not Equal
  • Dalam templat ARM: Equal; gunakan negateCondition properti untuk menentukan Tidak Sama
Metode permintaan Satu atau beberapa metode HTTP dari: GET, , POST, PUT, DELETEHEAD, OPTIONS, TRACE. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan di mana permintaan menggunakan DELETE metode .

Cuplikan layar portal memperlihatkan kondisi kecocokan metode permintaan.

Jalur permintaan

Kondisi kecocokan jalur permintaan mengidentifikasi permintaan yang menyertakan jalur yang ditentukan dalam URL permintaan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Nota

Jalur adalah bagian dari URL setelah nama host dan tanda garis miring. Misalnya, di URL https://www.contoso.com/files/secure/file1.pdf, jalurnya adalah files/secure/file1.pdf.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi
  • Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan apa pun cocok dengan setiap permintaan, dan kondisi Tidak Ada kecocokan tidak cocok dengan permintaan apa pun, saat digunakan dengan kondisi kecocokan jalur permintaan .
  • Wildcard: Cocok saat path permintaan cocok dengan ekspresi wildcard. Ekspresi wildcard dapat menyertakan karakter * untuk mencocokkan nol karakter atau lebih dalam lintasan. Misalnya, ekspresi karakter pengganti files/customer*/file.pdf cocok dengan jalur files/customer1/file.pdf, files/customer109/file.pdf, dan files/customer/file.pdf, tetapi tidak cocok dengan files/customer2/anotherfile.pdf.
    • Di portal Microsoft Azure: Wildcards, Not Wildcards
    • Dalam templat ARM: Wildcard; gunakan negateCondition properti untuk menentukan Bukan Wildcard
Nilai Satu atau beberapa nilai string atau bilangan bulat yang mewakili nilai jalur permintaan yang cocok. Jika Anda menentukan garis miring terdepan, itu akan diabaikan. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.
Transformasi kasus Setiap transformasi dari daftar transformasi string standar.
Harta benda Nilai yang Didukung
Pengoperasi Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan apa pun cocok dengan setiap permintaan, dan kondisi Tidak Ada kecocokan tidak cocok dengan permintaan apa pun, saat digunakan dengan kondisi kecocokan jalur permintaan .
Nilai Satu atau beberapa nilai string atau bilangan bulat yang mewakili nilai jalur permintaan yang cocok. Jika Anda menentukan garis miring terdepan, itu akan diabaikan. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.
Transformasi kasus Setiap transformasi dari daftar transformasi string standar.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan di mana jalur file permintaan dimulai dengan files/secure/. Kami mengubah ekstensi file permintaan menjadi huruf kecil sebelum mengevaluasi kecocokan, sehingga permintaan ke files/SECURE/ dan variasi kasus lainnya juga memicu kondisi kecocokan ini.

Cuplikan layar portal memperlihatkan kondisi kecocokan jalur permintaan.

Protokol permintaan

Kondisi kecocokan protokol permintaan mengidentifikasi permintaan yang menggunakan protokol yang ditentukan (HTTP atau HTTPS).

Nota

Protokol terkadang juga disebut skema.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi
  • Di portal Microsoft Azure: Equal, Not Equal
  • Dalam templat ARM: Equal; gunakan negateCondition properti untuk menentukan Tidak Sama
Metode permintaan HTTP, HTTPS

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan di mana permintaan menggunakan HTTP protokol.

Cuplikan layar portal memperlihatkan kondisi kecocokan protokol permintaan.

URL untuk Permintaan

Mengidentifikasi permintaan yang cocok dengan URL yang ditentukan. Seluruh URL dievaluasi, termasuk protokol dan string kueri, tetapi bukan fragmen. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Petunjuk / Saran

Saat Anda menggunakan kondisi aturan ini, pastikan untuk menyertakan protokol dan garis miring /berikutnya. Misalnya, gunakan https://www.contoso.com/ alih-alih hanya www.contoso.com.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi Semua operator dari daftar operator standar didukung. Namun, kondisi Kecocokan Apa Saja cocok dengan setiap permintaan, dan kondisi Bukan Apa Saja tidak cocok dengan permintaan apa pun, saat digunakan dengan kondisi kecocokan URL permintaan.
Nilai Satu atau beberapa nilai string atau bilangan bulat yang mewakili nilai URL permintaan yang cocok. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.
Transformasi kasus Setiap transformasi dari daftar transformasi string standar.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan di mana URL permintaan dimulai dengan https://api.contoso.com/customers/123. Kami mengubah ekstensi file permintaan menjadi huruf kecil sebelum mengevaluasi kecocokan, sehingga permintaan ke https://api.contoso.com/Customers/123 dan variasi kasus lainnya juga akan memicu kondisi kecocokan ini.

Cuplikan layar portal memperlihatkan kondisi kecocokan URL permintaan.

Nama host

Kondisi kecocokan nama host mengidentifikasi permintaan berdasarkan nama host yang ditentukan dalam permintaan dari klien. Kondisi kecocokan menggunakan nilai header Host untuk mengevaluasi nama host. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi Semua operator dari daftar operator standar didukung. Namun, kondisi pencocokan 'Any' sesuai dengan setiap permintaan, dan kondisi pencocokan 'Not Any' tidak sesuai dengan permintaan apa pun, saat digunakan dengan kondisi pencocokan nama host.
Nilai Satu atau beberapa nilai string yang mewakili nilai nama host permintaan yang sesuai. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.
Transformasi kasus Setiap transformasi kasus dari daftar transformasi string standar.

Contoh

Dalam contoh ini, kita mencocokkan semua permintaan dengan Host header yang berakhiran dengan contoso.com.

Cuplikan layar portal memperlihatkan kondisi kecocokan nama host.

Protokol SSL

Kondisi kecocokan protokol SSL mengidentifikasi permintaan berdasarkan protokol SSL dari koneksi TLS yang dibuat. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi
  • Di portal Microsoft Azure: Equal, Not Equal
  • Dalam templat ARM: Equal; gunakan negateCondition properti untuk menentukan Tidak Sama
Protokol SSL
  • Di portal Microsoft Azure: 1.0, 1.1, 1.2
  • Dalam templat ARM: TLSv1, TLSv1.1, TLSv1.2

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan yang menggunakan protokol TLS 1.2.

Cuplikan layar portal memperlihatkan kondisi kecocokan protokol SSL.

Alamat soket

Kondisi pencocokan alamat soket mengidentifikasi permintaan berdasarkan alamat IP koneksi langsung ke edge Azure Front Door. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Nota

Jika klien menggunakan proksi HTTP atau load balancer untuk mengirim permintaan, alamat soket adalah alamat IP proksi atau load balancer.

Gunakan kondisi kecocokan alamat jarak jauh jika Anda perlu mencocokkan berdasarkan alamat IP asli klien.

  • Gunakan notasi CIDR saat menentukan blok alamat IP. Ini berarti bahwa sintaks untuk blok alamat IP adalah alamat IP dasar diikuti dengan garis miring dan ukuran awalan. Misalnya:
    • Contoh IPv4: 5.5.5.64/26 cocok dengan permintaan apa pun yang datang dari alamat 5.5.5.64 hingga 5.5.5.127.
    • Contoh IPv6: 1:2:3:/48 cocok dengan permintaan apa pun yang berasal dari alamat 1:2:3:0:0:0:0:0:0 hingga 1:2:3: ffff:ffff:ffff:ffff.
  • Saat Anda menentukan beberapa alamat IP dan blok alamat IP, logika 'OR' diterapkan.
    • Contoh IPv4: jika Anda menambahkan dua alamat 1.2.3.4 IP dan 10.20.30.40, kondisinya cocok untuk setiap permintaan yang tiba dari alamat 1.2.3.4 atau 10.20.30.40.
    • Contoh IPv6: jika Anda menambahkan dua alamat 1:2:3:4:5:6:7:8 IP dan 10:20:30:40:50:60:70:80, kondisinya cocok untuk setiap permintaan yang datang dari alamat 1:2:3:4:5:6:7:8 atau 10:20:30:40:50:60:70:80.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi
  • Di portal Microsoft Azure: IP Match, Not IP Match
  • Dalam templat ARM: IPMatch; gunakan negateCondition properti untuk menentukan Not IP Match
Nilai Tentukan satu atau beberapa rentang alamat IP. Jika beberapa rentang alamat IP ditentukan, rentang tersebut dievaluasi menggunakan logika OR.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan dari alamat IP dalam rentang 5.5.5.64/26.

Cuplikan layar portal memperlihatkan kondisi kecocokan alamat soket.

Port klien

Kondisi kecocokan port klien mengidentifikasi permintaan berdasarkan port TCP klien yang membuat permintaan. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi Semua operator dari daftar operator standar didukung. Namun, kondisi pencocokan Any sesuai dengan setiap permintaan, dan kondisi pencocokan bukan Any tidak sesuai dengan permintaan apa pun, saat digunakan dengan kondisi pencocokan port klien.
Nilai Satu atau beberapa nomor port, dinyatakan sebagai bilangan bulat. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan dengan port klien 1234.

Cuplikan layar portal memperlihatkan kondisi kecocokan port klien.

Port server

Kondisi kecocokan port server mengidentifikasi permintaan berdasarkan port TCP server Azure Front Door yang menerima permintaan. Port harus 80 atau 443. Anda dapat menentukan beberapa nilai yang akan dicocokkan, yang dapat digabungkan menggunakan logika OR.

Karakteristik

Harta benda Nilai yang Didukung
Pengoperasi Semua operator dari daftar operator standar didukung. Namun, kondisi Cocok apa saja cocok dengan setiap permintaan, dan kondisi kecocokan Tidak Ada tidak cocok dengan permintaan apa pun, ketika digunakan dengan kondisi kecocokan port server.
Nilai Nomor port, yang harus salah satu yaitu 80 atau 443. Jika beberapa nilai ditentukan, nilai tersebut dievaluasi menggunakan logika OR.

Contoh

Dalam contoh ini, kami mencocokkan semua permintaan dengan port server 443.

Cuplikan layar portal memperlihatkan kondisi kecocokan port server.

Daftar operator

Untuk aturan yang menerima nilai dari daftar operator standar, operator berikut ini valid:

Pengoperasi Deskripsi Dukungan templat ARM
Apa saja Cocok ketika ada nilai apa pun, terlepas dari apa itu. operator: Any
Setara Cocok ketika nilai sama persis dengan string yang ditentukan. operator: Equal
Berisi Sesuai ketika nilai mengandung string yang ditentukan. operator: Contains
Kurang Dari Cocok ketika panjang nilai kurang dari bilangan bulat yang ditentukan. operator: LessThan
Lebih Besar Dari Cocok ketika panjang nilai lebih besar dari bilangan bulat yang ditentukan. operator: GreaterThan
Kurang Dari atau Sama Dengan Cocok ketika panjang nilai kurang dari atau sama dengan bilangan bulat yang ditentukan. operator: LessThanOrEqual
Lebih Besar Dari atau Sama Dengan Cocok ketika panjang nilai lebih besar dari atau sama dengan bilangan bulat yang ditentukan. operator: GreaterThanOrEqual
Dimulai Dengan Cocok ketika nilai dimulai dengan string yang ditentukan. operator: BeginsWith
Diakhir Dengan Sesuai ketika nilai berakhir dengan string tertentu. operator: EndsWith
Tidak Ada Cocok jika tidak ada nilai. operator: Any dan negateCondition : true
Tidak Sama Cocok jika nilai tidak cocok dengan string yang ditentukan. operator: Equal dan negateCondition : true
Tidak Mengandung Cocok ketika nilai tidak berisi string yang ditentukan. operator: Contains dan negateCondition : true
Tidak Kurang Dari Cocok ketika panjang nilai tidak kurang dari bilangan bulat yang ditentukan. operator: LessThan dan negateCondition : true
Tidak Lebih Besar Dari Cocok ketika panjang nilai tidak lebih besar dari bilangan bulat yang ditentukan. operator: GreaterThan dan negateCondition : true
Tidak Kurang Dari atau Sama Dengan Cocok ketika panjang nilai tidak kurang dari atau sama dengan bilangan bulat yang ditentukan. operator: LessThanOrEqual dan negateCondition : true
Tidak Lebih Besar Dari atau Sama Dengan Cocok ketika panjang nilai tidak lebih besar dari atau sama dengan bilangan bulat yang ditentukan. operator: GreaterThanOrEqual dan negateCondition : true
Tidak Dimulai Dengan Cocok ketika nilai tidak dimulai dengan string yang ditentukan. operator: BeginsWith dan negateCondition : true
Tidak Berakhir Dengan Cocok ketika nilai tidak berakhir dengan string yang ditentukan. operator: EndsWith dan negateCondition : true
Pengoperasi Deskripsi Dukungan templat ARM
Apa saja Cocok ketika ada nilai apa pun, terlepas dari apa itu. operator: Any
Setara Cocok ketika nilai sama persis dengan string yang ditentukan. operator: Equal
Berisi Sesuai ketika nilai mengandung string yang ditentukan. operator: Contains
Kurang Dari Cocok ketika panjang nilai kurang dari bilangan bulat yang ditentukan. operator: LessThan
Lebih Besar Dari Cocok ketika panjang nilai lebih besar dari bilangan bulat yang ditentukan. operator: GreaterThan
Kurang Dari atau Sama Dengan Cocok ketika panjang nilai kurang dari atau sama dengan bilangan bulat yang ditentukan. operator: LessThanOrEqual
Lebih Besar Dari atau Sama Dengan Cocok ketika panjang nilai lebih besar dari atau sama dengan bilangan bulat yang ditentukan. operator: GreaterThanOrEqual
Dimulai Dengan Cocok ketika nilai dimulai dengan string yang ditentukan. operator: BeginsWith
Diakhir Dengan Sesuai ketika nilai berakhir dengan string tertentu. operator: EndsWith
RegEx Cocok ketika nilai cocok dengan ekspresi reguler yang ditentukan. Lihat di bawah ini untuk detail lebih lanjut. operator: RegEx
Tidak Ada Cocok jika tidak ada nilai. operator: Any dan negateCondition : true
Tidak Sama Cocok jika nilai tidak cocok dengan string yang ditentukan. operator: Equal dan negateCondition : true
Tidak Mengandung Cocok ketika nilai tidak berisi string yang ditentukan. operator: Contains dan negateCondition : true
Tidak Kurang Dari Cocok ketika panjang nilai tidak kurang dari bilangan bulat yang ditentukan. operator: LessThan dan negateCondition : true
Tidak Lebih Besar Dari Cocok ketika panjang nilai tidak lebih besar dari bilangan bulat yang ditentukan. operator: GreaterThan dan negateCondition : true
Tidak Kurang Dari atau Sama Dengan Cocok ketika panjang nilai tidak kurang dari atau sama dengan bilangan bulat yang ditentukan. operator: LessThanOrEqual dan negateCondition : true
Tidak Lebih Besar Dari atau Sama Dengan Cocok ketika panjang nilai tidak lebih besar dari atau sama dengan bilangan bulat yang ditentukan. operator: GreaterThanOrEqual dan negateCondition : true
Tidak Dimulai Dengan Cocok ketika nilai tidak dimulai dengan string yang ditentukan. operator: BeginsWith dan negateCondition : true
Tidak Berakhir Dengan Cocok ketika nilai tidak berakhir dengan string yang ditentukan. operator: EndsWith dan negateCondition : true
Bukan RegEx Sesuai jika nilai tidak sesuai dengan ekspresi reguler yang ditentukan. Lihat di bawah ini untuk detail lebih lanjut. operator: RegEx dan negateCondition : true

Petunjuk / Saran

Untuk operator numerik seperti Kurang dari dan Lebih Besar dari atau sama dengan, perbandingan yang digunakan didasarkan pada panjang. Nilai dalam kondisi kecocokan harus berupa bilangan bulat yang menentukan panjang yang ingin Anda bandingkan.

Ekspresi Reguler

Ekspresi reguler tidak mendukung operasi berikut:

  • Referensi belakang dan penangkapan subekspresi.
  • Penegasan tanpa lebar arbitrer.
  • Referensi subroutine dan pola rekursif.
  • Pola bersyarat.
  • Kata kerja kontrol lintas balik.
  • Arahan \C byte tunggal.
  • Direktif untuk kecocokan baris baru \R.
  • Awal \K direktif pengaturan ulang kecocokan.
  • Callout dan kode yang disematkan.
  • Pengelompokan atom dan kuantifier posesif.

Daftar transformasi string

Untuk aturan yang dapat mengubah string, transformasi berikut ini valid:

Mengubah Deskripsi Dukungan templat ARM
Menjadi huruf kecil Mengonversi string ke representasi huruf kecil. Lowercase
Mengubah ke huruf kapital Mengonversi string ke representasi huruf besar. Uppercase
Pangkas Memangkas spasi putih di depan dan di belakang pada string. Trim
Hapus nilai kosong Menghapus nilai null dari string. RemoveNulls
Pengodeaan URL Mengodekan string dalam format URL. UrlEncode
Dekode URL Menguraikan string URL. UrlDecode

Langkah selanjutnya