# 创建白名单 - CreateWhitelist
#### 功能介绍
创建白名单，控制监听器的访问权限。若开启了白名单功能，只有白名单中放通的IP可以访问该监听器的后端服务。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ELB&api=CreateWhitelist&version=v2)中直接运行调试该接口。
#### URI
POST /v2/{project_id}/elb/whitelists
表1参数说明 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                   |
|:---|:---|:---|:---|
| project_id | 是    | String | 操作用户的项目ID。 获取方法详见[获取项目ID](https://support.huaweicloud.com/api-elb/elb_fl_0008.html)。 |
   
#### 请求消息
表2请求参数 
| 参数        | 是否必选 | 参数类型                                                             | 描述                                                           |
|:---|:---|:---|:---|
| whitelist | 是    | [Whitelist] object | 白名单对象。详见 [表3]。 |
   
 表3whitelist字段说明 
| 参数               | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| tenant_id        | 否    | String  | 白名单所在的项目ID。 获取方法详见[获取项目ID](https://support.huaweicloud.com/api-elb/elb_fl_0008.html)。 需要和token中的project_id一致。 支持的最大字符长度：255                                                                         |
| listener_id      | 是    | String  | 监听器ID。 一个监听器只能创建一个白名单。                                                                                                                                                                                                                                                        |
| enable_whitelist | 否    | Boolean | 是否开启访问控制开关。 true：打开 false：关闭 默认值：true。                                                                                                                                               |
| whitelist        | 否    | String  | 白名单IP的字符串。不同IP之间通过逗号分隔。 可以指定一个IP，例如： 192.168.11.1 也可以指定网段，例如： 192.168.0.1/24 默认值：""。 |
   
#### 响应消息
表4响应参数 
| 参数        | 参数类型                                                              | 描述                                                            |
|:---|:---|:---|
| whitelist | [Whitelist] object | 白名单对象。详见 [表5]。 |
   
 表5whitelist字段说明 
| 参数               | 参数类型    | 描述                                                                                                                    |
|:---|:---|:---|
| id               | String  | 白名单的ID。                                                                                                               |
| tenant_id        | String  | 白名单所在的项目ID。 支持的最大字符长度：255                                                  |
| listener_id      | String  | 白名单关联的监听器ID。                                                                                                          |
| enable_whitelist | Boolean | 是否开启访问控制开关。 true：打开 false：关闭 |
| whitelist        | String  | 白名单IP的字符串。                                                                                                            |
   
#### 请求示例
- 请求样例 创建白名单
  ```
  POST https://{Endpoint}/v2/eabfefa3fd1740a88a47ad98e132d238/elb/whitelists
  { 
      "whitelist": { 
          "listener_id": "eabfefa3fd1740a88a47ad98e132d238",  
          "enable_whitelist": true,  
          "whitelist": "192.168.11.1,192.168.0.1/24,192.168.201.18/8,100.164.0.1/24" 
      } 
  }
  ```
  
 
#### 响应示例
- 响应样例
  ```
  { 
      "whitelist": { 
          "id": "eabfefa3fd1740a88a47ad98e132d238",  
          "listener_id": "eabfefa3fd1740a88a47ad98e132d238",  
          "tenant_id": "eabfefa3fd1740a88a47ad98e132d238",  
          "enable_whitelist": true,  
          "whitelist": "192.168.11.1,192.168.0.1/24,192.168.201.18/8,100.164.0.1/24" 
      } 
  }
  ```
  
 
#### 返回码
请参见[状态码](https://support.huaweicloud.com/api-elb/elb_gc_1102.html)。