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

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

Saat Penembolokan diatur ke Aktif, atur properti berikut:

Contoh

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

{
  "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"
  }
}

{
  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.

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

{
  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.

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

{
  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

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.

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

{
  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

Contoh

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

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

{
  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. Azure Front Door mendukung pengambilan dinamis jalur URL dengan {url_path:seg#} variabel server, dan mengonversi jalur URL menjadi huruf kecil atau huruf besar dengan {url_path.tolower} atau {url_path.toupper}. Untuk informasi selengkapnya, lihat Variabel server.

Properti

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 komputer klien digunakan sebagai pengganti token {client_ip} di dalam URL dengan menggunakan variabel serverclient_ip.

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

{
  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. Azure Front Door mendukung pengambilan dinamis jalur URL dengan {url_path:seg#} variabel server, dan mengonversi jalur URL menjadi huruf kecil atau huruf besar dengan {url_path.tolower} atau {url_path.toupper}. Untuk informasi selengkapnya, lihat Variabel server.

Properti

Contoh

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

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

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

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

Mengubah header respons

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

Bidang yang wajib diisi

Penimpaan konfigurasi rute

Jenis Rute: Pengalihan

Gunakan tindakan ini untuk mengarahkan klien ke URL baru.

Bidang yang wajib diisi

Jenis Rute: Penerusan

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

Penulisan ulang URL

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

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: