All Products
Search
Document Center

Edge Security Acceleration:BatchSetDcdnDomainConfigs

Last Updated:Oct 17, 2024

Configures features for one or more domain names.

Operation description

  • You can specify up to 50 domain names in each request.
  • You can call this operation up to 30 times per second per account.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
DomainNamesstringYes

The accelerated domain names. Specify multiple accelerated domain names with commas (,).

example.com,example.org
FunctionsstringYes

The features that you want to configure. Format:

  • functionName: The name of the feature. Separate multiple values with commas (,). For more information, see A list of features.

  • argName: The feature parameters for functionName.

  • argValue: The parameter values set for functionName.

  • parentid: the rule ID. This parameter is optional. You can use the condition rules engine to create a rule. For information, see Feature settings for domain names. A rule can identify parameters that are included in requests and filter requests based on the identified parameters. After you create a rule, a configid is generated. A configid can be used as parentId that is referenced by other features. This way, you can combine rules and features for flexible configurations.

If the parentId parameter is -1, the existing rules in the configurations are deleted.

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

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

04F0F334-1335-436C-A1D7-6C044FE73368
DomainConfigListarray<object>

The list of domain configurations.

DomainConfigModelobject
ConfigIdlong

The ID of the configuration.

123456
DomainNamestring

The domain name.

www.example.com
FunctionNamestring

The name of the feature.

set_resp_header

Examples

Sample success responses

JSONformat

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

Error codes

HTTP status codeError codeError messageDescription
400InvalidFunctions.MalformedThe specified Functions is invalid.The specified configuration is invalid.
400InvalidArgValue.MalformedThe specified ArgValue is invalid.The value specified for the ArgValue parameter is invalid.
400Invalid%s.ValueNotSupported[%s] is not supported.The specified value is not supported.
400Invalid%s.MalformedThe specified ArgValue [%s] is invalid.The value specified for the ArgValue parameter is invalid.
400MissingParameterYou must specify ArgValue.A required parameter is not set.
400InvalidRule.Malformed%s%s
400InvalidHeaderKey.ValueNotSupportedThe specified value of parameter HeaderKey is not supported.The HeaderKey parameter is set to an invalid value.
400MissingParameter%sThe specified value of ArgName %s is missing.A required parameter is not set.
400InvalidParameterDomain already exists in high ddos.The domain name is already protected by Anti-DDoS services.
400InvalidParameterThe number of domains reached the version limit.The number of domain names has reached the upper limit.
400ConfigExceedLimitCount of config entries exceeds the limit.The number of features exceeds the limit.
400EdgeScriptCountExceedLimitThe number of rules exceeds the default limit (1). To increase the limit, submit a ticket.-
400EdgeScripOptionsHasInnerConfigThe 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.
400EdgeScriptGrammarNotSupportA 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.
400EdgeScriptNotSupportJsJavaScript rules are not supported. For more information, submit a ticket.JavaScript rules are not supported. For more information, submit a ticket.
400ServiceInvokeFailedFailed to invoke service.An error occurred while invoking internal services.
400ConfigParentExceedLimitConfig Parent exceed limit.-
400BatchSetBusinessErrorsome configs error:%s-
400Function.InvalidParentIdThe specified parentId does not exist.-
400Domain.DDosQuotaFullThe user’s domain quota for DDos is full.-
400AccountArrearsThe user‘s account is in arrears.-
400DDosExpiredThe user‘s DDoS protection has expired.-
400Domain.DDosAlreadyExistsThis specified domain has been in DDoS.-
400Domain.PortConfiguringThis specified domain's special ports are configuring.-
400Domain.PortAllocateErrorYour port resource allocation failed, please try again in 30 minutes.-

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-10-10The Error code has changed. The response structure of the API has changedView Change Details
2023-08-17The Error code has changedView Change Details
2023-07-26The Error code has changedView Change Details
2023-06-13The Error code has changedView Change Details
2023-06-13The Error code has changedView Change Details
2023-05-23The Error code has changedView Change Details
2023-03-15The Error code has changedView Change Details