文档

BatchSetDcdnDomainConfigs - 批量配置域名

更新时间:

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

接口说明

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

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
dcdn:BatchSetDcdnDomainConfigsWrite
  • domain
    acs:dcdn:*:{#accountId}:domain/{#domainName}

请求参数

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

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

example.com,example.org
Functionsstring

功能列表,格式如下:

  • functionName(功能名称):可配置功能请参见功能列表,多个参数之间用半角逗号(,)分隔。
  • argNamefunctionName 的配置项(可配置多个配置项)。
  • argValuefunctionName 的配置项的取值。
[
 {
   "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
DomainConfigListobject []

域名配置清单。

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 返回结构发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
出参OpenAPI 返回结构发生变更
2023-08-17OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
2023-07-26OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
2023-06-13OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
2023-06-13OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
2023-05-23OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
2023-03-15OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
  • 本页导读 (1)
文档反馈