All Products
Search

This Product

    Edge Security Acceleration:SetDcdnDomainStagingConfig

    Document Center

    Edge Security Acceleration:SetDcdnDomainStagingConfig

    Last Updated:Dec 14, 2025

    Panggil operasi SetDcdnDomainStagingConfig untuk mengatur atau memodifikasi konfigurasi domain di lingkungan staging.

    Deskripsi operasi

    Catatan

    Frekuensi panggilan untuk satu pengguna dibatasi hingga 30 panggilan per detik.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    dcdn:SetDcdnDomainStagingConfig

    update

    *domain

    acs:dcdn:*:{#accountId}:domain/{#domainName}

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DomainName

    string

    Yes

    Nama domain yang dipercepat. Pisahkan beberapa nama domain dengan koma (,).

    example.com
    Functions

    string

    Yes

    Daftar fitur. Formatnya sebagai berikut:

    • functionName (nama fitur, wajib): Untuk daftar fitur yang dapat dikonfigurasi, lihat Daftar fitur.

    • argName (nama parameter, wajib): Parameter untuk functionName. Anda dapat menentukan beberapa parameter.

    • argValue (nilai parameter, wajib): Nilai parameter untuk functionName.

    • parentId (ID aturan kondisional, opsional): Anda dapat membuat aturan kondisional menggunakan fungsi condition dari Mesin aturan. Aturan ini mencocokkan dan memfilter permintaan pengguna berdasarkan parameter permintaan. Setiap aturan kondisional memiliki configid unik. Anda dapat menggunakan configid ini sebagai parameter ParentId untuk mereferensikan aturan tersebut dalam fungsi lain. Hal ini memungkinkan Anda menggabungkan aturan kondisional dengan konfigurasi fitur untuk fleksibilitas yang lebih tinggi. Untuk informasi selengkapnya, lihat Parameter untuk fitur konfigurasi nama domain.

    Jika Anda mengatur parentId ke -1, aturan kondisional yang ada dalam konfigurasi akan dihapus.

    "functionArgs": [{
   "argName": "Feature Parameter A", 
   "argValue": "Value of Feature Parameter A"
  }, 
{
  "argName": "Feature Parameter B", 
  "argValue": "Value of Feature Parameter B"
   }],

    "functionName": "Feature Name", "parentId": Opsional. Sesuai dengan configid dari aturan kondisional yang direferensikan. }]

    Contoh konfigurasi tanpa menggunakan parentId: Parameter permintaan berikut menunjukkan cara menggunakan fungsi origin_request_header untuk menambahkan header ke Permintaan asal:

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

    Contoh konfigurasi menggunakan parentId: Parameter permintaan berikut menunjukkan cara menggunakan fungsi origin_request_header untuk menambahkan header ke Permintaan asal dengan mereferensikan aturan kondisional yang memiliki configid=222728944812032:

            "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",
        "parentId": 222728944812032
}]

    Contoh penghapusan referensi parentId dari konfigurasi fitur: Fungsi origin_request_header sudah mereferensikan aturan kondisional dengan configid=222728944812032. Untuk menghapus referensi tersebut, gunakan parameter permintaan berikut:

            "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",
        "parentId": -1
}]

    [{"functionArgs": [{"argName": "key","argValue": "Content-Encoding"},{"argName": "value","argValue": "gzip"}],"functionName": "set_resp_header"} ]

    Beberapa fitur, seperti edge_function, memungkinkan Anda mengonfigurasi beberapa catatan. Untuk memperbarui catatan tertentu, gunakan ConfigId-nya (bertipe Long) untuk menentukan konfigurasi yang ingin dimodifikasi. Formatnya sebagai berikut:

    [{"functionArgs":[{"argName":"enable","argValue":"on"},{"argName":"pri","argValue":"1"},{"argName":"rule","argValue":"yyy"}],"ConfigId":123456,"functionName":"edge_function"}]

    Deskripsi fitur: Semua nilai parameter diproses sebagai string.

    Nama fitur

    Parameter

    edge_function: Edge Routine

    Parameter wajib:
    rule: Aturan DSL.
    pri: Prioritas.
    enable: Menentukan apakah aturan saat ini diaktifkan. Nilai yang valid: on dan off.
    Parameter opsional:
    name: Nama aturan.
    pos: Posisi eksekusi aturan. Untuk nama domain DCDN, hanya head yang didukung. foot tidak didukung.
    brk: Jika aturan ini cocok, aturan tersisa pada posisi eksekusi saat ini dilewati.
    option: Kontrol opsi.
    grammar: Kontrol tata bahasa. Nilai yang valid: kosong, es2, dan js.
    jsmode: Kontrol daftar putih nama domain JavaScript (JS). Nilai yang valid: redirect dan bypass.






























    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    ID permintaan.

    04F0F334-1335-436C-A1D7-6C044FE73368

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidFunctionName.ValueNotSupported %s %s
    400 InvalidArgName.ValueNotSupported %s The name of the %s parameter is invalid.
    400 InvalidArgValue.Malformed %s %s
    400 InvalidRule.Malformed %s %s
    400 ConfigurationConflicts The staging environment has a configuration in effect. You cannot modify the production environment configuration. The configuration exists in the staging environment. You cannot modify the configuration in the production environment.
    400 GrayConfigExist A canary configuration already exists under the domain. The domain name already has configurations in canary release.
    400 InvalidDomain.BelongToConfigGroup The domain is bound to a configuration group. Modify the domain in the configuration group. The domain name is associated with a configuration group. To modify the configuration of the domain name, you must modify the configuration group.
    400 EdgeScriptCountExceedLimit The number of rules exceeds the default limit. The number of rules exceeds the limit. To increase the limit, submit a ticket.
    400 EdgeScripOptionsHasInnerConfig The extension has a background configuration or a parameter of this configuration is invalid. For more information, submit a ticket. The extension has a background configuration or a configured parameter is invalid. For more information, submit a ticket.
    400 EdgeScriptGrammarNotSupport A background customization rule exists or a parameter of this configuration is invalid. For more information, submit a ticket. A background custom rule exists or a configured parameter is invalid. For more information, submit a ticket.
    400 EdgeScriptNotSupportJs JavaScript rules are not supported. For more information, submit a ticket. JavaScript rules are not supported. For more information, submit a ticket.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.