Help Center/ Web Application Firewall/ API Reference/ APIs/ Managing Policies/ Updating a Protection Policy

Updated on 2026-05-12 GMT+08:00

View PDF

Updating a Protection Policy

Function

This API is used to update a policy. The request body can contain only the part to be updated.

Calling Method

For details, see Calling APIs.

URI

PATCH /v1/{project_id}/waf/policy/{policy_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. To obtain it, log in to the Huawei Cloud console, click the username, choose My Credentials, and find the project ID in the Projects list.
policy_id	Yes	String	Protection policy ID. You can call the ListPolicy API to obtain the policy ID.

**Table 2** Query Parameters
Parameter	Mandatory	Type	Description
enterprise_project_id	No	String	Definition Obtain the enterprise project ID by calling the ListEnterpriseProject API of Enterprise Project Management Service (EPS). To obtain the resource details in all enterprise projects of a user, set this parameter to all_granted_eps. Constraints N/A Range 0: the default enterprise project. all_granted_eps: all enterprise projects. A specific enterprise project ID: Enter a maximum of 36 characters. Default Value 0

Request Parameters

**Table 3** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition User token. It can be obtained by calling the IAM API (value of X-Subject-Token in the response header). Constraints N/A Range N/A Default Value N/A
Content-Type	Yes	String	Content type.

**Table 4** Request body parameters
Parameter	Mandatory	Type	Description
name	No	String	Protection policy name.
level	No	Integer	Basic web protection level. 1: low. At this level, only requests with obvious attack characteristics are blocked. If a large number of false alarms are reported, this level is recommended. 2: medium. This is the default level, which meets web protection requirements in most scenarios. 3: strict. At this level, WAF provides the finest granular protection and can intercept attacks with complex bypass features, such as Jolokia cyber attacks, common gateway interface (CGI) vulnerability detection, and Druid SQL injection attacks.
full_detection	No	Boolean	Detection mode in the precise protection rule. false: Instant detection. If a request matches a configured precise protection rule, WAF immediately ends threat detection and blocks the request. true: Full detection. If a request matches a configured precise protection rule, WAF does not block the request immediately. Instead, WAF continues to detect other threats and then blocks the request.
robot_action	No	Action object	Protective actions for each rule in anti-crawler protection.
action	No	PolicyAction object	Protective action
options	No	PolicyOption object	Whether a protection type is enabled in protection policy.
modulex_options	No	Map<String,Object>	Configurations of intelligent access control protection items. Currently, this feature is still in the open beta test (OBT) phase and available only in certain sites.
hosts	No	Array of strings	ID array of protected domain names bound to the protection policy.
bind_host	No	Array of BindHost objects	Array of protected domain names bound to a protection policy. It contains more detailed domain name information than the hosts field.
extend	No	Map<String,String>	Extended field, which is used to store check configurations in basic web protection. When the field is modified to shiro_rememberMe_enable, deep_decode, or check_all_headers, an additional extend field nesting is required. For example, if the key is extend, the value is {"shiro_rememberMe_enable":true}.

**Table 5** Action
Parameter	Mandatory	Type	Description
category	No	String	Protective action information in feature anti-crawler. log: WAF only logs detected attacks. block: WAF blocks detected attacks.

**Table 6** PolicyAction
Parameter	Mandatory	Type	Description
category	No	String	Protective action for basic web protection (log: log only; block: block).
followed_action_id	No	String	ID of the known attack source rule.

**Table 7** PolicyOption
Parameter	Mandatory	Type	Description
webattack	No	Boolean	Whether basic web protection is enabled.
common	No	Boolean	Whether general check is enabled.
crawler	No	Boolean	This parameter is reserved. The value of this parameter is fixed at true. You can ignore this parameter.
crawler_engine	No	Boolean	Whether the search engine check is enabled.
crawler_scanner	No	Boolean	Whether the anti-crawler inspection is enabled.
crawler_script	No	Boolean	Whether the JavaScript anti-crawler is enabled.
crawler_other	No	Boolean	Whether other crawler check is enabled.
webshell	No	Boolean	Whether web shell detection is enabled.
cc	No	Boolean	Whether CC attack protection is enabled.
custom	No	Boolean	Whether precise protection is enabled.
whiteblackip	No	Boolean	Whether blacklist and whitelist protection is enabled
geoip	No	Boolean	Whether geolocation access control is enabled.
ignore	No	Boolean	Whether global protection whitelist protection is enabled.
privacy	No	Boolean	Whether data masking is enabled.
antitamper	No	Boolean	Whether web tamper protection is enabled.
antileakage	No	Boolean	Whether information leakage prevention is enabled.
bot_enable	No	Boolean	Whether website anti-crawler is enabled.
modulex_enabled	No	Boolean	Whether CC attack protection for moduleX is enabled. This feature is in the open beta test (OBT). During the OBT, only the log only mode is supported.

**Table 8** BindHost
Parameter	Mandatory	Type	Description
id	No	String	Domain name ID.
hostname	No	String	Domain name.
waf_type	No	String	Domain name mode. cloud: cloud mode. premium: dedicated mode.
mode	No	String	This parameter is required only in dedicated mode.

Response Parameters

Status code: 200

**Table 9** Response body parameters
Parameter	Type	Description
id	String	Protection policy ID.
name	String	Protection policy name.
level	Integer	Basic web protection level. 1: low. At this level, only requests with obvious attack characteristics are blocked. If a large number of false alarms are reported, this level is recommended. 2: medium. This is the default level, which meets web protection requirements in most scenarios. 3: strict. At this level, WAF provides the finest granular protection and can intercept attacks with complex bypass features, such as Jolokia cyber attacks, common gateway interface (CGI) vulnerability detection, and Druid SQL injection attacks.
full_detection	Boolean	Detection mode in the precise protection rule. false: Instant detection. If a request matches a configured precise protection rule, WAF immediately ends threat detection and blocks the request. true: Full detection. If a request matches a configured precise protection rule, WAF does not block the request immediately. Instead, WAF continues to detect other threats and then blocks the request.
robot_action	Action object	Protective actions for each rule in anti-crawler protection.
action	PolicyAction object	Protective action
options	PolicyOption object	Whether a protection type is enabled in protection policy.
modulex_options	Map<String,Object>	Configurations of intelligent access control protection items. Currently, this feature is still in the open beta test (OBT) phase and available only in certain sites.
hosts	Array of strings	ID array of protected domain names bound to the protection policy.
bind_host	Array of BindHost objects	Array of domain names protected with the protection policy. Compared with the hosts field, this field contains more details.
extend	Map<String,String>	Extended field, which is used to store the switch configuration of basic web protection.
timestamp	Long	Time the protection policy was created.

**Table 10** Action
Parameter	Type	Description
category	String	Protective action information in feature anti-crawler. log: WAF only logs detected attacks. block: WAF blocks detected attacks.

**Table 11** PolicyAction
Parameter	Type	Description
category	String	Protective action for basic web protection (log: log only; block: block).
followed_action_id	String	ID of the known attack source rule.

**Table 12** PolicyOption
Parameter	Type	Description
webattack	Boolean	Whether basic web protection is enabled.
common	Boolean	Whether general check is enabled.
crawler	Boolean	This parameter is reserved. The value of this parameter is fixed at true. You can ignore this parameter.
crawler_engine	Boolean	Whether the search engine check is enabled.
crawler_scanner	Boolean	Whether the anti-crawler inspection is enabled.
crawler_script	Boolean	Whether the JavaScript anti-crawler is enabled.
crawler_other	Boolean	Whether other crawler check is enabled.
webshell	Boolean	Whether web shell detection is enabled.
cc	Boolean	Whether CC attack protection is enabled.
custom	Boolean	Whether precise protection is enabled.
whiteblackip	Boolean	Whether blacklist and whitelist protection is enabled
geoip	Boolean	Whether geolocation access control is enabled.
ignore	Boolean	Whether global protection whitelist protection is enabled.
privacy	Boolean	Whether data masking is enabled.
antitamper	Boolean	Whether web tamper protection is enabled.
antileakage	Boolean	Whether information leakage prevention is enabled.
bot_enable	Boolean	Whether website anti-crawler is enabled.
modulex_enabled	Boolean	Whether CC attack protection for moduleX is enabled. This feature is in the open beta test (OBT). During the OBT, only the log only mode is supported.

**Table 13** BindHost
Parameter	Type	Description
id	String	Domain name ID.
hostname	String	Domain name.
waf_type	String	Domain name mode. cloud: cloud mode. premium: dedicated mode.
mode	String	This parameter is required only in dedicated mode.

Status code: 400

**Table 14** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.
encoded_authorization_message	String	You can call the decode-authorization-message interface of the STS service to decode the rejection reason. For details, see the STS5 joint commissioning and self-verification. This parameter is returned only when an IAM 5 authentication error occurs.
details	Array of IAM5ErrorDetails objects	The set of error messages reported when a downstream service is invoked. This parameter is returned only when an IAM 5 authentication error occurs.

**Table 15** IAM5ErrorDetails
Parameter	Type	Description
error_code	String	Error codes of the downstream service.
error_msg	String	Error messages of the downstream service.

Status code: 401

**Table 16** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.
encoded_authorization_message	String	You can call the decode-authorization-message interface of the STS service to decode the rejection reason. For details, see the STS5 joint commissioning and self-verification. This parameter is returned only when an IAM 5 authentication error occurs.
details	Array of IAM5ErrorDetails objects	The set of error messages reported when a downstream service is invoked. This parameter is returned only when an IAM 5 authentication error occurs.

**Table 17** IAM5ErrorDetails
Parameter	Type	Description
error_code	String	Error codes of the downstream service.
error_msg	String	Error messages of the downstream service.

Status code: 500

**Table 18** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_msg	String	Error message.
encoded_authorization_message	String	You can call the decode-authorization-message interface of the STS service to decode the rejection reason. For details, see the STS5 joint commissioning and self-verification. This parameter is returned only when an IAM 5 authentication error occurs.
details	Array of IAM5ErrorDetails objects	The set of error messages reported when a downstream service is invoked. This parameter is returned only when an IAM 5 authentication error occurs.

**Table 19** IAM5ErrorDetails
Parameter	Type	Description
error_code	String	Error codes of the downstream service.
error_msg	String	Error messages of the downstream service.

Example Requests

Disable the blacklist and whitelist protection in a policy. Project ID: project_id; policy ID: policy_id.

PATCH https://{Endpoint}/v1/{project_id}/waf/policy/{policy_id}?enterprise_project_id=0

{
  "options" : {
    "whiteblackip" : false
  }
}

Example Responses

Status code: 200

{
  "id" : "38ff0cb9a10e4d5293c642bc0350fa6d",
  "name" : "demo",
  "level" : 2,
  "action" : {
    "category" : "log"
  },
  "options" : {
    "webattack" : true,
    "common" : true,
    "crawler" : true,
    "crawler_engine" : false,
    "crawler_scanner" : true,
    "crawler_script" : false,
    "crawler_other" : false,
    "webshell" : false,
    "cc" : true,
    "custom" : true,
    "whiteblackip" : false,
    "geoip" : true,
    "ignore" : true,
    "privacy" : true,
    "antitamper" : true,
    "antileakage" : false,
    "bot_enable" : true
  },
  "hosts" : [ "c0268b883a854adc8a2cd352193b0e13" ],
  "timestamp" : 1650529538732,
  "full_detection" : false,
  "bind_host" : [ {
    "id" : "c0268b883a854adc8a2cd352193b0e13",
    "hostname" : "www.demo.com",
    "waf_type" : "cloud"
  } ]
}

SDK Sample Code

The SDK sample code is as follows.

Disable the blacklist and whitelist protection in a policy. Project ID: project_id; policy ID: policy_id.

     package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.waf.v1.region.WafRegion;
import com.huaweicloud.sdk.waf.v1.*;
import com.huaweicloud.sdk.waf.v1.model.*;


public class UpdatePolicySolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        WafClient client = WafClient.newBuilder()
                .withCredential(auth)
                .withRegion(WafRegion.valueOf("<YOUR REGION>"))
                .build();
        UpdatePolicyRequest request = new UpdatePolicyRequest();
        request.withPolicyId("{policy_id}");
        UpdatePolicyRequestBody body = new UpdatePolicyRequestBody();
        PolicyOption optionsbody = new PolicyOption();
        optionsbody.withWhiteblackip(false);
        body.withOptions(optionsbody);
        request.withBody(body);
        try {
            UpdatePolicyResponse response = client.updatePolicy(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}
 
 
  

Disable the blacklist and whitelist protection in a policy. Project ID: project_id; policy ID: policy_id.

     # coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkwaf.v1.region.waf_region import WafRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkwaf.v1 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = WafClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(WafRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = UpdatePolicyRequest()
        request.policy_id = "{policy_id}"
        optionsbody = PolicyOption(
            whiteblackip=False
        )
        request.body = UpdatePolicyRequestBody(
            options=optionsbody
        )
        response = client.update_policy(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)
 
 
  

Disable the blacklist and whitelist protection in a policy. Project ID: project_id; policy ID: policy_id.

     package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    waf "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/waf/v1"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/waf/v1/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/waf/v1/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth, err := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        SafeBuild()

    if err != nil {
        fmt.Println(err)
        return
    }

    hcClient, err := waf.WafClientBuilder().
         WithRegion(region.ValueOf("<YOUR REGION>")).
         WithCredential(auth).
         SafeBuild()


    if err != nil {
        fmt.Println(err)
        return
    }

    client := waf.NewWafClient(hcClient)

    request := &model.UpdatePolicyRequest{}
	request.PolicyId = "{policy_id}"
	whiteblackipOptions:= false
	optionsbody := &model.PolicyOption{
		Whiteblackip: &whiteblackipOptions,
	}
	request.Body = &model.UpdatePolicyRequestBody{
		Options: optionsbody,
	}
	response, err := client.UpdatePolicy(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}
 
 
  

For SDK sample code of more programming languages, see the Sample Code tab in API Explorer. SDK sample code can be automatically generated.

Status Codes

Status Code	Description
200	OK
400	Request failed.
401	The token does not have required permissions.
500	Internal server error.

Error Codes

See Error Codes.

Parent Topic: Managing Policies

Previous topic: Updating the Domain Name Protection Policy

Next topic: Deleting a Protection Policy

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

For any further questions, feel free to contact us through the chatbot.

Chatbot