更新时间:2024-11-18 GMT+08:00

查询IP黑白名单规则列表

功能介绍

查询IP黑白名单规则列表

URI

GET /v1/edgesec/configuration/http/policies/{policy_id}/blocktrustip-rule

表1 路径参数

参数

是否必选

参数类型

描述

policy_id

String

策略id

表2 Query参数

参数

是否必选

参数类型

描述

name

String

规则名称

addr

String

ip/ip段

page

Integer

分页查询参数,第page页

pagesize

Integer

分页查询参数,每页显示pagesize条记录

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

auth token

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

total

Integer

策略下防护规则数量

items

Array of ShowHttpBlockTrustIpRuleResponseBody objects

防护规则列表

size

Long

防护规则下IP/IP段数量

表5 ShowHttpBlockTrustIpRuleResponseBody

参数

参数类型

描述

id

String

规则id

name

String

规则名称

policy_id

String

规则所在策略id

policy_name

String

规则所在策略名称

timestamp

Long

创建规则时间戳

description

String

规则描述

status

Integer

规则开关:

  • 0:关闭

  • 1:开启

addr

String

ip地址/地址段

white

Integer

  • 0:拦截

  • 1:放行

  • 2:仅记录

followed_action_id

String

攻击惩罚规则id

ip_group

HttpIpGroup object

ip地址组

表6 HttpIpGroup

参数

参数类型

描述

id

String

ip地址组id

name

String

ip地址组名称

ips

Array of strings

ip地址/地址段列表

size

Integer

ip地址/地址段大小

description

String

ip地址组描述

create_time

Long

ip地址组创建时间戳

状态码: 400

表7 响应Body参数

参数

参数类型

描述

error_code

String

标准化错误码:服务名.八位数字编码

error_msg

String

清晰的错误信息

encoded_authorization_message

String

对接IAM5.0的服务,拒绝访问时需要返回IAM的相关响应

状态码: 401

表8 响应Body参数

参数

参数类型

描述

error_code

String

标准化错误码:服务名.八位数字编码

error_msg

String

清晰的错误信息

encoded_authorization_message

String

对接IAM5.0的服务,拒绝访问时需要返回IAM的相关响应

状态码: 500

表9 响应Body参数

参数

参数类型

描述

error_code

String

标准化错误码:服务名.八位数字编码

error_msg

String

清晰的错误信息

encoded_authorization_message

String

对接IAM5.0的服务,拒绝访问时需要返回IAM的相关响应

请求示例

响应示例

状态码

状态码

描述

200

OK

400

请求失败

401

token权限不足

500

服务器内部错误

错误码

请参见错误码