文档中心

Web应用防火墙

CC 防护

BatchCopyCCRule-批量复制 CC 规则

根据规则 ID 将 CC 防护规则批量复制到目标域名或域名组。

注意事项

服务接口调用总上限：1000 QPS

单账号调用上限：50 QPS

请求说明

请求方式：POST

请求地址：https://waf.volcengineapi.com/?Action=BatchCopyCCRule&Version=2023-12-25

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

Action String 必选示例值：BatchCopyCCRule

接口名称。当前 API 的名称为 BatchCopyCCRule。

Version String 必选示例值：2023-12-25

接口版本。当前 API 的版本为 2023-12-25。

Body

ProjectName String 可选示例值：default

项目名称，用于关联当前资源对应的项目，仅可关联当前身份下具有权限的项目。获取项目名称可参考 ListProjectResources 接口（获取项目资源列表），也可调用 CreateProject 接口创建新的项目。默认值为 default。

DstHostGroupIDs Integer[] 可选示例值：[7061]

复制 CC 防护规则的目标域名组 ID 列表，数组元素为域名组 ID。该参数与 DstHosts参数选填其一，用于指定规则复制的目标对象。

DstHosts String[] 可选示例值：-

复制 CC 防护规则的目标域名列表，数组元素为域名字符串。该参数与DstHostGroupIDs参数选填其一，用于指定规则复制的目标对象。

DstRulePriorityAdjustType Integer 必选示例值：1

复制后规则的插入方式，支持的取值如下所示。

1：按最低优先级插入；

2：按最高优先级插入。

OverwriteSameName Boolean 可选示例值：true

是否覆盖目标域名下同名的 CC 防护规则。默认值为 false。

取值为 true 时表示覆盖同名规则

取值为 false 时表示跳过同名规则。

SrcRuleID Integer 必选示例值：54253

指定需要复制的 CC 防护规则的唯一标识 ID，接口将基于该 ID 找到对应的规则并进行批量复制操作。

返回参数

FailedHosts Object[] 示例值：-

复制 CC 防护规则失败的域名列表，每个元素包含域名和失败原因。

Host String 示例值：example.volcwaf.com

复制 CC 防护规则失败的域名.

Reason Integer 示例值：1

复制 CC 防护规则到目标域名失败的原因代码，包括：

0：未知错误；

1：内部错误；

2：域名不存在；

3：CC 规则数量已到上限；

4：CC 规则优先级冲突；

5：CC 规则冲突；

6：路径下高级条件组数量已到上限。

SkippedHosts String[] 示例值：["example.volc001.com"]

批量复制 CC 防护规则时，被跳过复制的域名列表，数组元素为域名字符串。

SuccessHosts String[] 示例值：["example.volc002.com"]

批量复制CCv3规则时，成功复制规则的目标域名列表，数组元素为域名字符串。

错误码

您可访问公共错误码，获取更多错误码信息。

输入示例 1

输入示例

POST https://waf.volcengineapi.com/?Action=BatchCopyCCRule&Version=2023-12-25&ProjectName=default
X-Date: 20230711T035055Z
Authorization: HMAC-SHA256 Credential=AKLTNGU0OGEyMT***/20230711/cn-beijing/waf/request, SignedHeaders=content-type;x-content-sha256;x-date, Signature=da4fac562d00f41ad8***

{
  "DstHostGroupIDs": [
    7061
  ],
  "DstRulePriorityAdjustType": 1,
  "OverwriteSameName": true,
  "SrcRuleID": 54253
}

输出示例

{
    "ResponseMetadata": {
        "RequestId": "20231009200242CE25C146B591DDCE****",
        "Action": "BatchCopyCCRule",
        "Version": "2023-12-25",
        "Service": "waf",
        "Region": "cn-beijing"
    },
    "Result": null
}

最近更新时间：2026.06.03 17:05:18

这个页面对您有帮助吗？

有用

无用