Enables or disables the access control function for a listener.


Use OpenAPI Explorer to perform debug operations and generate SDK code examples.

Request parameters

Parameter Type Required? Example value Description
Action String Yes SetListenerAccessControlStatus

The name of this action.

Value: SetListenerAccessControlStatus

RegionId String Yes cn-hangzhou

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

To query the region ID, call DescribeRegions.

AccessControlStatus String Yes open_white_list

Indicates whether to enable access control. Valid values:

  • open_white_list: Enable a whitelist for access control.
  • close: Disable access control.
Note When the access control function is enabled, you must configure a whitelist of IP addresses. Otherwise, no access is allowed.
ListenerPort Integer Yes 80

The frontend port used by the SLB instance.

Value range: 1 to 65535

LoadBalancerId String Yes lb-8vb86hxixo8lvsja86jaz

The ID of the SLB instance.

Response parameters

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

The ID of the request.


Request example

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

Response examples

XML format


JSON format

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

Error codes

See common error codes.