ModifyWhiteIps - 更新指定实例的访问白名单-检索分析服务 Elasticsearch版(ES)-阿里云帮助中心

调用ModifyWhiteIps，更新指定实例的访问白名单。

接口说明

注意事项

实例状态为生效中（activating）、失效（invalid）和冻结（inactive），无法更新信息。
您可以通过两种方式更新白名单：IP 白名单列表和 IP 白名单组。两种方式不能同时使用，且除了 InstanceId 和 clientToken 外，两种方式支持配置的参数也不同，具体如下：
- IP 白名单列表：whiteIpList、nodeType、networkType
- IP 白名单组：modifyMode、whiteIpGroup
公网访问白名单不支持配置私网 IP 地址，私网访问白名单不支持配置公网 IP 地址。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

elasticsearch:ModifyWhiteIps

update

*Instance

acs:elasticsearch:{#regionId}:{#accountId}:instances/{#instancesId}

无

请求语法

PATCH /openapi/instances/{InstanceId}/actions/modify-white-ips HTTP/1.1

路径参数

名称	类型	必填	描述	示例值
InstanceId	string	是	实例 ID。	es-cn-0pp1jxvcl000z****

请求参数

名称	类型	必填	描述	示例值
clientToken	string	否	用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大不超过 64 个 ascii 字符。	5A2CFF0E-5718-45B5-9D4D-70B3FF****
body	object	否	请求体参数。
nodeType	string	否	节点类型，如果选填了 whiteIpList 参数，则该参数必填。可选值： WORKER：Elasticsearch 集群 KIBANA：Kibana 集群	WORKER
networkType	string	否	网络类型，如果选填了 whiteIpList 参数，则该参数必填。可选值： PRIVATE：私网 PUBLIC：公网	PUBLIC
modifyMode	string	否	修改方式，可选值： Cover（默认）：使用 ips 参数的值覆盖原 IP 白名单。 Append：在原 IP 白名单中增加 ips 参数中输入的 IP 地址。 Delete：在原 IP 白名单中删除 ips 参数中输入的 IP 地址，至少需要保留一个 IP 地址。	Cover
whiteIpList	array	否	IP 地址白名单列表。whiteIpGroup 为空时可用，更改默认分组白名单。
	string	否	IP 地址白名单列表。whiteIpGroup 为空时可用，该参数值会更新 Default 白名单分组中的 IP 白名单配置。重要不支持同时配置 whiteIpList 和 whiteIpGroup。	192.168.xx.xx
whiteIpGroup	object	否	以白名单组方式更新实例白名单配置，仅支持更新一个白名单组。重要不支持同时配置 whiteIpList 和 whiteIpGroup。
groupName	string	否	白名单组的组名。如果选填了 whiteIpGroup 参数，则该参数必填。	test_group
ips	array	否	白名单组中的 IP 地址列表。如果选填了 whiteIpGroup 参数，则该参数必填。
	string	否	白名单组中的 IP 地址列表。如果选填了 whiteIpGroup 参数，则该参数必填。	192.168.xx.xx
whiteIpType	string	否	IP 白名单的类型，可选值： PRIVATE_KIBANA：Kibana 私网访问白名单 PRIVATE_ES：Elasticsearch 私网访问白名单 PUBLIC_ES：Elasticsearch 公网访问白名单 PUBLIC_KIBANA：Kibana 公网访问白名单枚举值： PRIVATE_KIBANA : kibana 私网白名单 PRIVATE_ES : Es 实例私网白名单 PUBLIC_ES : Es 实例公网白名单 PUBLIC_KIBANA : kibana 公网白名单	PRIVATE_ES

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

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

返回参数

名称	类型	描述	示例值
	object	返回结果对象。
Result	boolean	返回结果： true：白名单更新成功 false：白名单更新失败	true
RequestId	string	请求 ID。	5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1DERFG

示例

正常返回示例

JSON格式

{
  "Result": true,
  "RequestId": "5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1DERFG"
}

错误码

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

变更历史

更多信息，参考变更详情。