Changes the name, status, or configurations of a protection rule.
Operation description
- You can call this operation up to 20 times per second per account.
- Alibaba Cloud Dynamic Content Delivery Network (DCDN) supports POST requests.
- You must configure at least one of the RuleStatus, RuleName and RuleConfig parameters.
Debugging
Authorization information
There is currently no authorization information disclosed in the API.
Request parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| RuleId | long | Yes | The ID of the protection rule. You can specify only one ID in each request. | 200001 |
| RuleStatus | string | No | The new status of the protection rule. Valid values:
| off |
| RuleName | string | No | The new name of the protection rule. | test |
| RuleConfig | string | No | The new configurations of the protection rule. Note
After you modify the configurations of the protection rule, the previous configurations are overwritten.
| {\"origin\":\"custom\",\"conditions\":[{\"opValue\":\"eq\",\"key\":\"URL\",\"values\":\"/example\"},{\"opValue\":\"eq\",\"key\":\"Header\",\"values\":\"3333\",\"subKey\":\"trt\"}],\"actionExternal\":{},\"action\":\"monitor\",\"ccStatus\":1,\"ratelimit\":{\"target\":\"remote_addr\",\"interval\":\"5\",\"threshold\":\"2\",\"effect\":\"rule\",\"status\":{\"code\":\"404\",\"count\":\"2\"},\"ttl\":\"1800\"}}' |
Response parameters
Examples
Sample success responses
JSONformat
{
"RequestId": "CB1A380B-09F0-41BB-3C2B-72F8FD6DA2FE"
}Error codes
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 400 | InvalidParameter | The specified parameter is invalid. | A parameter is set to an invalid value. |
| 400 | Rule.NotExist | The specified rule does not exist. | The specified rule does not exist in the current context or system configuration. Please verify the existence of the rule identifier and ensure it has been correctly defined or implemented. |
| 400 | RuleConfigs.Malformed | The specified RuleConfigs format is invalid. | The RuleConfigs parameter is in an invalid format. |
| 400 | RuleName.AlreadyExists | Rule name already exists in specified policy. | The specified rule name is already used by another rule. |
| 400 | Rule.Name.CantBeModified | The specified rule name can not be modified. | The name of the specified rule cannot be modified. |
| 500 | InternalError | An 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 time | Summary of changes | Operation |
|---|---|---|
| 2023-08-29 | The Error code has changed | View Change Details |
| 2023-03-10 | The Error code has changed | View Change Details |