All Products
Search
Document Center

Edge Security Acceleration:BatchSetDcdnDomainConfigs

Last Updated:Mar 23, 2026

Gunakan BatchSetDcdnDomainConfigs untuk mengonfigurasi fitur beberapa nama domain sekaligus.

Deskripsi operasi

  • Anda dapat menyertakan hingga 50 nama domain dalam satu permintaan.

  • Batas laju adalah 30 panggilan per detik per akun.

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:BatchSetDcdnDomainConfigs

update

*domain

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

DomainNames

string

Yes

Nama domain yang akan dipercepat. Pisahkan beberapa nama domain dengan koma (,). Perhatikan batasan berikut:

  • Anda dapat menentukan maksimal 20 nama domain.

  • Hasil perkalian jumlah nama domain dan jumlah fitur dalam parameter Functions tidak boleh melebihi 50.

example.com,example.org

Functions

string

Yes

Daftar hingga 50 fitur. Gunakan format berikut:

  • functionName: Nama fitur. Untuk daftar fitur yang dapat dikonfigurasi, lihat Feature list.

  • argName: Item konfigurasi untuk fitur yang ditentukan oleh functionName. Anda dapat menentukan beberapa item konfigurasi.

  • argValue: Nilai untuk argName yang ditentukan.

  • parentid: ID kondisi aturan. Parameter ini bersifat opsional. Anda dapat membuat kondisi aturan dengan menggunakan fungsi condition, bagian dari rules engine. Kondisi aturan menyaring permintaan pengguna berdasarkan parameter tertentu. Membuat kondisi aturan akan menghasilkan configid. Anda kemudian dapat menggunakan configid ini sebagai nilai parameter parentid untuk mereferensikan kondisi tersebut dalam fungsi lain. Hal ini memungkinkan Anda menggabungkan kondisi aturan dengan konfigurasi fitur untuk fleksibilitas yang lebih besar. Untuk informasi selengkapnya tentang fungsi yang dapat dikonfigurasi, lihat Parameters for domain name configuration features.

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

[{"functionArgs":[{"argName":"switch","argValue":"on"},{"argName":"region","argValue":"*"}],"functionName":"ipv6"}]

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

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

DomainConfigList

object

DomainConfigModel

array<object>

Konfigurasi nama domain.

object

ConfigId

integer

ID konfigurasi. Jika nilai 0 dikembalikan, konfigurasi gagal. Anda harus mengonfigurasi ulang fitur tersebut.

123456

DomainName

string

Nama domain.

www.example.com

FunctionName

string

Nama fitur.

set_resp_header

Contoh

Respons sukses

JSONformat

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  "DomainConfigList": {
    "DomainConfigModel": [
      {
        "ConfigId": 123456,
        "DomainName": "www.example.com",
        "FunctionName": "set_resp_header"
      }
    ]
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidFunctions.Malformed The specified Functions is invalid.
400 InvalidArgValue.Malformed The specified ArgValue is invalid.
400 Invalid%s.ValueNotSupported [%s] is not supported.
400 Invalid%s.Malformed The specified ArgValue [%s] is invalid.
400 MissingParameter You must specify ArgValue.
400 InvalidRule.Malformed %s
400 InvalidHeaderKey.ValueNotSupported The specified value of parameter HeaderKey is not supported.
400 MissingParameter%s The specified value of ArgName %s is missing.
400 InvalidParameter Domain already exists in high ddos.
400 ConfigExceedLimit Count of config entries exceeds the limit.
400 EdgeScriptCountExceedLimit The number of rules exceeds the default limit (1). 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.
400 EdgeScriptGrammarNotSupport A background customization rule exists or a parameter of this configuration is invalid. For more information, submit a ticket.
400 EdgeScriptNotSupportJs JavaScript rules are not supported. For more information, submit a ticket.
400 ServiceInvokeFailed Failed to invoke service.
400 ConfigParentExceedLimit Config Parent exceed limit.
400 BatchSetBusinessError some configs error:%s
400 Function.InvalidParentId The specified parentId does not exist.
400 Domain.DDosQuotaFull The user’s domain quota for DDos is full.
400 AccountArrears The user‘s account is in arrears.
400 DDosExpired The user‘s DDoS protection has expired.
400 Domain.DDosAlreadyExists This specified domain has been in DDoS.
400 Domain.PortConfiguring This specified domain's special ports are configuring.
400 Domain.PortAllocateError Your port resource allocation failed, please try again in 30 minutes.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.