欢迎关注大数据技术架构与案例微信公众号:过往记忆大数据
过往记忆博客公众号iteblog_hadoop
欢迎关注微信公众号:
过往记忆大数据

ElasticSearch API备忘录列表

本文所列的所有API在ElasticSearch文档是有详尽的说明,但它的结构组织的不太好。 这篇文章把ElasticSearch API用表格的形式供大家参考。


如果想及时了解Spark、Hadoop或者Hbase相关的文章,欢迎关注微信公共帐号:iteblog_hadoop
CategoryDescriptionCall examples
Document APISingle Document APIAdds a new document
PUT /my_index/my_type/1
{
  "my_field" : "my_value"
}

PUT /my_index/my_type
{
  …​
}

PUT /my_index/my_type/1/_create
{
  …​
}
Gets an existing document
GET /my_index/my_type/0
Deletes a document
DELETE /my_index/my_type/0
Updates a document
POST /my_index/my_type/1/_update
{
  …​
}
Multi-Document APIMulti-get
GET /_mget
{
  "docs" : [
    {
      "_index" : "my_index",
      "_type" : "my_type",
      …​
    }
  ]
}

GET /my_index/_mget
{
  "docs" : [
    {
      "_type" : "my_type",
      …​
    }
  ]
}


GET /my_index/my_type/_mget
{
  "docs" : [
    {
      …​
    }
  ]
}
Performs many index/delete operations in one call
Deletes by query
POST /my_index/_delete_by_query
{
  "query": {
    "match": {
      …​
    }
  }
}
Updates by query
POST /my_index/_update_by_query?conflicts=proceed
POST /my_index/_update_by_query?conflicts=proceed
{
  "query": {
    "term": {
      "my_field": "my_value"
    }
  }
}

POST /my_index1,my_index2/my_type1,my_type2/_update_by_query
Reindexes
POST /_reindex
{
  "source": {
    "index": "old_index"
  },
  "dest": {
    "index": "new_index"
  }
}
Search APIURI SearchExecutes a search with query parameters on the URL
GET /my_index/my_type/_search?q=my_field:my_field
GET /my_index/my_type/_search
{
  "query" : {
    "term" : { "my_field" : "my_value" }
  }
}
Search Shards APIGets indices/shards of a search would be executed against
GET /my_index/_search_shards
Count APIExecutes a count query
GET /my_index/my_type/_count?q=my_field:my_value
GET /my_index/my_type/_count
{
  "query" : {
    "term" : { "my_field" : "my_value" }
  }
}
Validate APIValidates a search query
GET /my_index/my_type/_validate?q=my_field:my_value
GET /my_index/my_type/_validate
{
  "query" : {
    "term" : { "my_field" : "my_value" }
  }
}
Explain APIProvides feedback on computation of a search
GET /my_index/my_type/0/_explain
GET /my_index/my_type/0/_explain?q=message:search
Profile API Provides timing information on individual components during a search
GET /_search
{
  "profile": true,
  "query" : {
    …​
  }
}
Field Stats API Finds statistical properties of fields without executing a search
GET /_field_stats
GET /my_index/_field_stats
GET /my_index1,my_index2/_field_stats
Indices APIIndex managementInstantiates a new index
PUT /my_index
{
  "settings" : {
    …​
  }
}
Deletes existing indices
DELETE /my_index
DELETE /my_index1,my_index2
DELETE /my_index*
DELETE /_all
Retrieves information about indices
GET /my_index
GET /my_index*
GET my_index/_settings,_mappings
Checks whether an index exists
HEAD /my_index
Closes/opens an index
POST /my_index/_close
POST /my_index/_open
Shrinks an index to a new index with fewer primary shards
Rolls over an alias to a new index if conditions are met
POST /my_index/_rollover
{
  "conditions": {
    …​
  }
}
Mapping managementAdds a new type to an existing index
PUT /my_index/_mapping/new_type
{
  "properties": {
    "my_field": {
      "type": "text"
    }
  }
}
Retrieves mapping definition for fields
GET /my_index/_mapping/my_type/field/my_field
GET /my_index1,my_index2/_mapping/my_type/field/my_field
GET /_all/_mapping/my_type1,my_type2/field/my_field1,my_field2
GET /_all/_mapping/my_type1*/field/my_field*
Checks whether a type exists
HEAD /my_index/_mapping/my_type
Alias managementCreates an alias over an index
POST /_aliases
{
  "actions" : [
    { "add" :
      { "index" : "my_index", "alias" : "my_alias" }
    }
  ]
}

POST /_aliases
{
  "actions" : [
    { "add" :
      { "index" : ["index1", "index2"] , "alias" : "another_alias" }
    }
  ]
}
Removes an alias
POST /_aliases
{
  "actions" : [
    { "remove" :
      { "index" : "my_index", "alias" : "my_old_alias" }
    }
  ]
}
Index settingsUpdates settings of indices
PUT /my_index/_settings
{
  …​
}
Retrieves settings of indices
GET /my_index/_settings
Performs an analysis process of a text and return the tokens
GET /_analyze
{
  "analyzer" : "standard",
  "text" : "this is a test"
}
Creates a new template
PUT /_template/my_template
{
  …​
}
Deletes an existing template
DELETE /_template/my_template
Gets info about an existing template
GET /_template/my_template
Checks whether a template exists
HEAD /_template/my_template
Replica configuration Sets index data location on a disk
MonitoringProvides statistics on indices
GET /_stats
GET /my_index1/_stats
GET /my_index1,my_index2/_stats
GET /my_index1/_stats/flush,merge
Provides info on Lucene segments
GET /_segments
GET /my_index1/_segments
GET /my_index1,my_index2/_segments
Provide recovery info on indices
GET /_recovery
GET /my_index1/_recovery
GET /my_index1,my_index2/_recovery
Provide store info on shard copies of indices
GET /_shard_stores
GET /my_index1/_shard_stores
GET /my_index1,my_index2/_shard_stores
Status managementClears the cache of indices
POST /_cache/clear
POST /my_index/_cache/clear
POST /my_index1,my_index2/_cache/clear
Explicitly refreshes indices
POST /_refresh
POST /my_index/_refresh
POST /my_index1,my_index2/_refresh
Flushes in-memory transaction log on disk
POST /_flush
POST /my_index/_flush
POST /my_index1,my_index2/_flush
Merge Lucene segments
POST /_forcemerge
POST /my_index/_forcemerge
POST /my_index1,my_index2/_forcemerge
cat APIcat aliasesShows information about aliases, including filter and routing infos
GET /_cat/aliases?v
GET /_cat/aliases/my_alias?v
cat allocationsProvides a snapshot on how many shards are allocated and how much disk space is used for each node
GET /_cat/allocation?v
cat countProvides quick access to the document count
GET /_cat/count?v
GET /_cat/count/my_index?v
cat fielddataShows heap memory currently being used by fielddata
GET /_cat/fielddata?v
GET /_cat/fielddata/my_field1,my_field2?v
cat healthOne-line representation of the same information from /_cluster/health
GET /_cat/health?v
GET /_cat/health?v&ts=0
cat indicesProvides a node-spanning cross-section of each index
GET /_cat/indices?v
GET /_cat/indices?v&health=yellow
GET /_cat/indices/my_index*?v&health=yellow
cat masterDisplays the master’s node ID, bound IP address, and node name
GET /_cat/master?v
cat nodeattrsShows custom node attributes
GET /_cat/nodeattrs?v
GET /_cat/nodeattrs?v&h=name,id,pid,ip
cat nodesShows cluster topology
GET /_cat/nodes?v
GET /_cat/nodes?v&h=name,id,pid,ip
cat pending tasksProvides the same information as /_cluster/pending_tasks
GET /_cat/pending_tasks?v
cat pluginsProvides a node-spanning view of running plugins per node
GET /_cat/plugins?v
GET /_cat/plugins?v&h=name,id,pid,ip
cat recoveryShows on-going and completed index shard recoveries
GET /_cat/recovery?v
GET /_cat/recovery?v&h=name,id,pid,ip
cat repositoriesShows snapshot repositories registered in the cluster
GET /_cat/repositories?v
cat thread poolShows cluster-wide thread pool statistics per node
GET /_cat/thread_pool?v
GET /_cat/thread_pool?v&h=id,pid,ip
cat shardsDisplays shards to nodes relationships
GET /_cat/shards?v
GET /_cat/shards/my_index?v
GET /_cat/shards/my_ind*?v
cat segmentsProvides information similar to _segments
GET /_cat/segments?v
GET /_cat/segments/my_index?v
GET /_cat/segments/my_index1,my_index2?v
cat snapshotsShows snapshots belonging to a repository
/_cat/snapshots/my_repo?v
cat templatesProvides information about existing templates
GET /_cat/templates?v
GET /_cat/templates/my_template
GET /_cat/templates/my_template*
Cluster APICluster HealthGets the status of a cluster’s health
GET /_cluster/health
GET /_cluster/health/my_index1
GET /_cluster/health/my_index1,my_index2
Cluster StateGets state information about a cluster
GET /_cluster/state
GET /_cluster/state/version,nodes/my_index1
GET /_cluster/state/version,nodes/my_index1,my_index2
GET /_cluster/state/version,nodes/_all
Cluster StatsRetrieves statistics from a cluster
GET /_cluster/stats
GET /_cluster/stats?human&pretty
Pending cluster tasksReturns a list of any cluster-level changes
GET /_cluster/pending_tasks
Cluster RerouteExecutes a cluster reroute allocation
GET /_cluster/reroute {
  …​
}
Cluster Update SettingsUpdate cluster-wide specific settings
GET /_cluster/settings
{
  "persistent" : {
    …​
  },
  "transient" : {
    …​
  }
}
Node StatsRetrieves cluster nodes statistics
GET /_nodes/stats
GET /_nodes/my_node1,my_node2/stats
GET /_nodes/127.0.0.1/stats
GET /_nodes/stats/indices,os,process
Node InfoRetrieves cluster nodes information
GET /_nodes
GET /_nodes/my_node1,my_node2
GET /_nodes/_all/indices,os,process
GET /_nodes/indices,os,process
GET /_nodes/my_node1,my_node2/_all
Task Management API Retrieve information about tasks currently executing on nodes in the cluster
GET /_tasks
GET /_tasks?nodes=my_node1,my_node2
GET /_tasks?nodes=my_node1,my_node2&actions=cluster:*
Nodes Hot ThreadsGets current hot threads on nodes in the cluster
GET /_nodes/hot_threads
GET /_nodes/hot_threads/my_node
GET /_nodes/my_node1,my_node2/hot_threads
Cluster Allocation Explain API Answers the question "why is this shard unnassigned?"
GET /_cluster/allocation/explain
GET /_cluster/allocation/explain
{
  "index": "myindex",
  "shard": 0,
  "primary": false
}
符号标记了将来版本中可能删除(或更改)的实验性API

本文转载自:ElasticSearch API cheatsheet

本博客文章除特别声明,全部都是原创!
原创文章版权归过往记忆大数据(过往记忆)所有,未经许可不得转载。
本文链接: 【ElasticSearch API备忘录列表】(https://www.iteblog.com/archives/2030.html)
喜欢 (9)
分享 (0)
发表我的评论
取消评论

表情
本博客评论系统带有自动识别垃圾评论功能,请写一些有意义的评论,谢谢!