Updated on 2025-08-29 GMT+08:00

Deleting an IP Address Group

Function

This API is used to delete an IP address group. An IP address group that has been associated with a listener cannot be deleted. You need to disassociate the IP address group first.

Calling Method

For details, see Calling APIs.

URI

DELETE /v3/{project_id}/elb/ipgroups/{ipgroup_id}

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.

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

Response Parameters

Status code: 204

Definition: Normal response to the DELETE operation.

None

Example Requests

Deleting an IP address group

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

Example Responses

None

Status Codes

Status Code

Description

204

Definition: Normal response to the DELETE operation.

Error Codes

See Error Codes.