UpdateKibanaWhiteIps
更新指定阿里云Elasticsearch实例的Kibana访问白名单
服务地址:
华东1 金融云
输入参数
只看必填
InstanceId实例ID
clientToken用于保证请求的幂等性
modifyMode修改方式
body请求体
kibanaIPWhitelistKibana节点IP访问白名单
0IP地址白名单列表
whiteIpGroup以白名单组方式更新Kibana访问白名单配置
groupName白名单组的组名
whiteIpType白名单类型
ips白名单组中的IP列表
0白名单组中的IP列表
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

注意事项

  • 调用该接口时,当实例状态为生效中(activating)、失效(invalid)和冻结(inactive)时,无法更新信息。
  • 您可以通过两种方式更新白名单:IP 白名单列表和 IP 白名单组。两种方式不能同时使用,且除了 InstanceId 和 clientToken 外,两种方式支持配置的参数也不同,具体如下:
    • IP 白名单列表:kibanaIPWhitelist
    • IP 白名单组:modifyMode、whiteIpGroup
  • 公网访问白名单不支持配置私网 IP 地址,私网访问白名单不支持配置公网 IP 地址。

请求语法

PATCH /openapi/instances/{InstanceId}/kibana-white-ips HTTP/1.1
POST /openapi/instances/{InstanceId}/kibana-white-ips HTTP/1.1

路径参数

字段名称字段详情
InstanceIdstring

实例 ID。

示例值:es-cn-tl329rbpc0001****参考取值来源:
    ListInstance

请求参数

字段名称字段详情
clientTokenstring

用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不值过 64 个 ASCII 字符。

示例值:5A2CFF0E-5718-45B5-9D4D-70B3FF****
modifyModestring

修改方式,取值含义如下:展开详情

示例值:Cover枚举值:CoverAppendDelete
bodyobject

请求体。

请求说明

注意 白名单组的增加和删除是由 modifyMode 为 Cover 的调用来实现的,Delete 和 Append 无法实现白名单组粒度的增删,只能修改白名单组中的 IP 地址列表。具体说明如下:

  • modifyMode 为 Cover 时,如果 ips 为空,则删除该白名单组。如果 groupName 不在已有白名单组组名的列表中,则会新建一个白名单组。
  • modifyMode 为 Delete 时,删除后的 ips 至少需要保留一个 IP 地址。
  • modifyMode 为 Append 时,需要保证白名单组组名为已创建,否则会提示 NotFound 的错误。

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:E5EF11F1-DBAE-4020-AC24-DFA6C4345CAE
Resultobject

返回对应 Elasticsearch 实例的详情。

返回说明

说明 下文返回示例中,本文只保证包含返回数据列表中的参数,而未提到的参数仅供参考,程序中不能强制依赖获取这些参数。
变更历史
变更时间变更内容概要操作
2022-09-13
变更请求参数modifyMode
新增请求参数body
变更返回参数
2022-08-30
删除错误码400