Amazon Elasticsearch Service
开发人员指南 (API 版本 2015-01-01)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 Amazon AWS 入门

支持的 Elasticsearch 操作

Amazon ES 支持 Elasticsearch 的许多版本。以下主题介绍 Amazon ES 在每个版本中支持的操作。

值得注意的 API 差异

集群设置

在 Elasticsearch 5.3 之前,Amazon ES 域上的 _cluster/settings API 仅支持 HTTP PUT 方法而不是 GET 方法。较新的版本支持 GET 方法,如以下示例所示:

GET https://domain.region.es.amazonaws.com/_cluster/settings?pretty

示例返回以下内容:

{ "persistent" : { "cluster" : { "routing" : { "allocation" : { "cluster_concurrent_rebalance" : "2" } } }, "indices" : { "recovery" : { "max_bytes_per_sec" : "20mb" } } }, "transient" : { "cluster" : { "routing" : { "allocation" : { "exclude" : { "di_number" : "2" } } } } } }
  • cluster_concurrent_rebalance 指定可在任何给定时间重定位至新节点的分片的数量。

  • max_bytes_per_sec 是 Elasticsearch 在恢复事件期间使用的最大数据传输速度。

  • di_number 是配置发生更改后用于将分片复制到新的域实例 的内部 Amazon ES 值。

收缩

_shrink API 可能导致升级、配置更改和域删除操作失败。建议不要在运行 Elasticsearch 版本 5.3 或 5.1 的域上使用它。这些版本上存在的错误可能会导致收缩索引的快照还原操作失败。

如果在其他 Elasticsearch 版本上使用 _shrink API,请先发出以下请求,然后再启动收缩操作:

PUT https://domain.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.region.es.amazonaws.com/source-index/_settings { "settings": { "index.routing.allocation.require._name": null, "index.blocks.read_only": false } }

版本 6.3

对于 Elasticsearch 6.3,Amazon ES 支持以下操作。

  • /_alias

  • /_aliases

  • /_all

  • /_analyze

  • /_bulk

  • /_cache/clear (仅索引)

  • /_cat

  • /_cluster/allocation/explain

  • /_cluster/health

  • /_cluster/pending_tasks

  • 适用于多个属性的 /_cluster/settings4

    • action.auto_create_index

    • action.search.shard_count.limit

    • indices.breaker.fielddata.limit

    • indices.breaker.request.limit

    • indices.breaker.total.limit

  • /_cluster/state

  • /_cluster/stats

  • /_count

  • /_delete_by_query1

  • /_explain

  • /_field_stats

  • /_flush

  • /_forcemerge (仅索引)

  • /_ingest

  • /_mapping

  • /_mget

  • /_msearch

  • /_mtermvectors

  • /_nodes

  • /_plugin/kibana

  • /_rank_eval

  • /_recovery (仅索引)

  • /_refresh

  • /_reindex1

  • /_rollover

  • /_scripts3

    /_search2

  • /_search profile

  • /_segments (仅索引)

  • /_shard_stores

  • /_shrink5

  • /_snapshot

  • /_split

  • /_stats

  • /_status

  • /_tasks

  • /_template

  • /_termvectors (仅索引)

  • /_update3

  • /_update_by_query1

  • /_validate

  1. 群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用 /_tasks 操作,以验证请求是否成功完成。

  2. 对具有消息正文的 /_search/scroll 的 DELETE 请求必须在 HTTP 标头中指定 "Content-Length"。默认情况下,大多数客户端会添加此标头。要避免 scroll_id 值中出现 = 字符问题,请使用请求正文(而不是查询字符串)将 scroll_id 值传递到 Amazon ES。

  3. 有关使用脚本的注意事项,请参阅其他支持的资源

  4. 请参考 PUT 方法。有关 GET 方法的信息,请参阅值得注意的 API 差异

  5. 请参阅收缩

版本 6.2

对于 Elasticsearch 6.2,Amazon ES 支持以下操作。

  • /_alias

  • /_aliases

  • /_all

  • /_analyze

  • /_bulk

  • /_cache/clear (仅索引)

  • /_cat

  • /_cluster/allocation/explain

  • /_cluster/health

  • /_cluster/pending_tasks

  • 适用于多个属性的 /_cluster/settings4

    • action.auto_create_index

    • action.search.shard_count.limit

    • indices.breaker.fielddata.limit

    • indices.breaker.request.limit

    • indices.breaker.total.limit

  • /_cluster/state

  • /_cluster/stats

  • /_count

  • /_delete_by_query1

  • /_explain

  • /_field_stats

  • /_flush

  • /_forcemerge (仅索引)

  • /_ingest

  • /_mapping

  • /_mget

  • /_msearch

  • /_mtermvectors

  • /_nodes

  • /_plugin/kibana

  • /_rank_eval

  • /_recovery (仅索引)

  • /_refresh

  • /_reindex1

  • /_rollover

  • /_scripts3

    /_search2

  • /_search profile

  • /_segments (仅索引)

  • /_shard_stores

  • /_shrink5

  • /_snapshot

  • /_split

  • /_stats

  • /_status

  • /_tasks

  • /_template

  • /_termvectors (仅索引)

  • /_update3

  • /_update_by_query1

  • /_validate

  1. 群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用 /_tasks 操作,以验证请求是否成功完成。

  2. 对具有消息正文的 /_search/scroll 的 DELETE 请求必须在 HTTP 标头中指定 "Content-Length"。默认情况下,大多数客户端会添加此标头。要避免 scroll_id 值中出现 = 字符问题,请使用请求正文(而不是查询字符串)将 scroll_id 值传递到 Amazon ES。

  3. 有关使用脚本的注意事项,请参阅其他支持的资源

  4. 请参考 PUT 方法。有关 GET 方法的信息,请参阅值得注意的 API 差异

  5. 请参阅收缩

版本 6.0

对于 Elasticsearch 6.0,Amazon ES 支持以下操作。

  • /_alias

  • /_aliases

  • /_all

  • /_analyze

  • /_bulk

  • /_cache/clear (仅索引)

  • /_cat

  • /_cluster/allocation/explain

  • /_cluster/health

  • /_cluster/pending_tasks

  • 适用于多个属性的 /_cluster/settings4

    • action.auto_create_index

    • action.search.shard_count.limit

    • indices.breaker.fielddata.limit

    • indices.breaker.request.limit

    • indices.breaker.total.limit

  • /_cluster/state

  • /_cluster/stats

  • /_count

  • /_delete_by_query1

  • /_explain

  • /_field_stats

  • /_flush

  • /_forcemerge (仅索引)

  • /_ingest

  • /_mapping

  • /_mget

  • /_msearch

  • /_mtermvectors

  • /_nodes

  • /_plugin/kibana

  • /_recovery (仅索引)

  • /_refresh

  • /_reindex1

  • /_rollover

  • /_scripts3

    /_search2

  • /_search profile

  • /_segments (仅索引)

  • /_shard_stores

  • /_shrink5

  • /_snapshot

  • /_stats

  • /_status

  • /_tasks

  • /_template

  • /_termvectors (仅索引)

  • /_update3

  • /_update_by_query1

  • /_validate

  1. 群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用 /_tasks 操作,以验证请求是否成功完成。

  2. 对具有消息正文的 /_search/scroll 的 DELETE 请求必须在 HTTP 标头中指定 "Content-Length"。默认情况下,大多数客户端会添加此标头。要避免 scroll_id 值中出现 = 字符问题,请使用请求正文(而不是查询字符串)将 scroll_id 值传递到 Amazon ES。

  3. 有关使用脚本的注意事项,请参阅其他支持的资源

  4. 请参考 PUT 方法。有关 GET 方法的信息,请参阅值得注意的 API 差异

  5. 请参阅收缩

版本 5.6

对于 Elasticsearch 5.6,Amazon ES 支持以下操作。

  • /_alias

  • /_aliases

  • /_all

  • /_analyze

  • /_bulk

  • /_cache/clear (仅索引)

  • /_cat

  • /_cluster/allocation/explain

  • /_cluster/health

  • /_cluster/pending_tasks

  • 适用于多个属性的 /_cluster/settings4

    • action.auto_create_index

    • action.search.shard_count.limit

    • indices.breaker.fielddata.limit

    • indices.breaker.request.limit

    • indices.breaker.total.limit

  • /_cluster/state

  • /_cluster/stats

  • /_count

  • /_delete_by_query1

  • /_explain

  • /_field_stats

  • /_flush

  • /_forcemerge (仅索引)

  • /_ingest

  • /_mapping

  • /_mget

  • /_msearch

  • /_mtermvectors

  • /_nodes

  • /_plugin/kibana

  • /_recovery (仅索引)

  • /_refresh

  • /_reindex1

  • /_rollover

  • /_scripts3

    /_search2

  • /_search profile

  • /_segments (仅索引)

  • /_shard_stores

  • /_shrink5

  • /_snapshot

  • /_stats

  • /_status

  • /_tasks

  • /_template

  • /_termvectors (仅索引)

  • /_update3

  • /_update_by_query1

  • /_validate

  1. 群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用 /_tasks 操作,以验证请求是否成功完成。

  2. 对具有消息正文的 /_search/scroll 的 DELETE 请求必须在 HTTP 标头中指定 "Content-Length"。默认情况下,大多数客户端会添加此标头。要避免 scroll_id 值中出现 = 字符问题,请使用请求正文(而不是查询字符串)将 scroll_id 值传递到 Amazon ES。

  3. 有关使用脚本的注意事项,请参阅其他支持的资源

  4. 请参考 PUT 方法。有关 GET 方法的信息,请参阅值得注意的 API 差异

  5. 请参阅收缩

版本 5.5

对于 Elasticsearch 5.5,Amazon ES 支持以下操作。

  • /_alias

  • /_aliases

  • /_all

  • /_analyze

  • /_bulk

  • /_cache/clear (仅索引)

  • /_cat

  • /_cluster/allocation/explain

  • /_cluster/health

  • /_cluster/pending_tasks

  • 适用于多个属性的 /_cluster/settings4

    • action.auto_create_index

    • action.search.shard_count.limit

    • indices.breaker.fielddata.limit

    • indices.breaker.request.limit

    • indices.breaker.total.limit

  • /_cluster/state

  • /_cluster/stats

  • /_count

  • /_delete_by_query1

  • /_explain

  • /_field_stats

  • /_flush

  • /_forcemerge (仅索引)

  • /_ingest

  • /_mapping

  • /_mget

  • /_msearch

  • /_mtermvectors

  • /_nodes

  • /_plugin/kibana

  • /_recovery (仅索引)

  • /_refresh

  • /_reindex1

  • /_rollover

  • /_scripts3

    /_search2

  • /_search profile

  • /_segments (仅索引)

  • /_shard_stores

  • /_shrink5

  • /_snapshot

  • /_stats

  • /_status

  • /_tasks

  • /_template

  • /_termvectors (仅索引)

  • /_update3

  • /_update_by_query1

  • /_validate

  1. 群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用 /_tasks 操作,以验证请求是否成功完成。

  2. 对具有消息正文的 /_search/scroll 的 DELETE 请求必须在 HTTP 标头中指定 "Content-Length"。默认情况下,大多数客户端会添加此标头。要避免 scroll_id 值中出现 = 字符问题,请使用请求正文(而不是查询字符串)将 scroll_id 值传递到 Amazon ES。

  3. 有关使用脚本的注意事项,请参阅其他支持的资源

  4. 请参考 PUT 方法。有关 GET 方法的信息,请参阅值得注意的 API 差异

  5. 请参阅收缩

版本 5.3

对于 Elasticsearch 5.3,Amazon ES 支持以下操作。

  • /_alias

  • /_aliases

  • /_all

  • /_analyze

  • /_bulk

  • /_cache/clear (仅索引)

  • /_cat

  • /_cluster/allocation/explain

  • /_cluster/health

  • /_cluster/pending_tasks

  • 适用于多个属性的 /_cluster/settings4

    • action.auto_create_index

    • action.search.shard_count.limit

    • indices.breaker.fielddata.limit

    • indices.breaker.request.limit

    • indices.breaker.total.limit

  • /_cluster/state

  • /_cluster/stats

  • /_count

  • /_delete_by_query1

  • /_explain

  • /_field_stats

  • /_flush

  • /_forcemerge (仅索引)

  • /_ingest

  • /_mapping

  • /_mget

  • /_msearch

  • /_mtermvectors

  • /_nodes

  • /_plugin/kibana

  • /_recovery (仅索引)

  • /_refresh

  • /_reindex1

  • /_rollover

  • /_search2

  • /_search profile

  • /_segments (仅索引)

  • /_shard_stores

  • /_shrink5

  • /_snapshot

  • /_stats

  • /_status

  • /_tasks

  • /_template

  • /_termvectors (仅索引)

  • /_update3

  • /_update_by_query1

  • /_validate

  1. 群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用 /_tasks 操作,以验证请求是否成功完成。

  2. 对具有消息正文的 /_search/scroll 的 DELETE 请求必须在 HTTP 标头中指定 "Content-Length"。默认情况下,大多数客户端会添加此标头。要避免 scroll_id 值中出现 = 字符问题,请使用请求正文(而不是查询字符串)将 scroll_id 值传递到 Amazon ES。

  3. 有关使用脚本的注意事项,请参阅其他支持的资源

  4. 请参考 PUT 方法。有关 GET 方法的信息,请参阅值得注意的 API 差异

  5. 请参阅收缩

版本 5.1

对于 Elasticsearch 5.1,Amazon ES 支持以下操作。

  • /_alias

  • /_aliases

  • /_all

  • /_analyze

  • /_bulk

  • /_cache/clear (仅索引)

  • /_cat

  • /_cluster/allocation/explain

  • /_cluster/health

  • /_cluster/pending_tasks

  • 适用于若干属性的 /_cluster/settings (仅 PUT):

    • action.auto_create_index

    • action.search.shard_count.limit

    • indices.breaker.fielddata.limit

    • indices.breaker.request.limit

    • indices.breaker.total.limit

  • /_cluster/state

  • /_cluster/stats

  • /_count

  • /_delete_by_query1

  • /_explain

  • /_field_stats

  • /_flush

  • /_forcemerge (仅索引)

  • /_ingest

  • /_mapping

  • /_mget

  • /_msearch

  • /_mtermvectors

  • /_nodes

  • /_plugin/kibana

  • /_recovery (仅索引)

  • /_refresh

  • /_reindex1

  • /_rollover

  • /_search2

  • /_search profile

  • /_segments (仅索引)

  • /_shard_stores

  • /_shrink4

  • /_snapshot

  • /_stats

  • /_status

  • /_tasks

  • /_template

  • /_termvectors (仅索引)

  • /_update3

  • /_update_by_query1

  • /_validate

  1. 群集配置更改可能会在这些操作完成前将其中断。我们建议您与这些操作一起使用 /_tasks 操作,以验证请求是否成功完成。

  2. 对具有消息正文的 /_search/scroll 的 DELETE 请求必须在 HTTP 标头中指定 "Content-Length"。默认情况下,大多数客户端会添加此标头。要避免 scroll_id 值中出现 = 字符问题,请使用请求正文(而不是查询字符串)将 scroll_id 值传递到 Amazon ES。

  3. 有关使用脚本的注意事项,请参阅其他支持的资源

  4. 请参阅收缩

版本 2.3

对于 Elasticsearch 2.3,Amazon ES 支持以下操作。

  • /_alias

  • /_aliases

  • /_all

  • /_analyze

  • /_bulk

  • /_cache/clear (仅索引)

  • /_cat

  • /_cluster/health

  • 适用于以下四个属性的 /_cluster/settings (仅限 PUT):

    • indices.breaker.fielddata.limit

    • indices.breaker.request.limit

    • indices.breaker.total.limit

    • threadpool.bulk.queue_size

  • /_cluster/stats

  • /_count

  • /_flush

  • /_forcemerge (仅索引)

  • /_mapping

  • /_mget

  • /_msearch

  • /_nodes

  • /_percolate

  • /_plugin/kibana

  • /_recovery (仅索引)

  • /_refresh

  • /_search

  • /_segments (仅索引)

  • /_snapshot

  • /_stats

  • /_status

  • /_template

版本 1.5

对于 Elasticsearch 1.5,Amazon ES 支持以下操作。

  • /_alias

  • /_aliases

  • /_all

  • /_analyze

  • /_bulk

  • /_cat

  • /_cluster/health

  • 适用于以下四个属性的 /_cluster/settings (仅限 PUT):

    • indices.breaker.fielddata.limit

    • indices.breaker.request.limit

    • indices.breaker.total.limit

    • threadpool.bulk.queue_size

  • /_cluster/stats

  • /_count

  • /_flush

  • /_mapping

  • /_mget

  • /_msearch

  • /_nodes

  • /_percolate

  • /_plugin/kibana

  • /_plugin/kibana3

  • /_refresh

  • /_search

  • /_snapshot

  • /_stats

  • /_status

  • /_template