更新策略组

1. 接口描述

接口请求路径：POST /prod-api/waf/nlaV1/basic/modifyNlaACL

modifyNlaACL 用于更新指定 HTTP DDoS（NLA）策略组的名称、状态、备注及关联域名。

Token 获取方式见 密钥鉴权。

2. 输入参数

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

参数名称	必选	类型	描述
aclId	是	Long	策略组 ID 示例值：74
aclName	是	String	策略组名称 示例值：酷酷酷
aclStatus	是	String	策略组状态，支持以下值： On：启用 Off：关闭 DetectionOnly：仅记录 示例值：Off
domainIds	否	Array of Long	关联域名 ID 列表；可为空 示例值：[215, 233, 235]
remark	否	String	备注；可为 null

3. 示例

示例1 更新策略组

输入示例

{
  "aclId": 74,
  "aclName": "酷酷酷",
  "remark": null,
  "aclStatus": "Off",
  "domainIds": [215, 233, 235]
}

代码调用

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

JavaGo

import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.ContentType;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

public class ModifyNlaACLTest {

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

        String requestBody = "{"
                + "\"aclId\":74,"
                + "\"aclName\":\"酷酷酷\","
                + "\"remark\":null,"
                + "\"aclStatus\":\"Off\","
                + "\"domainIds\":[215,233,235]"
                + "}";

        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
            HttpPost httpPost = new HttpPost(url);
            httpPost.setHeader("Authorization", "Bearer " + token);
            httpPost.setEntity(new StringEntity(requestBody, ContentType.APPLICATION_JSON));

            try (CloseableHttpResponse response = httpClient.execute(httpPost)) {
                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 (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://{登录域名}/prod-api/waf/nlaV1/basic/modifyNlaACL"
    token := "eyJhbGciOiJIUzUxMiJ9.xxxxxx"

    requestBody := []byte(`{
  "aclId": 74,
  "aclName": "酷酷酷",
  "remark": null,
  "aclStatus": "Off",
  "domainIds": [215, 233, 235]
}`)

    req, err := http.NewRequest(http.MethodPost, url, bytes.NewReader(requestBody))
    if err != nil {
        panic(err)
    }
    req.Header.Set("Authorization", "Bearer "+token)
    req.Header.Set("Content-Type", "application/json")

    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": "酷酷酷",
    "remark": null,
    "aclStatus": "Off",
    "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.remark	String	备注；可能为空
data.domainIds	Array of Long	关联域名 ID 列表。示例值：[215, 233, 235]

5. 错误码

HTTP 状态码 / 业务提示	描述
200	成功
401	未鉴权或 Token 无效
403	无权限
aclId不能为空	未传 aclId
名称不能为空	未传 aclName
状态[aclStatus]只能为On|Off|DetectionOnly	aclStatus 取值非法
更新失败，请确认aclId是否正确	策略组不存在或不属于当前账号
创建失败，可能原因：1.存在错误的域名ID；2.域名不在套餐[{oid}]下	关联域名校验失败