You need to enable JavaScript to run this app.
文档中心
云安全中心

云安全中心

复制全文
下载 pdf
HIDS_ALARM
ListBanIPList - 获取封禁IP列表
复制全文
下载 pdf
ListBanIPList - 获取封禁IP列表

获取封禁IP列表

调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数

参数
类型
是否必填
示例值
描述
Action
String

ListBanIPList

要执行的操作,取值:ListBanIPList。

Version
String

2024-05-08

API的版本,取值:2024-05-08。

PageNumber
Long

60

翻页页码

PageSize
Long

1

每页的大小

BanTypeList
Array of String

[gsGWA wKeEi AdKEP]

封禁列表 security_group(安全组封禁)

BanIP
String

ahmsX

封禁IP

StatusList
Array of String

[yGuaM HJMOX ZMpBA]

封禁状态 ban(已封禁)/unban(已解封)/ban_fail(封禁失败)/unban_fail(解封失败)/banning(封禁中)/unbanning(解封中)

HostName
String

NNNpO

主机名称

SortBy
String

MJunl

排序字段

SortOrder
String

cAbwz

排序顺序

  • Asc 升序排列
  • Desc 降序排列
Tags
Array of String

[mHtAV fXqRV IIVjo]

主机标签

AgentID
String

UolyB

主机ID

BanPort
Long

12

封禁端口

BanType
String

Tumcf

封禁方式 security_group(安全组封禁)

BanStartTimeEndUnix
Long

19

封禁开始时间 结束时间范围

BanStartTimeStartUnix
Long

50

封禁开始时间 起始时间范围

CloudProviders
Array of String

[fnFbo WenWv Cqqdl]

云厂商

IP
String

AUNPe

IP

LeafGroupIDs
Array of String

[ukLAF emQGo IGdzc]

叶子分组ID列表

TopGroupID
String

JCfxb

根分组ID

BanEndTimeEndUnix
Long

18

封禁结束时间 结束时间范围

BanEndTimeStartUnix
Long

69

封禁结束时间 起始时间范围

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构

参数
类型
示例值
描述
Data
Array of Object

--

Data

PageNumber
Long

34

当前页面

PageSize
Long

1

页面大小

TotalCount
Long

68

全部数据条数

请求示例

POST /?Action=ListBanIPList&Version=2024-05-08HTTP/1.1
Host: seccenter.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20241120T080538Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20241120/cn-beijing/seccenter/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{
  "AgentID": "Sbvhe",
  "BanEndTimeEndUnix": 20,
  "BanEndTimeStartUnix": 51,
  "BanIP": "apKGi",
  "BanPort": 38,
  "BanStartTimeEndUnix": 8,
  "BanStartTimeStartUnix": 30,
  "BanType": "wzFXS",
  "BanTypeList": [
    "dSdHk",
    "FmIlc",
    "cdGsy"
  ],
  "CloudProviders": [
    "hzQOg",
    "IwCWO",
    "RJijN"
  ],
  "HostName": "PYaZW",
  "IP": "ZdEns",
  "LeafGroupIDs": [
    "pSamH",
    "XIpKc",
    "ThhVV"
  ],
  "PageNumber": 48,
  "PageSize": 25,
  "SortBy": "sPjta",
  "SortOrder": "odJYy",
  "StatusList": [
    "abbei",
    "wKrxJ",
    "tCBEp"
  ],
  "Tags": [
    "VzAOn",
    "NzkiN",
    "KQiER"
  ],
  "TopGroupID": "eLfiH"
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "20241120165538010234567890",
    "Action": "ListBanIPList",
    "Version": "2024-05-08",
    "Service": "seccenter",
    "Region": "cn-beijing"
  },
  "Result": {
    "Data": [
      {
        "AccountID": "uVuJB",
        "AgentID": "KlGnI",
        "BanEndTimeUnix": 17,
        "BanIP": "pWMFV",
        "BanStartTimeUnix": 93,
        "BanType": "HOCwQ",
        "CloudProvider": "CFYAz",
        "EcsInstance": {
          "AccessKey": "ipVvA",
          "AccountID": "WDwQj",
          "Cpu": 81,
          "CreatedAt": "sNLis",
          "ECSUpdateAt": "wNQeb",
          "EipAddress": "BwhnS",
          "HostName": "hVgdE",
          "IPList": [
            "OmvrI",
            "bcHnk",
            "bXMba"
          ],
          "InstanceName": "EJBdK",
          "Mem": 0,
          "OsName": "IcWnL",
          "OsType": "eTvQJ",
          "Platform": "mIocx",
          "PlatformVersion": "QzBKy",
          "PrimaryIpAddress": "RQUaS",
          "Region": "cQgwj",
          "SecurityEnhancementStrategy": "xCXfr",
          "Status": "OVOiy",
          "Visibility": "nVEOv",
          "VpcId": "UBFpe",
          "VpcName": "EhJww",
          "ZoneId": "INzrw"
        },
        "GroupID": "xswlg",
        "ID": "GVgCX",
        "IPtablesID": "aABeT",
        "InsertTime": 73,
        "Platform": "jqmEo",
        "PortEnd": 79,
        "PortStart": 13,
        "Reason": "gbDwl",
        "Region": "toSBP",
        "RelateAlarmInfo": {
          "AlarmHandleMethod": 28,
          "AlarmType": "zENpr",
          "CloudProvider": "okqDK",
          "RelatedAlarmID": "ekgAm"
        },
        "SecurityGroupID": "PmXRv",
        "Status": "BxdcP",
        "Tags": [
          "ofSXz",
          "dVjcd",
          "dkJwr"
        ],
        "TopGroupID": "oRlEV",
        "UpdateTime": 22
      }
    ],
    "PageNumber": 79,
    "PageSize": 58,
    "TotalCount": 56
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码
错误码
错误信息
说明
400
MissingParameter

The required parameter %s is missing.

请求参数缺失

400
InvalidParameter

The specified parameter %s is invalid.

请求参数错误

400
OperationDenied

Operation is denied because the specified resource is in use.

不允许的操作

500
InternalError

The request has failed due to an unknown error.

服务器内部错误

最近更新时间:2026.06.01 14:36:58
这个页面对您有帮助吗?
有用
有用
无用
无用