全部产品
Search
文档中心

API Gateway:cache-control

更新时间:Jun 28, 2025

Plugin cache-control menambahkan header Expires dan Cache-Control ke respons berdasarkan akhiran file URL. Plugin ini memungkinkan browser menyimpan cache file dengan akhiran tertentu seperti jpg dan png.

Atribut saat dijalankan

Tahap eksekusi plugin: Authorization. Prioritas eksekusi plugin: 200.

Bidang

Bidang

Tipe data

Diperlukan

Nilai default

Deskripsi

suffix

string

Tidak. Akhiran yang akan dicocokkan, seperti jpg dan png.

Untuk mencocokkan beberapa akhiran, pisahkan akhiran dengan tanda vertikal (|). Contoh: png|jpg.

Jika Anda tidak menentukan parameter ini, semua akhiran akan cocok.

-

Parameter ini menentukan akhiran file yang akan dicocokkan.

expires

string

Ya. Periode maksimum waktu untuk menyimpan cache file.

Jika Anda menentukan angka sebagai nilai, satuannya adalah detik. Misalnya, untuk menentukan periode 1 jam, Anda harus memasukkan 3600.

epoch dan max didukung dan

membawa makna yang sama seperti dalam nginx.

-

Parameter ini menentukan periode maksimum waktu untuk menyimpan cache file.

Contoh konfigurasi

  1. Simpan cache file dengan akhiran jpg, png, atau jpeg selama satu jam:

    suffix: jpg|png|jpeg
    expires: 3600

    Berdasarkan konfigurasi tersebut, header Expires dan Cache-Control akan ditambahkan ke respons permintaan untuk menyimpan cache file yang sesuai selama satu jam:

    curl http://example.com/test.png
    curl http://exmaple.com/test.jpg
  2. Simpan cache semua file hingga Thu, 31 Dec 2037 23:55:55 GMT:

    expires: max