批量开启网页防篡改防护 - BatchStartWebTamperProtection

project_id

是

String

参数解释:

项目ID，用于明确项目归属，配置后可通过该ID查询项目下资产。获取方式请参见获取项目ID。

约束限制:

不涉及

取值范围:

字符长度1-256位

默认取值:

不涉及

enterprise_project_id

否

String

参数解释:

企业项目ID，用于过滤不同企业项目下的资产。获取方式请参见获取企业项目ID。

如需查询所有企业项目下的资产请传参“all_granted_eps”。

约束限制:

开通企业项目功能后才需要配置企业项目ID参数。

取值范围:

字符长度1-256位

默认取值:

0，表示默认企业项目（default）。

X-Auth-Token

是

String

参数解释:

用户Token，包含了用户的身份、权限等信息，在调用API接口时，可通过Token进行身份认证。获取方式请参见获取用户Token。

约束限制:

不涉及

取值范围:

字符长度1-32768位

默认取值:

不涉及

host_id_list

是

Array of strings

参数解释:

需要开启防护的服务器ID列表，仅支持填写未开启网页防篡改防护的服务器ID，已开启网页防篡改防护的服务器可使用UpdateWebTamperHostPolicy接口进行修改策略。

约束限制 :

仅支持填写未开启网页防篡改防护的服务器ID，且Linux服务器和Windows服务器不可同时填写，需分批开启。

取值范围:

最少1条，最多20000条

默认取值 :

不涉及

charging_mode

否

String

参数解释:

计费模式

约束限制:

不涉及

取值范围:

• packet_cycle: 包年/包月，可填写resource_id。

• on_demand: 按需计费，无需填写resource_id。

默认取值:

on_demand

resource_id

否

String

参数解释:

资源ID，即网页防篡改配额的配额ID，当charging_mode选择packet_cycle时可填写该字段，表示使用一个指定配额，也可不填写该字段，表示随机选择符合的配额。

约束限制 :

不涉及

取值范围:

字符长度0-64位

默认取值 :

不涉及

tags

否

Array of TagInfo objects

参数解释：

资源标签列表，仅计费模式选择按需计费时支持填写。

约束限制:

仅计费模式选择按需计费时支持填写。

取值范围:

最少0条，最多2097152条

默认取值:

不涉及

protect_dir_info

是

WebTamperProtectDirRequestInfo object

防护目录信息

enable_timing_off

否

Boolean

参数解释:

定时开关设置状态

约束限制:

不涉及

取值范围:

• True ：开启定时关闭防护功能，必须填写timing_off_config_info。

• False ：关闭定时关闭防护功能，无需填写timing_off_config_info。

默认取值:

False

timing_off_config_info

否

WebTamperTimingOffConfigInfoRequestInfo object

定时开关配置详情

enable_rasp_protect

否

Boolean

参数解释:

动态网页防篡改开启状态，仅Linux服务器支持。

约束限制:

仅Linux服务器支持开启动态网页防篡改，Windows服务器不可填写该字段。

取值范围:

• True ：开启动态网页防篡改，必须填写rasp_path。

• False ：关闭动态网页防篡改，无需填写rasp_path。

默认取值:

False

rasp_path

否

String

参数解释:

动态网页防篡改的Tomcat bin目录，仅Linux服务器支持。

约束限制:

仅Linux服务器支持配置动态网页防篡改的Tomcat bin目录，Windows服务器不可填写该字段。

取值范围:

字符长度1-256位，必须以/开头，不能以/结尾，只能包含英文大小写字母，数字，下划线，中划线和点。

默认取值:

不涉及

enable_privileged_process

否

Boolean

参数解释:

特权进程开启状态

约束限制:

不涉及

取值范围:

• True ：开启特权进程，必须填写privileged_process_info。

• False ：关闭特权进程，无需填写privileged_process_info。

默认取值:

False

privileged_process_info

否

WebTamperPrivilegedProcessRequestInfo object

特权进程配置详情

key

否

String

参数解释：

键

取值范围:

最大长度128个unicode字符。 key不能为空

value

否

String

参数解释：

值

取值范围:

最大长度255个unicode字符。

protect_dir_list

是

Array of WebTamperProtectHostDirRequestInfo objects

参数解释:

防护目录列表

约束限制:

不涉及

取值范围:

最少1条，最多50条

默认取值:

不涉及

exclude_file_type

否

String

参数解释:

排除文件类型

约束限制:

不涉及

取值范围:

文件类型只能输入字母、数字，最多支持10个文件类型，每个文件类型长度不超过10个字符，多个文件类型以分号隔开。

默认取值:

不涉及

protect_mode

否

String

参数解释:

防护模式，仅Linux服务器支持设置防护模式为告警模式，Windows服务器仅支持拦截模式。

约束限制:

不涉及

取值范围:

• recovery ：拦截模式。

• alarm ：告警模式，仅Linux服务器支持。

默认取值:

recovery

protect_dir

是

String

参数解释:

防护目录

约束限制:

不涉及

取值范围:

字符长度1-256位。Linux服务器，必须以/开头，不能以/结尾，只能包含英文大小写字母，数字，下划线，中划线和点。Windows服务器，目录名不能包含;/*?"<>|，不能以空格开头，不能以\结尾。

默认取值:

不涉及

exclude_child_dir

否

String

参数解释:

排除子目录

约束限制:

不涉及

取值范围:

子目录名必须是防护目录的有效相对路径，目录名最大长度不能超过256个字符，最多可添加10个子目录，多个子目录用;隔开。Linux服务器的子目录名不能以/开头或结尾，Windows服务器的子目录名不能以\开头或结尾。

默认取值:

不涉及

exclude_file_path

否

String

参数解释:

排除文件路径

约束限制:

仅Linux服务器支持填写排除文件路径，Windows服务器不可填写该字段。

取值范围:

排除文件路径必须是防护目录的有效相对路径，不能以/开头或结尾，文件路径最大长度不能超过256个字符；最多可添加50个文件路径，多个文件路径用;隔开。

默认取值:

不涉及

local_backup_dir

否

String

参数解释:

本地备份路径，Linux服务器必须填写该字段。

约束限制:

仅Linux服务器需要填写本地备份路径，Windows服务器不可填写该字段。

取值范围:

本地备份路径不能包含;字符，不能以空格开头，不能以/结尾，本地备份路径长度不得超过256个字符。

默认取值:

不涉及

week_off_list

否

Array of integers

参数解释:

自动关闭防护周期列表

约束限制:

不涉及

取值范围:

最少1条，最多7条

默认取值:

不涉及

timing_range_list

否

Array of TimingRangeConfigRequestInfo objects

参数解释:

自动关闭防护时间段

约束限制:

不涉及

取值范围:

最少1条，最多5条

默认取值:

不涉及

time_range

否

String

参数解释:

自动关闭防护的时间段范围，开始时间与结束之间用中划线相连，如15:00-15:30。

约束限制:

每个时间段最短不能少于5分钟。多个时间段之间不允许重叠，且两段时间间隔必须大于5分钟（时间00:00和23:59特例除外）。

取值范围:

字符长度0-20位

默认取值:

不涉及

description

否

String

参数解释:

自动关闭防护的时间段描述

约束限制:

不涉及

取值范围:

字符长度0-20位

默认取值:

不涉及

privileged_process_path_list

否

Array of strings

参数解释:

特权进程文件路径列表

约束限制 :

不涉及

取值范围:

最少0条，最多10条

默认取值 :

不涉及

privileged_child_status

否

Boolean

参数解释:

特权进程子进程可信状态

约束限制 :

不涉及

取值范围:

• True ：开启特权进程子进程可信。

• False ：关闭特权进程子进程可信。

默认取值 :

False

200

请求已成功