Tindakan seperangkat aturan

Seperangkat aturan Azure Front Door terdiri dari aturan dengan kombinasi kondisi dan tindakan kecocokan. Artikel ini menyediakan deskripsi terperinci tentang tindakan yang bisa Anda gunakan dalam seperangkat aturan. Suatu tindakan menentukan perilaku yang diterapkan ke jenis permintaan yang diidentifikasi oleh kondisi kecocokan. Dalam seperangkat aturan, aturan dapat memiliki hingga lima tindakan. Front Door juga mendukung variabel server dalam tindakan seperangkat aturan.

Tindakan berikut ini tersedia untuk digunakan dalam seperangkat aturan:

Pengambil alihan konfigurasi rute

Tindakan penimpaan konfigurasi rute digunakan untuk mengambil alih grup asal atau konfigurasi penembolokan untuk permintaan tersebut. Anda dapat memilih untuk mengambil alih atau mematuhi konfigurasi grup asal yang ditentukan dalam rute. Namun, saat Anda mengambil alih konfigurasi rute, Anda harus mengonfigurasi penembolokan. Jika tidak, penembolokan akan dinonaktifkan untuk permintaan tersebut.

Anda juga dapat mengganti cara file di-cache untuk permintaan tertentu, termasuk:

• Mengambil alih perilaku penembolokan yang ditentukan oleh asal.
• Penggunaan parameter untai (karakter) kueri untuk menghasilkan kunci cache permintaan.
• Nilai Waktu aktif (TTL) untuk mengontrol berapa lama konten tinggal di cache.

Properti

Properti	Nilai yang Didukung
Mengambil alih grup asal	Ya: Mengambil alih grup asal yang digunakan untuk permintaan. Tidak: Menggunakan grup asal yang ditentukan dalam rute.
penembolokan	Diaktifkan: Memaksa penembolokan diaktifkan untuk permintaan. Dinonaktifkan: Memaksa penembolokan dinonaktifkan untuk permintaan.

Saat Pengambil alihan grup asal diatur ke Ya, atur properti berikut:

Properti	Nilai yang Didukung
Grup asal	Grup asal tempat permintaan dialihkan. Pengaturan ini mengambil alih konfigurasi yang ditentukan dalam rute titik akhir Front Door.
Protokol penerusan	Protokol untuk Azure Front Door yang akan digunakan saat meneruskan permintaan ke asal. Nilai yang didukung hanya HTTP, hanya HTTPS, permintaan masuk yang Cocok. Pengaturan ini mengambil alih konfigurasi yang ditentukan dalam rute titik akhir Front Door.

Saat Penembolokan diatur ke Aktif, atur properti berikut:

Properti	Nilai yang Didukung
Perilaku penembolokan untai (karakter) kueri	Abaikan Untai (karakter) Kueri: Untai (karakter) kueri tidak dipertimbangkan saat kunci cache dibuat. Dalam templat ARM, aturqueryStringCachingBehaviorproperti ke IgnoreQueryString. Gunakan untai (karakter) kueri: Setiap URL unik memiliki kunci cache sendiri. Dalam templat ARM, gunakan queryStringCachingBehavior dari UseQueryString. Abaikan untai (karakter) kueri yang ditentukan: Untai (karakter) kueri yang ditentukan dalam parameter dikecualikan saat kunci cache dibuat. Dalam templat ARM, aturqueryStringCachingBehaviorproperti ke IgnoreSpecifiedQueryStrings. Sertakan untai (karakter) kueri yang ditentukan: Untai (karakter) kueri yang ditentukan dalam parameter disertakan saat kunci cache dibuat. Dalam templat ARM, aturqueryStringCachingBehaviorproperti ke IncludeSpecifiedQueryStrings.
Parameter kueri	Daftar nama parameter string kueri, dipisahkan oleh koma. Properti ini hanya diatur saat Perilaku penembolokan untai (karakter) kueri diatur ke Abaikan Untai (karakter) Kueri yang Ditentukan atau Sertakan Untai (karakter) Kueri yang Ditentukan.
Kompresi	Diaktifkan: Azure Front Door secara dinamis mengompresi konten di tepi, sehingga menghasilkan respons yang lebih kecil dan lebih cepat. Untuk informasi lebih lanjut, lihat Kompresi file. Dalam templat ARM, aturisCompressionEnabledproperti ke Enabled. Dinonaktifkan. Front Door tidak melakukan pemadatan. Dalam templat ARM, aturisCompressionEnabledproperti ke Disabled.
Perilaku cache	Asal kehormatan: Front Door selalu menghormati arahan header respons asal. Jika arahan asal hilang, Front Door menyimpan konten di mana saja dari 1 hingga 3 hari. Dalam templat ARM, aturcacheBehaviorproperti ke HonorOrigin. Selalu ambil alih: Nilai TTL yang dimunculkan dari asal Anda diganti dengan nilai yang ditentukan dalam tindakan. Perilaku ini hanya diterapkan jika respons dapat di-cache. Dalam templat ARM, aturcacheBehaviorproperti ke OverrideAlways. Ambil alih jika asal tidak ada: Jika tidak ada nilai TTL yang dimunculkan dari asal Anda, seperangkat aturan menetapkan TTL ke nilai yang ditentukan dalam tindakan. Perilaku ini hanya diterapkan jika respons dapat di-cache. Dalam templat ARM, aturcacheBehaviorproperti ke OverrideIfOriginMissing.
Durasi cache	Saat Perilaku cache diatur ke Override always atau Override if origin missing, bidang ini harus menentukan durasi cache yang akan digunakan. Durasi maksimal 366 hari. Untuk nilai 0 detik, CDN menyimpan konten dalam cache, tetapi harus memvalidasi ulang setiap permintaan dengan server asal. Properti ini hanya diatur saat Perilaku cache diatur ke Selalu ambil alih atau Ambil alih jika asal tidak ada. Di portal Microsoft Azure: tentukan hari, jam, menit, dan detik. Dalam template ARM: gunakan cacheDuration untuk menentukan durasi dalam format d.hh:mm:ss.

Contoh

Dalam contoh ini, kami merutekan semua permintaan yang cocok ke grup asal bernama MyOriginGroup, terlepas dari konfigurasi di rute titik akhir Front Door.

Portal

JSON

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "originGroupOverride": {
      "originGroup": {
        "id": "/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Cdn/profiles/<profile-name>/originGroups/MyOriginGroup"
      },
      "forwardingProtocol": "MatchRequest"
    },
    "cacheConfiguration": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

Bicep

{
  name: 'RouteConfigurationOverride'
  parameters: {
    originGroupOverride: {
      originGroup: {
        id: '/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.Cdn/profiles/<profile-name>/originGroups/MyOriginGroup'
      }
      forwardingProtocol: 'MatchRequest'
    }
    cacheConfiguration: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

Dalam contoh ini, kita mengatur kunci cache untuk menyertakan parameter untai (karakter) kueri bernama customerId. Kompresi diaktifkan, dan kebijakan penembolokan asal dipatuhi.

Portal

JSON

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "cacheConfiguration": {
      "queryStringCachingBehavior": "IncludeSpecifiedQueryStrings",
      "queryParameters": "customerId",
      "isCompressionEnabled": "Enabled",
      "cacheBehavior": "HonorOrigin",
      "cacheDuration": null
    },
    "originGroupOverride": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

Bicep

{
  name: 'RouteConfigurationOverride'
  parameters: {
    cacheConfiguration: {
      queryStringCachingBehavior: 'IncludeSpecifiedQueryStrings'
      queryParameters: 'customerId'
      isCompressionEnabled: 'Enabled'
      cacheBehavior: 'HonorOrigin'
      cacheDuration: null
    }
    originGroupOverride: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

Dalam contoh ini, kita mengambil alih masa berakhir cache menjadi 6 jam, untuk permintaan yang cocol yang belum menentukan durasi cache. Azure Front Door mengabaikan untai (karakter) kueri saat menentukan kunci cache, dan kompresi diaktifkan.

Portal

JSON

{
  "name": "RouteConfigurationOverride",
  "parameters": {
    "cacheConfiguration": {
      "queryStringCachingBehavior": "IgnoreQueryString",
      "cacheBehavior": "OverrideIfOriginMissing",
      "cacheDuration": "0.06:00:00",
    },
    "originGroupOverride": null,
    "typeName": "DeliveryRuleRouteConfigurationOverrideActionParameters"
  }
}

Bicep

{
  name: 'RouteConfigurationOverride'
  parameters: {
    cacheConfiguration: {
      queryStringCachingBehavior: 'IgnoreQueryString'
      cacheBehavior: 'OverrideIfOriginMissing'
      cacheDuration: '0.06:00:00'
    }
    originGroupOverride: null
    typeName: 'DeliveryRuleRouteConfigurationOverrideActionParameters'
  }
}

Mengubah header permintaan

Gunakan tindakan ubah header permintaan untuk mengubah header dalam permintaan saat dikirim ke asal Anda.

Properti

Properti	Nilai yang Didukung
Operator	Menambahkan: Header yang ditentukan akan ditambahkan ke permintaan dengan nilai yang ditentukan. Jika header sudah ada, nilai ditambahkan ke nilai header yang ada menggunakan perangkaian string. Tidak ada pemisah yang ditambahkan. Dalam templat ARM, gunakan headerAction dari Append. Menimpa: Header yang ditentukan akan ditambahkan ke permintaan dengan nilai yang ditentukan. Jika header sudah ada, nilai yang ditentukan akan menimpa nilai yang sudah ada. Dalam templat ARM, gunakan headerAction dari Overwrite. Menghapus: Jika header yang ditentukan dalam aturan ada, header akan dihapus dari permintaan. Dalam templat ARM, gunakan headerAction dari Delete.
Nama header	Nama header yang akan diubah.
Nilai Header	Nilai yang akan ditambahkan atau ditimpa.

Contoh

Dalam contoh ini, kita menambahkan nilai AdditionalValue ke MyRequestHeader header permintaan. Jika nilai asalnya menetapkan header respons ke nilai ValueSetByClient, maka setelah tindakan ini diterapkan, header permintaan akan memiliki nilai ValueSetByClientAdditionalValue.

Portal

JSON

{
  "name": "ModifyRequestHeader",
  "parameters": {
    "headerAction": "Append",
    "headerName": "MyRequestHeader",
    "value": "AdditionalValue",
    "typeName": "DeliveryRuleHeaderActionParameters"
  }
}

Bicep

{
  name: 'ModifyRequestHeader'
  parameters: {
    headerAction: 'Append'
    headerName: 'MyRequestHeader'
    value: 'AdditionalValue'
    typeName: 'DeliveryRuleHeaderActionParameters'
  }
}

Mengubah header respons

Gunakan tindakan ubah header respons untuk mengubah header yang ada dalam respons sebelum dikembalikan ke klien Anda.

Properti

Properti	Nilai yang Didukung
Operator	Menambahkan: Header yang ditentukan akan ditambahkan ke respons dengan nilai yang ditentukan. Jika header sudah ada, nilai ditambahkan ke nilai header yang ada menggunakan perangkaian string. Tidak ada pemisah yang ditambahkan. Dalam templat ARM, gunakan headerAction dari Append. Menimpa: Header yang ditentukan akan ditambahkan ke respons dengan nilai yang ditentukan. Jika header sudah ada, nilai yang ditentukan akan menimpa nilai yang sudah ada. Dalam templat ARM, gunakan headerAction dari Overwrite. Menghapus: Jika header yang ditentukan dalam aturan ada, header akan dihapus dari respons. Dalam templat ARM, gunakan headerAction dari Delete.
Nama header	Nama header yang akan diubah.
Nilai Header	Nilai yang akan ditambahkan atau ditimpa.

Contoh

Dalam contoh ini, kami menghapus header dengan nama X-Powered-By dari respons sebelum dikembalikan ke klien.

Portal

JSON

{
  "name": "ModifyResponseHeader",
  "parameters": {
    "headerAction": "Delete",
    "headerName": "X-Powered-By",
    "typeName": "DeliveryRuleHeaderActionParameters"
  }
}

Bicep

{
  name: 'ModifyResponseHeader'
  parameters: {
    headerAction: 'Delete'
    headerName: 'X-Powered-By'
    typeName: 'DeliveryRuleHeaderActionParameters'
  }
}

Pengalihan URL

Gunakan tindakan pengalihan URL untuk mengalihkan klien ke URL baru. Komputer klien akan dikirimi respons pengalihan dari Azure Front Door.

Properti

Properti	Nilai yang Didukung
Jenis pengalihan	Jenis respons untuk dikembalikan kepada pemohon. Di portal Microsoft Azure: Ditemukan (302), Dipindahkan (301), Pengalihan Sementara (307), Pengalihan Permanen (308). Dalam templat ARM: Found, Moved, TemporaryRedirect, PermanentRedirect
Protokol pengalihan	Di portal Microsoft Azure: Match Request, HTTP, HTTPS Dalam templat ARM: MatchRequest, Http, Https
Host tujuan	Pilih nama host yang Anda inginkan agar permintaan dialihkan. Biarkan kosong untuk mempertahankan host yang masuk.
Jalur tujuan	Jalur yang akan digunakan dalam pengalihan. Sertakan / terdepan. Biarkan kosong untuk mempertahankan jalur yang masuk.
Untai kueri	String kueri yang digunakan dalam pengalihan. Jangan sertakan ? terdepan. Biarkan kosong untuk mempertahankan untai kueri yang masuk.
Fragmen tujuan	Fragmen yang akan digunakan dalam pengalihan. Biarkan kosong untuk mempertahankan fragmen yang masuk.

Contoh

Dalam contoh ini, kita mengalihkan permintaan ke https://contoso.com/exampleredirection?clientIp={client_ip}, sambil mempertahankan fragmen. Pengalihan Sementara HTTP (307) digunakan. Alamat IP klien digunakan sebagai pengganti {client_ip} token dalam URL dengan menggunakan client_ipvariabel server.

Portal

JSON

{
  "name": "UrlRedirect",
  "parameters": {
    "redirectType": "TemporaryRedirect",
    "destinationProtocol": "Https",
    "customHostname": "contoso.com",
    "customPath": "/exampleredirection",
    "customQueryString": "clientIp={client_ip}",
    "typeName": "DeliveryRuleUrlRedirectActionParameters"
  }
}

Bicep

{
  name: 'UrlRedirect'
  parameters: {
    redirectType: 'TemporaryRedirect'
    destinationProtocol: 'Https'
    customHostname: 'contoso.com'
    customPath: '/exampleredirection'
    customQueryString: 'clientIp={client_ip}'
    typeName: 'DeliveryRuleUrlRedirectActionParameters'
  }
}

Penulisan ulang URL

Gunakan tindakan penulisan ulang URL untuk menulis ulang jalur permintaan yang sedang dalam perjalanan ke alamat asal Anda.

Properti

Properti	Nilai yang Didukung
Pola sumber	Tentukan pola sumber di jalur URL yang akan diganti. Saat ini, pola sumber menggunakan kecocokan berbasis awalan. Untuk mencocokkan semua jalur URL, gunakan garis miring (/) sebagai nilai pola sumber.
Tujuan	Tentukan jalur tujuan yang akan digunakan dalam penulisan ulang. Jalur tujuan akan menimpa pola sumber.
Pertahankan jalur yang tidak cocok	Jika diatur ke Ya, jalur yang tersisa setelah pola sumber akan ditambahkan ke jalur tujuan yang baru.

Contoh

Dalam contoh ini, kita akan menulis ulang semua permintaan ke jalur /redirection dan tidak akan mempertahankan jalur lainnya.

Portal

JSON

{
  "name": "UrlRewrite",
  "parameters": {
    "sourcePattern": "/",
    "destination": "/redirection",
    "preserveUnmatchedPath": false,
    "typeName": "DeliveryRuleUrlRewriteActionParameters"
  }
}

Bicep

{
  name: 'UrlRewrite'
  parameters: {
    sourcePattern: '/'
    destination: '/redirection'
    preserveUnmatchedPath: false
    typeName: 'DeliveryRuleUrlRewriteActionParameters'
  }
}

Penting

Azure Front Door (klasik) akan dihentikan pada 31 Maret 2027. Untuk menghindari gangguan layanan apa pun, penting untuk memigrasikan profil Azure Front Door (klasik) Anda ke Azure Front Door Standard atau tingkat Premium paling lambat Maret 2027. Untuk informasi selengkapnya, lihat Penghentian Azure Front Door (klasik).

Di Azure Front Door (klasik), Mesin aturan dapat terdiri hingga 25 aturan yang berisi kondisi yang cocok dan tindakan terkait. Artikel ini memberikan deskripsi terperinci tentang setiap tindakan yang dapat Anda tentukan dalam suatu aturan.

Suatu tindakan mendefinisikan perilaku yang diterapkan ke jenis permintaan yang cocok dengan kondisi atau kumpulan kondisi kecocokan. Dalam konfigurasi Mesin aturan, aturan dapat memiliki hingga 10 kondisi yang cocok dan 5 tindakan. Anda hanya dapat memiliki satu tindakan Konfigurasi Perutean Pengambil Alihan dalam satu aturan.

Tindakan berikut tersedia untuk digunakan dalam konfigurasi Mesin aturan.

Mengubah header permintaan

Gunakan tindakan ini untuk mengubah header yang ada dalam permintaan yang dikirim ke backend Anda.

Bidang yang wajib diisi

Perbuatan	Nama header HTTP	Nilai
Lampirkan	Ketika opsi ini dipilih dan aturannya cocok, header yang ditentukan di Nama header akan ditambahkan ke permintaan dengan nilai yang ditentukan. Jika header sudah ada, nilai ditambahkan ke nilai yang sudah ada.	String
Timpa	Ketika opsi ini dipilih dan aturannya cocok, header yang ditentukan di Nama header akan ditambahkan ke permintaan dengan nilai yang ditentukan. Jika header sudah ada, nilai yang ditentukan akan menimpa nilai yang sudah ada.	String
Hapus	Ketika opsi ini dipilih dengan aturan yang cocok dan header yang ditentukan dalam aturan ada, header akan dihapus dari permintaan.	String

Mengubah header respons

Gunakan tindakan ini untuk mengubah header yang ada dalam respons yang dimunculkan ke klien Anda.

Bidang yang wajib diisi

Perbuatan	Nama Header HTTP	Nilai
Lampirkan	Ketika opsi ini dipilih dan aturannya cocok, header yang ditentukan di Nama header akan ditambahkan ke respons menggunakan Nilai yang ditentukan. Jika header sudah ada, Nilai ditambahkan ke nilai yang sudah ada.	String
Timpa	Saat opsi ini dipilih dan aturannya cocok, header yang ditentukan di Nama header ditambahkan ke respons menggunakan Nilai yang ditentukan. Jika header sudah ada, Nilai akan menimpa nilai yang ada.	String
Hapus	Ketika opsi ini dipilih dengan aturan yang cocok dan header yang ditentukan terdapat dalam aturan, header akan dihapus dari respons.	String

Penimpaan konfigurasi rute

Jenis Rute: Pengalihan

Gunakan tindakan ini untuk mengarahkan klien ke URL baru.

Bidang yang wajib diisi

Bidang	Deskripsi
Jenis pengalihan	Pengalihan adalah cara untuk mengirim pengguna/klien dari satu URL ke URL lain. Jenis pengalihan menetapkan kode status yang digunakan oleh klien untuk memahami tujuan pengalihan. Anda dapat memilih kode status pengalihan berikut: Ditemukan (302), Dipindahkan (301), Dialihkan sementara (307), dan Dialihkan permanen (308).
Protokol pengalihan	Mempertahankan protokol sesuai permintaan yang masuk, atau menentukan protokol baru untuk pengalihan. Misalnya, pilih 'HTTPS' untuk pengalihan HTTP ke HTTPS.
Host tujuan	Atur nilai ini untuk mengubah nama host di URL untuk pengalihan atau pertahankan nama host dari permintaan masuk.
Jalur tujuan	Mempertahankan jalur sesuai permintaan masuk atau memperbarui jalur di URL untuk pengalihan.
Untai kueri	Atur nilai ini untuk mengganti string kueri yang ada dari URL permintaan masuk atau pertahankan kumpulan asli string kueri.
Fragmen tujuan	Fragmen tujuan adalah bagian URL setelah '#', biasanya digunakan oleh browser untuk membuka bagian halaman tertentu. Atur nilai ini untuk menambahkan fragmen ke URL pengalihan.

Jenis Rute: Penerusan

Gunakan tindakan ini untuk meneruskan klien ke URL baru. Tindakan ini juga berisi sub tindakan untuk regenerasi URL dan penembolokan.

Bidang	Deskripsi
Kumpulan backend	Pilih kumpulan backend untuk mengambil alih dan melayani permintaan, Anda akan melihat semua kumpulan backend yang telah dikonfigurasi sebelumnya saat ini di profil Front Door Anda.
Protokol penerusan	Protokol yang digunakan untuk meneruskan permintaan ke backend atau mencocokkan protokol dari permintaan masuk.
Penulisan ulang URL	Jalur yang akan digunakan saat membuat permintaan regenerasi URL untuk diteruskan ke backend.
penembolokan	Mengaktifkan penembolokan untuk aturan perutean ini. Saat diaktifkan, Azure Front Door menyimpan konten statis Anda.

Penulisan ulang URL

Gunakan pengaturan ini untuk mengonfigurasi Jalur Penerusan Kustom opsional yang dapat digunakan saat membuat permintaan untuk diteruskan ke backend.

Bidang	Deskripsi
Jalur penerusan kustom	Tentukan jalur tempat permintaan diteruskan.

penembolokan

Gunakan pengaturan ini untuk mengontrol bagaimana file di-cache bagi permintaan yang memuat untai kueri. Baik untuk melakukan cache konten Anda berdasarkan semua parameter atau pada parameter yang dipilih. Anda dapat menggunakan pengaturan ini untuk menimpa nilai time to live (TTL) untuk mengontrol berapa lama konten tetap berada di cache. Untuk memaksa penembolokan sebagai tindakan, atur bidang penembolokan ke "Aktif". Opsi berikut muncul saat Anda memaksa penembolokan:

Perilaku cache	Deskripsi
Abaikan String Kueri	Setelah aset di-cache, semua permintaan berikutnya akan mengabaikan untai kueri hingga aset yang di-cache kedaluwarsa.
Menggunakan String Kueri	Setiap permintaan dengan URL unik, termasuk untai kueri, diperlakukan sebagai aset unik dengan cache tersendiri.
Abaikan String Kueri yang Ditentukan	Untai kueri URL permintaan yang tercantum dalam pengaturan "Parameter kueri" diabaikan untuk penembolokan.
Sertakan String Kueri yang Ditentukan	Untai kueri URL permintaan yang tercantum dalam pengaturan "Parameter kueri" dipakai untuk penembolokan.

Bidang lainnya	Deskripsi
Pemadatan dinamis	Front Door dapat secara dinamis memadatkan konten di tepi, yang menghasilkan respons yang lebih kecil dan lebih cepat.
Parameter kueri	Daftar parameter yang diizinkan atau tidak diizinkan yang dipisahkan koma, yang akan digunakan sebagai dasar untuk penembolokan.
Menggunakan durasi cache default	Atur untuk menggunakan durasi penembolokan default Azure Front Door atau tentukan durasi penembolokan yang mengabaikan arahan respons asal.

Langkah berikutnya

• Pelajari cara mengonfigurasi Seperangkat aturan pertama Anda.
• Pelajari selengkapnya tentang Kondisi kecocokan yang ditetapkan aturan.
• Pelajari selengkapnya tentang seperangkat Aturan Azure Front Door.