查询策略组基本信息

1. 接口描述

接口请求路径：GET /prod-api/waf/nlaV1/basic/describeNlaACL/{aclId}

describeNlaACL 用于按策略组 ID 查询 HTTP DDoS（NLA）策略组的基本信息及关联域名 ID 列表。

Token 获取方式见 密钥鉴权。

2. 输入参数

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

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

3. 示例

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

输入示例

GET /prod-api/waf/nlaV1/basic/describeNlaACL/74

代码调用

请将 {登录域名}、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 DescribeNlaACLTest {

    public static void main(String[] args) throws Exception {
        String url = "https://{登录域名}/prod-api/waf/nlaV1/basic/describeNlaACL/74";
        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/nlaV1/basic/describeNlaACL/74"
    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": {
    "aclId": 74,
    "aclName": "酷酷酷",
    "aclStatus": "Off",
    "oid": "202404123459097884616",
    "alias": "c8f24509cb564acfbad2fbfa2eac4d",
    "remark": "12",
    "ownerUid": 279,
    "createTime": "2025-11-13 17:05:00",
    "updateTime": "2026-05-14 15:48:19",
    "domainIds": [215, 233, 235]
  }
}

4. 输出参数

参数名称	类型	描述
code	Integer	状态码。示例值：200
msg	String	提示信息。示例值：成功
data	Object	策略组基本信息
data.aclId	Long	策略组 ID。示例值：74
data.aclName	String	策略组名称。示例值：酷酷酷
data.aclStatus	String	策略组状态，支持以下值： On：启用 Off：关闭 DetectionOnly：仅记录 示例值：Off
data.oid	String	所属套餐号。示例值：202404123459097884616
data.alias	String	套餐别名。示例值：c8f24509cb564acfbad2fbfa2eac4d
data.remark	String	备注。示例值：12
data.ownerUid	Long	所属用户 ID。示例值：279
data.createTime	String	创建时间，格式 yyyy-MM-dd HH:mm:ss 示例值：2025-11-13 17:05:00
data.updateTime	String	更新时间，格式 yyyy-MM-dd HH:mm:ss 示例值：2026-05-14 15:48:19
data.domainIds	Array of Long	关联域名 ID 列表。示例值：[215, 233, 235]

5. 错误码

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