调用SetListenerAccessControlStatus是否开启指定监听的白名单访问控制。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
RegionId String 否 cn-hangzhou

负载均衡实例的地域。

您可以通过调用DescribeRegions接口查询地域ID。

Action String 是 SetListenerAccessControlStatus

系统规定参数。取值：SetListenerAccessControlStatus。

LoadBalancerId String 是 lb-8vb86hxixo8lvsja8****

负载均衡实例的ID。
ListenerPort Integer 是 80

负载均衡实例前端使用的端口。

取值：1-65535。

AccessControlStatus String 是 open_white_list

是否开启访问控制。取值：

  • open_white_list：开启白名单访问控制。
  • close：关闭白名单访问控制。
说明 如果开启访问控制后，没有设置白名单则无法访问负载均衡服务。
ListenerProtocol String 否 https

负载均衡实例前端使用的协议。

说明 相同端口存在不同协议监听时，此字段必填。

返回数据

名称 类型 示例值 描述
RequestId String CEF72CEB-54B6-4AE8-B225-F876FF7BA984

请求ID。

示例

请求示例

http(s)://[Endpoint]/?RegionId=cn-hangzhou
&Action=SetListenerAccessControlStatus
&ResourceOwnerId=11
&LoadBalancerId=lb-8vb86hxixo8lvsja8****
&ListenerPort=80
&AccessControlStatus=open_white_list
&ListenerProtocol=https
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<SetListenerAccessControlStatusResponse>
    <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
</SetListenerAccessControlStatusResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
400 TooManyListeners More than 1 listener is found, please be more specified 检索到的监听数量大于1，请提供更具体的查询条件。
400 OperationFailed.ActionNotSupport The loadbalancer of ipv6 does not support such action. 操作失败，原因是Ipv6类型负载均衡实例不支持此操作。
400 OperationUnsupported.SetAccessControl The singleTunnel/anyTunnel loadbalancer does not support config AccessControlList. 操作被拒绝，原因是Single Tunnel和Any Tunnel 类型负载均衡实例不支持配置Acl。

访问错误中心查看更多错误码。