创建防篡改规则
功能介绍
创建防篡改规则
URI
POST /v1/{project_id}/waf/policy/{policy_id}/antitamper
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID,对应控制台用户名->我的凭证->项目列表->项目ID |
| policy_id | 是 | String | 防护策略id,您可以通过调用查询防护策略列表(ListPolicy)获取策略id |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| enterprise_project_id | 否 | String | 您可以通过调用企业项目管理服务(EPS)的查询企业项目列表接口(ListEnterpriseProject)查询企业项目id |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token,通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
| Content-Type | 是 | String | 内容类型 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| hostname | 是 | String | 防护网站,查询云模式防护域名列表(ListHost)接口获取防护域名,响应体中的的hostname字段 |
| url | 是 | String | 防篡改规则防护的url,需要填写标准的url格式,例如/admin/xxx或者/admin/,以""号结尾代表路径前缀 |
| description | 否 | String | 规则描述 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 规则id |
| policyid | String | 策略id |
| hostname | String | 防篡改的域名 |
| url | String | 防篡改的url, |
| description | String | 创建规则的时间戳 |
| status | Integer | 规则状态,0:关闭,1:开启 |
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误信息 |
状态码:401
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误信息 |
状态码:500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 错误码 |
| error_msg | String | 错误信息 |
请求示例
在项目id为project_id,防护策略id为policy_id的防护策略下创建防篡改规则。创建防篡改规则的防护网站为"www.demo.com",防篡改规则防护的url为 "/test",规则描述为"demo"。
POST https://{Endpoint}/v1/{project_id}/waf/policy/{policy_id}/antitamper?enterprise_project_id=0
{
"hostname" : "www.demo.com",
"url" : "/test",
"description" : "demo"
} 响应示例
状态码:200
请求成功
{
"id" : "eed1c1e9c1b04b4bad4ba1186387a5d8",
"policyid" : "38ff0cb9a10e4d5293c642bc0350fa6d",
"description" : "demo",
"status" : 1,
"hostname" : "www.demo.com",
"url" : "/test"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求失败 |
| 401 | token权限不足 |
| 500 | 服务器内部错误 |
错误码
请参见错误码。