使用DescribeBruteForceRecords查询防暴力破解的拦截IP记录-云安全中心-阿里云

查询防暴力破解拦截IP的记录，即用户配置的防暴力破解策略拦截成功的拦截记录。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
CurrentPage	integer	否	分页查询时，当前页的页码。	1
Status	integer	否	暴力破解防御规则的状态。取值： 0：失效 1：启用 2：失败	1
BlockIp	string	否	防暴力破解 IP 地址。	175.106.XX.XX
PageSize	integer	否	分页查询时，每页显示的数据最大条数。每页默认显示的数据条数为 20 条，PageSize 参数值为空时，将默认返回 20 条数据。建议 PageSize 取值不要为空。	20
InstanceId	string	否	指定要查询的服务器实例 ID。	i-bp1fu4aqltf1huhc****
Remark	string	否	要查询的服务器的名称或 IP 地址。	222.185.XX.XX

返回参数

名称	类型	描述	示例值
	object	返回的结构体。
RequestId	string	本次调用请求的 ID，是由阿里云为该请求生成的唯一标识符，可用于排查和定位问题。	7E0618A9-D5EF-4220-9471-C42B5E92719F
PageInfo	object	分页信息。
CurrentPage	integer	分页查询时，当前页的页码。	1
PageSize	integer	分页查询时，每页显示的数据的最大条数。默认值为 20。	20
TotalCount	integer	数据的总条数。	263
Count	integer	当前页的数据量。	10
MachineList	array<object>	防暴力破解记录的列表信息。
BruteForceRecord	object	返回的数据结构体。
Status	integer	暴力破解防御规则的状态。取值： 0：失效 1：启用 2：失败	2
BlockExpireDate	long	防暴力破解 IP 拦截到期的时间戳。	1671506882063
Uuid	string	该记录生效的服务器 UUID。	6d5b361f-958d-48a8-a9d2-d6e82c1****
InternetIp	string	公网 IP。	120.79.XX.XX
InstanceName	string	服务器实例的名称。	record-test-***
BlockIp	string	防暴力破解拦截的 IP 地址。	10.12.XX.XX
Port	string	防暴力破解端口。	22/22
Source	string	此次规则下发的来源。 userRule：用户规则 blinkRule：系统规则	userRule
IntranetIp	string	内网 IP。	192.168.XX.XX
Id	long	防暴力破解拦截规则记录主键 ID。	112XX
RuleName	string	规则名称。	AntiRuleName
ErrorCode	string	拦截 IP 失败返回错误的 Code 信息。	InstanceSecurityGroupLimitExceeded
BlockType	string	拦截类型。取值： group：安全组拦截 alinet：主机网络插件拦截	alinet
AliNetOnline	boolean	主机网络插件在线状态。取值： true：在线 false：离线	false

示例

正常返回示例

JSON格式

{
  "RequestId": "7E0618A9-D5EF-4220-9471-C42B5E92719F",
  "PageInfo": {
    "CurrentPage": 1,
    "PageSize": 20,
    "TotalCount": 263,
    "Count": 10
  },
  "MachineList": [
    {
      "Status": 2,
      "BlockExpireDate": 1671506882063,
      "Uuid": "6d5b361f-958d-48a8-a9d2-d6e82c1****\n",
      "InternetIp": "120.79.XX.XX",
      "InstanceName": "record-test-***",
      "BlockIp": "10.12.XX.XX",
      "Port": "22/22",
      "Source": "userRule",
      "IntranetIp": "192.168.XX.XX",
      "Id": 0,
      "RuleName": "AntiRuleName",
      "ErrorCode": "InstanceSecurityGroupLimitExceeded",
      "BlockType": "alinet",
      "AliNetOnline": false
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
403	NoPermission	caller has no permission	当前操作未被授权，请联系主账号在RAM控制台进行授权后再执行操作。
500	ServerError	ServerError	服务故障，请稍后重试！

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

变更历史

变更时间	变更内容概要	操作
2024-04-22	OpenAPI 入参发生变更	查看变更详情
2023-04-06	OpenAPI 返回结构发生变更	查看变更详情