ModifyListenerAttribute

1. API Description

The API is used to modify the attributes of a listener, including protocols, scheduler, health check configurations, and etc.

2. Input Parameters

The following request parameter list only provides API request parameters.

Parameter Name	Required	Type	Description
listenerId	Yes	String	Listener ID.
listenerName	No	String	Listener name. This parameter can contain up to 64 characters. Only letters, numbers, - and periods (.) are supported.
protocol	No	String	Listening protocol. Valid value： TCP UDP
backendProtocol	No	String	Backend protocol. Valid value： TCP UDP
scheduler	No	String	Scheduling algorithm. Valid value: wrr (default): Weighted Round-Robin scheduling. Backend servers that have higher weights receive more requests than backend servers that have lower weights. rr: Round-Robin. Requests are forwarded to backend servers in sequence.
kind	No	String	Working mode. Valid value: DR
healthCheck	No	HealthCheck	Health check configurations.
notify	No	Notify	Notifications.

3. Output Parameters

Parameter Name	Type	Description
requestId	String	The unique request ID, which is returned for each request. RequestId is required for locating a problem.

4. Code Example

Example

Modify the attribute of a listener.

POST / HTTP/1.1
Host: console.harmonynetworks.net/api/v2/bmc
Content-Type: application/json
X-ZC-Action: ModifyListenerAttribute
<Common Request Params>

Request:
{
  "listenerId": "xxxx",
  "listenerName": "xxxx"
}

Response:
{
  "requestId": "TEEFDCA5B-76FB-4E91-A18E-DF7F5D2CE41F",
  "response": {
    "requestId": "TEEFDCA5B-76FB-4E91-A18E-DF7F5D2CE41F"
  }
}

5. Error Codes

No error codes related to the API business logic. For other error codes, see Common Error Codes.​