全部产品
Search
文档中心

Edge Security Acceleration:BatchSetDcdnDomainConfigs

更新时间:Dec 14, 2025

Anda dapat memanggil operasi BatchSetDcdnDomainConfigs untuk mengonfigurasi fitur pada beberapa Domain sekaligus.

Deskripsi operasi

  • Anda dapat mengonfigurasi hingga 50 Domain dalam satu panggilan.

  • Frekuensi panggilan maksimum untuk satu akun adalah 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:BatchSetDcdnDomainConfigs

update

*domain

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

DomainNames

string

Yes

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

  • Anda dapat menentukan hingga 50 nama domain.

  • Jumlah nama domain dikalikan dengan jumlah fungsi tidak boleh melebihi 50.

example.com,example.org

Functions

string

Yes

Daftar fitur. Anda dapat menentukan 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 item konfigurasi untuk functionName.

  • parentid: ID kondisi aturan. Parameter ini bersifat opsional. Anda dapat membuat kondisi aturan menggunakan fungsi condition, yaitu Mesin aturan. Kondisi aturan dapat mendeteksi berbagai parameter dalam permintaan pengguna untuk mencocokkan dan menyaring permintaan tersebut. Setelah kondisi aturan dibuat, configid yang sesuai akan dihasilkan. Anda dapat menggunakan configid sebagai nilai parameter ParentId dan mereferensikannya dalam fungsi lain. Hal ini memungkinkan Anda menggabungkan kondisi aturan dengan konfigurasi fitur untuk membuat konfigurasi yang lebih fleksibel. 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>

Daftar konfigurasi nama domain.

object

ConfigId

integer

ID konfigurasi. Jika nilai yang dikembalikan adalah 0, 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. The specified configuration is invalid.
400 InvalidArgValue.Malformed The specified ArgValue is invalid. The value specified for the ArgValue parameter is invalid.
400 Invalid%s.ValueNotSupported [%s] is not supported. The specified value is not supported.
400 Invalid%s.Malformed The specified ArgValue [%s] is invalid. The value specified for the ArgValue parameter is invalid.
400 MissingParameter You must specify ArgValue. A required parameter is not set.
400 InvalidRule.Malformed %s %s
400 InvalidHeaderKey.ValueNotSupported The specified value of parameter HeaderKey is not supported. The HeaderKey parameter is set to an invalid value.
400 MissingParameter%s The specified value of ArgName %s is missing. A required parameter is not set.
400 InvalidParameter Domain already exists in high ddos. The domain name is already protected by Anti-DDoS services.
400 ConfigExceedLimit Count of config entries exceeds the limit. The number of features 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. 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.
400 ServiceInvokeFailed Failed to invoke service. An error occurred while invoking internal services.
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.