All Products
Search
Document Center

Dynamic Content Delivery Network:BatchSetDcdnDomainConfigs

Last Updated:Mar 01, 2024

Configures features for one or more domain names.

Operation description

  • You can specify up to 50 domain names in each request. Separate multiple domain names with commas (,).
  • You can call this operation up to 30 times per second per account.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • The required resource types are displayed in bold characters.
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
dcdn:BatchSetDcdnDomainConfigsWRITE
  • domain
    acs:dcdn:*:{#accountId}:domain/{#domainName}
    none
none

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.

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

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 changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
Output ParametersThe response structure of the API has changed.
2023-08-17The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 400 change
2023-07-26The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 400 change
2023-06-13The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 400 change
2023-06-13The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 400 change
2023-05-23The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 400 change
2023-03-15The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    Error Codes 400 change