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

Deleting a Listener

Function

This API is used to delete a listener.

Constraints

Before you delete a listener, delete associated backend server groups or remove all backend servers in the default backend server group, and delete all forwarding policies.

Calling Method

For details, see Calling APIs.

URI

DELETE /v3/{project_id}/elb/listeners/{listener_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

listener_id

Yes

String

Specifies the listener ID.

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

Successful request.

None

Example Requests

Deleting a listener

DELETE https://{ELB_Endpoint}/v3/99a3fff0d03c428eac3678da6a7d0f24/elb/listeners/0b11747a-b139-492f-9692-2df0b1c87193

Example Responses

None

Status Codes

Status Code

Description

204

Successful request.

Error Codes

See Error Codes.