全部产品
Search
文档中心

边缘安全加速:BatchSetDcdnDomainConfigs - 批量配置域名

更新时间:Oct 17, 2024

调用BatchSetDcdnDomainConfigs实现域名批量配置功能。

接口说明

  • 单次配置的域名数量不超过 50 个。
  • 单用户调用频率:30 次/秒。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
DomainNamesstring

您的加速域名,多个域名使用半角逗号(,)分隔。

example.com,example.org
Functionsstring

功能列表,格式如下:

  • functionName(功能名称):可配置功能请参见功能列表,多个参数之间用半角逗号(,)分隔。
  • argNamefunctionName 的配置项(可配置多个配置项)。
  • argValuefunctionName 的配置项的取值。
  • parentid(规则条件 ID,非必填):通过配置域名配置功能参数中的功能函数 condition(规则引擎),可以创建出规则条件(规则条件可以通过识别用户请求中携带的各种参数来匹配和过滤用户请求),每一个规则条件被创建以后都会生成一个对应的 configid ,configid 可以被当作 ParentId 参数被其他功能函数引用,这样规则条件就可以与功能配置一起组合形成更灵活的配置。
[
 {
   "functionArgs": [
    {
     "argName": "功能参数 A", 
     "argValue": "功能参数 A 对应的值"
    }, 
  {
    "argName": "功能参数 B", 
    "argValue": "功能参数 B 对应的值"
     }
 ], 
 "functionName": "功能名称"
    }
]
[{"functionArgs":[{"argName":"switch","argValue":"on"},{"argName":"region","argValue":"*"}],"functionName":"ipv6"}]

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

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

域名配置清单。

DomainConfigModelobject
ConfigIdlong

配置 ID,如果返回为 0,则表示该条配置未配置成功,需要重新配置。

123456
DomainNamestring

域名。

www.example.com
FunctionNamestring

功能名称。

set_resp_header

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400InvalidFunctions.MalformedThe specified Functions is invalid.不支持该配置,请重新填写。
400InvalidArgValue.MalformedThe specified ArgValue is invalid.ArgValue错误,请重新填写。
400Invalid%s.ValueNotSupported[%s] is not supported.不支持该设置。
400Invalid%s.MalformedThe specified ArgValue [%s] is invalid.不支持该ArgValue,请填写正确的ArgValue。
400MissingParameterYou must specify ArgValue.缺少参数。
400InvalidRule.Malformed%s%s
400InvalidHeaderKey.ValueNotSupportedThe specified value of parameter HeaderKey is not supported.HeaderKey的值不合法。
400MissingParameter%sThe specified value of ArgName %s is missing.缺少参数。
400InvalidParameterDomain already exists in high ddos.开通的域名已经在高防中开通服务
400InvalidParameterThe number of domains reached the version limit.已开通的域名数量达到版本限制
400ConfigExceedLimitCount of config entries 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.扩展项存在后台配置或该配置的参数不合法,如有疑问,请提交工单咨询
400EdgeScriptGrammarNotSupportA background customization rule exists or a parameter of this configuration is invalid. For more information, submit a ticket.存在后台定制规则或该配置的参数不合法,如有疑问,请提交工单咨询
400EdgeScriptNotSupportJsJavaScript rules are not supported. For more information, submit a ticket.未开放JS规则,如有疑问,请提交工单咨询
400ServiceInvokeFailedFailed to invoke service.调用内部服务失败。
400ConfigParentExceedLimitConfig Parent exceed limit.已引用的高级条件规则超过5条
400BatchSetBusinessErrorsome configs error:%s发生配置错误:%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.您的DDoS防护已过期,无法操作
400Domain.DDosAlreadyExistsThis specified domain has been in DDoS.该域名已接入阿里云高防产品,请删除后再接入DCDN DDoS防护
400Domain.PortConfiguringThis specified domain's special ports are configuring.域名的特殊端口配置中,请稍后
400Domain.PortAllocateErrorYour port resource allocation failed, please try again in 30 minutes.您本次提交的自定义端口资源分配失败,请30分钟后重试。多次重试失败可提交工单处理

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2023-10-10OpenAPI 错误码发生变更、OpenAPI 返回结构发生变更查看变更详情
2023-08-17OpenAPI 错误码发生变更查看变更详情
2023-07-26OpenAPI 错误码发生变更查看变更详情
2023-06-13OpenAPI 错误码发生变更查看变更详情
2023-06-13OpenAPI 错误码发生变更查看变更详情
2023-05-23OpenAPI 错误码发生变更查看变更详情
2023-03-15OpenAPI 错误码发生变更查看变更详情