全部产品
Search
文档中心

Edge Security Acceleration:Fungsi untuk konfigurasi nama domain

更新时间:Jan 16, 2026

Anda dapat memanggil operasi BatchSetDcdnDomainConfigs untuk mengonfigurasi fitur pada beberapa nama domain yang dipercepat sekaligus. Topik ini menjelaskan fitur-fitur yang dapat dikonfigurasi melalui operasi API tersebut beserta parameter terkaitnya.

Catatan

Informasi dasar

dynamic

  • Deskripsi fitur: Konfigurasi terkait DCDN. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Aturan untuk akselerasi konten statis dan dinamis.

  • ID Fitur (FunctionID/FuncId): 46.

  • Deskripsi parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Aktifkan Akselerasi Statis:

    • on: mengaktifkan fitur.

    • off: menonaktifkan fitur.

    on

    static_route_type

    String

    Tidak

    Ekstensi file untuk akselerasi konten statis.

    .txt

    static_route_url

    String

    Tidak

    URI untuk akselerasi konten statis.

    /domain/detail/log.txt

    static_route_path

    String

    Tidak

    Jalur file untuk akselerasi konten statis.

    Catatan

    Anda dapat menggunakan karakter wildcard, seperti tanda bintang (*) dan tanda tanya (?), untuk pencocokan kabur jalur file statis. Tanda bintang (*) cocok dengan nol atau lebih karakter. Tanda tanya (?) cocok dengan satu karakter.

    /abc/test/*

    dynamic_route_origin

    String

    Tidak

    Kebijakan protokol asal untuk konten dinamis. Nilai yang valid:

    • http: DCDN menggunakan HTTP untuk meminta resource dari server asal.

    • https: DCDN menggunakan HTTPS untuk meminta resource dari server asal.

    • follow: DCDN menggunakan protokol yang sama dengan klien untuk meminta resource dari server asal.

    • follow-port: DCDN menggunakan protokol yang sesuai dengan port server asal untuk meminta resource dari server asal.

    Catatan

    Jika Anda tidak mengatur dynamic_route_origin, nilai default follow digunakan.

    https

    dynamic_route_round_robin

    String

    Tidak

    Menentukan apakah akan mengaktifkan load balancing. Nilai yang valid:

    • on: mengaktifkan fitur.

    • off (default): menonaktifkan fitur.

    off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "static_route_type",
                "argValue": ".txt"
            }, {
                "argName": "static_route_url",
                "argValue": "/domain/detail/log.txt"
            },{
                "argName": "static_route_path",
                "argValue": "/abc/test/*"
            }, {
                "argName": "dynamic_route_origin",
                "argValue": "https"
            }, {
                "argName": "dynamic_route_round_robin",
                "argValue": "off"
            }],
            "functionName": "dynamic"
        }],
        "DomainNames": "example.com"
    }

ipv6

  • Deskripsi fitur: Konfigurasi akses IPv6. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Aktifkan IPv6.

  • ID Fitur (FunctionID/FuncId): 194.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    switch

    String

    Ya

    Aktifkan akses IPv6:

    • on: mengaktifkan fitur.

    • off: menonaktifkan fitur.

    on

    region

    String

    Ya

    Wilayah tempat Anda ingin mengaktifkan IPv6. Karakter wildcard (*) didukung.

    Catatan
    • Tanda bintang (*) menunjukkan bahwa IPv6 diaktifkan untuk semua wilayah. Saat ini, Anda hanya dapat mengaktifkan IPv6 untuk semua wilayah. Jika Anda ingin mengaktifkan IPv6 untuk wilayah tertentu, kirim tiket untuk mengajukan permohonan.

    • Jika Anda tidak mengatur parameter ini, IPv6 diaktifkan untuk semua wilayah secara default.

    *

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "switch",
                "argValue": "on"
            }, {
                "argName": "region",
                "argValue": "*"
            }],
            "functionName": "ipv6"
        }],
        "DomainNames": "example.com"
    }

Konfigurasi asal

set_req_host_header

  • Deskripsi fitur: Mengonfigurasi host asal. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi host asal default.

  • ID Fitur (FunctionID/FuncId): 18.

  • Deskripsi parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Contoh

    domain_name

    String

    Ya

    Konten header host asal.

    example.com

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "domain_name",
                "argValue": "example.com"
            }],
            "functionName": "set_req_host_header"
        }],
        "DomainNames": "example.com"
    }

forward_scheme

  • Deskripsi fitur: Mengonfigurasi kebijakan protokol asal. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi tindak lanjut protokol statis untuk pengambilan asal.

  • ID Fitur (FunctionID/FuncId): 47.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan kebijakan protokol asal. Nilai yang valid:

    • on: mengaktifkan fitur.

    • off: menonaktifkan fitur.

    on

    scheme_origin

    String

    Tidak

    Kebijakan protokol asal. Nilai yang valid:

    • http: DCDN menggunakan HTTP untuk pengambilan asal.

    • https: DCDN menggunakan HTTPS untuk pengambilan asal.

    • follow: DCDN menggunakan protokol yang sama dengan permintaan klien untuk pengambilan asal.

    Catatan

    Jika Anda tidak mengatur scheme_origin, nilai default follow digunakan.

    follow

    scheme_origin_port

    String

    Tidak

    Port asal kustom. Parameter ini harus digunakan bersama parameter scheme_origin. Nilai yang valid:

    • Jika Anda mengatur scheme_origin ke http, Anda hanya perlu mengonfigurasi port asal HTTP. Contoh: 80.

    • Jika Anda mengatur scheme_origin ke https, Anda hanya perlu mengonfigurasi port asal HTTPS. Contoh: 443.

    • Jika Anda mengatur scheme_origin ke follow, Anda harus mengonfigurasi port asal HTTP dan HTTPS. Pisahkan dengan titik dua (:). Contoh: 80:443.

    80:443

  • Contoh konfigurasi 1: DCDN menggunakan protokol yang sama dengan permintaan klien untuk pengambilan asal. Port asal adalah port default untuk protokol tersebut. Port 80 digunakan untuk HTTP dan Port 443 digunakan untuk HTTPS.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "scheme_origin",
                "argValue": "follow"
            }],
            "functionName": "forward_scheme"
        }],
        "DomainNames": "example.com"
    }
  • Contoh konfigurasi 2: DCDN menggunakan protokol yang sama dengan permintaan klien untuk pengambilan asal. Port asal adalah port kustom. Port 8080 digunakan untuk HTTP dan Port 4433 digunakan untuk HTTPS.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "scheme_origin",
                "argValue": "follow"
            }, {
                "argName": "scheme_origin_port",
                "argValue": "8080:4433"
            }],
            "functionName": "forward_scheme"
        }],
        "DomainNames": "example.com"
    }

l2_oss_key

  • Deskripsi fitur: Mengonfigurasi pengambilan asal dari bucket pribadi. Catatan: Pertama kali menggunakan fitur ini, Anda harus mengaktifkan kebijakan akses default dengan sekali klik. Setelah kebijakan diaktifkan, DCDN diberikan akses read-only ke semua bucket OSS yang dimiliki oleh Akun Alibaba Cloud Anda. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Pengambilan asal dari bucket OSS pribadi.

  • ID Fitur (FunctionID/FuncId): 85.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    private_oss_auth

    String

    Ya

    Menentukan apakah akan mengaktifkan pengambilan asal dari bucket pribadi. Nilai yang valid:

    • on: mengaktifkan fitur.

    • off: menonaktifkan fitur.

    Setelah Anda mengaktifkan fitur ini, sistem secara otomatis mengonfigurasi token Layanan Keamanan (STS). Hal ini menyederhanakan konfigurasi. Namun, metode ini hanya mendukung pengambilan asal dari bucket OSS pribadi yang dimiliki oleh Akun Alibaba Cloud yang sama dengan nama domain yang dipercepat DCDN. Untuk informasi selengkapnya tentang token STS, lihat Apa itu STS?.

    on

    perm_private_oss_tbl

    String

    Tidak

    Konfigurasi token keamanan permanen. Formatnya adalah access_id=123 access_secret=123abc. Pisahkan parameter dengan spasi.

    Setelah Anda mengonfigurasi token keamanan permanen, Anda dapat mengonfigurasi pengambilan asal dari bucket OSS pribadi yang dimiliki oleh Akun Alibaba Cloud yang sama dengan nama domain yang dipercepat DCDN, serta dari bucket OSS pribadi yang dimiliki oleh Akun Alibaba Cloud lainnya. Untuk informasi selengkapnya tentang token keamanan permanen, lihat Buat AccessKey.

    access_id=123 access_secret=123abc

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "private_oss_auth",
                "argValue": "on"
            },{
                "argName": "perm_private_oss_tbl",
                "argValue": "access_id=123 access_secret=123abc"
            }],
            "functionName": "l2_oss_key"
        }],
        "DomainNames": "example.com"
    }

oss_key_list

  • Deskripsi fitur: Daftar kunci pribadi untuk pengambilan asal dari OSS. Anda dapat mengonfigurasi satu atau beberapa aturan untuk menentukan beberapa bucket OSS pribadi dan token keamanannya masing-masing.

  • ID Fitur (FunctionID/FuncId): 183.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    host

    String

    Ya

    Alamat lengkap bucket OSS.

    example.oss-cn-hangzhou.aliyuncs.com

    key

    String

    Ya

    Konfigurasi token keamanan permanen. Formatnya adalah access_id=123 access_secret=123abc. Pisahkan parameter dengan spasi.

    Setelah Anda mengonfigurasi token keamanan permanen, Anda dapat mengonfigurasi pengambilan asal dari bucket OSS pribadi yang dimiliki oleh Akun Alibaba Cloud yang sama dengan nama domain yang dipercepat DCDN, serta dari bucket OSS pribadi yang dimiliki oleh Akun Alibaba Cloud lainnya. Untuk informasi selengkapnya tentang token keamanan permanen, lihat Buat AccessKey.

    access_id=123 access_secret=123abc

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "host",
                "argValue": "example.oss-cn-hangzhou.aliyuncs.com"
            },{
                "argName": "key",
                "argValue": "access_id=123 access_secret=123abc"
            }],
            "functionName": "oss_key_list"
        }],
        "DomainNames": "example.com"
    }

https_origin_sni

  • Deskripsi fitur: Mengonfigurasi SNI asal. Anda dapat mengatur SNI asal tertentu untuk server asal tertentu. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi SNI asal tertentu. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi SNI asal.

  • ID Fitur (FunctionID/FuncId): 114.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    enabled

    String

    Ya

    Menentukan apakah akan mengaktifkan fitur SNI asal. Nilai yang valid:

    • on: mengaktifkan fitur.

    • off: menonaktifkan fitur.

    on

    https_origin_sni

    String

    Ya

    Informasi SNI yang dibawa dalam permintaan asal. Ini adalah alamat server asal yang perlu diakses oleh permintaan asal.

    origin.example.com

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "https_origin_sni",
                "argValue": "origin.example.com"
            }, {
                "argName": "enabled",
                "argValue": "on"
            }],
            "functionName": "https_origin_sni"
        }],
        "DomainNames": "example.com"
    }

forward_timeout

  • Deskripsi fitur: Mengonfigurasi waktu habis permintaan asal. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Waktu habis permintaan asal.

  • ID Fitur (FunctionID/FuncId): 124.

  • Deskripsi parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Contoh

    forward_timeout

    Integer

    Ya

    Periode waktu habis permintaan. Satuan: detik.

    Catatan

    Kami menyarankan agar Anda mengatur periode waktu habis kurang dari 100 detik.

    30

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "forward_timeout",
                "argValue": "30"
            }],
            "functionName": "forward_timeout"
        }],
        "DomainNames": "example.com"
    }

advanced_origin

  • Deskripsi fitur: Mengonfigurasi asal lanjutan. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Asal lanjutan. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

  • Konflik fitur: Fitur asal lanjutan bertentangan dengan fitur asal bersyarat (fungsi: origin_dns_host, ID fitur: 212). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur telah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Anda dapat memanggil operasi DeleteDcdnSpecificConfig untuk menghapus konfigurasi tertentu untuk nama domain.

  • ID Fitur (FunctionID/FuncId): 235.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    variable_type

    String

    Ya

    Jenis variabel. Nilai yang valid:

    • header: header permintaan yang dibawa dalam permintaan pengguna.

    • arg: parameter string kueri yang dibawa dalam URL permintaan pengguna.

    • uri: jalur yang dibawa dalam URL permintaan pengguna.

    • cookie: cookie permintaan yang dibawa dalam permintaan pengguna.

    uri

    variable

    String

    Ya

    Nama variabel.

    Catatan

    Jika Anda mengatur variable_type ke uri, Anda harus mengatur variable ke uri.

    uri

    conditions

    String

    Ya

    Kondisi. Nilai yang valid:

    • ==: sama dengan.

    • !=: tidak sama dengan.

    ==

    value

    String

    Ya

    Nilai variabel.

    /image

    origin

    String

    Ya

    Nama domain yang digunakan untuk kueri DNS selama pengambilan asal. Ini adalah nilai variabel dalam permintaan pengguna. Jika nilainya cocok, permintaan dialihkan ke URL asal yang ditentukan.

    origin.example.com

  • Contoh konfigurasi:

    {
     "Functions": [{
      "functionArgs": [{
       "argName": "conditions",
       "argValue": "=="
      }, {
       "argName": "variable_type",
       "argValue": "uri"
      }, {
       "argName": "value",
       "argValue": "/image"
      }, {
       "argName": "origin",
       "argValue": "origin.example.com"
      }, {
       "argName": "variable",
       "argValue": "uri"
      }],
      "functionName": "advanced_origin"
     }],
     "DomainNames": "example.com",
    }

follow_302

  • Deskripsi fitur: Mengonfigurasi pengalihan 302 untuk pengambilan asal. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi pengalihan 301/302 untuk pengambilan asal. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

  • ID Fitur (FunctionID/FuncId): 219.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan pengalihan 302 untuk pengambilan asal. Nilai yang valid:

    • on: mengaktifkan fitur.

    • off: menonaktifkan fitur.

    on

    max_tries

    Integer

    Tidak

    Jumlah maksimum pengalihan 302.

    • Nilai default: 2.

    • Nilai yang valid: [1,5].

    Catatan

    Jumlah pengambilan asal - 1 = jumlah pengalihan 302. Artinya jumlah maksimum pengambilan asal default adalah 3, dan rentang nilai yang valid adalah [2,6].

    2

    retain_args

    String

    Tidak

    Menentukan apakah akan mempertahankan parameter permintaan asli saat mengalihkan ke server asal tujuan. Nilai yang valid:

    • on: mempertahankan parameter.

    • off (default): tidak mempertahankan parameter.

    off

    retain_header

    String

    Tidak

    Menentukan apakah akan mempertahankan header permintaan asli saat mengalihkan ke server asal tujuan. Nilai yang valid:

    • On: Pertahankan.

    • off (default): tidak mempertahankan header.

    off

    response_header

    String

    Tidak

    Header respons pengalihan 302. Ini adalah nama header respons pengalihan 302 yang dikirim server asal ke DCDN. Nama header default adalah Location.

    X-Alicdn-Redirect

    retain_host

    String

    Tidak

    Pertahankan nama domain asal untuk pengalihan 302. Saat diaktifkan, DCDN mempertahankan nama domain asal selama pengalihan 302. Ini hanya berlaku saat mengalihkan ke nama domain tujuan. Nilai yang valid:

    • on: mengaktifkan fitur.

    • off (default): menonaktifkan fitur.

    off

    modify_host

    String

    Tidak

    Ubah nama domain asal untuk pengalihan 302. DCDN mengubah nama domain asal selama pengalihan 302. Ini hanya berlaku saat mengalihkan ke nama domain tujuan. Secara default, nama domain asal tidak diubah.

    example.com

    cache

    String

    Tidak

    Cache hasil pengalihan 302. Saat diaktifkan, DCDN menyimpan cache hasil pengalihan untuk URL yang sama selama pengalihan 302 untuk meningkatkan performa respons DCDN. Nilai yang valid:

    • on: mengaktifkan fitur.

    • off (default): menonaktifkan fitur.

    off

    expired_time

    Integer

    Tidak

    Periode waktu habis untuk caching hasil pengalihan 302. Ini adalah periode waktu habis untuk DCDN menyimpan cache hasil pengalihan untuk URL yang sama selama pengalihan 302. Parameter ini harus digunakan bersama fitur cache. Satuan: detik. Nilai default: 3600.

    7200

    follow_origin_host

    String

    Tidak

    Gunakan nama domain asal sebagai host asal untuk pengalihan 302. Saat diaktifkan, DCDN menggunakan nama domain asal sebagai host asal. Nama domain asal terbaru digunakan bahkan setelah alih bencana primer/sekunder. Nilai yang valid:

    • on: mengaktifkan fitur.

    • off (default): menonaktifkan fitur.

    off

    follow_5xx_retry_origin

    String

    Tidak

    Alih bencana server asal primer/sekunder. Saat diaktifkan, DCDN beralih ke server asal berikutnya yang tersedia jika menerima kode status 5xx dari server asal. Nilai yang valid:

    • on: mengaktifkan fitur.

    • off (default): menonaktifkan fitur.

    off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "max_tries",
                "argValue": 2
            }, {
                "argName": "retain_args",
                "argValue": "off"
            }, {
                "argName": "retain_header",
                "argValue": "off"
            }, {
                "argName": "response_header",
                "argValue": "X-Alicdn-Redirect"
            }, {
                "argName": "retain_host",
                "argValue": "off"
            }, {
                "argName": "modify_host",
                "argValue": "example.com"
            }, {
                "argName": "cache",
                "argValue": "off"
            }, {
                "argName": "expired_time",
                "argValue": "7200"
            }, {
                "argName": "follow_origin_host",
                "argValue": "off"
            }, {
                "argName": "follow_5xx_retry_origin",
                "argValue": "off"
            }],
            "functionName": "follow_302"
        }],
        "DomainNames": "example.com"
    }
    

set_req_header

  • Deskripsi fitur: Mengonfigurasi header HTTP asal kustom. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Ubah header permintaan inbound.

    Catatan

    `set_req_header` adalah v1. Kami menyarankan Anda menggunakan v2, yaitu `origin_request_header`. Versi v2 mendukung lebih banyak fitur untuk header HTTP asal kustom.

  • ID Fitur (FunctionID/FuncId): 39.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    key

    String

    Ya

    Nama header asal.

    Accept-Encoding

    value

    String

    Ya

    Nilai header asal. Untuk menghapus header asal, atur nilainya ke null.

    gzip

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "value",
                "argValue": "gzip"
            }, {
                "argName": "key",
                "argValue": "Accept-Encoding"
            }],
            "functionName": "set_req_header"
        }],
        "DomainNames": "example.com"
    }

origin_request_header

  • Deskripsi fitur: Mengonfigurasi header permintaan HTTP asal (versi baru). Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi header permintaan HTTP asal. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

  • ID Fitur (FunctionID/FuncId): 228.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    header_operation_type

    String

    Ya

    Operasi header permintaan. Nilai yang valid:

    • add: Menambahkan entri baru.

    • delete: hapus.

    • Modify

    • Gunakan replace alih-alih rewrite.

    add

    header_name

    String

    Ya

    Nama header permintaan.

    Accept-Encoding

    header_value

    String

    Tidak

    Nilai header permintaan. Anda dapat mengonfigurasi beberapa nilai untuk parameter header permintaan. Pisahkan beberapa nilai dengan koma (,).

    gzip

    duplicate

    String

    Tidak

    Menentukan apakah akan mengizinkan penambahan header permintaan dengan nama yang sama. Jika Anda mengatur header_operation_type ke add, Anda harus menentukan apakah duplikat diizinkan. Nilai yang valid:

    • On: Izinkan.

    • Off: Dinonaktifkan.

    off

    header_source

    String

    Tidak

    Nilai parameter yang akan diganti. Jika Anda mengatur header_operation_type ke rewrite, Anda harus mengatur parameter ini. Ekspresi reguler didukung.

    value1

    header_destination

    String

    Tidak

    Nilai parameter baru. Jika Anda mengatur header_operation_type ke rewrite, Anda harus mengatur parameter ini.

    value123

    match_all

    String

    Tidak

    Mode pencocokan. Jika Anda mengatur header_operation_type ke rewrite, Anda harus mengatur mode pencocokan. Nilai yang valid:

    • on: mencocokkan semua nilai. Semua nilai yang cocok diganti.

    • off: hanya mencocokkan nilai pertama. Hanya nilai pertama yang cocok yang diganti.

    off

  • Contoh konfigurasi: Menambahkan header permintaan asal kustom ke nama domain yang dipercepat example.com. Nama header permintaan diatur ke `Accept-Encoding` dan nilai header permintaan diatur ke `gzip`.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "header_operation_type",
                "argValue": "add"
            }, {
                "argName": "header_name",
                "argValue": "Accept-Encoding"
            }, {
                "argName": "header_value",
                "argValue": "gzip"
            }, {
                "argName": "duplicate",
                "argValue": "off"
            }],
            "functionName": "origin_request_header"
        }],
        "DomainNames": "example.com"
    }

origin_response_header

  • Deskripsi fitur: Mengonfigurasi header respons HTTP asal. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Ubah header respons inbound. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

  • ID Fitur (FunctionID/FuncId): 229.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    header_operation_type

    String

    Ya

    Operasi header respons. Nilai yang valid:

    • add: Menambahkan item.

    • Delete: Menghapus item.

    • To modify is to make a change.

    • Replace.

    add

    header_name

    String

    Ya

    Nama header respons.

    Cache-Control

    header_value

    String

    Tidak

    Nilai header respons. Anda dapat mengonfigurasi beberapa nilai untuk parameter header respons. Pisahkan beberapa nilai dengan koma (,).

    no-cache

    duplicate

    String

    Tidak

    Menentukan apakah akan mengizinkan penambahan header respons dengan nama yang sama. Jika Anda mengatur header_operation_type ke add, Anda harus menentukan apakah duplikat diizinkan. Nilai yang valid:

    • on: mengizinkan duplikat.

    • off: tidak mengizinkan duplikat.

    off

    header_source

    String

    Tidak

    Nilai parameter yang akan diganti. Jika Anda mengatur header_operation_type ke rewrite, Anda harus mengatur parameter ini. Ekspresi reguler didukung.

    value1

    header_destination

    String

    Tidak

    Nilai parameter baru. Jika Anda mengatur header_operation_type ke rewrite, Anda harus mengatur parameter ini.

    value123

    match_all

    String

    Tidak

    Mode pencocokan. Jika Anda mengatur header_operation_type ke rewrite, Anda harus mengatur mode pencocokan. Nilai yang valid:

    • on: mencocokkan semua nilai. Semua nilai yang cocok diganti.

    • off: hanya mencocokkan nilai pertama. Hanya nilai pertama yang cocok yang diganti.

    off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "header_operation_type",
                "argValue": "add"
            }, {
                "argName": "header_name",
                "argValue": "Cache-Control"
            }, {
                "argName": "header_value",
                "argValue": "no-cache"
            }, {
                "argName": "duplicate",
                "argValue": "off"
            }],
            "functionName": "origin_response_header"
        }],
        "DomainNames": "example.com"
    }

back_to_origin_url_rewrite

  • Deskripsi fitur: Menulis ulang URI asal. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Tulis ulang URI asal. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

  • ID Fitur (FunctionID/FuncId): 225.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    source_url

    String

    Ya

    URI yang akan ditulis ulang.

    ^/hello$

    target_url

    String

    Ya

    URI tujuan.

    /hello/test

    flag

    String

    Tidak

    Aturan eksekusi untuk operasi penulisan ulang. Nilai yang valid:

    • Kosong: Jika parameter ini tidak diatur, aturan penulisan ulang berikutnya terus dieksekusi setelah aturan saat ini dieksekusi.

    • break: Setelah aturan saat ini dieksekusi, aturan penulisan ulang berikutnya tidak lagi dieksekusi.

    • enhance_break: Mirip dengan break, tetapi memproses permintaan dengan parameter dan juga berlaku untuk stream live FLV.

    break

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "flag",
                "argValue": "break"
            }, {
                "argName": "source_url",
                "argValue": "^/hello$"
            }, {
                "argName": "target_url",
                "argValue": "/hello/test"
            }],
            "functionName": "back_to_origin_url_rewrite"
        }],
        "DomainNames": "example.com",
    }

back_to_origin_argument_rewrite

  • Deskripsi fitur: Menulis ulang parameter asal. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Tulis ulang parameter asal. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

    Catatan

    Penulisan ulang parameter asal memodifikasi parameter kueri dari URL permintaan asal. Anda dapat mengonfigurasi beberapa aturan penulisan ulang. Prioritas tindakan penulisan ulang adalah sebagai berikut: Add > Delete > Reserve Only > Modify. Jika aturan penulisan ulang yang berbeda berlaku untuk parameter yang sama, hanya aturan dengan prioritas tertinggi yang berlaku.

  • ID Fitur (FunctionID/FuncId): 224.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    delete_argument

    String

    Tidak

    Daftar parameter yang akan dihapus. Pisahkan beberapa parameter dengan spasi.

    code1

    save_argument

    String

    Tidak

    Daftar parameter yang akan dipertahankan. Pisahkan beberapa parameter dengan spasi. Hanya parameter yang tercantum yang dipertahankan. Tindakan tambah dan hapus parameter masih berlaku.

    Kosong

    ignore_all_argument

    String

    Tidak

    Menentukan apakah akan mengabaikan semua parameter. Nilai yang valid:

    • on: mengabaikan semua parameter. Hanya fitur tambah parameter yang tetap efektif. Fitur hapus, pertahankan hanya, dan ubah parameter menjadi tidak efektif.

    • off (default): tidak mengabaikan semua parameter. Fitur pertahankan, tambah, dan hapus parameter tetap efektif.

    on

    add_argument

    String

    Tidak

    Parameter yang akan ditambahkan. Ini memiliki prioritas tertinggi. Pisahkan beberapa parameter dengan spasi.

    value=123

    modify_argument

    String

    Tidak

    Parameter yang akan diubah. Ini memiliki prioritas terendah. Jika parameter dihapus, parameter tersebut tidak dipertahankan. Pisahkan beberapa parameter dengan spasi.

    value=321

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan penulisan ulang parameter asal. Nilai yang valid:

    • on: mengaktifkan fitur.

    • off: menonaktifkan fitur.

    on

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "delete_argument",
                "argValue": ""
            }, {
                "argName": "save_argument",
                "argValue": ""
            }, {
                "argName": "add_argument",
                "argValue": ""
            }, {
                "argName": "modify_argument",
                "argValue": ""
            }, {
                "argName": "ignore_all_argument",
                "argValue": "on"
            }, {
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "back_to_origin_argument_rewrite"
        }],
        "DomainNames": "example.com"
    }

aws_s3_bucket

  • Deskripsi fitur: Mengonfigurasi bucket Amazon S3 untuk penandatanganan. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

  • ID Fitur (FunctionID/FuncId): 186.

  • Deskripsi parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Contoh

    enabled

    String

    Ya

    Aktifkan autentikasi bucket Amazon S3:

    • L2 diaktifkan.

    • off: menonaktifkan fitur.

    l2

    bucketname

    String

    Tidak

    Nama bucket Amazon S3.

    /

    accesskey

    String

    Ya

    AWS AccessKey.

    123456789

    secretkey

    String

    Ya

    AWS SecretKey.

    12345678

    region

    String

    Ya

    Wilayah penyimpanan Amazon S3.

    us-east-2

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enabled",
                "argValue": "l2"
            }, {
                "argName": "accesskey",
                "argValue": "123456789"
            }, {
                "argName": "secretkey",
                "argValue": "123456789"
            }, {
                "argName": "region",
                "argValue": "us-east-2"
            }],
            "functionName": "aws_s3_bucket"
        }],
        "DomainNames": "example.com"
    }

origin_certificate_verification

  • Deskripsi fitur: Mengonfigurasi verifikasi sertifikat asal (daftar putih SNI). Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi daftar putih Common Name. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

  • ID Fitur (FunctionID/FuncId): 223.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    enabled

    String

    Ya

    Menentukan apakah akan mengaktifkan verifikasi sertifikat asal. Nilai yang valid:

    • on: mengaktifkan fitur.

    • off: menonaktifkan fitur.

    on

    common_name_whitelist

    String

    Tidak

    Daftar nama domain yang masuk daftar putih untuk sertifikat. Anda dapat mengonfigurasi beberapa nama domain. Pisahkan dengan koma (,). Sertifikat yang cocok dengan nama domain dalam daftar putih ini dapat lolos verifikasi.

    example.com

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "common_name_whitelist",
                "argValue": "example.com"
            }],
            "functionName": "origin_certificate_verification"
        }],
        "DomainNames": "example.com"
    }

origin_dns_host

  • Deskripsi fitur: Mengonfigurasi asal bersyarat. Anda dapat menggunakan fitur ini dengan fitur mesin aturan (fungsi: condition, ID fitur: 250) untuk mengalihkan permintaan ke server asal tertentu berdasarkan informasi seperti jalur, parameter URL, dan header permintaan dalam permintaan pengguna. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

  • Prasyarat: Sebelum mengonfigurasi asal bersyarat, Anda harus membuat setidaknya satu kondisi aturan untuk mesin aturan. Saat mengonfigurasi asal bersyarat, Anda harus mengaitkannya dengan kondisi aturan. Untuk informasi selengkapnya, lihat Mesin aturan. Jika Anda tidak mengaitkan konfigurasi asal bersyarat dengan kondisi aturan, semua lalu lintas asal DCDN diarahkan ke URL asal tunggal ini. Hal ini menggagalkan tujuan mengontrol URL asal dengan kondisi aturan.

  • Konflik fitur: Fitur asal bersyarat bertentangan dengan fitur asal lanjutan (fungsi: advanced_origin, ID fitur: 235). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur telah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Anda dapat memanggil operasi DeleteDcdnSpecificConfig untuk menghapus konfigurasi tertentu untuk nama domain.

  • ID Fitur (FunctionID/FuncId): 212.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    ali_origin_dns_host

    String

    Ya

    Nama domain yang digunakan untuk kueri DNS selama pengambilan asal.

    example.com

  • Contoh konfigurasi: Atur `parentid` untuk merujuk kondisi aturan yang telah dibuat menggunakan fitur mesin aturan (fungsi: condition, ID fitur: 250). Referensi dibuat melalui `configid` yang dihasilkan saat konfigurasi ditambahkan. Hal ini memastikan bahwa ketika permintaan pengguna memenuhi kondisi aturan ini, permintaan tersebut dialihkan ke URL asal yang ditentukan.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ali_origin_dns_host",
                "argValue": "example.com"
            }],
            "functionName": "origin_dns_host",
            "parentId":30119730104****
        }],
        "DomainNames": "example.com"
    }

origin_host

  • Deskripsi fitur: Mengonfigurasi host asal untuk server asal tertentu. Anda dapat mengatur host asal tertentu untuk server asal tertentu. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

  • ID Fitur (FunctionID/FuncId): 242.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    origin

    String

    Ya

    URL asal tertentu. Anda juga dapat tidak menentukannya dengan mengatur parameter origin ke all, yang merepresentasikan semua server asal.

    example.com

    host

    String

    Ya

    Host tertentu. Anda juga dapat tidak menentukannya dengan mengatur parameter host ke ali_follow_origin, yang berarti nilai host mengikuti URL asal.

    host.example.com

  • Contoh konfigurasi 1: Saat permintaan pengguna dialihkan ke server asal example.com, nilai `host` yang digunakan adalah host.example.com.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "example.com"
            }, {
                "argName": "host",
                "argValue": "host.example.com"
            }],
            "functionName": "origin_host"
        }],
        "DomainNames": "example.com"
    }
  • Contoh konfigurasi 2: Permintaan pengguna yang dialihkan ke semua server asal (direpresentasikan oleh `all`) menggunakan nilai `host` yang sama host.example.com.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "all"
            }, {
                "argName": "host",
                "argValue": "host.example.com"
            }],
            "functionName": "origin_host"
        }],
        "DomainNames": "example.com"
    }
  • Contoh konfigurasi 3: Untuk permintaan pengguna yang dialihkan ke semua server asal (direpresentasikan oleh `all`), nilai `host` mengikuti URL asal (direpresentasikan oleh ali_follow_origin).

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "all"
            }, {
                "argName": "host",
                "argValue": "ali_follow_origin"
            }],
            "functionName": "origin_host"
        }],
        "DomainNames": "example.com"
    }

ali_origin_port_scheme

  • Deskripsi fitur: Mengonfigurasi port dan protokol asal. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

  • ID Fitur (FunctionID/FuncId): 276.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    port

    String

    Ya

    Port asal.

    Catatan

    Jika Anda mengatur scheme ke follow, Anda harus menggunakan format http:80|https:443.

    80

    scheme

    String

    Ya

    Protokol asal. Anda dapat menyesuaikan protokol asal. Nilai yang valid: http, https, follow, https_sm, dan follow_sm.

    • http: Pengambilan asal dilakukan melalui HTTP.

    • https: Pengambilan asal dilakukan melalui HTTPS dengan algoritma internasional.

    • follow: Alibaba Cloud CDN mengikuti protokol, HTTP atau HTTPS, yang digunakan oleh klien. Saat protokol HTTPS digunakan, hanya algoritma Rivest-Shamir-Adleman (RSA) yang didukung.

      • Jika klien menggunakan HTTP, pengambilan asal juga menggunakan HTTP.

      • Klien berkomunikasi menggunakan protokol HTTPS.

        • Jika klien menggunakan algoritma internasional, pengambilan asal menggunakan HTTPS dengan algoritma internasional.

        • Jika klien menggunakan algoritma kriptografi Tiongkok, pengambilan asal menggunakan HTTPS dengan algoritma internasional.

    • https_sm: Pengambilan asal dilakukan melalui HTTPS dengan algoritma kriptografi Tiongkok.

    • follow_sm: Layanan mengikuti protokol, HTTP atau HTTPS, yang digunakan oleh klien. Algoritma RSA dan SM didukung.

      • Klien menggunakan protokol HTTP untuk pengambilan asal.

      • Klien menggunakan protokol HTTPS.

        • Jika klien menggunakan algoritma internasional, pengambilan asal menggunakan HTTPS dan algoritma internasional.

        • Jika klien menggunakan algoritma kriptografi Tiongkok, pengambilan asal menggunakan HTTPS dan algoritma kriptografi Tiongkok.

    Catatan

    Algoritma internasional adalah algoritma enkripsi standar internasional. Algoritma kriptografi Tiongkok adalah algoritma enkripsi domestik yang disertifikasi oleh Administrasi Kriptografi Negara Tiongkok.

    http

  • Contoh konfigurasi 1: Mengatur protokol asal ke `http` dan port asal ke 80.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "port",
                "argValue": "80"
            }, {
                "argName": "scheme",
                "argValue": "http"
            }],
            "functionName": "ali_origin_port_scheme"
        }],
        "DomainNames": "example.com"
    }
  • Contoh konfigurasi 2: Protokol asal mengikuti protokol yang digunakan oleh permintaan pengguna. Saat pengambilan asal dilakukan melalui HTTP, permintaan dialihkan ke port 80 server asal. Saat pengambilan asal dilakukan melalui HTTPS, permintaan dialihkan ke port 443 server asal.

    {
    "Functions":[{
    "functionArgs": [{
    "argName": "port",
    "argValue": "http:80|https:443"
      }, {
    "argName": "scheme",
    "argValue": "follow"
      }],
      "functionName":"ali_origin_port_scheme"
    }],
      "DomainNames":"example.com"
    }

origin_sni

  • Deskripsi fitur: Mengonfigurasi SNI asal tertentu. Anda dapat mengatur SNI asal tertentu untuk server asal tertentu. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi SNI asal tertentu. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

  • ID Fitur (FunctionID/FuncId): 262.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    origin

    String

    Ya

    URL asal. Anda juga dapat tidak menentukannya dengan mengatur parameter origin ke all.

    example.com

    sni_host

    String

    Ya

    Nilai host SNI:

    • Anda dapat mengaturnya ke bidang statis, seperti example.org.

    • Untuk mengikuti URL asal sebagai SNI, atur ke ali_follow_origin.

    • Untuk mengikuti host asal sebagai SNI, atur ke ali_follow_host.

    example.org

    keepalive_sni

    String

    Tidak

    Menentukan apakah akan mengaktifkan pencocokan SNI untuk koneksi persisten. Nilai yang valid:

    • on: mengaktifkan fitur.

    • off: menonaktifkan fitur.

    Catatan

    Jika Anda mengaktifkan fitur ini, koneksi persisten yang berbeda digunakan untuk SNI asal yang berbeda.

    /

  • Contoh konfigurasi 1: Saat permintaan pengguna dialihkan ke server asal origin.example.com, nilai SNI yang digunakan adalah host.example.com.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "origin.example.com"
            }, {
                "argName": "sni_host",
                "argValue": "host.example.com"
            }],
            "functionName": "origin_sni"
        }],
        "DomainNames": "example.com"
    }
  • Contoh konfigurasi 2: Permintaan pengguna yang dialihkan ke semua server asal (direpresentasikan oleh all) menggunakan nilai SNI yang sama host.example.com.

    {
    "Functions": [{
    "functionArgs": [{
    "argName": "origin",
    "argValue": "all"
      }, {
    "argName": "sni_host",
    "argValue": "host.example.com"
    }],
    "functionName":"origin_sni"
     }],
     "DomainNames":"example.com"
    }
  • Contoh konfigurasi 3: Untuk permintaan pengguna yang dialihkan ke semua server asal (direpresentasikan oleh all), nilai SNI mengikuti URL asal (direpresentasikan oleh nilai parameter ali_follow_origin).

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "all"
            }, {
                "argName": "sni_host",
                "argValue": "ali_follow_origin"
            }],
            "functionName": "origin_sni"
        }],
        "DomainNames": "example.com"
    }
  • Contoh konfigurasi 4: Untuk permintaan pengguna yang dialihkan ke semua server asal (direpresentasikan oleh all), nilai SNI mengikuti host asal (direpresentasikan oleh nilai parameter ali_follow_host).

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin",
                "argValue": "all"
            }, {
                "argName": "sni_host",
                "argValue": "ali_follow_host"
            }],
            "functionName": "origin_sni"
        }],
        "DomainNames": "example.com"
    }

source_group

  • Deskripsi fitur: Mengonfigurasi pengaturan grup asal. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

  • ID Fitur (FunctionID/FuncId): 294.

  • Deskripsi parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Contoh

    source_group_name

    String

    Ya

    Nama grup asal. Dapat berisi huruf kecil, angka, dan garis bawah (_). Panjang maksimum adalah 128 byte.

    example_origin

    source_info

    String

    Ya

    Informasi tentang server asal. Format: Alamat Server Asal_Prioritas_Bobot_Port. Gunakan garis bawah (_) untuk memisahkan nilai parameter yang berbeda. Gunakan koma (,) untuk memisahkan beberapa server asal.

    • Alamat Server Asal: Mendukung IPv4, IPv6, dan nama domain.

    • Prioritas: Nilai yang valid: 1 hingga 65535. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi.

    • Bobot: Nilai yang valid: 1 hingga 100. DCDN mendistribusikan permintaan ke server asal yang berbeda berdasarkan bobotnya.

    • Port: Nilai yang valid: 1 hingga 65535.

    • Sumber tunggal: 192.168.0.1_10_33_80

    • Beberapa sumber: 192.168.0.1_10_33_80, 192.0.2.1_10_67_80

    retry_times

    Integer

    Tidak

    Jumlah upaya pengambilan asal ulang.

    3

    retry_status_rule

    Integer

    Tidak

    Kode status yang memicu pengambilan asal ulang. Saat ini, hanya lima nilai berikut yang didukung: 4xx, 5xx, 404, 404-or-5xx, dan 4xx-or-5xx. Anda dapat mengonfigurasi salah satunya.

    404-or-5xx

    failback_source

    String

    Tidak

    Gunakan informasi asal dasar untuk cadangan. Nilai yang valid:

    • on: Jika semua server asal dalam grup asal tidak tersedia, URL asal dalam Informasi Dasar - Informasi Asal digunakan.

    • off: Jika semua server asal dalam grup asal tidak tersedia, kode status 5xx yang menunjukkan bahwa server asal tidak tersedia dikembalikan langsung ke klien.

    on

    Catatan

    Logika pengambilan asal ulang:

    • Jumlah pengulangan: Jumlah kali mencoba pengambilan asal ulang.

      • Pengulangan hanya dilakukan antara alamat IP yang berbeda dalam grup asal yang sama.

      • Jumlah maksimum pengulangan sebenarnya dibatasi oleh jumlah alamat IP yang tersedia dalam grup asal yang sama.

      • Jika `retry_times` tidak dikonfigurasi, jumlah pengulangan default adalah minimum antara 3 dan jumlah alamat IP asal yang tersedia.

      • Jika `retry_times` dikonfigurasi, jumlah pengulangan adalah minimum antara nilai yang dikonfigurasi dan jumlah alamat IP asal yang tersedia.

    • Kode status untuk pengulangan: Node melakukan pengulangan saat menerima kode status tertentu.

      • Jika `retry_status_rule` tidak dikonfigurasi, pengulangan dipicu secara default saat server asal merespons dengan kode status 5xx.

      • Jika `retry_status_rule` dikonfigurasi, pengulangan failover dipicu berdasarkan kode status yang dikonfigurasi. Saat ini, hanya lima nilai berikut yang didukung: 4xx, 5xx, 404, 404-or-5xx, dan 4xx-or-5xx. Anda dapat mengonfigurasi salah satunya.

      • Setelah Anda mengonfigurasi `retry_status_rule`, kode status 5xx default tetap berlaku. Misalnya, jika Anda mengonfigurasi `404`, node DCDN melakukan pengulangan saat menerima kode status 404 atau 5xx.

    • Urutan pengambilan asal ulang: Pengulangan dilakukan dalam urutan prioritas menurun dari alamat IP dalam grup asal yang sama.

    • Skenario waktu habis pengambilan asal: Saat server asal secara aktif merespons dengan kode status pengulangan, node DCDN melakukan pengulangan permintaan. Jika server asal tidak merespons dengan kode status pengulangan, node DCDN mengikuti proses penanganan waktu habis dan melakukan pengulangan permintaan setelah periode waktu habis tercapai.

      • Waktu habis koneksi TCP asal: 10 detik.

      • Waktu habis penulisan asal: 30 detik. Ini adalah waktu habis untuk menulis konten setelah koneksi dibuat dengan server asal.

      • Waktu habis pembacaan asal: 30 detik. Waktu habis ini terjadi jika server asal gagal mengirim konten lengkap yang diminta oleh node DCDN dalam periode yang ditentukan.

    • Logika probing asal:

      • Koneksi Layer 4 abnormal: Jika node DCDN gagal membuat koneksi Layer 4 dengan alamat IP asal, alamat IP asal tersebut ditambahkan ke tabel mati. Permintaan pengambilan asal berikutnya tidak mengakses alamat IP asal ini. Node DCDN kemudian melakukan probing alamat IP asal tersebut di Layer 4 setiap 5 detik. Jika koneksi berhasil dibuat, alamat IP asal dipulihkan ke daftar yang tersedia.

      • Koneksi Layer 4 normal: Jika node DCDN memiliki koneksi Layer 4 normal dengan alamat IP asal tetapi menerima kode status pengulangan (seperti 5xx) dari server asal, logika pengulangan dipicu. Namun, alamat IP asal tetap berada dalam daftar yang tersedia, dan permintaan akses berikutnya masih dikirim ke server asal ini berdasarkan bobotnya. Artinya, jika koneksi Layer 4 normal, pengecualian Layer 7 tidak secara otomatis memblokir alamat IP asal. Untuk secara aktif memblokir alamat IP asal, Anda harus mengonfigurasi fitur pemantauan asal Layer 7 dan pemeriksaan kesehatan.

  • Contoh konfigurasi:

    {
    "Functions":[{
     "functionArgs":[{
     "argName":"source_group_name",
     "argValue":"test_yidong"
    },{
     "argName":"source_info",
      "argValue":"192.168.0.1_10_33_80,192.0.2.1_10_67_80"
    },{
    "argName":"retry_times",
    "argValue":"3"
     },{
    "argName":"retry_status_rule",
    "argValue":"404,502"
    },{
    "argName":"failback_source",
      "argValue":"on"
    }],
    "functionName":"source_group"
    }],
     "DomainNames":"example.com"
    }

ipv6_origin

  • Deskripsi fitur: Mengonfigurasi pengambilan asal melalui IPv6. Untuk informasi selengkapnya tentang fitur ini, lihat topik konfigurasi konsol Konfigurasi pengambilan asal melalui IPv6. Fitur ini hanya tersedia untuk pengguna yang ditambahkan ke daftar putih. Untuk menggunakan fitur ini, kirim tiket.

  • ID Fitur (FunctionID/FuncId): 265

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan pengambilan asal melalui IPv6.

    • on: Mengaktifkan fitur.

    • off: Menonaktifkan fitur.

    Catatan

    Jika fitur ini diaktifkan, DCDN menyediakan layanan IPv6 untuk pengambilan asal.

    • Jika titik kehadiran (PoP) DCDN dan server asal memiliki alamat IPv6 aktif, DCDN membuat koneksi melalui IPv6.

    • DCDN membuat koneksi melalui IPv4 dalam skenario berikut:

      • PoP DCDN tidak memiliki alamat IPv6 aktif.

      • Server asal tidak memiliki alamat IPv6 aktif.

      • Baik PoP DCDN maupun server asal tidak memiliki alamat IPv6 aktif.

    on

    follow

    String

    Ya

    Menentukan apakah permintaan kembali-ke-asal mengikuti versi protokol IP dari permintaan klien.

    • on: Fitur diaktifkan.

    • off: Fitur dinonaktifkan.

    Catatan

    Saat fitur ini diaktifkan, permintaan kembali-ke-asal DCDN mengikuti versi protokol IP dari permintaan klien.

    • Jika permintaan klien menggunakan IPv6, DCDN memprioritaskan server asal IPv6 untuk permintaan kembali-ke-asal. Jika tidak ada server asal IPv6 yang tersedia, DCDN menggunakan server asal IPv4.

    • Jika permintaan klien menggunakan IPv4, DCDN memprioritaskan server asal IPv4 untuk permintaan kembali-ke-asal. Jika tidak ada server asal IPv4 yang tersedia, DCDN menggunakan server asal IPv6.

    on

    ipv6_v4_mix_used

    String

    Tidak

    Menentukan apakah akan mengaktifkan fitur Polling Alamat Asal IPv4/IPv6.

    • on: Diaktifkan.

    • off: Dinonaktifkan.

    Catatan
    • Fitur Polling Alamat Asal IPv4/IPv6 saling eksklusif dengan fitur Pengambilan Asal melalui IPv6 dan fitur Ikuti Protokol IP Klien untuk Pengambilan Asal. Jika Polling Alamat Asal IPv4/IPv6 diaktifkan, kedua fitur lainnya dinonaktifkan.

    • Fitur ini menggunakan metode polling untuk mengirim permintaan pengambilan asal ke semua alamat server asal IPv4 dan IPv6 yang dikonfigurasi. Proses ini berlaku untuk semua permintaan klien, terlepas dari apakah klien menggunakan IPv4 atau IPv6.

    • Jika bobot dikonfigurasi untuk alamat IPv4 dan IPv6, permintaan pengambilan asal didistribusikan sesuai dengan bobot tersebut.

    Off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            },{
                "argName": "follow",
                "argValue": "on"
            }],
            "functionName": "ipv6_origin"
        }],
        "DomainNames": "example.com"
    }

cos_auth

  • Deskripsi: Mengonfigurasi bucket autentikasi untuk Tencent Cloud Object Storage (COS). Fitur ini hanya tersedia untuk pengguna yang masuk daftar putih. Untuk meminta akses, kirim tiket.

  • ID Fungsi (FunctionID/FuncId): 288.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Nilai contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan bucket autentikasi untuk Tencent Cloud COS.

    • on: Aktifkan.

    • off: Nonaktifkan.

    on

    cos_valid_period

    String

    Tidak

    Periode validitas tanda tangan autentikasi dalam detik. Nilai default adalah 3600 detik.

    /

    cos_secret_id

    String

    Ya

    ID autentikasi dari Tencent Cloud.

    123456789

    cos_secret_key

    String

    Ya

    Kunci autentikasi dari Tencent Cloud.

    12345678

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "cos_secret_id",
                "argValue": "123456789"
            }, {
                "argName": "cos_secret_key",
                "argValue": "123456789"
            }],
            "functionName": "cos_auth"
        }],
        "DomainNames": "example.com"
    }

oss_auth

  • Deskripsi fitur: Mengonfigurasi informasi autentikasi untuk bucket Layanan Penyimpanan Objek (OSS) yang digunakan untuk pengambilan asal DCDN.

  • ID Fungsi (FunctionID/FuncId): 10.

  • Catatan: Platform secara otomatis menambahkan konfigurasi `oss_auth` saat Anda mengatur bucket OSS sebagai asal untuk nama domain yang dipercepat. Jangan menambahkan atau menghapus konfigurasi ini secara manual. Jika konfigurasi ini dihapus, pembebasan tagihan untuk lalu lintas asal DCDN tidak dapat diterapkan. Selain itu, jika autentikasi bucket pribadi diaktifkan, pengambilan asal dari DCDN ke bucket OSS pribadi gagal.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Nilai contoh

    oss_bucket_id

    String

    Ya

    Nama domain publik bucket OSS.

    dcdn-test.oss-cn-hongkong.aliyuncs.com

    oss_pri_buckets

    String

    Ya

    Nama domain publik bucket OSS dan nama bucket yang sesuai.

    dcdn-test.oss-cn-hongkong.aliyuncs.com|dcdn-test

  • Contoh konfigurasi:

    {
        "Functions": [
                {
                  "ArgValue": "dcdn-test.oss-cn-hongkong.aliyuncs.com",
                  "ArgName": "oss_bucket_id"
                },
                {
                  "ArgValue": "dcdn-test.oss-cn-hongkong.aliyuncs.com|dcdn-test",
                  "ArgName": "oss_pri_buckets"
                }
              ],
            "functionName": "oss_auth"
        }],
        "DomainNames": "example.com"
    }

Konfigurasi cache

filetype_based_ttl_set

  • Menentukan waktu kedaluwarsa cache untuk file berdasarkan ekstensi file. Untuk informasi selengkapnya, lihat Konfigurasi waktu-ke-hidup cache.

  • ID Fungsi (FunctionID/FuncId): 6.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    ttl

    Integer

    Ya

    Durasi cache dalam detik. Nilainya harus bilangan bulat dari 1 hingga 99999999, yaitu sedikit lebih dari 3 tahun.

    500000

    file_type

    String

    Ya

    Jenis file. Parameter ini peka huruf besar/kecil. Pisahkan beberapa jenis file dengan koma (,). Contoh: jpg,txt.

    jpg

    weight

    Integer

    Tidak

    Bobot. Nilai yang valid: 1 hingga 99.

    Catatan

    Nilai default adalah 1. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi.

    1

    swift_origin_cache_high

    String

    Tidak

    Memprioritaskan kebijakan cache server asal. Jika Anda mengatur parameter ini ke `on`, kebijakan cache server asal didahulukan saat server asal mengembalikan header terkait cache, seperti `Cache-Control` dan `Pragma`. Nilai yang valid:

    • `on`: diaktifkan

    • `off` (default): dinonaktifkan

    off

    swift_no_cache_low

    String

    Tidak

    Abaikan header respons `no-cache` dari server asal. Jika Anda mengatur parameter ini ke `on`, header respons `no-cache` berikut dari server asal diabaikan.

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    Nilai yang valid:

    • `on`: diaktifkan

    • `off` (default): dinonaktifkan

    off

    swift_follow_cachetime

    String

    Tidak

    Izinkan klien mengikuti kebijakan cache DCDN. Jika Anda mengatur parameter ini ke `on`, kebijakan cache DCDN akhir dikembalikan ke klien. Nilai yang valid:

    • `on`: diaktifkan

    • `off` (default): dinonaktifkan

    off

    force_revalidate

    String

    Tidak

    Paksa validasi konten saat TTL adalah 0. Nilai yang valid:

    • `on`: diaktifkan. Saat TTL adalah 0, konten di-cache pada titik kehadiran (POPs), dan setiap permintaan memerlukan pengambilan asal untuk memvalidasi konten yang di-cache.

    • `off` (default): dinonaktifkan. Saat TTL adalah 0, konten tidak di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk mengambil konten.

    off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "file_type",
                "argValue": "jpg"
            }, {
                "argName": "weight",
                "argValue": "1"
            }, {
                "argName": "ttl",
                "argValue": "500000"
            }, {
                "argName": "swift_origin_cache_high",
                "argValue": "off"
            }, {
                "argName": "swift_no_cache_low",
                "argValue": "off"
            }, {
                "argName": "swift_follow_cachetime",
                "argValue": "off"
            },{
                "argName": "force_revalidate",
                "argValue": "off"
            }],
            "functionName": "filetype_based_ttl_set"
        }],
        "DomainNames": "example.com"
    }
    

path_based_ttl_set

  • Deskripsi: Mengonfigurasi waktu kedaluwarsa cache untuk folder. Untuk informasi selengkapnya, lihat Konfigurasi waktu kedaluwarsa cache.

  • ID Fungsi (FunctionID/FuncId): 7.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    ttl

    Integer

    Ya

    Durasi cache dalam detik. Nilainya harus bilangan bulat dari 1 hingga 99999999, yaitu sedikit lebih dari 3 tahun.

    500000

    path

    String

    Ya

    Jalur folder. Jalur harus dimulai dengan garis miring (/).

    /example/demo

    weight

    Integer

    Tidak

    Bobot. Nilai yang valid: 1 hingga 99.

    Catatan

    Nilai default adalah 1. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi.

    1

    swift_origin_cache_high

    String

    Tidak

    Memprioritaskan kebijakan cache server asal. Jika Anda mengatur parameter ini ke `on`, kebijakan cache server asal didahulukan saat server asal mengembalikan header terkait cache, seperti `Cache-Control` dan `Pragma`. Nilai yang valid:

    • `on`: diaktifkan

    • `off` (default): dinonaktifkan

    off

    swift_no_cache_low

    String

    Tidak

    Abaikan header respons `no-cache` dari server asal. Jika Anda mengatur parameter ini ke `on`, header respons `no-cache` berikut dari server asal diabaikan.

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    Nilai yang valid:

    • `on`: diaktifkan

    • `off` (default): dinonaktifkan

    off

    swift_follow_cachetime

    String

    Tidak

    Izinkan klien mengikuti kebijakan cache DCDN. Jika Anda mengatur parameter ini ke `on`, kebijakan cache DCDN akhir dikembalikan ke klien. Nilai yang valid:

    • `on`: diaktifkan

    • `off` (default): dinonaktifkan

    off

    force_revalidate

    String

    Tidak

    Paksa validasi konten saat TTL adalah 0. Nilai yang valid:

    • `on`: diaktifkan. Saat TTL adalah 0, konten di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk memvalidasi konten yang di-cache.

    • `off` (default): dinonaktifkan. Saat TTL adalah 0, konten tidak di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk mengambil konten.

    off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "path",
                "argValue": "/example/demo"
            }, {
                "argName": "weight",
                "argValue": "1"
            }, {
                "argName": "ttl",
                "argValue": "500000"
            }, {
                "argName": "swift_origin_cache_high",
                "argValue": "off"
            }, {
                "argName": "swift_no_cache_low",
                "argValue": "off"
            }, {
                "argName": "swift_follow_cachetime",
                "argValue": "off"
            }, {
                "argName": "force_revalidate",
                "argValue": "off"
            }],
            "functionName": "path_based_ttl_set"
        }],
        "DomainNames": "example.com"
    }
    

filetype_force_ttl_code

  • Mengonfigurasi waktu kedaluwarsa cache kode status. Untuk informasi selengkapnya, lihat Konfigurasi waktu kedaluwarsa kode status.

  • ID Fungsi (FunctionID/FuncId): 63.

  • Deskripsi parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Contoh

    file_type

    String

    Ya

    Jenis file. Parameter ini peka huruf besar/kecil. Pisahkan beberapa jenis file dengan koma (,). Contoh: jpg,txt.

    jpg

    code_string

    String

    Ya

    Kode status dan durasi cache-nya dalam detik. Durasi maksimum adalah 3 tahun. Pisahkan beberapa entri dengan koma (,). Contoh: 302=0,301=0,4xx=2.

    403=10

    swift_code_origin_cache_high

    String

    Tidak

    Memprioritaskan kebijakan cache server asal. Jika Anda mengatur parameter ini ke `on`, kebijakan cache server asal didahulukan saat server asal mengembalikan header terkait cache, seperti `Cache-Control` dan `Pragma`. Nilai yang valid:

    • `on`: diaktifkan

    • `off` (default): dinonaktifkan

    off

    swift_code_no_cache_low

    String

    Tidak

    Abaikan header respons `no-cache` dari server asal. Jika Anda mengatur parameter ini ke `on`, header respons `no-cache` berikut dari server asal diabaikan.

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    Nilai yang valid:

    • `on`: diaktifkan

    • `off` (default): dinonaktifkan

    off

    swift_code_follow_cachetime

    String

    Tidak

    Izinkan klien mengikuti kebijakan cache DCDN. Jika Anda mengatur parameter ini ke `on`, kebijakan cache DCDN akhir dikembalikan ke klien. Nilai yang valid:

    • `on`: diaktifkan

    • `off` (default): dinonaktifkan

    off

    force_revalidate

    String

    Tidak

    Paksa validasi konten saat TTL adalah 0. Nilai yang valid:

    • `on`: diaktifkan. Saat TTL adalah 0, konten di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk memvalidasi konten yang di-cache.

    • `off` (default): dinonaktifkan. Saat TTL adalah 0, konten tidak di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk mengambil konten.

    off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "file_type",
                "argValue": "jpg"
            }, {
                "argName": "code_string",
                "argValue": "403=10"
            }, {
                "argName": "swift_code_origin_cache_high",
                "argValue": "off"
            }, {
                "argName": "swift_code_no_cache_low",
                "argValue": "off"
            }, {
                "argName": "swift_code_follow_cachetime",
                "argValue": "off"
            }, {
                "argName": "force_revalidate",
                "argValue": "off"
            }],
            "functionName": "filetype_force_ttl_code"
        }],
        "DomainNames": "example.com"
    }

path_force_ttl_code

  • Mengonfigurasi waktu kedaluwarsa cache kode status untuk jalur tertentu. Untuk informasi selengkapnya, lihat Konfigurasi waktu kedaluwarsa kode status.

  • ID Fungsi (FunctionID/FuncId): 65.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    path

    String

    Ya

    Jalur folder. Jalur harus dimulai dengan garis miring (/). Contoh: /image.

    /example/demo

    code_string

    String

    Ya

    Kode status dan durasi cache-nya dalam detik. Nilainya harus bilangan bulat dari 1 hingga 99999999, yaitu sedikit lebih dari 3 tahun. Pisahkan beberapa entri dengan koma (,). Contoh: 302=0,301=0,4xx=2.

    403=10,404=15

    swift_code_origin_cache_high

    String

    Tidak

    Memprioritaskan kebijakan cache server asal. Jika Anda mengatur parameter ini ke `on`, kebijakan cache server asal didahulukan saat server asal mengembalikan header terkait cache, seperti `Cache-Control` dan `Pragma`. Nilai yang valid:

    • `on`: diaktifkan

    • `off` (default): dinonaktifkan

    off

    swift_code_no_cache_low

    String

    Tidak

    Abaikan header respons `no-cache` dari server asal. Jika Anda mengatur parameter ini ke `on`, header respons `no-cache` berikut dari server asal diabaikan.

    • Cache-Control: no-store

    • Cache-Control: no-cache

    • Cache-Control: max-age=0

    • Pragma: no-cache

    Nilai yang valid:

    • `on`: diaktifkan

    • `off` (default): dinonaktifkan

    off

    swift_code_follow_cachetime

    String

    Tidak

    Izinkan klien mengikuti kebijakan cache DCDN. Jika Anda mengatur parameter ini ke `on`, kebijakan cache DCDN akhir dikembalikan ke klien. Nilai yang valid:

    • `on`: diaktifkan

    • `off` (default): dinonaktifkan

    off

    force_revalidate

    String

    Tidak

    Paksa validasi konten saat TTL adalah 0. Nilai yang valid:

    • `on`: diaktifkan. Saat TTL adalah 0, konten di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk memvalidasi konten yang di-cache.

    • `off` (default): dinonaktifkan. Saat TTL adalah 0, konten tidak di-cache pada POPs, dan setiap permintaan memerlukan pengambilan asal untuk mengambil konten.

    off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "path",
                "argValue": "/example/demo"
            }, {
                "argName": "code_string",
                "argValue": "403=10,404=15"
            }, {
                "argName": "swift_code_origin_cache_high",
                "argValue": "off"
            }, {
                "argName": "swift_code_no_cache_low",
                "argValue": "off"
            }, {
                "argName": "swift_code_follow_cachetime",
                "argValue": "off"
            }, {
                "argName": "force_revalidate",
                "argValue": "off"
            }],
            "functionName": "path_force_ttl_code"
        }],
        "DomainNames": "example.com"
    }
    

default_ttl_code

  • Deskripsi: Mengatur waktu kedaluwarsa cache kode status (prioritas asal).

  • ID Fungsi (FunctionID/FuncId): 207.

  • Deskripsi parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Contoh

    default_ttl_code

    String

    Ya

    Kode status dan durasi cache-nya dalam detik. Nilainya harus bilangan bulat dari 1 hingga 99999999, yaitu sedikit lebih dari 3 tahun. Pisahkan beberapa kode status dengan koma (,).

    4xx=3,200=3600,5xx=1

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "default_ttl_code",
                "argValue": "4xx=3,200=3600,5xx=1"
            }],
            "functionName": "default_ttl_code"
        }],
        "DomainNames": "example.com"
    }

set_resp_header

  • Deskripsi: Mengonfigurasi header respons HTTP kustom. Untuk informasi selengkapnya, lihat Ubah header respons outbound.

  • ID Fungsi (FunctionID/FuncId): 27.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    key

    String

    Ya

    Header respons.

    Cache-Control

    value

    String

    Ya

    Nilai header respons. Pisahkan beberapa nilai dengan koma (,).

    Catatan

    Untuk menghapus header respons, atur nilainya ke null.

    no-cache

    header_operation_type

    String

    Tidak

    Operasi yang dilakukan pada header permintaan. Nilainya adalah:

    • add: Menambahkan entri.

    • Delete: hapus.

    • Modify: Untuk mengubah.

    • `rewrite`: mengganti header.

    add

    duplicate

    String

    Tidak

    Menentukan apakah akan mengizinkan penambahan header respons dengan nama yang sama. Parameter ini wajib saat Anda mengatur `header_operation_type` ke `add`. Nilai yang valid:

    • on: Duplikat diizinkan.

    • `off`: tidak diizinkan.

    off

    header_source

    String

    Tidak

    Nilai yang akan diganti. Parameter ini wajib saat Anda mengatur `header_operation_type` ke `rewrite`. Nilainya bisa berupa ekspresi reguler.

    value1

    header_destination

    String

    Tidak

    Nilai baru. Parameter ini wajib saat Anda mengatur `header_operation_type` ke `rewrite`.

    value123

    match_all

    String

    Tidak

    Pola pencocokan. Parameter ini wajib saat Anda mengatur `header_operation_type` ke `rewrite`. Nilai yang valid:

    • `on`: cocokkan semua. Semua nilai yang cocok diganti.

    • `off`: cocokkan yang pertama. Hanya nilai pertama yang cocok yang diganti.

    /

    access_origin_control

    String

    Tidak

    Menentukan apakah akan mengaktifkan autentikasi lintas domain. Nilai yang valid:

    • `on`: POP DCDN mengautentikasi permintaan pengguna lintas domain.

    • `off`: nonaktifkan fitur ini.

    /

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "header_operation_type",
                "argValue": "add"
            }, {
                "argName": "key",
                "argValue": "Cache-Control"
            }, {
                "argName": "value",
                "argValue": "no-cache"
            }, {
                "argName": "duplicate",
                "argValue": "off"
            }],
            "functionName": "set_resp_header"
        }],
        "DomainNames": "example.com"
    }

error_page

  • Deskripsi: Mengonfigurasi halaman kesalahan kustom. Untuk informasi selengkapnya, lihat Konfigurasi halaman kustom.

  • ID Fungsi (FunctionID/FuncId): 15.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    error_code

    Integer

    Ya

    Kode kesalahan.

    404

    rewrite_page

    String

    Ya

    Halaman pengalihan.

    http://example.aliyundoc.com/error404.html

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "error_code",
                "argValue": "404"
            }, {
                "argName": "rewrite_page",
                "argValue": "http://example.aliyundoc.com/error404.html"
            }],
            "functionName": "error_page"
        }],
        "DomainNames": "example.com"
    }

host_redirect

  • Deskripsi fitur: Mengonfigurasi aturan penulisan ulang URI. Untuk instruksi konfigurasi konsol terperinci, lihat Konfigurasi aturan penulisan ulang URI.

  • ID Fungsi (FunctionID/FuncId): 43.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    regex

    String

    Ya

    URL yang akan ditulis ulang. Harus berupa URI yang dimulai dengan garis miring (/) dan tidak boleh mengandung protokol `http://` atau nama domain. Ekspresi reguler PCRE didukung. Contoh: ^/hello$.

    ^/hello$

    replacement

    String

    Ya

    URL tujuan. Harus berupa URI yang dimulai dengan garis miring (/) dan tidak boleh mengandung protokol `http://` atau nama domain.

    /hello/test

    flag

    String

    Tidak

    Tindakan yang dilakukan POP DCDN setelah URI ditulis ulang. Nilai yang valid:

    • Kosong: Nilai default. Artinya parameter flag tidak dilewatkan. Jika beberapa aturan dikonfigurasi dan URL permintaan cocok dengan suatu aturan, POP melanjutkan pencocokan aturan berikutnya setelah aturan saat ini dieksekusi.

    • break: Jika URL permintaan cocok dengan suatu aturan, permintaan ditulis ulang ke URL tujuan. Parameter dalam URL asli tidak dimodifikasi. Setelah aturan saat ini dieksekusi, tidak ada aturan lain yang dicocokkan.

    • redirect: Jika URL permintaan cocok dengan suatu aturan, permintaan dialihkan ke URL tujuan dengan kode status 302. POP DCDN mengembalikan URL tujuan sebagai header `Location` ke klien. Parameter dalam URL asli tidak dimodifikasi. Setelah aturan saat ini dieksekusi, aturan berikutnya masih dicocokkan.

    • enhance_break: Mirip dengan break, tetapi menulis ulang selang URL lengkap, termasuk parameternya.

    • enhance_redirect: Mirip dengan redirect, tetapi menulis ulang seluruh URL, termasuk parameternya.

    Catatan

    Metode penulisan ulang dan dukungan untuk nama domain serta protokol lainnya bervariasi berdasarkan tindakan:

    • Kosong, break, dan enhance_break langsung menulis ulang URL permintaan pengguna. Tidak mendukung penulisan ulang ke nama domain atau protokol lain, seperti menulis ulang dari HTTP ke HTTPS.

    • redirect dan enhance_redirect menggunakan pengalihan 302 untuk menulis ulang URL. Mendukung penulisan ulang ke nama domain atau protokol lain:

      • Alamat `Location` 302 dapat diatur ke nama domain yang dipercepat saat ini atau nama domain lain. Misalnya, Anda dapat menulis ulang URL dari `example.com` ke `aliyundoc.com`.

      • Alamat `Location` 302 mendukung protokol lain. Misalnya, Anda dapat menulis ulang URL dari HTTP ke HTTPS.

    redirect

    rewrite_method

    String

    Tidak

    Metode pengalihan. Kode status 302, 303, dan 307 didukung:

    • 302: Metode pengalihan default. Metode permintaan GET tidak berubah. Metode permintaan lain mungkin berubah menjadi GET.

    • 303: Metode permintaan GET tidak berubah. Metode permintaan lain berubah menjadi GET, dan isi pesan hilang.

    • 307: Metode permintaan dan isi pesan tidak berubah.

    302

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "flag",
                "argValue": "redirect"
            }, {
                "argName": "regex",
                "argValue": "^/hello$"
            }, {
                "argName": "replacement",
                "argValue": "/hello/test"
            }, {
                "argName": "rewrite_method",
                "argValue": "302"
            }],
            "functionName": "host_redirect"
        }],
        "DomainNames": "example.com"
    }

self_defined_cachekey

  • Deskripsi: Mengonfigurasi CacheKey kustom. Untuk informasi selengkapnya, lihat CacheKey Kustom.

  • ID Fungsi (FunctionID/FuncId): 227.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    uri

    Array of String

    Tidak

    Menulis ulang URI sumber dalam permintaan ke URI tujuan dan menyimpan hasilnya sebagai kunci cache.

    • `uri_to_rewrite` menentukan URI sumber.

    • `ai_uri_regex` menentukan URI tujuan.

    [{"uri_to_rewrite":"/hello","ai_uri_regex":"/hello/test"}]

    args

    Array of String

    Tidak

    Menjalankan operasi tambah, hapus, ubah, atau pertahankan pada parameter permintaan dan menyimpan hasilnya sebagai kunci cache. Nilai yang valid:

    • `args_operation_type`: menentukan jenis operasi parameter. Nilai yang didukung adalah `add`, `delete`, `modify`, dan `keep`.

    • `args`: menentukan nilai parameter untuk operasi.

    [{"args":"test=123","args_operation_type":"add"}]

    headers

    String

    Tidak

    Menambahkan beberapa header HTTP dan menambahkannya ke kunci cache. Pisahkan beberapa header HTTP dengan spasi.

    example

    variable

    Array of String

    Tidak

    Variabel kustom. Anda dapat menggunakan ekspresi reguler untuk mengekstrak bidang apa pun dari parameter permintaan, header HTTP, cookie, atau URI dalam URL permintaan, lalu menambahkan bidang tersebut ke kunci cache.

    []

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "uri",
                "argValue": [{
                    "uri_to_rewrite": "/hello",
                    "ai_uri_regex": "/hello/test"
                }]
            }, {
                "argName": "args",
                "argValue": [{
                    "args": "test=123",
                    "args_operation_type": "add"
                }]
            }, {
                "argName": "headers",
                "argValue": ""
            }, {
                "argName": "variable",
                "argValue": []
            }],
            "functionName": "self_defined_cachekey"
        }],
        "DomainNames": "example.com"
    }

rewrite_host

  • Deskripsi: Mengonfigurasi cache bersama.

  • ID Fungsi (FunctionID/FuncId): 54.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    share_host

    String

    Ya

    Nama domain tujuan yang dapat berbagi cache dengan nama domain saat ini. Konfigurasi ini tidak memodifikasi header `Host` untuk pengambilan asal. Ini hanya menggunakan nilai `share_host` untuk menghasilkan kunci cache guna mencari resource yang di-cache.

    example.com

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "share_host",
                "argValue": "example.com"
            }],
            "functionName": "rewrite_host"
        }],
        "DomainNames": "example.com"
    }

serving_stale_content

  • Deskripsi: Menyajikan konten kedaluwarsa saat server asal tidak tersedia.

  • ID Fungsi (FunctionID/FuncId): 260.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    origin_error_status_code

    String

    Tidak

    Kode status abnormal kustom dari server asal.

    • Deskripsi: Menentukan kode status asal tempat fitur ini berlaku.

    • Nilai default: Parameter ini tidak ditentukan secara default. Secara default, kesalahan asal didefinisikan sebagai waktu habis atau kode status 5xx apa pun.

    • Konfigurasi: Anda dapat memasukkan `4xx` atau `5xx` untuk pencocokan kabur, atau memasukkan kode status tertentu seperti `502` atau `504` untuk pencocokan eksak. Untuk menentukan beberapa kode status, pisahkan dengan koma (,).

    502

    extend_expiration_time

    Integer

    Tidak

    Waktu kedaluwarsa diperpanjang.

    • Deskripsi: Waktu maksimum untuk menyimpan cache kedaluwarsa setelah masa berlakunya habis.

    • Nilai default: Parameter ini tidak ditentukan secara default. Waktu kedaluwarsa diperpanjang default adalah 1 jam.

    • Konfigurasi: Masukkan bilangan bulat positif yang lebih besar dari atau sama dengan 1. Satuan: detik.

    60

    origin_first

    String

    Tidak

    Kebijakan memprioritaskan asal.

    • Deskripsi: Jika Anda mengatur parameter ini ke on, kebijakan asal diprioritaskan. Jika server asal mengembalikan file dengan kebijakan cache Cache-Control: stale-if-error=xx, waktu yang ditentukan oleh parameter `stale-if-error` digunakan sebagai waktu kedaluwarsa diperpanjang.

    • Nilai default: Parameter ini tidak ditentukan secara default. Ini setara dengan `off`. Dalam hal ini, waktu kedaluwarsa diperpanjang ditentukan oleh parameter `extend_expiration_time`.

    • Konfigurasi: Nilai yang didukung adalah on (diaktifkan) dan off (dinonaktifkan).

    on

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "origin_error_status_code",
                "argValue": "502"
            }, {
                "argName": "extend_expiration_time",
                "argValue": "60"
            }, {
                "argName": "origin_first",
                "argValue": "off"
            }],
            "functionName": "serving_stale_content"
        }],
        "DomainNames": "example.com"
    }

Konfigurasi HTTPS

https_option

  • Deskripsi fitur: Mengonfigurasi parameter HTTPS dasar. Untuk informasi selengkapnya, lihat Konfigurasi sertifikat HTTPS, Konfigurasi HTTP/2, dan Konfigurasi OCSP Stapling.

  • ID Fungsi (FunctionID/FuncId): 78.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Nilai contoh

    http2

    String

    Tidak

    Menentukan apakah akan mengaktifkan HTTP/2:

    • on: Mengaktifkan fitur.

    • off: Menonaktifkan fitur.

    on

    ocsp_stapling

    String

    Tidak

    Menentukan apakah akan mengaktifkan fitur Online Certificate Status Protocol (OCSP) Stapling:

    • on: Mengaktifkan fitur.

    • off: Menonaktifkan fitur.

    on

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "http2",
                "argValue": "on"
            }, {
                "argName": "ocsp_stapling",
                "argValue": "on"
            }],
            "functionName": "https_option"
        }],
        "DomainNames": "example.com"
    }

http_force

  • Deskripsi: Mengonfigurasi pengalihan paksa ke HTTP. Untuk informasi selengkapnya, lihat Konfigurasi pengalihan paksa.

  • Konflik fitur: Fitur pengalihan paksa HTTP bertentangan dengan fitur pengalihan paksa HTTPS (fungsi: https_force, ID fungsi: 44). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur ini sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Untuk menghapus konfigurasi fitur untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.

  • ID Fungsi (FunctionID/FuncId): 45.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Nilai contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan pengalihan paksa HTTP.

    • on: Mengaktifkan fitur.

    • off: Menonaktifkan fitur.

    on

    http_rewrite

    String

    Tidak

    Metode pengalihan. Kode status yang didukung adalah 301 dan 308.

    • 301: Metode permintaan GET tidak berubah. Metode permintaan lain mungkin berubah menjadi metode GET.

    • 308: Metode permintaan dan entitas pesan tidak berubah.

    301

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "http_rewrite",
                "argValue": "301"
            }],
            "functionName": "http_force"
        }],
        "DomainNames": "example.com"
    }

https_force

  • Deskripsi fitur: Mengonfigurasi pengalihan paksa ke HTTPS. Untuk informasi selengkapnya, lihat Konfigurasi pengalihan paksa.

  • Konflik fitur: Fitur pengalihan paksa HTTPS bertentangan dengan fitur pengalihan paksa HTTP (fungsi: http_force, ID Fungsi: 45). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Untuk menghapus konfigurasi, Anda dapat memanggil operasi DeleteDcdnSpecificConfig. Setelah konfigurasi dihapus, Anda dapat mengonfigurasi fitur lainnya.

  • ID Fungsi (FunctionID/FuncId): 44.

  • Deskripsi parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan pengalihan paksa ke HTTPS:

    • on: Mengaktifkan fitur.

    • off: Menonaktifkan fitur.

    on

    https_rewrite

    String

    Tidak

    Metode pengalihan. Nilai yang valid adalah 301 dan 308.

    • 301: Metode permintaan GET tetap tidak berubah. Metode permintaan lain mungkin berubah menjadi GET.

    • 308: Metode permintaan dan entitas pesan tetap tidak berubah.

    301

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "https_rewrite",
                "argValue": "301"
            }],
            "functionName": "https_force"
        }],
        "DomainNames": "example.com"
    }

https_tls_version

  • Deskripsi fitur: Mengonfigurasi versi TLS. Untuk informasi selengkapnya, lihat Konfigurasi versi TLS dan paket sandi.

  • ID Fungsi (FuncId): 110.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Nilai contoh

    tls10

    String

    Tidak

    Menentukan apakah akan mengaktifkan TLSv1.0:

    • on (default): Mengaktifkan pengaturan.

    • Mati: Instans dimatikan.

    on

    tls11

    String

    Tidak

    Menentukan apakah akan mengaktifkan TLSv1.1:

    • on (default): Diaktifkan.

    • off: Menunjukkan pemadaman.

    on

    tls12

    String

    Tidak

    Menentukan apakah akan mengaktifkan TLSv1.2:

    • On (default): Pengaturan diaktifkan.

    • Off: Dimatikan.

    on

    tls13

    String

    Tidak

    Menentukan apakah akan mengaktifkan TLSv1.3:

    • on (default): Mengaktifkan pengaturan.

    • off: Pemadaman.

    on

    ciphersuitegroup

    String

    Tidak

    Grup paket sandi:

    • all (default): Semua paket sandi.

    • strict: Paket sandi kuat.

    • custom: Paket sandi kustom.

    all

    ciphersuite

    String

    Tidak

    Paket sandi kustom. Parameter ini hanya valid ketika ciphersuitegroup diatur ke custom. Tentukan beberapa paket sandi yang dipisahkan dengan koma.

    TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

  • Contoh konfigurasi:

    • Konfigurasi default: Aktifkan TLS 1.0, TLS 1.1, dan TLS 1.2, dan gunakan semua paket sandi.

      {
          "Functions": [{
              "functionArgs": [
                  {
                    "ArgValue": "on",
                    "ArgName": "tls10"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls11"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls12"
                  },
                  {
                    "ArgValue": "off",
                    "ArgName": "tls13"
                  },
                  {
                    "ArgValue": "all",
                    "ArgName": "ciphersuitegroup"
                  }
                ],
              "functionName": "https_tls_version"
          }],
          "DomainNames": "example.com"
      }
    • Aktifkan TLS 1.2 dan TLS 1.3, dan gunakan paket sandi kuat.

      {
          "Functions": [{
              "functionArgs": [
                  {
                    "ArgValue": "off",
                    "ArgName": "tls10"
                  },
                  {
                    "ArgValue": "off",
                    "ArgName": "tls11"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls12"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls13"
                  },
                  {
                    "ArgValue": "strict",
                    "ArgName": "ciphersuitegroup"
                  }
                ],
              "functionName": "https_tls_version"
          }],
          "DomainNames": "example.com"
      }
    • Aktifkan TLS 1.2 dan TLS 1.3, dan gunakan paket sandi kustom.

      {
          "Functions": [{
              "functionArgs": [
                  {
                    "ArgValue": "off",
                    "ArgName": "tls10"
                  },
                  {
                    "ArgValue": "off",
                    "ArgName": "tls11"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls12"
                  },
                  {
                    "ArgValue": "on",
                    "ArgName": "tls13"
                  },
                  {
                    "ArgValue": "custom",
                    "ArgName": "ciphersuitegroup"
                  },
                  {
                    "ArgValue": "TLS_ECDHE_ECDSA_WITH_AES_128_CCM_8,TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256,TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256",
                    "ArgName": "ciphersuite"
                  }
                ],
              "functionName": "https_tls_version"
          }],
          "DomainNames": "example.com"
      }

HSTS

  • Deskripsi: Mengonfigurasi HTTP Strict Transport Security (HSTS). Untuk informasi selengkapnya, lihat Konfigurasi HSTS.

  • ID Fungsi (FunctionID/FuncId) adalah 112.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Nilai contoh

    enabled

    String

    Ya

    Aktifkan HSTS:

    • Diaktifkan.

    • off: Mematikan sistem.

    on

    https_hsts_max_age

    Integer

    Ya

    Waktu kedaluwarsa dalam detik.

    Catatan

    Nilai yang direkomendasikan adalah 5.184.000 detik (60 hari).

    5184000

    https_hsts_include_subdomains

    String

    Tidak

    Menentukan apakah akan menyertakan parameter subdomain dalam header HTTP Strict Transport Security (HSTS). Nilai yang valid adalah on atau off.

    Catatan

    Sebelum mengaktifkan opsi ini, pastikan HTTPS diaktifkan untuk semua subdomain dari nama domain yang dipercepat. Jika tidak, subdomain menjadi tidak dapat diakses setelah secara otomatis dialihkan ke HTTPS.

    off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enabled",
                "argValue": "on"
            }, {
                "argName": "https_hsts_max_age",
                "argValue": "5184000"
            }, {
                "argName": "https_hsts_include_subdomains",
                "argValue": "off"
            }],
            "functionName": "HSTS"
        }],
        "DomainNames": "example.com"
    }

Kontrol akses

referer_white_list_set

  • Deskripsi: Mengonfigurasi daftar putih Referer. Untuk informasi selengkapnya tentang cara mengonfigurasi fitur ini di konsol, lihat Konfigurasi perlindungan hotlink Referer.

  • Konflik: Fitur daftar putih Referer saling eksklusif dengan fitur daftar hitam Referer (fungsi: referer_black_list_set, ID fungsi: 5). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Untuk menghapus konfigurasi tertentu untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.

  • ID Fungsi (FunctionID/FuncId): 1.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    refer_domain_allow_list

    String

    Ya

    Daftar putih. Pisahkan beberapa nama domain dengan koma (,).

    example.aliyundoc.com,demo.aliyundoc.com

    allow_empty

    String

    Tidak

    Menentukan apakah akan mengizinkan akses ke resource DCDN jika bidang Referer kosong. Nilai yang valid:

    • on: Mengizinkan akses.

    • off (default): Menolak akses.

    off

    redirect_url

    String

    Tidak

    URL pengalihan. Jika Referer dalam permintaan pengguna tidak cocok dengan nama domain mana pun dalam daftar putih, permintaan diblokir. Alih-alih mengembalikan kesalahan 403, DCDN mengembalikan kode status 302 dan header Location. Parameter ini menentukan nilai header Location. URL harus dimulai dengan http:// atau https://.

    http://www.example.com

    disable_ast

    String

    Tidak

    Mengaktifkan mode pencocokan eksak. Ini mengontrol apakah nama domain dalam daftar putih dicocokkan secara eksak. Jika Anda mengatur parameter ini ke on, pencocokan eksak digunakan.

    • Jika diatur ke on:

      • Pencocokan eksak didukung.

        • Jika daftar putih berisi example.com, ini cocok dengan example.com.

        • Jika daftar putih berisi a*b.example.com, ini cocok dengan a<string apa saja>b.example.com.

      • Pencocokan akhiran tidak didukung.

    • Jika diatur ke off (default):

      • Pencocokan eksak tidak didukung.

      • Pencocokan akhiran didukung.

        • Jika daftar putih berisi example.com, ini cocok dengan example.com dan <string apa saja>.example.com.

        • Jika daftar putih berisi a*b.example.com, ini cocok dengan a<string apa saja>b.example.com dan <string apa saja>.a<string apa saja>b.example.com.

    off

    ignore_scheme

    String

    Tidak

    Menentukan apakah akan mengabaikan skema. Jika diaktifkan, Referer dalam permintaan pengguna dianggap valid bahkan jika tidak menyertakan header protokol HTTP atau HTTPS. Contoh:

    • Jika diatur ke on, format Referer adalah:

      referer: www.example.com

    • Jika diatur ke off (default), format Referer adalah:

      referer: https://www.example.com

    off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "allow_empty",
                "argValue": "off"
            }, {
                "argName": "refer_domain_allow_list",
                "argValue": "example.aliyundoc.com,demo.aliyundoc.com"
            }],
            "functionName": "referer_white_list_set"
        }],
        "DomainNames": "example.com"
    }

referer_black_list_set

  • Deskripsi: Mengonfigurasi daftar hitam Referer. Untuk informasi selengkapnya tentang cara mengonfigurasi fitur ini di konsol, lihat Konfigurasi perlindungan hotlink Referer.

  • Konflik: Fitur daftar hitam Referer saling eksklusif dengan fitur daftar putih Referer (fungsi: referer_white_list_set, ID fungsi: 1). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Untuk menghapus konfigurasi tertentu untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.

  • ID Fungsi (FunctionID/FuncId): 5.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    refer_domain_deny_list

    String

    Ya

    Daftar hitam. Pisahkan beberapa nama domain dengan koma (,).

    example.aliyundoc.com,demo.aliyundoc.com

    allow_empty

    String

    Tidak

    Menentukan apakah akan mengizinkan akses ke resource DCDN jika bidang Referer kosong:

    • on: Mengizinkan akses.

    • off: Menolak akses.

    off

    redirect_url

    String

    Tidak

    URL pengalihan. Jika Referer dalam permintaan pengguna cocok dengan nama domain dalam daftar hitam, permintaan diblokir. Alih-alih mengembalikan kesalahan 403, DCDN mengembalikan kode status 302 dan header Location. Parameter ini menentukan nilai header Location. URL harus dimulai dengan http:// atau https://.

    http://www.example.com

    disable_ast

    String

    Tidak

    Mengaktifkan mode pencocokan eksak. Ini mengontrol apakah nama domain dalam daftar hitam dicocokkan secara eksak. Jika Anda mengatur parameter ini ke on, pencocokan eksak digunakan.

    • Jika diatur ke on:

      • Pencocokan eksak didukung.

        • Jika daftar hitam berisi example.com, ini cocok dengan example.com.

        • Jika daftar hitam berisi a*b.example.com, ini cocok dengan a<string apa saja>b.example.com.

      • Pencocokan akhiran tidak didukung.

    • Jika diatur ke off (default):

      • Pencocokan eksak tidak didukung.

      • Pencocokan akhiran didukung.

        • Jika daftar hitam berisi example.com, ini cocok dengan example.com dan <string apa saja>.example.com.

        • Jika daftar hitam berisi a*b.example.com, ini cocok dengan a<string apa saja>b.example.com dan <string apa saja>.a<string apa saja>b.example.com.

    off

    ignore_scheme

    String

    Tidak

    Menentukan apakah akan mengabaikan skema. Jika diaktifkan, Referer dalam permintaan pengguna dianggap valid bahkan jika tidak menyertakan header protokol HTTP atau HTTPS. Contoh:

    • Jika diatur ke on, format Referer adalah:

      referer: www.example.com

    • Jika diatur ke off (default), format Referer adalah:

      referer: https://www.example.com

    off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "allow_empty",
                "argValue": "off"
            }, {
                "argName": "refer_domain_deny_list",
                "argValue": "example.aliyundoc.com,demo.aliyundoc.com"
            }],
            "functionName": "referer_black_list_set"
        }],
        "DomainNames": "example.com"
    }

aliauth

  • Deskripsi: Mengonfigurasi penandatanganan URL. Untuk informasi selengkapnya tentang cara mengonfigurasi fitur ini di konsol, lihat Konfigurasi penandatanganan URL.

  • ID Fungsi (FunctionID/FuncId): 25.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    auth_m3u8

    String

    Tidak

    Mengaktifkan penulisan ulang konten M3U8. Ini menambahkan parameter penandatanganan yang diperlukan ke file TS dalam file M3U8 untuk mencegah kegagalan akses. Nilai yang valid adalah on (default) dan off.

    on

    auth_type

    String

    Ya

    Metode penandatanganan. Nilai yang valid:

    • no_auth: Tanpa penandatanganan.

    • type_a: penandatanganan tipe A.

    • type_b: penandatanganan tipe B.

    • type_c: signing tipe c.

    • type_f: Tipe penandatanganan F.

    type_a

    auth_key1

    String

    Ya

    Kunci enkripsi 1. Kunci harus terdiri dari 16 hingga 128 karakter dan dapat berisi huruf besar, huruf kecil, dan angka.

    1234567890123456789

    auth_key2

    String

    Tidak

    Kunci enkripsi 2. Kunci harus terdiri dari 16 hingga 128 karakter dan dapat berisi huruf besar, huruf kecil, dan angka.

    1234567890123456789

    ali_auth_delta

    Integer

    Tidak

    Periode validitas URL yang ditandatangani. Nilai default: 1800. Satuan: detik.

    1800

    req_auth_ip_white

    String

    Tidak

    Daftar putih IP. Alamat IP dalam daftar ini dibebaskan dari verifikasi penandatanganan.

    Anda dapat memasukkan beberapa alamat IP. Pisahkan dengan koma (,).

    192.168.0.1

    req_auth_ip_acl_xfwd

    String

    Tidak

    Metode untuk mengambil alamat IP klien untuk daftar putih. Nilai yang valid:

    • on: Ini adalah mode default. DCDN memverifikasi alamat IP pertama di sebelah kiri dalam header X-Forwarded-For permintaan pengguna. Alamat IP ini adalah alamat IP asal klien.

    • off: DCDN memverifikasi alamat IP yang digunakan untuk membuat koneksi antara klien dan titik kehadiran DCDN.

    • all: DCDN memverifikasi kedua alamat IP berikut:

      • Alamat IP pertama di sebelah kiri dalam header X-Forwarded-For permintaan pengguna, yaitu alamat IP asal klien.

      • Alamat IP yang digunakan untuk membuat koneksi antara klien dan titik kehadiran DCDN.

    all

    sign_param

    String

    Tidak

    Nama parameter penandatanganan. Parameter ini hanya valid ketika `auth_type` diatur ke `type_f`.

    sign

    time_param

    String

    Tidak

    Nama parameter timestamp. Parameter ini hanya valid ketika `auth_type` diatur ke `type_f`.

    time

    time_format

    String

    Tidak

    Format timestamp. Parameter ini hanya valid ketika `auth_type` diatur ke `type_f`.

    • dec: desimal

    • hex: heksadesimal

    hec

    path_encoding

    String

    Tidak

    Menentukan apakah akan mengaktifkan pengkodean URL. Nilai yang valid: on dan off. Parameter ini hanya valid ketika `auth_type` diatur ke `type_f`.

    on

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "auth_type",
                "argValue": "type_a"
            }, {
                "argName": "auth_key1",
                "argValue": "1234567890123456789"
            }, {
                "argName": "auth_key2",
                "argValue": "1234567890123456789"
            }, {
                "argName": "ali_auth_delta",
                "argValue": 1800
            }, {
                "argName": "req_auth_ip_white",
                "argValue": "192.168.0.1"
            }, {
                "argName": "req_auth_ip_acl_xfwd",
                "argValue": "all"   
            }, {
                "argName": "sign_param",
                "argValue": "sign"
            }, {
                "argName": "time_param",
                "argValue": "time"
            }, {
                "argName": "time_format",
                "argValue": "hec"
            }, {
                "argName": "path_encoding",
                "argValue": "on"
            }],
            "functionName": "aliauth"
        }],
        "DomainNames": "example.com"
    }

cdn_remote_auth

  • Deskripsi: Mengonfigurasi autentikasi jarak jauh.

  • ID Fungsi (FunctionID/FuncId): 258.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan autentikasi jarak jauh. Nilai yang valid:

    • Diaktifkan.

    • Off: Pemadaman.

    on

    remote_auth_addr

    String

    Ya

    Alamat server otentikasi. Format: https://dcdn.aliyun.com/auth atau http://10.10.10.10/auth.

    https://example.aliyundoc.com/auth

    remote_auth_method

    String

    Ya

    Metode permintaan. Nilai yang valid: get, post, dan head.

    get

    remote_auth_type

    String

    Ya

    Jenis file yang memerlukan autentikasi. `all` menunjukkan semua jenis file. Untuk menentukan beberapa jenis file, pisahkan dengan tanda pipa vertikal (|). Jenis file peka huruf besar/kecil. Misalnya, jpg tidak sama dengan JPG.

    all

    remote_auth_reserve_args

    String

    Ya

    Parameter yang dipertahankan dalam permintaan. Untuk menentukan beberapa parameter, pisahkan dengan tanda pipa vertikal (|). Parameter tidak peka huruf besar/kecil. Misalnya, key sama dengan KEY.

    • all: Mempertahankan semua parameter.

    • ali_delete_all_args: Menghapus semua parameter URL.

    all

    remote_auth_custom_args

    String

    Tidak

    Parameter kustom yang ditambahkan. Untuk menentukan beberapa parameter, pisahkan dengan tanda pipa vertikal (|). Parameter peka huruf besar/kecil. Misalnya, key tidak sama dengan KEY.

    empty

    remote_auth_reserve_header

    String

    Ya

    Header permintaan yang dipertahankan. Untuk menentukan beberapa header, pisahkan dengan tanda pipa vertikal (|). Header tidak peka huruf besar/kecil. Misalnya, http_remote_addr sama dengan HTTP_Remote_Addr.

    • all: Mempertahankan semua header permintaan.

    • ali_delete_all_headers: Menghapus semua header permintaan.

    all

    remote_auth_custom_header

    String

    Tidak

    Header permintaan kustom yang ditambahkan. Untuk menentukan beberapa header, pisahkan dengan tanda pipa vertikal (|). Header tidak peka huruf besar/kecil. Misalnya, http_remote_addr sama dengan HTTP_Remote_Addr.

    empty

    remote_auth_success_code

    Integer

    Ya

    Kode status untuk autentikasi berhasil. Ini adalah hasil yang dikembalikan server otentikasi ke DCDN setelah autentikasi berhasil. Contoh: 200. Anda dapat menentukan beberapa kode status. Pisahkan dengan koma (,).

    200

    remote_auth_fail_code

    Integer

    Ya

    Kode status untuk autentikasi gagal. Ini adalah hasil yang dikembalikan server otentikasi ke DCDN setelah autentikasi gagal. Contoh: 403. Anda dapat menentukan beberapa kode status. Pisahkan dengan koma (,).

    403,404

    remote_auth_other_code_act

    String

    Tidak

    Tindakan yang diambil DCDN pada permintaan pengguna jika kode status yang dikembalikan oleh server otentikasi bukan kode keberhasilan atau kegagalan. Nilai yang valid:

    • pass (default): Mengizinkan permintaan.

    • reject: Menolak permintaan.

    pass

    remote_auth_fail_resp_code

    Integer

    Ya

    Kode status respons yang dikembalikan DCDN kepada pengguna setelah autentikasi gagal. Contoh: 403.

    403

    remote_auth_timeout

    Integer

    Ya

    Periode waktu habis autentikasi. Satuan: ms. Nilai maksimum adalah 3000.

    500

    remote_auth_timeout_action

    String

    Ya

    Tindakan yang diambil saat autentikasi habis waktu. Nilai yang valid:

    • pass: DCDN mengizinkan permintaan pengguna.

    • reject: DCDN mengembalikan `remote_auth_fail_resp_code` yang ditentukan kepada pengguna.

    pass

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "remote_auth_addr",
                "argValue": "https://example.aliyundoc.com/auth"
            }, {
                "argName": "remote_auth_method",
                "argValue": "get"
            }, {
                "argName": "remote_auth_type",
                "argValue": "all"
            }, {
                "argName": "remote_auth_reserve_args",
                "argValue": "all"
            }, {
                "argName": "remote_auth_custom_args",
                "argValue": ""
            }, {
                "argName": "remote_auth_reserve_header",
                "argValue": "all"
            }, {
                "argName": "remote_auth_custom_header",
                "argValue": ""
            }, {
                "argName": "remote_auth_success_code",
                "argValue": "200"
            }, {
                "argName": "remote_auth_fail_code",
                "argValue": "403"
            }, {
                "argName": "remote_auth_other_code_act",
                "argValue": "pass"
            }, {
                "argName": "remote_auth_fail_resp_code",
                "argValue": "403"
            }, {
                "argName": "remote_auth_timeout",
                "argValue": 500
            }, {
                "argName": "remote_auth_timeout_action",
                "argValue": "pass"
            }],
            "functionName": "cdn_remote_auth"
        }],
        "DomainNames": "example.com"
    }

ip_allow_list_set

  • Deskripsi: Mengonfigurasi daftar putih IP. Untuk informasi selengkapnya tentang cara mengonfigurasi fitur ini di konsol, lihat Konfigurasi daftar hitam dan daftar putih IP.

  • Konflik: Fitur daftar putih IP saling eksklusif dengan fitur daftar hitam IP (fungsi: ip_black_list_set, ID fungsi: 13). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Untuk menghapus konfigurasi tertentu untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.

  • ID Fungsi (FunctionID/FuncId): 69.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    ip_list

    String

    Ya

    Daftar IP. Pisahkan beberapa alamat IP atau blok CIDR dengan koma (,).

    192.168.0.1/24

    customize_response_status_code

    String

    Tidak

    Kode status respons kustom. Nilai default kosong, yang menunjukkan bahwa kode status respons adalah 403. Anda dapat memasukkan angka 3 digit untuk mengatur kode status respons kustom.

    429

    ip_acl_xfwd

    String

    Tidak

    Menentukan apakah akan menggunakan alamat IP dalam header X-Forwarded-For. Nilai yang valid:

    • on: Ini adalah nilai default. DCDN menggunakan alamat IP pertama di sebelah kiri dalam header x-forwarded-for permintaan pengguna untuk verifikasi.

    • off: Menggunakan alamat real client IP.

    • all: DCDN menggunakan header x-forwarded-for dan alamat IP koneksi untuk verifikasi.

    all

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ip_list",
                "argValue": "192.168.0.1/24"
            }],
            "functionName": "ip_allow_list_set"
        }],
        "DomainNames": "example.com"
    }

ip_black_list_set

  • Deskripsi: Mengonfigurasi daftar hitam IP. Untuk informasi selengkapnya tentang cara mengonfigurasi fitur ini di konsol, lihat Konfigurasi daftar hitam dan daftar putih IP.

  • Konflik: Fitur daftar hitam IP saling eksklusif dengan fitur daftar putih IP (fungsi: ip_allow_list_set, ID fungsi: 69). Anda hanya dapat mengaktifkan salah satunya. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter switch-nya diatur ke `off`. Untuk menghapus konfigurasi tertentu untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.

  • ID Fungsi (FunctionID/FuncId): 13.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    ip_list

    String

    Ya

    Daftar IP. Pisahkan beberapa alamat IP atau blok CIDR dengan koma (,).

    192.168.0.1

    customize_response_status_code

    String

    Tidak

    Kode status respons kustom. Nilai default kosong, yang menunjukkan bahwa kode status respons adalah 403. Anda dapat memasukkan angka 3 digit untuk mengatur kode status respons kustom.

    429

    ip_acl_xfwd

    String

    Tidak

    Menentukan apakah akan menggunakan alamat IP dalam header X-Forwarded-For. Nilai yang valid:

    • on: Ini adalah nilai default. DCDN menggunakan alamat IP pertama di sebelah kiri dalam header x-forwarded-for permintaan pengguna untuk verifikasi.

    • Nonaktif: Menggunakan alamat IP sumber yang sebenarnya.

    • all: DCDN menggunakan header x-forwarded-for dan alamat IP koneksi untuk verifikasi.

    all

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ip_list",
                "argValue": "192.168.0.1"
            }],
            "functionName": "ip_black_list_set"
        }],
        "DomainNames": "example.com"
    }

ali_ua

  • Deskripsi: Mengonfigurasi kontrol akses berdasarkan header User-Agent. Untuk informasi selengkapnya tentang cara mengonfigurasi fitur ini di konsol, lihat Konfigurasi daftar hitam dan daftar putih User-Agent.

  • ID Fungsi (FunctionID/FuncId): 58.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    ua

    String

    Ya

    String User-Agent. Karakter wildcard (*) didukung untuk mencocokkan string apa pun. Untuk menentukan beberapa nilai, pisahkan dengan tanda pipa vertikal (|). Contoh: *curl*|*IE*|*chrome*|*firefox*.

    *curl*|*IE*|*chrome*|*firefox*

    type

    String

    Ya

    Jenis daftar. Nilai yang valid:

    • black: daftar hitam.

    • white: daftar putih.

    Catatan

    Daftar hitam dan daftar putih saling eksklusif. Hanya satu jenis yang dapat efektif pada satu waktu.

    black

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ua",
                "argValue": "*curl*|*IE*|*chrome*|*firefox*"
            }, {
                "argName": "type",
                "argValue": "black"
            }],
            "functionName": "ali_ua"
        }],
        "DomainNames": "example.com"
    }

Optimalisasi performa

tesla

  • Deskripsi fitur: Mengonfigurasi optimalisasi HTML untuk mempercepat pemuatan halaman. Untuk informasi selengkapnya, lihat Optimalisasi HTML.

  • ID Fungsi (FunctionID/FuncId): 16.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan akselerasi untuk optimalisasi HTML.

    • on: Mengaktifkan fitur.

    • off: Menonaktifkan fitur.

    on

    trim_js

    String

    Tidak

    Menentukan apakah akan mengoptimalkan kode JavaScript (JS) inline dalam HTML.

    • on: Mengaktifkan fitur.

    • off (default): Menonaktifkan optimalisasi.

    off

    trim_css

    String

    Tidak

    Menentukan apakah akan mengoptimalkan kode Cascading Style Sheets (CSS) inline dalam HTML.

    • on: Mengaktifkan optimalisasi.

    • off (default): Status mati.

    off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "trim_css",
                "argValue": "off"
            }, {
                "argName": "trim_js",
                "argValue": "off"
            }],
            "functionName": "tesla"
        }],
        "DomainNames": "example.com"
    }

gzip

  • Deskripsi fitur: Mengoptimalkan halaman menggunakan kompresi Gzip. Untuk informasi selengkapnya tentang fitur ini, lihat Kompresi gzip.

  • ID Fungsi (FunctionID/FuncId): 35.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan optimalisasi Gzip untuk halaman.

    • on: Mengaktifkan fitur.

    • off: Menonaktifkan fitur.

    on

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "gzip"
        }],
        "DomainNames": "example.com"
    }

brotli

  • Deskripsi fitur: Mengonfigurasi kompresi Brotli untuk halaman. Untuk informasi selengkapnya tentang fitur ini, lihat Kompresi Brotli.

  • ID Fungsi (FunctionID/FuncId): 97.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan kompresi Brotli untuk halaman.

    • on: Mengaktifkan fitur.

    • off: Menonaktifkan fitur.

    on

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "brotli"
        }],
        "DomainNames": "example.com"
    }

set_hashkey_args

  • Deskripsi fitur: Mengonfigurasi fitur untuk mengabaikan parameter URL dengan hanya mempertahankan parameter yang ditentukan. Untuk informasi selengkapnya tentang fitur ini, lihat Abaikan parameter.

  • Konflik fitur: Fitur Abaikan Parameter URL (Pertahankan) bertentangan dengan fitur Abaikan Parameter URL (Hapus) (fungsi: ali_remove_args, ID fungsi: 75). Anda hanya dapat mengaktifkan salah satu fitur ini pada satu waktu. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter enable-nya diatur ke `off`. Untuk menghapus konfigurasi fitur untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.

  • ID Fungsi (FunctionID/FuncId): 19.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    hashkey_args

    String

    Tidak

    Daftar parameter yang dipertahankan. Pisahkan beberapa parameter dengan koma (,). Anda dapat menentukan hingga 10 parameter.

    key1,key2

    disable

    String

    Ya

    Menentukan apakah akan mengabaikan semua parameter.

    • on: Mengabaikan semua parameter. Fitur menghapus, mempertahankan, dan mengubah parameter dinonaktifkan. Hanya fitur menambahkan parameter yang tetap efektif.

    • off (default): Menonaktifkan fitur. Fitur mempertahankan, menambahkan, dan menghapus parameter tetap efektif.

    Catatan

    Prioritas mengabaikan semua parameter untuk kunci hash cache lebih rendah daripada prioritas mempertahankan daftar parameter cache.

    on

    keep_oss_args

    String

    Ya

    Menentukan apakah akan mempertahankan parameter untuk permintaan pengambilan asal.

    • on: Mempertahankan semua parameter dalam permintaan pengambilan asal.

    • off: Parameter dalam permintaan pengambilan asal sama dengan parameter dalam kunci hash cache.

    on

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "hashkey_args",
                "argValue": ""
            }, {
                "argName": "keep_oss_args",
                "argValue": "on"
            }, {
                "argName": "disable",
                "argValue": "on"
            }],
            "functionName": "set_hashkey_args"
        }],
        "DomainNames": "example.com"
    }

ali_remove_args

  • Deskripsi fitur: Mengonfigurasi fitur untuk mengabaikan parameter URL dengan menghapus parameter yang ditentukan. Untuk informasi selengkapnya tentang fitur ini, lihat Abaikan parameter.

  • Konflik fitur: Fitur Abaikan Parameter URL (Hapus) bertentangan dengan fitur Abaikan Parameter URL (Pertahankan) (fungsi: set_hashkey_args, ID fungsi: 19). Anda hanya dapat mengaktifkan salah satu fitur ini pada satu waktu. Jika salah satu fitur sudah dikonfigurasi, Anda harus menghapus konfigurasinya sebelum dapat mengonfigurasi yang lain. Fitur dianggap telah dikonfigurasi meskipun parameter enable-nya diatur ke `off`. Untuk menghapus konfigurasi fitur untuk nama domain, Anda dapat memanggil operasi DeleteDcdnSpecificConfig.

  • ID Fungsi (FunctionID/FuncId): 75.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    ali_remove_args

    String

    Ya

    Parameter yang akan dihapus. Pisahkan beberapa parameter dengan spasi.

    Catatan

    Parameter yang tersisa digunakan sebagai argumen URL dalam kunci hash.

    test

    keep_oss_args

    String

    Ya

    Menentukan apakah akan mempertahankan parameter untuk permintaan pengambilan asal.

    • on: Mempertahankan semua parameter dalam permintaan pengambilan asal.

    • off: Parameter dalam permintaan pengambilan asal sama dengan parameter dalam kunci hash cache.

    off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ali_remove_args",
                "argValue": "test"
            }, {
                "argName": "keep_oss_args",
                "argValue": "off"
            }],
            "functionName": "ali_remove_args"
        }],
        "DomainNames": "example.com"
    }

image_transform

  • Deskripsi fitur: Mengonfigurasi transformasi gambar DCDN. Untuk informasi selengkapnya tentang fitur ini, lihat Metode dan manfaat pengeditan gambar.

  • ID Fungsi (FunctionID/FuncId): 239.

  • Parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan transformasi gambar.

    • on: Mengaktifkan fitur.

    • off: Menonaktifkan fitur.

    on

    filetype

    String

    Ya

    Format gambar yang mendukung transkode. Pisahkan beberapa format dengan tanda pipa vertikal (|). Nilai berikut didukung:

    • JPEG: Format gambar JPEG.

    • JPG: Format gambar JPG.

    • PNG: Format gambar PNG.

    • WEBP: Format gambar WEBP.

    • BMP: Format gambar BMP.

    • GIF: Format gambar GIF.

    • TIFF: Format gambar TIFF.

    • JP2: Format gambar JPEG 2000.

    jpg|jpeg|png

    webp

    String

    Tidak

    Menentukan apakah akan mengaktifkan konversi otomatis ke WebP.

    • on: Mengaktifkan konversi.

    • mati: Instans dimatikan.

    on

    orient

    String

    Tidak

    Menentukan apakah akan mengaktifkan rotasi gambar otomatis.

    • on: Fitur diaktifkan.

    • off: Sumber daya dimatikan.

    Catatan

    Fitur ini hanya berfungsi untuk gambar yang memiliki properti rotasi.

    on

    slim

    Integer

    Tidak

    Pelangsingan gambar. Atur persentase pelangsingan. Nilainya bisa dari 0 hingga 100. Fitur ini mengurangi kualitas gambar untuk menghemat lalu lintas tanpa mengubah resolusi, dimensi, atau format.

    10

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "filetype",
                "argValue": "jpg|jpeg|png"
            }, {
                "argName": "webp",
                "argValue": "on"
            }, {
                "argName": "orient",
                "argValue": "on"
            }, {
                "argName": "slim",
                "argValue": ""
            }, {
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "image_transform"
        }],
        "DomainNames": "example.com"
    }

Fitur video

range

  • Deskripsi fitur: Mengonfigurasi pengambilan asal range. Untuk informasi selengkapnya, lihat Konfigurasi Pengambilan Asal Range.

  • ID Fungsi: 31.

  • Parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan pengambilan asal range.

    • on: Aktifkan.

    • off: Nonaktifkan.

    • force: Paksa aktifkan.

    on

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "range"
        }],
        "DomainNames": "example.com"
    }

video_seek

  • Deskripsi: Mengonfigurasi pencarian video. Untuk detail konfigurasi konsol, lihat Pencarian video.

  • ID Fungsi: 30.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan pencarian video.

    • on: Aktifkan.

    • off: Nonaktifkan.

    on

    flv_seek_by_time

    String

    Tidak

    Menentukan apakah akan mengaktifkan pencarian berdasarkan waktu untuk file FLV.

    • on: Aktifkan.

    • off: Nonaktifkan.

    on

    mp4_seek_start

    String

    Tidak

    Parameter awal kustom untuk file MP4.

    mp4starttime

    mp4_seek_end

    String

    Tidak

    Parameter akhir kustom untuk file MP4.

    mp4endtime

    flv_seek_start

    String

    Tidak

    Parameter awal kustom untuk file FLV.

    flvstarttime

    flv_seek_end

    String

    Tidak

    Parameter akhir kustom untuk file FLV.

    flvendtime

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "video_seek"
        }],
        "DomainNames": "example.com"
    }

ali_video_split

  • Deskripsi: Mengonfigurasi pemutaran audio saja.

  • ID Fungsi: 204.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan pemutaran audio saja.

    • on: Aktifkan.

    • off: Nonaktifkan.

    on

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "ali_video_split"
        }],
        "DomainNames": "example.com"
    }

ali_video_preview

  • Deskripsi: Mengonfigurasi pratinjau video.

  • ID Fungsi: 205.

  • Parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan pratinjau video.

    • on: Aktifkan.

    • off: Nonaktifkan.

    Catatan

    Anda dapat menggunakan file TS dan MP3, serta menyeret dan melepas file FLV dan MP4.

    on

    ali_video_preview_argument

    String

    Ya

    Nama parameter kustom untuk pratinjau video. Nilai parameter ini harus dalam satuan detik.

    fds

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "ali_video_preview_argument",
                "argValue": "fds"
            }],
            "functionName": "ali_video_preview"
        }],
        "DomainNames": "example.com"
    }

hls_token_rewrite

  • Deskripsi: Mengonfigurasi enkripsi dan penulisan ulang M3U8.

  • ID Fungsi: 253.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan enkripsi dan penulisan ulang M3U8.

    • on: Aktifkan.

    • off: Nonaktifkan.

    on

    hls_token_arg_name

    String

    Tidak

    Nama parameter kustom untuk token HLS. Jika Anda tidak mengatur parameter ini, MtsHlsUriToken digunakan sebagai nama parameter default.

    example

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }],
            "functionName": "hls_token_rewrite"
        }],
        "DomainNames": "example.com",
    }

Konfigurasi keamanan

ddos_domain

  • Deskripsi fitur: Mengonfigurasi penjadwalan Anti-DDoS. Untuk informasi selengkapnya, lihat Pengaturan Mitigasi.

  • ID Fungsi (FuncId): 209.

  • Deskripsi parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Contoh

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan perlindungan Anti-DDoS:

    • on: Aktifkan

    • off: Nonaktifkan

    on

    dispatch_qps

    String

    Tidak

    Ambang batas permintaan per detik (QPS).

    • Rentang nilai: 2000 hingga 50000.

    • Nilai default: 20000.

    20000

    auto_dispatch

    String

    Tidak

    Mengaktifkan pembersihan lalu lintas cerdas. Jika Anda mengaktifkan fitur ini, Anda tidak perlu menentukan ambang batas QPS. Sistem DCDN secara otomatis menentukan apakah akan mengaktifkan pola pembersihan lalu lintas.

    • on: Aktifkan

    • off: Nonaktifkan

    on

    checkurl

    String

    Ya

    Jalur untuk pemeriksaan kesehatan di bawah nama domain.

    Nilai default: / (direktori root nama domain).

    /*/examplefile.txt

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "dispatch_qps",
                "argValue": "20000"
            }, {
                "argName": "checkurl",
                "argValue": "/*/examplefile.txt"
            }],
            "functionName": "ddos_domain"
        }],
        "DomainNames": "example.com"
    }

ali_location

  • Fitur: Daftar hitam berdasarkan lokasi. Untuk informasi selengkapnya, lihat Konfigurasi daftar hitam berdasarkan wilayah.

  • ID Fungsi (FuncId): 57.

  • Parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Nilai contoh

    location

    String

    Ya

    Menentukan wilayah tempat kebijakan pemblokiran berlaku. Nilainya dapat dalam salah satu format berikut:

    • Kode negara dua huruf kapital yang sesuai dengan standar ISO 3166. Untuk menentukan beberapa negara, pisahkan kode dengan spasi.

    • Anda dapat mengatur wilayah ke global.

    global

    type

    String

    Ya

    Menentukan jenis kebijakan pemblokiran. Nilai yang valid:

    • black: Daftar hitam. Memblokir alamat IP klien dari wilayah yang ditentukan.

    • white: Daftar putih. Memblokir alamat IP klien dari semua wilayah kecuali yang ditentukan.

    black

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "location",
                "argValue": "global"
            }, {
                "argName": "type",
                "argValue": "white"
            }],
            "functionName": "ali_location"
        }],
        "DomainNames": "example.com"
    }

Pembatasan laju

limit_rate

  • Deskripsi fitur: Mengonfigurasi batas laju untuk satu permintaan.

  • ID Fungsi: 72.

  • Deskripsi parameter:

    Anda dapat mengonfigurasi batas laju tetap dengan `ali_limit_rate`, batas laju dinamis berdasarkan parameter dalam URL permintaan, atau batas laju berbasis waktu.

    Untuk membatasi laju berdasarkan parameter dalam URL permintaan, gunakan parameter `traffic_limit_arg` dan `traffic_limit_unit` bersama-sama.

    Untuk mengatur waktu mulai dan akhir pembatasan laju, gunakan parameter `ali_limit_start_hour` dan `ali_limit_end_hour` bersama-sama.

    Parameter

    Type

    Wajib

    Deskripsi

    Nilai contoh

    ali_limit_rate

    String

    Ya

    Menentukan batas laju untuk satu permintaan. Nilainya adalah angka diikuti satuan. Satuan yang didukung adalah `k` untuk KByte/s dan `m` untuk MByte/s.

    Nilai minimum adalah `100k`. Nilai kurang dari `100k` diproses sebagai `100k`.

    • `1m`: Mengatur batas laju untuk satu permintaan menjadi 1 MByte/s.

    • `100k`: Mengatur batas laju untuk satu permintaan menjadi 100 KByte/s.

    ali_limit_rate_after

    String

    Tidak

    Jumlah data yang dikirim sebelum pembatasan laju dimulai. Nilainya adalah angka diikuti satuan. Satuan yang didukung adalah `k` untuk KByte dan `m` untuk MByte.

    1000

    traffic_limit_arg

    String

    Tidak

    Nama parameter pembatasan laju. Laju dibatasi berdasarkan argumen yang diambil dari URL. Misalnya, `rate`.

    Jika permintaan tidak berisi parameter ini, batas laju default yang ditentukan oleh `ali_limit_rate` digunakan. Untuk menonaktifkan pembatasan laju saat parameter ini tidak ada dalam permintaan, atur `ali_limit_rate` ke `0k`.

    rate

    traffic_limit_unit

    String

    Tidak

    Satuan untuk parameter `traffic_limit_arg`. Satuan yang didukung adalah `m` (MByte/s) dan `k` (KByte/s). Misalnya, jika parameter ini diatur ke `m` dan URL permintaan berisi `rate=1`, batas laju aktualnya adalah 1 MByte/s.

    Nilai minimum adalah `100k`. Nilai kurang dari `100k` diproses sebagai `100k`.

    m

    ali_limit_start_hour

    Integer

    Tidak

    Waktu mulai pembatasan laju. Nilainya harus bilangan bulat dari 0 hingga 24 dan harus kurang dari waktu akhir. Nilai default adalah 0.

    Catatan

    Ini merepresentasikan jam dalam format 24 jam. Misalnya, `0` merepresentasikan 00:00:00 dan `24` merepresentasikan 24:00:00.

    20

    ali_limit_end_hour

    Integer

    Tidak

    Waktu akhir pembatasan laju. Nilainya harus bilangan bulat dari 0 hingga 24 dan harus lebih besar dari waktu mulai. Nilai default adalah 24.

    23

  • Contoh konfigurasi 1: Mengatur batas laju untuk satu permintaan menjadi 1 MB/s.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ali_limit_rate",
                "argValue": "1m"
            }],
            "functionName": "limit_rate"
        }],
        "DomainNames": "example.com"
    }
  • Contoh konfigurasi 2: Batas laju default untuk satu permintaan adalah 1 MB/s. Jika URL permintaan berisi parameter `rate`, laju dibatasi berdasarkan nilai parameter tersebut. Misalnya, jika permintaan berisi `rate=200`, batas laju aktual menjadi 200 KB/s.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "ali_limit_rate",
                "argValue": "1m"
            },{
                "argName": "traffic_limit_arg",
                "argValue": "rate"
            },{
                "argName": "traffic_limit_unit",
                "argValue": "k"
            }],
            "functionName": "limit_rate"
        }],
        "DomainNames": "example.com"
    }

WebSocket

websocket

  • Deskripsi: Mengonfigurasi WebSocket. Untuk informasi selengkapnya, lihat Konfigurasi WebSocket.

  • ID Fungsi (FunctionID/FuncId): 144.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Nilai contoh

    enabled

    String

    Ya

    Menentukan apakah akan mengaktifkan WebSocket.

    • on: Mengaktifkan fitur.

    • off: Menonaktifkan fitur.

    on

    origin_scheme

    String

    Tidak

    Protokol untuk permintaan pengambilan asal WebSocket. Nilai yang valid:

    • http: WebSocket menggunakan HTTP untuk pengambilan asal.

    • https: WebSocket menggunakan HTTPS untuk pengambilan asal. Server asal harus mendukung port 443.

    • follow: WebSocket menggunakan protokol yang sama dengan permintaan klien. Server asal harus mendukung port 443 atau port 80.

    Catatan

    Jika Anda tidak mengatur parameter ini, nilai default adalah follow.

    http

    heartbeat

    String

    Tidak

    Waktu habis koneksi.

    • Rentang nilai: 1 hingga 300

    • Satuan: detik

    • Nilai default: 60

    60

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "enabled",
                "argValue": "on"
            }, {
                "argName": "origin_scheme",
                "argValue": "http"
            }, {
                "argName": "heartbeat",
                "argValue": "60"
            }],
            "functionName": "websocket"
        }],
        "DomainNames": "example.com"
    }

Akselerasi aplikasi IP

protogw

  • Deskripsi fitur: Mengonfigurasi akselerasi aplikasi IP. Untuk informasi selengkapnya, lihat Apa itu akselerasi aplikasi IP?.

  • ID Fungsi (FunctionID/FuncId): 163.

  • Parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Contoh

    realip

    String

    Ya

    Menentukan protokol yang digunakan untuk meneruskan alamat IP asal klien. Nilai yang valid:

    • off: Status mati.

    • toa: Meneruskan alamat IP asal klien. Anda harus menginstal modul kernel TOA pada server asal. Tidak diperlukan modifikasi pada program layanan.

    • pp: Meneruskan alamat IP asal klien. Protokol ini didukung oleh Nginx open source secara default. Anda harus memastikan perangkat lunak server asal lainnya kompatibel.

    toa

    port

    String

    Ya

    Port akselerasi.

    Catatan
    • Akselerasi tidak didukung pada port berikut: 22, 123, 161 hingga 162, 179, 830, 2049, 2601, 2605, 3389, 5049, 7547, 8082, 8087, 8182, 8888, 9998, 15772, 15776, 15778 hingga 15779, 18053, 18098 hingga 18099, 18888, 19313, 19777, dan 56667.

    • Untuk menambahkan port 80 atau 443, kirim tiket.

    8443

    mux

    String

    Tidak

    Menentukan apakah akan mengaktifkan multiplexing untuk port. Nilai yang valid:

    • on: Aktif.

    • off: Mati.

    off

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "realip",
                "argValue": "toa"
            }, {
                "argName": "port",
                "argValue": "8443"
            }, {
                "argName": "mux",
                "argValue": "off"
            }],
            "functionName": "protogw"
        }],
        "DomainNames": "example.com"
    }

EdgeScript/Fungsi tepi

edge_function

  • Deskripsi: Mengonfigurasi EdgeScript. Untuk informasi selengkapnya, lihat Ikhtisar EdgeScript.

  • ID Fungsi (FunctionID atau FuncId): 180.

  • Deskripsi parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Contoh

    rule

    String

    Ya

    Aturan DSL.

    if eq($uri, '/') {\n rewrite('https://example.com/index.html', 'redirect')\n}

    pri

    Integer

    Ya

    Prioritas. Nilai yang valid: [0, 999]. Nilai yang lebih kecil menunjukkan prioritas yang lebih tinggi.

    Catatan

    Prioritas untuk eksekusi header dan eksekusi footer bersifat independen satu sama lain.

    0

    enable

    String

    Ya

    Menentukan apakah akan mengaktifkan aturan. Nilai yang valid:

    • on: Aturan diaktifkan.

    • off: Aturan dinonaktifkan.

    on

    name

    String

    Ya

    Nama aturan. Hanya huruf dan garis bawah (_) yang didukung.

    test

    pos

    String

    Tidak

    Posisi tempat aturan dieksekusi. Nilai yang valid:

    • head (default): Aturan dieksekusi di awal alur pemrosesan permintaan.

    • foot: Aturan dieksekusi di akhir alur pemrosesan permintaan.

    head

    brk

    String

    Tidak

    Menentukan apakah akan memutus eksekusi. Nilai yang valid:

    • on: Jika aturan ini terkena, aturan yang tersisa pada posisi eksekusi saat ini dilewati.

    • off (default): Jika aturan ini terkena, aturan yang tersisa masih dieksekusi.

    off

    option

    String

    Tidak

    Bidang ekstensi.

    empty

    grammar

    String

    Tidak

    Sintaks aturan. Nilai yang valid: es2 (default) dan js.

    /

    jsmode

    String

    Tidak

    Mode eksekusi JavaScript (JS). Nilai yang valid:

    • redirect: Mode Blok.

    • bypass (default): Mode bypass.

    /

  • Contoh konfigurasi:

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "name",
                "argValue": "test"
            }, {
                "argName": "rule",
                "argValue": "if eq($uri, '/') {\n  rewrite('https://example.com/index.html', 'redirect')\n}"
            }, {
                "argName": "pri",
                "argValue": "0"
            }, {
                "argName": "pos",
                "argValue": "head"
            }, {
                "argName": "enable",
                "argValue": "on"
            }, {
                "argName": "brk",
                "argValue": "off"
            }, {
                "argName": "option",
                "argValue": ""
            }],
            "functionName": "edge_function"
        }],
        "DomainName": "example.com"
    }

EdgeRoutine

edgeroutine

  • Deskripsi: Mengonfigurasi EdgeRoutine. Untuk informasi selengkapnya, lihat Apa itu fungsi tepi?.

  • ID Fitur (FunctionID/FuncId): 275.

  • Fitur ini hanya tersedia berdasarkan permintaan. Untuk menggunakan fitur ini, Anda harus atau kirim tiket.

Mesin aturan

condition

  • Deskripsi fitur: Mesin aturan memungkinkan Anda mengonfigurasi berbagai aturan bersyarat. Aturan bersyarat mendeteksi parameter dalam permintaan pengguna untuk menentukan apakah konfigurasi berlaku untuk permintaan tertentu. Anda dapat menggunakan aturan ini untuk kontrol yang lebih fleksibel dan tepat atas cara kebijakan konfigurasi DCDN dieksekusi.

  • ID Fitur (FunctionID/FuncId): 250.

  • Deskripsi parameter:

    Parameter

    Tipe

    Wajib

    Deskripsi

    Nilai contoh

    rule

    Array

    Ya

    Isi aturan bersyarat, termasuk namanya, status, operator logika, dan ekspresi bersyarat.

    Isi aturan:

    {\"match\":{\"logic\":\"and\",\"criteria\":[{\"matchType\":\"clientipVer\",\"matchObject\":\"CONNECTING_IP\",\"matchOperator\":\"equals\",\"matchValue\":\"v6\",\"negate\":false}]},\"name\":\"example\",\"status\":\"enable\"}

    Hasil:

    • Nama aturan: example

    • Status: enable

    • Operator logika: and

    • Ekspresi bersyarat: Versi protokol alamat IP klien yang terhubung adalah v6.

    Tabel berikut menjelaskan format ekspresi bersyarat, yaitu format untuk `argValue`:

    Parameter

    Deskripsi

    "match":

    `match` menentukan ekspresi pencocokan bersyarat.

    "logic":"and"

    `logic` menentukan operator logika untuk ekspresi pencocokan bersyarat. Nilai yang valid adalah `and` dan `or`.

    "criteria"

    `criteria` menentukan isi ekspresi bersyarat.

    "matchType":"clientipVer"

    `matchType` menentukan jenis informasi dalam permintaan pengguna untuk dicocokkan.

    "matchObject":"CONNECTING_IP"

    `matchObject` lebih lanjut menentukan jenis pencocokan. Misalnya, alamat IP klien dapat ditentukan sebagai alamat IP yang terhubung atau alamat IP X-Forwarded-For (XFF).

    "matchOperator":"equals"

    `matchOperator` menentukan tindakan untuk operasi pencocokan.

    "matchValue":"v6"

    `matchValue` menentukan nilai preset untuk dicocokkan terhadap informasi dalam permintaan pengguna.

    "negate":false

    `negate` menentukan apakah akan meniadakan hasil ekspresi bersyarat. Nilai yang valid adalah `true` dan `false`.

    "name":"example"

    `name` menentukan nama aturan bersyarat.

    "status":"enable"

    `status` menentukan status aturan bersyarat.

  • Contoh konfigurasi:

    Contoh berikut menunjukkan cara menggunakan OpenAPI untuk menambahkan konfigurasi mesin aturan untuk nama domain yang dipercepat example.com. Konfigurasi ini mencocokkan dan memfilter permintaan berdasarkan apakah versi protokol IP klien adalah IPv6.

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "rule",
                "argValue": "{\"match\":{\"logic\":\"and\",\"criteria\":[{\"matchType\":\"clientipVer\",\"matchObject\":\"CONNECTING_IP\",\"matchOperator\":\"equals\",\"matchValue\":\"v6\",\"negate\":false}]},\"name\":\"example\",\"status\":\"enable\"}"
            }],
            "functionName": "condition"
        }],
        "DomainNames": "example.com"
    }

    Setelah Anda membuat konfigurasi mesin aturan, Anda dapat mengaitkannya dengan konfigurasi fitur lain. Hal ini memberikan kontrol yang lebih fleksibel dan tepat atas cara kebijakan konfigurasi DCDN dieksekusi.

    Catatan:

    • Untuk merujuk konfigurasi mesin aturan dari fitur lain, atur parameter `parentid` ke `configid` aturan bersyarat. `configid` dihasilkan saat Anda menambahkan konfigurasi mesin aturan.

    • Parameter `parentid` tidak didukung saat fungsinya adalah `condition` (mesin aturan).

QUIC

iquic

  • Deskripsi: Mengonfigurasi protokol QUIC. Untuk informasi selengkapnya, lihat Apa itu QUIC?.

  • ID Fungsi: 281.

  • Parameter:

    Parameter

    Type

    Wajib

    Deskripsi

    Nilai contoh

    iquic_enable

    String

    Ya

    Menentukan apakah akan mengaktifkan protokol QUIC:

    • on: Aktifkan

    • off: Nonaktifkan

    on

  • Contoh konfigurasi

    {
        "Functions": [{
            "functionArgs": [{
                "argName": "iquic_enable",
                "argValue": "on"
            }],
            "functionName": "iquic"
        }],
        "DomainNames": "example.com"
    }