Add Region Blocking
Updated at：2025-10-16
Description
- Enable IP region blocking protection in the TBSP.
- If the user's region is mainland China, regions blocked will include overseas, Hong Kong, Macau, and Taiwan. Conversely, if the user's region is overseas, Hong Kong, Macau, or Taiwan, the blocked region will be mainland China.
- Each TBSP instance comes with a default monthly quota allowing 10 active region blocking additions.
Request structure
Plain Text
1POST /v{version}/tbsp/{id}/areaBlocking?clientToken={clientToken} HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization: authorization string
4{
5 "ip": ip,
6 "blockTime": blockTime,
7 "blockType": blockType
8}Request headers
No additional headers required beyond standard ones.
Request parameters
| Parameter name | Types | Required or not | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number, current value is 1. |
| id | String | Yes | URL parameter | ID of the TBSP |
| clientToken | String | Yes | Query | Idempotence token, for details, refer to [Idempotence](EIP/API Reference/General Description.md#Idempotence) |
| action | String | Yes | Query | The parameter value is modifyThreshold in this API |
| ip | String | Yes | RequestBody | IP address of TBSP protection object |
| blockTime | Int | No | RequestBody | Region blocking duration (in minutes), minimum 30, maximum 1,440; blockTime is mandatory for fixed-duration region blocking |
| blockType | String | No | RequestBody | Blocking type, which can be fixedDuration (fixed duration) or systemDetermines (system-determined), defaulted as fixedDuration if left blank |
Response headers
No special headers are required beyond the standard ones.
Response parameters
No special response parameters are available.
Request example
Request example: Fixed-duration region blocking
Java
1POST /v1/tbsp/ipDdos-f294b1c9/areaBlocking?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16
4{
5 "ip": "100.88.15.226",
6 "blockTime": 30
7}Request example: System-determined region blocking
Java
1POST /v1/tbsp/ipDdos-f294b1c9/areaBlocking?clientToken=914447ae-a041-46cf-ae72-c6f515a94a7e HTTP/1.1
2Host: eip.bj.baidubce.com
3Authorization:bce-auth-v1/a43eea003308400587496785f7f5d9ee/2022-04-28T11:06:00Z/3600/host;x-bce-date/25ec3d4baba54ad7397cb31c96cb5e364088ff79f9b853ffb8dc6c11ebcdcf16
4{
5 "ip": "122.105.0.115",
6 "blockType":"systemDetermines"
7}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: 36a6324a-7b10-4736-8872-4c29be8ef854