All Products
Search
Document Center

Edge Security Acceleration:CreateDcdnWafPolicy

Last Updated:Oct 17, 2024

Creates a Web Application Firewall (WAF) protection policy.

Operation description

  • You can call this operation up to 20 times per second per user.
  • Alibaba Cloud Dynamic Route for CDN (DCDN) supports POST requests.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
PolicyNamestringYes

The name of the protection policy. The name can be up to 64 characters in length and can contain letters, digits, and underscores (_).

policy_test
PolicyTypestringYes

Specifies whether to set the current policy as the default policy. Valid values:

  • default: sets the current policy as the default policy.
  • custom: does not set the current policy as the default policy.
default
PolicyStatusstringYes

The status of the protection policy. Valid values:

  • on: The policy is enabled.
  • off: The policy is disabled.
on
DefenseScenestringYes

The type of the WAF protection policy. Valid values:

  • waf_group: basic web protection
  • custom_acl: custom protection
  • whitelist: IP address whitelist
  • ip_blacklist: IP address blacklist
  • region_block: region blacklist
  • bot: bot management
waf_group

Response parameters

ParameterTypeDescriptionExample
object
PolicyIdlong

The ID of the protection policy that you created.

10000001
RequestIdstring

The ID of the request.

CB1A380B-09F0-41BB-A198-72F8FD6DA2FE

Examples

Sample success responses

JSONformat

{
  "PolicyId": 10000001,
  "RequestId": "CB1A380B-09F0-41BB-A198-72F8FD6DA2FE"
}

Error codes

HTTP status codeError codeError messageDescription
400InvalidParameterThe specified parameter is invalid.A parameter is set to an invalid value.
400Policy.DefaultExistedThe default policy is existed in specified defense scene.The specified protection scenario already has a default policy.
400PolicyName.AlreadyExistsThe specified policy name already exists.The specified policy name is already used by another policy.
500InternalErrorAn internal error occurred; please try again later.An internal error occurred. Try again later. If the error persists, submit a ticket.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-08-29The Error code has changedView Change Details