Last Updated: Aug 24, 2017


Adds an IP or IP address range to the access control list of the specified listener. This interface supports incremental updates.

Request Parameters

Name Type Required Description
Action String Yes Operator interface name, required parameter. Value:AddListenerWhiteListItem.
RegionId String Yes Region Id.
LoadBalancerId String Yes Unique ID of a Server Load Balancer instance.
ListenerPort Integer Yes Server Load Balancer instance’s frontend port. Value:1-65535.
SourceItems String Yes Access control list. This is effective when the listener’s AccessControlStatus is open_white_list. Enter IP addresses or IP address segments here. Separate multiple entries with “,”. Users cannot enter or similar addresses. The only method provided by Server Load Balancer that allows all access is to call the SetListenerAccessControlStatus interface and set it to Close.

Return Parameters

All are public return parameters. See Public Parameters.


Request Example

  2. &Action=AddListenerWhiteListItem
  3. &LoadBalancerId=139a00604ad-cn-east-hangzhou-01
  4. &ListenerPort=80
  5. &SourceItems=,
  6. &<Public Request Parameters>

Return 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. {"RequestId":" CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
    2. }
Thank you! We've received your feedback.