全部产品
Search
文档中心

CDN:Konfigurasi waktu kedaluwarsa kode status

更新时间:Nov 18, 2025

Ketika Titik Kehadiran (POP) Content Delivery Network (CDN) Alibaba Cloud mengambil sumber daya dari server asal Anda, server asal akan mengembalikan kode status respons. Anda dapat mengonfigurasi durasi cache untuk kode-kode status tersebut di CDN. Ketika klien meminta kembali sumber daya yang sama, POP CDN akan langsung mengembalikan kode status tersebut tanpa melakukan pengambilan asal, sehingga mengurangi beban pada server asal Anda. Setelah durasi cache berakhir, pengambilan asal baru akan dipicu.

Skenario

Anda dapat mengonfigurasi waktu kedaluwarsa kode status untuk menentukan aksi caching yang dilakukan oleh POP ketika server asal mengembalikan kode status abnormal.

Secara default, ketika POP mengambil sumber daya yang diminta dari server asal dan server asal mengembalikan kode status 2xx, sumber daya tersebut di-cache berdasarkan aturan dan prioritas cache default Alibaba Cloud CDN dan DCDN. Jika server asal mengembalikan kode status abnormal (misalnya, non-2xx) dan Anda ingin menghindari pemrosesan berulang terhadap permintaan identik oleh server asal, Anda dapat menentukan durasi cache untuk kode status tersebut. Hal ini memungkinkan POP menyimpan cache kode status dan langsung mengembalikannya ke klien, sehingga mengurangi beban pada server asal.

Kasus penggunaan

Seorang klien terus-menerus mencoba mengakses File A, yang telah dihapus dari server asal. POP tidak memiliki salinan cache File A, sehingga semua permintaan untuk File A diteruskan ke server asal, yang kemudian mengembalikan kode status 4xx. Hal ini secara signifikan meningkatkan beban pada server asal. Jika Anda mengonfigurasi POP untuk menyimpan cache kode status 4xx, POP akan menyimpan cache kode status tersebut setelah pengambilan asal pertama. Selama durasi cache yang ditentukan, ketika klien meminta kembali File A, POP akan langsung mengembalikan kode status 4xx tanpa melakukan pengambilan asal.

Aturan cache untuk kode status abnormal

  • Untuk kode status 204, 305, 404, 405, 414, 424, 429, 500, 501, 502, 503, dan 504, aturan cache adalah sebagai berikut:

    1. Jika server asal mengembalikan header respons set-cookie, CDN tidak menyimpan cache respons tersebut.

    2. Jika server asal tidak mengembalikan header respons Set-Cookie, respons di-cache berdasarkan waktu kedaluwarsa kode status yang Anda konfigurasikan di konsol CDN. Untuk informasi tentang cara beberapa aturan berlaku, lihat bagian Prioritas beberapa aturan.

    3. Jika server asal tidak mengembalikan header respons Set-Cookie dan Anda tidak mengonfigurasi waktu kedaluwarsa untuk kode status di konsol CDN, respons di-cache berdasarkan header respons Pragma, Cache-Control, atau Expires dari server asal.

    4. Jika server asal tidak mengembalikan header respons Set-Cookie, Pragma, Cache-Control, atau Expires dan Anda tidak mengonfigurasi waktu kedaluwarsa untuk kode status di konsol CDN, respons di-cache selama 1 detik secara default.

  • Untuk kode status 302, 307, dan 403, aturan cache adalah sebagai berikut:

    1. Jika server asal mengembalikan header respons set-cookie, CDN tidak menyimpan cache respons tersebut.

    2. Jika server asal tidak mengembalikan header respons Set-Cookie, respons di-cache berdasarkan waktu kedaluwarsa kode status yang Anda konfigurasikan di konsol CDN. Untuk informasi tentang cara beberapa aturan berlaku, lihat bagian Prioritas beberapa aturan.

    3. Jika server asal tidak mengembalikan header respons Set-Cookie dan Anda tidak mengonfigurasi waktu kedaluwarsa untuk kode status di konsol CDN, respons di-cache berdasarkan header respons Pragma, Cache-Control, atau Expires dari server asal.

    4. Jika server asal tidak mengembalikan header respons Set-Cookie, Pragma, Cache-Control, atau Expires dan Anda tidak mengonfigurasi waktu kedaluwarsa untuk kode status di konsol CDN, respons tidak di-cache.

  • Untuk kode status 304, CDN tidak menyimpan cache respons tersebut. Anda tidak dapat mengatur durasi cache untuk kode status ini.

  • Untuk kode status abnormal lainnya, seperti 400, aturan cache adalah sebagai berikut:

    1. Jika server asal mengembalikan header respons set-cookie, CDN tidak menyimpan cache respons tersebut.

    2. Jika server asal tidak mengembalikan header respons Set-Cookie, respons di-cache berdasarkan waktu kedaluwarsa kode status yang Anda konfigurasikan di konsol CDN. Untuk informasi tentang cara beberapa aturan berlaku, lihat bagian Prioritas beberapa aturan.

    3. Dalam skenario lainnya, respons tidak di-cache.

  • Untuk permintaan yang menggunakan range origin fetch, jika POP CDN menerima kode status non-206 dari server asal, POP CDN akan menghapus shard file yang di-cache. Waktu habis (timeout) pengambilan asal tidak menyebabkan shard file yang di-cache dihapus.

    Dalam skenario range origin fetch, server asal membagi file besar menjadi beberapa shard file yang lebih kecil dan mengembalikannya ke POP CDN. Misalnya, sebuah file dibagi menjadi 10 shard. POP CDN telah menyimpan cache lima shard. Ketika POP meminta shard keenam, server asal mengembalikan kode status 5xx. Dalam kasus ini, lima shard yang sebelumnya di-cache akan dihapus.

Prioritas beberapa aturan

Anda dapat mengatur beberapa aturan cache untuk kode status. Jika suatu permintaan cocok dengan beberapa aturan, hanya satu aturan yang berlaku. Aturan yang berlaku ditentukan sebagai berikut:

  • Urutan evaluasi:

    Aturan dievaluasi terlebih dahulu berdasarkan jenis (Ekstensi File > Direktori), lalu berdasarkan waktu pembuatan (lebih lama > lebih baru).

  • Prioritas aturan dengan jenis berbeda: Ekstensi File > Direktori.

    Misalnya, permintaan pengguna cocok dengan dua aturan yang dikonfigurasi untuk kode status 404. Jenis aturan tersebut adalah Ekstensi File dan Direktori. Waktu kedaluwarsa kode status 404 ditentukan oleh aturan dengan jenis Ekstensi File. Untuk contoh detail, lihat Contoh konfigurasi.

  • Prioritas aturan dengan jenis yang sama: Lebih lama > Lebih baru (dari atas ke bawah dalam daftar aturan).

    Misalnya, permintaan pengguna cocok dengan dua aturan yang dikonfigurasi untuk kode status 404. Aturan tersebut memiliki jenis yang sama, yaitu Ekstensi File atau Direktori. Waktu kedaluwarsa kode status 404 ditentukan oleh aturan yang dibuat lebih dulu. Untuk contoh detail, lihat Contoh konfigurasi.

Prosedur

  1. Masuk ke Konsol CDN.

  2. Di panel navigasi kiri, klik Domain Names.

  3. Pada halaman Domain Names, temukan nama domain target dan klik Manage di kolom Actions.

  4. Di panel navigasi domain, klik Cache.

  5. Klik tab Status Code TTL.

  6. Klik Create Rule untuk mengonfigurasi waktu kedaluwarsa untuk kode status.

    image

    Jenis

    Catatan

    Type

    Anda dapat mengatur parameter ini menjadi Directory atau File Extension. Pilih jenis sesuai kebutuhan.

    Catatan

    Prioritas aturan dengan jenis berbeda: Ekstensi File > Direktori. Untuk informasi selengkapnya, lihat Aturan cache untuk kode status abnormal.

    Object

    • Jika Anda memilih Directory sebagai jenis, petunjuknya adalah sebagai berikut:

      • Anda hanya dapat menambahkan satu direktori dalam satu waktu.

      • Masukkan path lengkap direktori. Path harus diawali dengan garis miring (/). Contohnya, /directory/aaa.

    • Jika Anda memilih File Extension sebagai jenis, parameter dijelaskan sebagai berikut:

      • Masukkan satu atau beberapa ekstensi file. Pisahkan beberapa ekstensi file dengan koma (,). Contohnya, jpg,txt.

        Catatan

        Jika Anda membuat aturan untuk ekstensi file yang identik kecuali huruf kapitalnya, aturan yang dibuat belakangan akan menimpa aturan yang dibuat sebelumnya. Misalnya, setelah Anda membuat aturan untuk jpg,txt, Anda membuat aturan lain untuk JPG,TXT. Aturan JPG,TXT akan menimpa aturan jpg,txt. Jika Anda ingin membuat aturan untuk ekstensi file huruf kecil, buat aturan terpisah untuk txt dan jpg. Aturan ini bersifat case-sensitive.

      • Anda tidak dapat menggunakan tanda bintang (*) untuk mencocokkan semua jenis file.

    Expire In

    Tentukan kode status yang ingin Anda cache dan durasi cache-nya. Durasi cache maksimum adalah tiga tahun. Satuan adalah detik. Ikuti aturan berikut:

    • Pisahkan beberapa kode status dengan koma (,).

    • Untuk kode status 2xx dan 3xx, Anda hanya dapat menentukan kode status individual. Anda tidak dapat menggunakan pencocokan blur. Misalnya, 201=10 didukung, tetapi 2xx=12 tidak didukung.

    • Untuk kode status 4xx dan 5xx, Anda dapat menentukan kode status individual atau menggunakan pencocokan blur. Misalnya, baik 401=10 maupun 4xx=12 didukung.

    Honor Origin TTL

    Jika Anda mengaktifkan fitur ini dan server asal mengembalikan header kebijakan cache, seperti Cache-Control dan Pragma, kebijakan cache server asal akan didahulukan.

    Ignore Origin No-Cache Header

    Jika Anda mengaktifkan fitur ini, POP CDN akan mengabaikan header kebijakan cache berikut dari server asal. Header-header ini menunjukkan bahwa respons tidak boleh di-cache.

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    Follow POP Cache Policy

    Jika Anda mengaktifkan fitur ini, POP CDN akan mengembalikan kebijakan cache efektif akhir kepada klien.

    Force Revalidation

    Parameter ini hanya berlaku ketika durasi cache adalah 0. Efeknya adalah sebagai berikut:

    • Shutdown (default): Jika waktu hidup (TTL) untuk CDN diatur ke 0, node CDN tidak menyimpan cache file. Setiap permintaan harus melakukan pengambilan asal untuk mengambil konten.

    • Enabled: Ketika waktu hidup untuk CDN/ diatur ke 0, file dapat di-cache pada node CDN/, tetapi setiap permintaan memerlukan pengambilan asal untuk mengautentikasi konten yang di-cache.

  7. Klik OK.

    Setelah Anda mengonfigurasi waktu kedaluwarsa untuk kode status, Anda dapat menemukan aturan tersebut dalam daftar di tab Expire In. Anda dapat Modify atau Delete aturan tersebut.

Contoh konfigurasi

  • Contoh 1: Aturan direktori

    Gambar berikut menunjukkan cara membuat aturan direktori.示例一

    Di direktori /directory/aaa, semua kode status 4xx di-cache selama 10 detik, dan kode status 201 di-cache selama 15 detik. Dalam rentang waktu tersebut, POP merespons langsung permintaan akses. Setelah durasi cache berakhir, permintaan dialihkan ke server asal.

  • Contoh 2: Aturan ekstensi file

    Gambar berikut menunjukkan cara membuat aturan ekstensi file.示例二

    Untuk file dengan ekstensi .jpg atau .txt, kode status 403 di-cache selama 10 detik, dan kode status 404 di-cache selama 15 detik. Dalam rentang waktu tersebut, POP merespons langsung permintaan akses. Setelah durasi cache berakhir, permintaan dialihkan ke server asal.

  • Contoh 3: Prioritas aturan dengan jenis berbeda

    Aturan direktori dan aturan ekstensi file dibuat dengan waktu kedaluwarsa berbeda untuk kode status, seperti yang ditunjukkan pada gambar berikut.示例三

    Pengguna meminta http://example.com/directory/aaa/test.jpg. Sumber daya tersebut tidak di-cache di POP. POP meminta sumber daya dari server asal, dan server asal mengembalikan kode status 404. Permintaan tersebut cocok dengan aturan direktori dan aturan ekstensi file. Karena prioritas aturan untuk jenis berbeda adalah Ekstensi File > Direktori, aturan ekstensi file yang berlaku. Durasi cache aktual untuk kode status 404 adalah 20 detik.

  • Contoh 4: Prioritas beberapa aturan dengan jenis yang sama

    Pertama, Aturan Direktori 1 dibuat untuk path /directory. Kemudian, Aturan Direktori 2 dibuat untuk path /directory/aaa. Aturan tersebut memiliki waktu kedaluwarsa berbeda untuk kode status, seperti yang ditunjukkan pada gambar berikut.示例四

    Pengguna meminta http://example.com/directory/aaa/test.jpg. Sumber daya tersebut tidak di-cache di POP. POP meminta sumber daya dari server asal, dan server asal mengembalikan kode status 404. Permintaan tersebut cocok dengan kedua aturan direktori. Karena prioritas aturan untuk jenis yang sama adalah Lebih lama > Lebih baru, Aturan Direktori 1, yang dibuat lebih dulu, yang berlaku. Durasi cache aktual untuk kode status 404 adalah 15 detik.

API Terkait

BatchSetCdnDomainConfig