文档中心

Web应用防火墙

地址组管理

ListIpGroup - 查询地址组详情

根据地址组 ID 查询某个指定地址组下的 IP 详情。

请求说明

请求方式：POST

请求地址：https://waf.volcengineapi.com/?Action=ListIpGroup&Version=2023-12-25

请求参数

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

Query

Action String 必选示例值：ListIpGroup

接口名称。当前 API 的名称为 ListIpGroup。

Version String 必选示例值：2023-12-25

接口版本。当前 API 的版本为 2023-12-25。

Body

ListAll String 可选示例值：true

是否需要全量查询。

IpGroupId Integer 必选示例值：1234

地址组 ID。地址组 ID 获取方式，可参考ListAllIpGroups-查询所有地址组。

ProjectName String 可选示例值：default

资源所属项目名称。获取方式可参考ListProjectResources - 获取项目资源列表。

Ip String 可选示例值：1.2.**.**

查询的地址或地址段。

Page Integer 必选示例值：1

查询页码，默认为 1。

PageSize Integer 必选示例值：10

单页条数，默认为 10。范围为 1～100。

返回参数

IpList String[] 可选示例值：["1.1.**.**","1.2.**.**"]

该地址组下的 IP 详情。

CurrentPage Integer 可选示例值：1

当前页面的页码。

PageSize Integer 可选示例值：10

单个页面显示的地址组数量上限。

TotalCount Integer 可选示例值：15

查询到的符合条件的地址组总数。

Count Integer 可选示例值：5

当前页面显示的地址组数量。

错误码

您可访问公共错误码，获取更多错误码信息。

输入示例 1

输入示例

POST https://waf.volcengineapi.com/?Action=ListIpGroup&Version=2023-12-25

{
    "ListAll": "true",
    "IpGroupId": 1234,
    "ProjectName": "default",
    "Ip": "1.2.**.**",
    "Page": 1,
    "PageSize": 10
}

输出示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "ListIpGroup",
        "Version": "2023-12-25",
        "Service": "waf",
        "Region": "cn-beijing"
    },
    "Result": {
        "IpList": [
            "1.1.**.**",
            "1.2.**.**"
        ],
        "CurrentPage": 1,
        "PageSize": 10,
        "TotalCount": 15,
        "Count": 5
    }
}

最近更新时间：2026.01.20 15:17:10

这个页面对您有帮助吗？

有用

无用