Updated on 2025-09-24 GMT+08:00

Unblocking a Blocked IP Address

Function

This API is used to unblock a blocked IP address.

Calling Method

For details, see Calling APIs.

URI

PUT /v5/{project_id}/event/blocked-ip

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Tenant project ID

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

enterprise_project_id

No

String

Enterprise project ID. To query all enterprise projects, set this parameter to all_granted_eps.

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

x-auth-token

Yes

String

User token.

It can be obtained by calling the IAM API used to obtain a user token. The value of X-Subject-Token in the response header is a token.

Table 4 Request body parameters

Parameter

Mandatory

Type

Description

data_list

No

Array of BlockedIpRequestInfo objects

List of IP addresses to be unblocked

Table 5 BlockedIpRequestInfo

Parameter

Mandatory

Type

Description

host_id

Yes

String

Server ID

src_ip

Yes

String

Attack source IP address

login_type

Yes

String

Login type. The options are as follows:

  • "mysql" # MySQL service

  • "rdp" # RDP service

  • "ssh" # SSH service

  • "vsftp" # vsftp service

Response Parameters

Status code: 200

successful response

None

Example Requests

Remove the blocked IP address 192.168.1.6 of the host af423efds-214432fgsdaf-gfdsaggbvf in SSH mode.

PUT https://{endpoint}/v5/{project_id}/event/blocked-ip

{
  "data_list" : [ {
    "host_id" : "af423efds-214432fgsdaf-gfdsaggbvf",
    "src_ip" : "192.168.1.6",
    "login_type" : "ssh"
  } ]
}

Example Responses

None

Status Codes

Status Code

Description

200

successful response

Error Codes

See Error Codes.