You can call the SetListenerAccessControlStatus API to determine whether to enable a whitelist for access control for a specified listener.


Click here to perform a debug operation in OpenAPI Explorer and automatically generate an SDK code example.

Request parameters

Name Type Required? Example value Description
Action String Yes SetListenerAccessControlStatus

The action to perform. Valid value: SetListenerAccessControlStatus.

RegionId String Yes cn-hangzhou

The ID of the region to which the SLB instance belongs.

You can call the DescribeRegions API to query this parameter.

AccessControlStatus String Yes open_white_list

Whether to enable access control. Valid values:

  • open_white_list: Enable a whitelist for access control.
  • close: Disable access control.
Note: If you do not set a whitelist after enabling access control, SLB is inaccessible.
ListenerPort Integer Yes 80

The frontend port used by the SLB instance. Valid values: 1–65535

LoadBalancerId String Yes lb-8vb86hxixo8lvsja86jaz

The ID of the SLB instance

Response parameters

Name Type Example value Description
RequestId String CEF72CEB-54B6-4AE8-B225-F876FF7BA984

The ID of the request


Request example

http(s)://[Endpoint]/? Action=SetListenerAccessControlStatus

Normal response examples

XML format


JSON format

	"RequestId":" CEF72CEB-54B6-4AE8-B225-F876FF7BA984"

Error response example

JSON format

	"Message":"The specified parameter is not valid.",

Error codes

Click here to view the error codes.