支持的操作
OpenSearch Service 支持 OpenSearch 和传统的 Elasticsearch OSS 的诸多版本。以下章节介绍 OpenSearch Service 在每个版本中支持的操作。
主题
- 值得注意的 API 差异
- OpenSearch 版本 1.2
- OpenSearch 版本 1.1
- OpenSearch 版本 1.0
- Elasticsearch 7.10 版
- Elasticsearch 7.9 版
- Elasticsearch 7.8 版
- Elasticsearch 7.7 版
- Elasticsearch 7.4 版
- Elasticsearch 7.1 版
- Elasticsearch 6.8 版
- Elasticsearch 6.7 版
- Elasticsearch 6.5 版
- Elasticsearch 6.4 版
- Elasticsearch 6.3 版
- Elasticsearch 6.2 版
- Elasticsearch 6.0 版
- Elasticsearch 5.6 版
- Elasticsearch 5.5 版
- Elasticsearch 5.3 版
- Elasticsearch 5.1 版
- Elasticsearch 2.3 版
- Elasticsearch 1.5 版
值得注意的 API 差异
设置和统计数据
OpenSearch Service 仅接受对使用“平面”设置表单的 _cluster/settings
API 的 PUT 请求。它拒绝使用扩展设置表单的请求。
// Accepted PUT _cluster/settings { "persistent" : { "action.auto_create_index" : false } } // Rejected PUT _cluster/settings { "persistent": { "action": { "auto_create_index": false } } }
高级 Java REST 客户端使用扩展表单,因此,如果您需要发送设置请求,请使用低级客户端。
在 Elasticsearch 5.3 之前,OpenSearch Service 域上的 _cluster/settings
API 仅支持 HTTP PUT
方法而不是 GET
方法。OpenSearch 和 Elasticsearch 较新的版本支持 GET
方法,如以下示例所示:
GET https://
domain-name
.region
.es.amazonaws.com/_cluster/settings?pretty
这是一个返回示例:
{
"persistent": {
"cluster": {
"routing": {
"allocation": {
"cluster_concurrent_rebalance": "2",
"node_concurrent_recoveries": "2",
"disk": {
"watermark": {
"low": "1.35gb",
"flood_stage": "0.45gb",
"high": "0.9gb"
}
},
"node_initial_primarirecoveries": "4"
}
}
},
"indices": {
"recovery": {
"max_bytper_sec": "40mb"
}
}
}
}
如果您针对某些设置和统计数据 API 比较来自开源 OpenSearch 集群和 OpenSearch Service 的响应,则可能会注意到缺少字段。OpenSearch Service 编辑公开服务内部的某些信息,例如来自 _nodes/stats
的文件系统数据路径或来自 _nodes
的操作系统名称和版本。
收缩
_shrink
API 可能导致升级、配置更改和域删除操作失败。建议不要在运行 Elasticsearch 版本 5.3 或 5.1 的域上使用它。这些版本上存在的错误可能会导致收缩索引的快照还原操作失败。
如果在其他 Elasticsearch 或 OpenSearch 版本上使用 _shrink
API,请先发出以下请求,然后再启动收缩操作:
PUT https://
domain-name
.region
.es.amazonaws.com/source-index
/_settings { "settings": { "index.routing.allocation.require._name": "name-of-the-node-to-shrink-to
", "index.blocks.read_only": true } }
然后,在收缩操作完成后发出以下请求:
PUT https://
domain-name
.region
.es.amazonaws.com/source-index
/_settings { "settings": { "index.routing.allocation.require._name": null, "index.blocks.read_only": false } } PUT https://domain-name
.region
.es.amazonaws.com/shrunken-index
/_settings { "settings": { "index.routing.allocation.require._name": null, "index.blocks.read_only": false } }
OpenSearch 版本 1.2
对于 OpenSearch 1.2,OpenSearch Service 支持以下操作。有关大多数操作的信息,请参阅 OpenSearch REST API 参考
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 OpenSearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
OpenSearch 版本 1.1
对于 OpenSearch 1.1,OpenSearch Service 支持以下操作。有关大多数操作的信息,请参阅 OpenSearch REST API 参考
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 OpenSearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
OpenSearch 版本 1.0
对于 OpenSearch 1.0,OpenSearch Service 支持以下操作。有关大多数操作的信息,请参阅 OpenSearch REST API 参考
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 OpenSearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 7.10 版
对于 Elasticsearch 7.10,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
-
旧索引模板 (
_template
) 被替换为以 Elasticsearch 7.8 为开头的可组合模板 (_index_template
)。可组合模板优先于旧模板。如果没有可组合模板匹配给定索引,则旧模板仍然可以匹配并应用。_template
操作仍然适用于 OpenSearch 和更高版本的 Elasticsearch OSS,但对两种模板类型的 GET 调用会返回不同的结果。
Elasticsearch 7.9 版
对于 Elasticsearch 7.9,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 OpenSearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
-
旧索引模板 (
_template
) 被替换为以 Elasticsearch 7.8 为开头的可组合模板 (_index_template
)。可组合模板优先于旧模板。如果没有可组合模板匹配给定索引,则旧模板仍然可以匹配并应用。_template
操作仍然适用于 OpenSearch 和更高版本的 Elasticsearch OSS,但对两种模板类型的 GET 调用会返回不同的结果。
Elasticsearch 7.8 版
对于 Elasticsearch 7.8,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
-
旧索引模板 (
_template
) 被替换为以 Elasticsearch 7.8 为开头的可组合模板 (_index_template
)。可组合模板优先于旧模板。如果没有可组合模板匹配给定索引,则旧模板仍然可以匹配并应用。_template
操作仍然适用于 OpenSearch 和更高版本的 Elasticsearch OSS,但对两种模板类型的 GET 调用会返回不同的结果。
Elasticsearch 7.7 版
对于 Elasticsearch 7.7,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 7.4 版
对于 Elasticsearch 7.4,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 7.1 版
对于 Elasticsearch 7.1,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 6.8 版
对于 Elasticsearch 6.8,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 6.7 版
对于 Elasticsearch 6.7,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 6.5 版
对于 Elasticsearch 6.5,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 6.4 版
对于 Elasticsearch 6.4,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 6.3 版
对于 Elasticsearch 6.3,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 6.2 版
对于 Elasticsearch 6.2,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 6.0 版
对于 Elasticsearch 6.0,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 5.6 版
对于 Elasticsearch 5.6,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 5.5 版
对于 Elasticsearch 5.5,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
有关使用脚本的注意事项,请参阅Amazon OpenSearch Service 中的其他支持资源。
-
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 5.3 版
对于 Elasticsearch 5.3,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
请参考
PUT
方法。有关GET
方法的信息,请参阅值得注意的 API 差异。此列表仅指 OpenSearch Service 支持的通用 Elasticsearch 操作,不包括特定于插件的支持的异常检测、ISM 等操作。 -
请参阅收缩。
Elasticsearch 5.1 版
对于 Elasticsearch 5.1,OpenSearch Service 支持以下操作。
|
|
|
-
群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用
/_tasks
操作,以验证请求是否成功完成。 -
对具有消息正文的
/_search/scroll
的 DELETE 请求必须在 HTTP 标头中指定"Content-Length"
。默认情况下,大多数客户端会添加此标头。要避免scroll_id
值中出现=
字符问题,请使用请求正文(而不是查询字符串)将scroll_id
值传递到 OpenSearch Service。 -
请参阅收缩。
Elasticsearch 2.3 版
对于 Elasticsearch 2.3,OpenSearch Service 支持以下操作。
|
|
Elasticsearch 1.5 版
对于 Elasticsearch 1.5,OpenSearch Service 支持以下操作。
|
|