edit-icon download-icon


Last Updated: Apr 12, 2018


Enable or disable the access control function for the specified listener.

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.
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]

AccessControlStatus String Yes

Whether to enable access control. Valid value:

  • open_whitelist

    Enable access control. If this value is entered, you must configure a whitelist of IP addresses to allow to access the listener using the AddListenerWhiteListItem API. Otherwise, no access is allowed.

  • close

    Disable access control.

Response parameter

Name Type Description
RequestId String The ID of the request.


Request example

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

Response example

  • XML format

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

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