全部产品
Search
文档中心

CDN:BatchSetCdnDomainConfig

更新时间:Dec 14, 2025

Anda dapat memanggil operasi BatchSetCdnDomainConfig untuk mengonfigurasi beberapa domain sekaligus.

Deskripsi operasi

  • Frekuensi pemanggilan untuk satu pengguna dibatasi hingga 3 kali per detik.

  • Anda dapat mengonfigurasi hingga 50 domain dalam satu batch. Pisahkan domain dengan koma (,).

  • Saat Anda memanggil operasi BatchSetCdnDomainConfig untuk mengonfigurasi fitur pada suatu domain, sebuah ConfigId unik akan dihasilkan. Anda dapat menggunakan ConfigId tersebut untuk memperbarui atau menghapus konfigurasi. Untuk informasi selengkapnya, lihat Kueri dan penggunaan ConfigId.

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

cdn:BatchSetCdnDomainConfig

update

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainNames}

None
  • ram:CreateServiceLinkedRole

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 sekaligus.

  • Jumlah nama domain × jumlah fitur harus kurang dari atau sama dengan 50.

www.example.com

Functions

string

Yes

Daftar fitur. Anda dapat menentukan hingga 50 fitur sekaligus. Formatnya sebagai berikut:

  • functionName (Nama fitur. Wajib): Untuk daftar fitur yang dapat dikonfigurasi, lihat Fitur. Pisahkan beberapa parameter dengan koma (,).

  • argName (Nama parameter. Wajib): Item konfigurasi untuk functionName. Anda dapat mengonfigurasi beberapa item.

  • argValue (Nilai parameter. Wajib): Nilai item konfigurasi untuk functionName.

  • parentid (ID kondisi aturan. Opsional): Anda dapat membuat aturan kondisional dengan mengonfigurasi fitur condition (rules engine). Aturan kondisional mencocokkan dan menyaring permintaan pengguna dengan mendeteksi berbagai parameter dalam permintaan tersebut. Untuk informasi selengkapnya tentang fitur condition, lihat Parameter untuk fitur konfigurasi nama domain. Setelah aturan kondisional dibuat, sebuah configid yang sesuai akan dihasilkan. Fitur lain dapat mereferensikan configid ini sebagai parameter ParentId. Hal ini memungkinkan Anda menggabungkan aturan kondisional dengan konfigurasi fitur untuk pengaturan yang lebih fleksibel.

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

   "functionArgs": [{
     "argName": "Parameter A", 
     "argValue": "Value of Parameter A"
    }, 
  {
    "argName": "Parameter B", 
    "argValue": "Value of Parameter B"
     }], 
 "functionName": "Feature name",
 "parentId": Optional. The configid of the referenced conditional rule.
}]

Contoh berikut menunjukkan konfigurasi yang tidak menggunakan parentId. Fitur origin_request_header digunakan untuk menambahkan Header HTTP saat fetch origin.

        "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 berikut menunjukkan konfigurasi yang menggunakan parentId. Fitur origin_request_header digunakan untuk menambahkan Header HTTP saat fetch origin dan mereferensikan aturan kondisional dengan 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 berikut menunjukkan cara menghapus referensi ke aturan kondisional. Fitur origin_request_header sebelumnya mereferensikan aturan kondisional dengan configid=222728944812032. Untuk menghapus referensi tersebut, atur parentId ke -1.

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

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 0 dikembalikan, konfigurasi gagal. Konfigurasikan ulang fitur tersebut.

1234567

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": 1234567,
        "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 incorrectly formatted.
400 InvalidArgValue.Malformed The specified ArgValue is invalid. Specified ArgValue is malformed.
400 Invalid%s.ValueNotSupported [%s] is not supported.
400 Invalid%s.Malformed The specified ArgValue [%s] is invalid.
400 MissingParameter%s The specified value of ArgName[%s] is missing. You must specify this parameter.
400 InvalidFunctionArgs.Malformed The specified FunctionArgs is invalid. The specified feature parameter is invalid.
400 MissingParameter The specified ArgValue is missing.
400 InvalidHeaderKey.ValueNotSupported The specified value of parameter HeaderKey is not supported. The specified HTTP header is invalid. Valid values: Content-Type, Cache-Control, Content-Disposition, Content-Language, Expires, Access-Control-Allow-Origin, Access-Control-Allow-Methods, Access-Control-Allow-Headers, Access-Control-Max-Age, Access-Control-Expose-Headers, and Access-Control-Allow-Credentials.
400 TooManyDomains The count of domain is over 50.
400 InvalidRule.Malformed %s
400 ConfigurationConflicts The staging environment has a configuration in effect and cannot modify the production environment configuration. Failed to modify the parameter settings in the production environment because the parameter settings are different from those in the stating environment. Set parameters in the staging environment before you publish them to the production environment.
400 InvalidFunction.NotSupported The domain is not supported to set the function. This feature is not supported for domain names.
400 InvalidDomain.BelongToConfigGroup This Domain activated in configuration group and should modify by config group.
400 EntityNotExist.Role EntityNotExist.Role
400 MissingParameterFunctions The specified value of Functions is missing.
400 NoPermission.SLR The current user does not have permission to create servicelinkedrole. Please contact the Alibaba Cloud account or administrator to authorize AliyunCDNFullAccess or custom policy:Service Name:cdn-ddos.cdn.aliyuncs.com,Role: AliyunServiceRoleForCDNAccessingDDoS,Permission: ram: CreateServiceLinkedRole You are not authorized to create service-linked roles. Obtain the AliyunCDNFullAccess permission or custom permission policies used to create service-linked roles from your Alibaba Cloud account or the administrator. Obtain custom permissions based on the following information: Service Name: cdn-ddos.cdn.aliyuncs.com, Service-linked Role Name: AliyunServiceRoleForCDNAccessingDDoS, Required Permission: ram:CreateServiceLinkedRole.
400 ConfigExceedLimit Count of config entries exceeds the limit. The upper limit is reached.
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.
400 ServiceInvokeFailed Failed to invoke service. An internal server error occurred.
400 ConfigParentExceedLimit Config parent exceed limit. The referenced advanced conditional rule exceeds the threshold.
400 Function.InvalidParentId The specified parentId does not exist. The specified rule does not exist.
400 BatchSetBusinessError some configs error:%s A configuration error occurred: %s
400 ConfigDuplicate Duplicate configuration. This function has already been configured and cannot be added repeatedly. Duplicate configuration. This function has already been configured and cannot be added repeatedly.
400 FunctionArgError The function parameter of the domain configuration is incorrect.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.