查询策略组基本信息

1. 接口描述

接口请求路径：GET /prod-api/waf/wafv3/acl/describeWebACL/{wafId}

describeWebACL 用于按策略组 ID 查询 Web 应用防火墙（WAF 3.0）策略组的基本信息及关联域名 ID 列表。

Token 获取方式见 密钥鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见 公共请求参数。

参数名称	必选	类型	描述
wafId	是	Long	Path 参数。策略组 ID 示例值：150

3. 示例

示例1 查询策略组基本信息

输入示例

GET /prod-api/waf/wafv3/acl/describeWebACL/150

代码调用

请将 {登录域名}、token 替换为实际值。

JavaGo

import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class DescribeWebACLTest {

    public static void main(String[] args) throws Exception {
        String url = "https://{登录域名}/prod-api/waf/wafv3/acl/describeWebACL/150";
        String token = "eyJhbGciOiJIUzUxMiJ9.xxxxxx";

        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
            HttpGet httpGet = new HttpGet(url);
            httpGet.setHeader("Authorization", "Bearer " + token);

            try (CloseableHttpResponse response = httpClient.execute(httpGet)) {
                int statusCode = response.getStatusLine().getStatusCode();
                String body = EntityUtils.toString(response.getEntity(), "UTF-8");
                System.out.println("Status Code: " + statusCode);
                System.out.println("Body: " + body);
            }
        }
    }
}

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://{登录域名}/prod-api/waf/wafv3/acl/describeWebACL/150"
    token := "eyJhbGciOiJIUzUxMiJ9.xxxxxx"

    req, err := http.NewRequest(http.MethodGet, url, nil)
    if err != nil {
        panic(err)
    }
    req.Header.Set("Authorization", "Bearer "+token)

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }
    fmt.Println("Status Code:", resp.StatusCode)
    fmt.Println("Body:", string(body))
}

输出示例

{
  "msg": "成功",
  "code": 200,
  "data": {
    "wafId": 150,
    "aclName": "测试",
    "aclStatus": "DetectionOnly",
    "oid": "202412345097884616",
    "alias": "c8f24509cb564acfbad2fbfa2eac4d",
    "remark": null,
    "ownerUid": 279,
    "createTime": "2026-05-18 17:38:09",
    "updateTime": "2026-05-18 17:43:05",
    "paranoiaLevel": "lenient",
    "domainIds": [215, 219]
  }
}

4. 输出参数

参数名称	类型	描述
code	Integer	状态码。示例值：200
msg	String	提示信息。示例值：成功
data	Object	策略组基本信息
data.wafId	Long	策略组 ID。示例值：150
data.aclName	String	策略组名称。示例值：测试
data.aclStatus	String	策略组状态，支持以下值： On：启用 Off：关闭 DetectionOnly：仅记录 示例值：DetectionOnly
data.oid	String	所属套餐号。示例值：202412345097884616
data.alias	String	套餐别名。示例值：c8f24509cb564acfbad2fbfa2eac4d
data.remark	String	备注；可能为空
data.ownerUid	Long	所属用户 ID。示例值：279
data.createTime	String	创建时间，格式 yyyy-MM-dd HH:mm:ss 示例值：2026-05-18 17:38:09
data.updateTime	String	更新时间，格式 yyyy-MM-dd HH:mm:ss 示例值：2026-05-18 17:43:05
data.paranoiaLevel	String	防护等级，支持以下值： lenient：宽松模式 balanced：平衡模式 strict：严格模式 示例值：lenient
data.domainIds	Array of Long	关联域名 ID 列表。示例值：[215, 219]

5. 错误码

HTTP 状态码 / 业务提示	描述
200	成功
401	未鉴权或 Token 无效
403	无权限