获取封禁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 | 排序顺序
|
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 | 请求参数缺失 |
400 | InvalidParameter | 请求参数错误 |
400 | OperationDenied | 不允许的操作 |
500 | InternalError | 服务器内部错误 |