Help Center/ Elastic Load Balance/ API Reference/ APIs (V3)/ IP Address Group/ Deleting IP Addresses from an IP Address Group
Updated on 2025-08-29 GMT+08:00

Deleting IP Addresses from an IP Address Group

Function

This API is used to delete IP addresses from an IP address group.

Note: Deleting IP addresses from an IP address group will affect all associated listeners.

Calling Method

For details, see Calling APIs.

URI

POST /v3/{project_id}/elb/ipgroups/{ipgroup_id}/iplist/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

ipgroup_id

Yes

String

Definition: Specifies the ID of an IP address group.

Constraints: N/A

Range: N/A

Default value: N/A

Request Parameters

Table 2 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

No

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

ipgroup

No

BatchDeleteIpListOption object

Definition: Specifies the request parameters for deleting IP entries in batches.

Constraints: N/A

Table 4 BatchDeleteIpListOption

Parameter

Mandatory

Type

Description

ip_list

No

Array of IpGroupIp objects

Definition: Provides information about IP entries in the IP address group.

Constraints: N/A

Table 5 IpGroupIp

Parameter

Mandatory

Type

Description

ip

Yes

String

Definition: Specifies the IP entries to be deleted from the IP address group. Each IP entry can be a single IP address, CIDR block, or IP address range.

Constraints: N/A

Range: N/A

Default value: N/A

Response Parameters

Status code: 200

Table 6 Response body parameters

Parameter

Type

Description

ipgroup

IpGroup object

Definition: Shows the IP address group information.

request_id

String

Definition: Specifies the request ID.

Range: The value is automatically generated, and can contain characters including digits, lowercase letters, and hyphens (-).

Table 7 IpGroup

Parameter

Type

Description

id

String

Definition: Specifies the ID of an IP address group.

Range: N/A

name

String

Definition: Specifies the name of an IP address group.

Range: N/A

description

String

Definition: Provides supplementary information about an IP address group.

Range: N/A

ip_list

Array of IpInfo objects

Definition: Specifies IP addresses in an IP address group. [] indicates any IP address.

listeners

Array of ListenerRef objects

Definition: Specifies the IDs of listeners with which the IP address group is associated.

project_id

String

Definition: Specifies the project ID of the IP address group.

Range: N/A

enterprise_project_id

String

Definition: Specifies the ID of the enterprise project.

Range:

  • 0: The resource belongs to the default enterprise project.

  • A string in UUID format indicates a non-default enterprise project.

created_at

String

Definition: Specifies the time when the IP address group was created.

Range: The value must be a UTC time in the yyyy-MM-dd'T'HH:mm:ss'Z' format.

updated_at

String

Definition: Specifies the time when the IP address group was updated.

Range: The value must be a UTC time in the yyyy-MM-dd'T'HH:mm:ss'Z' format.

Table 8 IpInfo

Parameter

Type

Description

ip

String

Definition: Specifies the IP entries in the IP address group.

Range: Each IP address range must be in the format of ip-ip, for example, 192.168.1.2-192.168.2.253 or 2001:0DB8:02de::0e12-2001:0DB8:02de::0e13. The end IP address must be greater than the start IP address.

description

String

Definition: Provides remarks about the IP address group.

Range: 0 to 255 characters.

Table 9 ListenerRef

Parameter

Type

Description

id

String

Definition: Specifies the listener ID.

Range: N/A

Example Requests

Deleting IP addresses from an IP address group

PUT https://{ELB_Endpoint}/v3/45977fa2dbd7482098dd68d0d8970117/elb/ipgroups/8722e0e0-9cc9-4490-9660-8c9a5732fbb0/iplist/batch-delete

{
  "ipgroup" : {
    "ip_list" : [ {
      "ip" : "192.168.1.123"
    }, {
      "ip" : "192.168.3.0/24"
    } ]
  }
}

Example Responses

Status code: 200

Successful request.

{
  "ipgroup" : {
    "description" : "",
    "id" : "8722e0e0-9cc9-4490-9660-8c9a5732fbb0",
    "name" : "test_ipg",
    "project_id" : "45977fa2dbd7482098dd68d0d8970117",
    "ip_list" : [ {
      "ip" : "192.168.1.122",
      "description" : ""
    } ],
    "listeners" : [ {
      "id" : "88f9c079-29cb-435a-b98f-0c5c0b90c2bd"
    }, {
      "id" : "2f4c9644-d5d2-4cf8-a3c0-944239a4f58c"
    } ],
    "created_at" : "2018-01-16T03:19:16",
    "updated_at" : "2018-01-16T03:19:16"
  }
}

Status Codes

Status Code

Description

200

Successful request.

Error Codes

See Error Codes.