调用 CreateAllowList 接口创建一个新的 IP 白名单。 ## 请求类型同步请求。 ## 注意事项在缓存数据库 Redis 版中使用白名单时存在一些约束和限制，具体限制请参见[创建白名单](https://docs.volcengine.com/docs/6293/70856#.5rOo5oSP5LqL6aG5)。 ## 调试 [去调试](https://api.volcengine.com/api-explorer/debug?action=CreateAllowList&serviceCode=Redis&version=2020-12-07&groupName=白名单管理) ## 请求参数 |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |AllowListName |String |是 |test |白名单名称，名称需同时满足如下要求：

* 不能以数字、中划线（\-）开头。

* 只能包含中文、字母、数字、下划线（_）和中划线（\-）。

* 长度需为 1~128 个字符。 | |AllowList |String |否 |10.1.1.1,10.2.3.0/24 |输入 IP 地址或 CIDR 格式的地址段。

说明

AllowList 和 SecurityGroupBindInfos 参数不可同时为空。

不允许设置重复的地址，多个地址间用英文逗号（,）隔开。

设置 0.0.0.0/0，表示允许所有地址访问；设置 127.0.0.1，表示禁止所有地址访问；同时设置 0.0.0.0/0和127.0.0.1，表示允许所有地址访问。

设置 CIDR 192.168.1.0/24，表示允许该网段内的 IP 地址访问；设置 192.168.1.1，表示仅允许该 IP 地址访问。

说明

若不设置该参数，新建白名单的备注信息默认为空。

说明

每个火山引擎账号在每个地域最多可设定一个默认白名单。新设置的默认白名单会自动顶替原有默认白名单，即原有默认白名单会自动变为非默认白名单。更多详情，请参见约束与限制。

说明

AllowList 和 SecurityGroupBindInfos参数不可同时为空。

说明

若该参数留空，新建白名单会加入默认（即 default）项目。

| |AllowListType |String |否 |DualStack |该字段已废弃不再使用，无需关注。 | |ClientToken |String |否 |WbiAlPqJM6tMoSOYhT\*\*\*\* |用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，要保证在不同请求间唯一，大小写敏感且不超过 127 个 ASCII 字符。 | ### SecurityGroupBindInfo |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |BindMode |String |是 |AssociateEcsIp |安全组关联模式。取值范围如下：

* `IngressDirectionIp`：入方向 IP，即允许安全组入方向的源地址中 TCP 协议和 ALL 协议涉及的 IP 访问数据库，若源地址中配置为安全组将被忽略。

* `AssociateEcsIp`：关联 ECS IP，即允许安全组内的云服务器访问数据库，当前仅支持主网卡的 IP 信息导入。

说明

关于安全组关联模式的更多详情，请参见创建白名单。

说明

您可以调用 DescribeSecurityGroups 接口查询安全组信息，包括安全组 ID。

单个白名单单次最多可选择添加 10 个安全组。

一个白名单最多支持 300 个 IP 或 IP 段，关联安全组涉及的 IP 或 IP 段超过限制时会关联失败，您可以调整安全组中的 IP 后重新关联。更多详情，请参见约束与限制。

| ## 返回参数 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |AllowListId |String |acl\-cnlf3xgczbjldzy\*\*\*\* |白名单 ID。 | ## 示例 ## 请求示例 ```JSON POST https://redis.cn-beijing.volcengineapi.com/?Action=CreateAllowList&Version=2020-12-07 HTTP/1.1 Host: redis.cn-beijing.volcengineapi.com Content-Type: application/json; charset=utf-8 X-Date: 20201103T104027Z Authorization: HMAC-SHA256 Credential=AK****/20201103/cn-beijing/Redis/request,SignedHeaders=content-type;host;x-date,Signature=**** { "AllowListName": "test", "AllowList": "10.1.1.1,10.2.3.0/24" } ``` ## 返回示例 ```JSON { "ResponseMetadata": { "RequestId": "2022041515414001021207408100610061", "Action": "CreateAllowList", "Version": "2020-12-07", "Service": "Redis", "Region": "cn-beijing" }, "Result": { "AllowListId": "acl-cnlf3xgczbjldzy****" } } ``` ## 错误码更多详情，请参见[错误码](https://docs.volcengine.com/docs/6293/73664)。