DescribeMajorProtectionBlackIps - 分页查询重保防护IP黑名单 - Web 应用防火墙

分页查询重保黑IP。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

yundun-waf:DescribeMajorProtectionBlackIps

get

*全部资源

*

acs:ResourceGroupId

无

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	是	WAF 实例的 ID。说明您可以调用 DescribeInstance 获取当前 WAF 实例的 ID。	waf_cdnsdf3****
TemplateId	integer	否	重保防护模板 ID。	5673
RuleId	integer	否	重保 IP 黑名单规则 ID。	20013199
IpLike	string	否	要查询的 IP。您可以设置该参数，模糊查询已添加的 IP 黑名单。	192.0.XX.XX
OrderBy	string	否	设置排序属性，支持按照如下属性倒序排列。取值： gmtModified：表示按照修改时间排序。 ip：表示按照 IP 排序。 templateId：表示按照模板 ID 排序。 id：表示按照主键排序。	gmtModified
PageNumber	integer	否	分页查询时，返回第几页数据。默认值为 1，表示返回第 1 页数据。	1
PageSize	integer	否	分页查询时，每页包含多少条结果。默认值为 10，表示每页包含 10 条结果。	10
RegionId	string	否	WAF 实例所属地域。取值： cn-hangzhou：表示中国内地。 ap-southeast-1：表示非中国内地。	cn-hangzhou
ResourceManagerResourceGroupId	string	否	阿里云资源组 ID。	rg-acfm***q

返回参数

名称	类型	描述	示例值
	object	请求结果。
TotalCount	integer	黑名单 IP 的总数。	63
RequestId	string	请求 ID。	41631674-EEB0-5B02-BEB4-40A758E9B841
IpList	array<object>	黑名单 IP 列表。
	object	黑名单 IP 列表。
Description	string	描述信息。	test0003asdffas
Ip	string	IP 地址。	192.0.XX.XX
RuleId	integer	重保 IP 黑名单规则 ID。	8508970
ExpiredTime	integer	生效截止时间戳，单位为秒。说明取值为 0 时，表示永久生效。	1662603328
GmtModified	integer	黑名单 IP 的修改时间。	1665456202000
TemplateId	integer	重保防护模板 ID。	9684

示例

正常返回示例

JSON格式

{
  "TotalCount": 63,
  "RequestId": "41631674-EEB0-5B02-BEB4-40A758E9B841",
  "IpList": [
    {
      "Description": "test0003asdffas",
      "Ip": "192.0.XX.XX",
      "RuleId": 8508970,
      "ExpiredTime": 1662603328,
      "GmtModified": 1665456202000,
      "TemplateId": 9684
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。