监听相关API：AddListenerWhiteListItem
描述
从指定监听的访问控制列表中添加ip或ip段。该接口支持增量更新。
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
| Action | String | 是 | 操作接口名，系统规定参数。取值：AddListenerWhiteListItem。 |
| RegionId | String | 是 | 地域Id。 |
| LoadBalancerId | String | 是 | 负载均衡实例的唯一标识。 |
| ListenerPort | Integer | 是 | 负载均衡实例前端使用的端口。取值：1-65535。 |
| SourceItems | String | 是 | 访问控制列表。Listener的AccessControlStatus为open_white_list时有效。支持ip地址或ip地址段的输入，多个ip地址或ip地址段间用”,”分割。不支持传入0.0.0.0类似的地址。负载均衡提供的允许所有访问的唯一方式是调用SetListenerAccessControlStatus接口设置为close。 |
返回参数
全是公共返回参数，详见 <公共请求参数>。
示例
请求示例
- https://slb.aliyuncs.com/
- &Action=AddListenerWhiteListItem
- &LoadBalancerId=139a00604ad-cn-east-hangzhou-01
- &ListenerPort=80
- &SourceItems=1.1.1.1,1.1.1.0/21
- &<公共请求参数>
返回示例
- XML 格式
- <?xml version="1.0" encoding="UTF-8"?>
- <AddListenerWhiteListItemResponse>
- <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
- </AddListenerWhiteListItemResponse>
- JSON格式
- {"RequestId":" CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
- }
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
根据您的描述，您想要了解如何使用阿里云的负载均衡（SLB）服务通过API接口来添加指定监听的访问控制列表（白名单）中的IP或IP段。下面我将为您提供一个简化的操作指南和示例请求，帮助您更好地理解和执行这个操作。
操作指南
-
确定参数：在调用此接口前，请确保您已知以下参数：
Action: 必须设置为AddListenerWhiteListItem。RegionId: 您的负载均衡实例所在的地域ID，例如cn-hangzhou。LoadBalancerId: 负载均衡实例的唯一标识。ListenerPort: 负载均衡监听的前端端口，范围是1-65535。SourceItems: 需要添加到白名单的IP地址或IP段，多个之间用逗号,分隔。注意，不支持包含0.0.0.0等通配符的地址。
-
构造请求：基于上述参数，构造一个HTTP POST请求到阿里云SLB API的服务地址。请求URL的基本格式如下：
https://slb.aliyuncs.com/?Action=AddListenerWhiteListItem &RegionId=cn-hangzhou &LoadBalancerId=lb-xxxxx &ListenerPort=80 &SourceItems=192.168.1.1,10.0.0.0/8 &SignatureMethod=HMAC-SHA1 &SignatureNonce=随机字符串 &AccessKeyId=您的AccessKeyId &SignatureVersion=1.0 &Timestamp=时间戳 &Signature=计算出的签名值其中，
Signature需要根据阿里云API签名规则，利用您的AccessKeySecret、请求参数及其它必要信息计算得出。其他如SignatureNonce、Timestamp也需要按照要求生成。 -
发送请求：使用支持HTTPS的工具或编程语言库（如cURL、Python requests库等），发送构造好的POST请求到阿里云SLB API服务器。
-
处理响应：API会返回JSON格式的响应数据，其中包含了操作的状态码和消息。如果操作成功，通常会返回一个成功的状态码和简短的消息确认。
示例请求说明
- 注意：实际应用中，您需要替换示例中的
lb-xxxxx、您的AccessKeyId等占位符，并正确计算签名值。 - 请确保您已经阅读并理解了阿里云API签名机制，以正确生成签名。
希望以上信息对您有所帮助！如果有更具体的问题或操作上的疑问，欢迎继续提问。
