All Products
Search
Document Center

Edge Security Acceleration:BatchSetDcdnDomainConfigs

Last Updated:Sep 11, 2026

Calls the BatchSetDcdnDomainConfigs operation to configure multiple domain names at a time.

Operation description

  • Single-user call frequency: 30 calls per second.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

dcdn:BatchSetDcdnDomainConfigs

update

*domain

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

None None

Request parameters

Parameter

Type

Required

Description

Example

DomainNames

string

Yes

The accelerated domain names. Separate multiple domain names with commas (,). Note the following configuration limits:

  • The product of "Number of domain names" multiplied by "Number of Functions" must be less than or equal to 20. For example:
    • If the number of Functions configured at a time is 20, you can specify only 1 domain name at a time.

    • If the number of Functions configured at a time is 1, you can specify up to 20 domain names at a time.

example.com,example.org

Functions

string

Yes

The list of features. Note the following configuration limits:

  • The product of "Number of domain names" multiplied by "Number of Functions" must be less than or equal to 20. For example:
    • If the number of Functions configured at a time is 20, you can specify only 1 domain name at a time.

    • If the number of Functions configured at a time is 1, you can specify up to 20 domain names at a time.

The format is as follows:

  • functionName (feature name): For configurable features, see Feature list. Separate multiple parameters with commas (,).

  • argName: The configuration item of functionName. You can configure multiple configuration items.

  • argValue: The value of the configuration item of functionName.

  • parentid (rule condition ID, optional): By configuring the condition feature function (rule engine) in Domain name configuration feature parameters, you can create rule conditions. Rule conditions can match and filter user requests by identifying various parameters carried in user requests. After each rule condition is created, a corresponding configid is generated. The configid can be used as the ParentId parameter and referenced by other feature functions. This way, rule conditions can be combined with feature configurations to form more flexible configurations.

[
 {
   "functionArgs": [
    {
     "argName": "Feature parameter A", 
     "argValue": "Value of feature parameter A"
    }, 
  {
    "argName": "Feature parameter B", 
    "argValue": "Value of feature parameter B"
     }
 ], 
 "functionName": "Feature name"
    }
]

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

Response elements

Element

Type

Description

Example

object

RequestId

string

The request ID.

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

DomainConfigList

object

DomainConfigModel

array<object>

The domain name configuration list.

object

ConfigId

integer

The configuration ID. If the returned value is 0, the configuration was not applied. You must reconfigure the settings.

123456

DomainName

string

The domain name.

www.example.com

FunctionName

string

The feature name.

set_resp_header

Examples

Success response

JSON format

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

Error codes

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. The number of referenced advanced condition rules exceeds 5.
400 BatchSetBusinessError some configs error:%s A configuration error occurred: %s.
400 Function.InvalidParentId The specified parentId does not exist. The specified rule condition does not exist.
400 Domain.DDosQuotaFull The user’s domain quota for DDos is full. The number of protected domain names has reached the upper limit. Upgrade your plan to increase the domain name quota.
400 AccountArrears The user‘s account is in arrears. Your account has an overdue payment. The operation cannot be performed.
400 DDosExpired The user‘s DDoS protection has expired. Your DDoS protection has expired. The operation cannot be performed.
400 Domain.DDosAlreadyExists This specified domain has been in DDoS. The domain name is already connected to Alibaba Cloud Anti-DDoS. Remove it before connecting to DCDN DDoS protection.
400 Domain.PortConfiguring This specified domain's special ports are configuring. The special port configuration for the domain name is in progress. Try again later.
400 Domain.PortAllocateError Your port resource allocation failed, please try again in 30 minutes. The custom port resource allocation failed. Try again after 30 minutes. If the issue persists after multiple retries, submit a ticket.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.