Modify DDoS basic protection threshold
Updated at：2025-10-16
Description
- Modify protection threshold for a specified public IP
Request structure
Java
1PUT /v{version}/ddos/{ip}?{action}&clientToken={clientToken} HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization: authorization string
4{
5 "thresholdType": thresholdType,
6 "ipCleanMbps": ipCleanMbps,
7 "ipCleanPps": ipCleanPps
8}Request headers
No special headers beyond common headers.
Request parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number, current value is 1. |
| ip | String | Yes | URL parameter | Public IP Address |
| action | String | Yes | Query | The parameter value is modifyThreshold in this API |
| clientToken | String | Yes | Query | Idempotence token; for details, refer to [Idempotence](EIP/API Reference/General Description.md#Idempotence) |
| thresholdType | String | Yes | RequestBody | Type of cleaning threshold setting, including bandwidth (upper limit), auto (smart), and manual |
| ipCleanMbps | Long | Yes | RequestBody | Traffic bandwidth per second, in Mbps, with a minimum of 120 Mbps and a maximum of 5,000 Mbps (required when cleaning threshold setting type is set as manual) |
| ipCleanPps | Long | Yes | RequestBody | Packets per second (pps), with a minimum of 58,594 pps and a maximum of 4,882,813 pps (required when cleaning threshold setting type is set as manual) |
Response headers
No special headers are required beyond the standard ones.
Response parameters
There are no special response parameters
Request example
Java
1PUT /v1/ddos/106.13.244.6?modifyThreshold&clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2021-11-06T12:28:04Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16
4{
5 "thresholdType": "manual",
6 "ipCleanMbps": 120,
7 "ipCleanPps": 60000
8}Response example
Java
1HTTP/1.1 200 OK
2Server: nginx/1.19.0
3Date: Thu, 28 Apr 2022 11:06:00 GMT
4Content-Type: application/json; charset=UTF-8
5X-Bce-Request-Id: 70b6324a-7b10-4736-8872-4c29be8ef474