Call the ModifyWafSwitch API to enable or disable Web attack protection.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action Boolean No ModifyWafSwitch

The operation that you want to perform. Valid values: ModifyWafSwitch.

Domain String No rstest.cdn.com

The domain that you want to add to WAF.

InstanceId String No waf_elasticity-cn-0xldbqtm005

The ID of the WAF instance.

Note You can callDescribePayInfo to view your WAF instance ID.
ServiceOn Integer Yes 1

The Web attack protection switch. Valid values:

  • 0: indicates closing.
  • 1: indicates enabled.
Region String Yes cn

The ID of the region to which the WAF instance belongs. Set the value to:

  • cn: mainland China (default)
  • cn-hongkong: outside mainland China

Response parameters

Parameter Type Example Description
RequestId String D7861F61-5B61-46CE-A47C-6B19160D5EB0

The ID of the request.

Result

The returned result.

Status Integer env

Request execution status:

  • 0: indicates that the request is pending execution.
  • 1: indicates that the request is being executed.
  • 2: indicates that the request has been completed.
WafTaskId String aliyun.waf.20180712214032277.qmxI9a

The ID of the WAF request.

Samples

Sample request


https://wafopenapi.cn-hangzhou.aliyuncs.com/? Action=ModifyWafSwitch
&Domain=www.aliyun.com
&InstanceId=waf_elasticity-cn-0xldbqtm005
&ServiceOn=1
&Common request parameters

Sample success responses

XML format

<ModifyWafSwitchResponse>
      <RequestId>D7861F61-5B61-46CE-A47C-6B19160D5EB0</RequestId>
      <Result>
            <Status>2</Status>
            <WafTaskId>aliyun.waf.20180712214032277.qmxI9a</WafTaskId>
      </Result>
</ModifyWafSwitchResponse>

JSON format

{
	"Result":{
		"Status":2,
		"WafTaskId":"aliyun.waf.20180712214032277.qmxI9a"
	},
	"RequestId":"D7861F61-5B61-46CE-A47C-6B19160D5EB0"
}

Errors

For a list of error codes, visit the API Error Center.