文档首页/ 云防火墙 CFW/ API参考/ API/ IPS管理/ 改变ips规则模式
更新时间:2024-12-25 GMT+08:00

改变ips规则模式

功能介绍

改变ips规则模式

调用方法

请参见如何调用API

URI

POST /v1/{project_id}/ips-rule/mode

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID,可以从调API处获取,也可以从控制台获取。可通过项目ID获取方式获取

表2 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

企业项目ID,用户根据组织规划企业项目,对应的ID为企业项目ID,可通过如何获取企业项目ID获取,用户未开启企业项目时为0

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token,可通过如何获取用户Token获取

表4 请求Body参数

参数

是否必选

参数类型

描述

ips_ids

Array of strings

ips的id列表

object_id

String

防护对象id

status

String

ips规则状态

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

data

IpsRuleChangeRespBody object

表6 IpsRuleChangeRespBody

参数

参数类型

描述

error_code

String

错误代码

error_msg

String

错误信息

group_id

String

分组id

id

String

防火墙id

ips_ids

Array of strings

ips的id列表

result

Boolean

修改结果

请求示例

更改ips规则模式为"OBSERVE"

https://{Endpoint}/v1/408972e72dcd4c1a9b033e955802a36b/ips-rule/mode?fw_instance_id=e743cfaf-8164-4807-aa13-d893d83313cf&enterprise_project_id=fb55459c-41b3-47fc-885d-540946fddda4

{
  "object_id" : "1b90f031-0c7b-4f25-95e2-b6d9940d269e",
  "status" : "OBSERVE",
  "ips_ids" : [ "340724" ]
}

响应示例

状态码: 200

OK

{
  "data" : {
    "group_id" : "e743cfaf-8164-4807-aa13-d893d83313cf",
    "id" : "e743cfaf-8164-4807-aa13-d893d83313cf",
    "ips_ids" : [ "340724" ],
    "result" : true
  }
}

状态码

状态码

描述

200

OK

201

Created

401

Unauthorized

403

Forbidden

404

Not Found

错误码

请参见错误码