支持的操作
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 支持以下操作。
|
|