All Products
Search
Document Center

Edge Security Acceleration:BatchSetDcdnWafDomainConfigs

Last Updated:Oct 17, 2024

Sets the protection status of multiple domain names at a time.

Operation description

  • You can call this operation up to 20 times per second.
  • Alibaba Cloud Dynamic Content Delivery Network (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
DomainNamesstringYes

The protected domain names for which you want to change the protection status. You can specify up to 50 domain names. Separate multiple domain names with commas (,).

example.com,example2.com
DefenseStatusstringNo

The protection status of the domain name. Valid values: on, off, and empty string.

  • When you add a domain name, the value of this parameter is on, and the value of ClientIpTag takes effect, which is empty if the default header is selected and is the value specified by the user if a custom header is selected.
  • When you delete a domain name, the value of this parameter is off, and the value of ClientIpTag does not take effect.
  • When you only modify the value of ClientIpTag, the value of DefenseStatus is an empty string.
on
ClientIpTagstringNo

Specifies the header that records the IP address to be obtained. If the default header is selected, the value of this parameter is empty. If a custom header is selected, the value of this parameter is the value specified by the user. Separate multiple values with commas (,). You can specify a maximum of five values.

X-Forwarded-For

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The ID of the request.

CB1A380B-09F0-41BB-3C82-72F8FD6DA2FE

Examples

Sample success responses

JSONformat

{
  "RequestId": "CB1A380B-09F0-41BB-3C82-72F8FD6DA2FE"
}

Error codes

HTTP status codeError codeError messageDescription
400InvalidParameterThe specified parameter is invalid.A parameter is set to an invalid value.
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