调用ModifyDBClusterAccessWhiteList接口修改指定云数据库ClickHouse集群的IP白名单。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyDBClusterAccessWhiteList

系统规定参数。取值:ModifyDBClusterAccessWhiteList

DBClusterId String cc-bp1qx68m06981****

集群ID。

SecurityIps String 192.168.xx.xx

白名单,支持如下两种格式:

  • IP地址形式,例如192.168.0.1表示允许此IP地址访问云数据库ClickHouse。
  • IP段形式:例如192.168.0.0/24表示允许从192.168.0.1到192.168.0.255的IP地址访问云数据库ClickHouse。
    说明
    • 禁止输入IP: 0.0.0.0。
    • 设置为127.0.0.1代表禁止所有地址访问。
DBClusterIPArrayName String default

需要修改的白名单分组名称。

说明 不配置该参数时,默认修改default分组中的白名单。
DBClusterIPArrayAttribute String default

白名单分组属性。

ModifyMode String Cover

修改方式,取值说明:

  • Cover:覆盖原白名单。
  • Append:在原白名单后追加修改的白名单。
  • Delete:删除原白名单。
说明 不配置该参数时,默认采用Cover方式修改白名单。

返回数据

名称 类型 示例值 描述
RequestId String D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC

请求ID。

示例

请求示例

http(s)://clickhouse.aliyuncs.com/?Action=ModifyDBClusterAccessWhiteList
&DBClusterId=cc-bp1qx68m06981****
&SecurityIps=192.168.xx.xx
&公共请求参数

正常返回示例

XML格式

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

<ModifyDBClusterAccessWhiteListResponse>
    <RequestId>D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC</RequestId>
</ModifyDBClusterAccessWhiteListResponse>

JSON格式

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

{
  "RequestId" : "D0CEC6AC-7760-409A-A0D5-E6CD8660E9CC"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDBCluster.NotFound The DBClusterId provided does not exist in our records. 您指定的 DBClusterId 不存在,请确认 DBClusterId 值是否正确。

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