接口功能介绍
基线策略修改接口
接口约束
此功能为收费功能。确认已经购买系统配额,并且开启基线扫描配置。如果没有购买配额,可按照页面提示进行购买。如果没有开启防护,请在服务器列表页开启机器防护
URI
POST /v1/sca/rule/update
路径参数
无
Query参数
无
请求参数
请求头header参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
regionid | 是 | String | 资源池id | 100054c0416811e9a6690242ac110002 | |
urlType | 是 | String | 请求地址类型。CTAPI | CTAPI | |
Content-Type | 是 | String | Content-Type | application/json |
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
id | 否 | Integer | 策略id,如果不填,则默认为0 | 11 | |
name | 否 | String | 策略名称,条件必填,checkfrequency,name,scaIds,agentGuids 4个字段任意一个填写了,必须填写本字段 | ||
agentGuids | 否 | String | 策略对应服务agentGuid,多个使用英文逗号隔开。全部:ALL。条件必填,checkfrequency,name,scaIds,agentGuids 4个字段任意一个填写了,必须填写本字段 | E3F52992-6046-4FA4-A926-61E45B184720 | |
checkfrequency | 否 | String | 检测频率1-每1天 2-每3天 3-每7天 4-每7天。条件必填,checkfrequency,name,scaIds,agentGuids 4个字段任意一个填写了,必须填写本字段 | 1 | |
checktime | 否 | String | 检测时间 00:00-06:00,06:00-12:00。条件必填,checkfrequency,name,scaIds,agentGuids 4个字段任意一个填写了,必须填写本字段 | 00:00-06:00 | |
ruleStatus | 否 | Boolean | 策略开关,true:开启,false:关闭,非必填,如果不填,则默认为false | ||
scaIds | 否 | String | 基线模板Id,多个使用英文逗号隔开。条件必填,checkfrequency,name,scaIds,agentGuids 4个字段任意一个填写了,必须填写本字段 |
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | String | 状态码 200-成功 | ||
error | String | 返回码 CTCSSCN_000000:成功 CTCSSCN_000001:失败 CTCSSCN_000003:用户未签署协议,安全卫士系统无法正常使用 CTCSSCN_000004:鉴权错误 CTCSSCN_000005:用户没有付费版配额,功能不可用 |
CTCSSCN_000000 | |
message | String | 返回信息 | 成功 | |
returnObj | Object | 返回对象 |
枚举参数
无
请求示例
请求url
无
请求头header
{"regionid": "100054c0416811e9a6690242ac110002","Content-Type":"application/json","urlType": "CTAPI"}
请求体body
{"id":228,"agentGuids":"ALL","checkfrequency":1,"checktime":"00:00-01:00","name":"windows","scaIds":"9,18,23,11","ruleStatus":true}
响应示例
{"statusCode": "200","error": "CTCSSCN_000000","message": "成功!","returnObj": null}
状态码
请参考 状态码
错误码
请参考 错误码