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

查询IP地址组列表

功能介绍

查询IP地址组列表

URI

GET /v1/edgesec/configuration/http/ip-groups

表1 Query参数

参数

是否必选

参数类型

描述

enterprise_project_id

String

您可以通过调用企业项目管理服务(EPS)的查询企业项目列表接口(ListEnterpriseProject)查询企业项目id,默认为0

page

Integer

分页查询参数,第page页

pagesize

Integer

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

name

String

IP地址组名称

ip

String

IP地址/地址段

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

租户token

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

total

Integer

全部IP地址组的数量

items

Array of ShowHttpIpGroupResponseBody objects

详细的IP地址组信息

表4 ShowHttpIpGroupResponseBody

参数

参数类型

描述

id

String

IP地址组id

name

String

IP地址组名称

ips

String

IP地址/地址段

size

String

IP地址/地址段大小

description

String

IP地址组备注

timestamp

Long

创建IP地址组的时间

rules

Array of HttpRuleInfo objects

使用IP地址组的策略和规则列表

表5 HttpRuleInfo

参数

参数类型

描述

rule_id

String

策略下的规则id

rule_name

String

策略下的规则名称

policy_id

String

策略id

policy_name

String

策略名称

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_code

String

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

error_msg

String

清晰的错误信息

encoded_authorization_message

String

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

状态码: 401

表7 响应Body参数

参数

参数类型

描述

error_code

String

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

error_msg

String

清晰的错误信息

encoded_authorization_message

String

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

状态码: 500

表8 响应Body参数

参数

参数类型

描述

error_code

String

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

error_msg

String

清晰的错误信息

encoded_authorization_message

String

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

请求示例

响应示例

状态码

状态码

描述

200

请求成功

400

请求失败

401

token权限不足

500

服务器内部错误

错误码

请参见错误码