edit-icon download-icon


Last Updated: Mar 06, 2018


Configure an access whitelist for a listener.

This API supports incremental updates.

Request parameter

Name Type Required Description
Action String Yes

The action to perform. Valid value:


RegionId String Yes The ID of the region where the SLB instance is located.
LoadBalancerId String Yes The ID of the SLB instance for which the TCP listener is created.
ListenerPort Integer Yes

The front-end port of the listener that is used to receive incoming traffic and distribute the traffic to the backend servers.

Valid value: [1, 65535]

SourceItems String Yes

The access whitelist of the IP addresses or an IP address range to allow to access the listener.

Separate multiple IP addresses or IP address ranges using commas (,).

Note: The IP address or the IP address range are not allowed. If you do not want to control the access for the listener. Call the SetListenerAccessControlStatus API and set the value of the AccessControlStatus parameter to close.

Response parameter

Name Type Description
RequestId String The ID of the request.


Request example

  1. https://slb.aliyuncs.com/?Action=AddListenerWhiteListItem
  2. &LoadBalancerId=139a00604ad-cn-east-hangzhou-01
  3. &ListenerPort=80
  4. &SourceItems=,
  5. &<Public Request Parameters>

Response example

  • XML format

    1. <?xml version="1.0" encoding="UTF-8"?>
    2. <AddListenerWhiteListItemResponse>
    3. <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
    4. </AddListenerWhiteListItemResponse>
  • JSON format

    1. {
    2. "RequestId":" CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
    3. }
Thank you! We've received your feedback.