Updated on 2026-01-09 GMT+08:00

Batch Deleting Backend Server Groups

Function

This API is used to batch delete backend server groups.

Calling Method

For details, see Calling APIs.

URI

POST /v3/{project_id}/elb/pools/batch-delete

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition: Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID.

Constraints: N/A

Range: The value can contain a maximum of 32 characters, including digits and lowercase letters.

Default value: N/A

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Definition: Specifies the token used for IAM authentication.

Constraints: N/A

Range: N/A

Default value: N/A

Table 3 Request body parameters

Parameter

Mandatory

Type

Description

pools

Yes

Array of strings

Specifies the IDs of the backend server groups to be deleted.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

pools

Array of BatchDeletePoolsResp objects

Specifies the response body for batch deleting backend server groups.

Table 5 BatchDeletePoolsResp

Parameter

Type

Description

id

String

Specifies the IDs of the backend server groups that are deleted.

ret_status

String

Specifies the deletion result of the backend server group. not found indicates that the backend server group does not exist, and successful indicates that the backend server group is deleted.

ret_code

String

Specifies the error code when the deletion fails.

Example Requests

Batch deleting backend server groups

POST https://{ELB_Endpoint}/v3/{project_id}/elb/pools/batch-delete

{
  "pools" : [ "de3404aeb44f499893fb42a0b218a515", "de3404aeb44f499893fb42a0b218a123" ]
}

Example Responses

Status code: 200

Successful request.

{
  "pools" : [ {
    "id" : "de3404aeb44f499893fb42a0b218a515",
    "ret_status" : "successful"
  }, {
    "id" : "de3404aeb44f499893fb42a0b218a515",
    "ret_status" : "not found",
    "ret_code" : "ELB.9903"
  } ],
  "request_id" : "98414965-856c-4be3-8a33-3e08432a222e"
}

Status Codes

Status Code

Description

200

Successful request.

Error Codes

See Error Codes.