elastomer-client 0.8.1 → 0.9.0

data/lib/elastomer/client/cluster.rb

@@ -30,7 +30,7 @@ module Elastomer
       #   :wait_for_nodes - the request waits until the specified number N of nodes is available
       #   :timeout - how long to wait [default is "30s"]
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/cluster-health.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-health.html
       #
       # Returns the response as a Hash
       def health( params = {} )
@@ -48,7 +48,7 @@ module Elastomer
       #   :metrics - list of metrics to select as an Array
       #   :indices - a single index name or an Array of index names
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/cluster-state.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-state.html
       #
       # Returns the response as a Hash
       def state( params = {} )
@@ -63,7 +63,7 @@ module Elastomer
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/cluster-stats.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-stats.html
       #
       # Returns the response as a Hash
       def stats( params = {} )
@@ -76,7 +76,7 @@ module Elastomer
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/cluster-pending.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-pending.html
       #
       # Returns the response as a Hash
       def pending_tasks( params = {} )
@@ -97,7 +97,7 @@ module Elastomer
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/cluster-update-settings.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-update-settings.html
       #
       # Returns the response as a Hash
       def get_settings( params = {} )
@@ -113,7 +113,7 @@ module Elastomer
       # body   - The new settings as a Hash or a JSON encoded String
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/cluster-update-settings.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-update-settings.html
       #
       # Returns the response as a Hash
       def update_settings( body, params = {} )
@@ -143,7 +143,7 @@ module Elastomer
       #     { :allocate => { :index => 'test', :shard => 1, :node => 'node3' }}
       #   ])
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/cluster-reroute.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-reroute.html
       #
       # Returns the response as a Hash
       def reroute( commands, params = {} )
@@ -166,7 +166,7 @@ module Elastomer
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/cluster-nodes-shutdown.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster-nodes-shutdown.html
       #
       # Returns the response as a Hash
       def shutdown( params = {} )
@@ -187,7 +187,7 @@ module Elastomer
       #   get_aliases
       #   get_aliases( :index => 'users' )
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-aliases.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-aliases.html
       #
       # Returns the response body as a Hash
       def get_aliases( params = {} )
@@ -213,7 +213,7 @@ module Elastomer
       #     { :add    => { :index => 'users-2', :alias => 'users' }}
       #   ])
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-aliases.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-aliases.html
       #
       # Returns the response body as a Hash
       def update_aliases( actions, params = {} )

data/lib/elastomer/client/delete_by_query.rb

@@ -22,7 +22,7 @@ module Elastomer
     #   # same thing but using the URI request method
     #   delete_by_query(nil, { :q => '*:*', :type => 'tweet' })
     #
-    # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-delete-by-query.html
+    # See https://www.elastic.co/guide/en/elasticsearch/plugins/current/delete-by-query-usage.html
     #
     # Returns a Hash of statistics about the delete operations, for example:
     #

data/lib/elastomer/client/docs.rb

@@ -8,7 +8,7 @@ module Elastomer
     # name - The name of the index as a String (optional)
     # type - The document type as a String (optional)
     #
-    # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs.html
+    # See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs.html
     #
     # Returns a Docs instance.
     def docs( name = nil, type = nil )
@@ -38,8 +38,8 @@ module Elastomer
       # new document will be created using POST semantics.
       #
       # There are several other document attributes that control how
-      # ElasticSearch will index the document. They are listed below. Please
-      # refer to the ElasticSearch documentation for a full explanation of each
+      # Elasticsearch will index the document. They are listed below. Please
+      # refer to the Elasticsearch documentation for a full explanation of each
       # and how it affects the indexing process.
       #
       #   :_id
@@ -62,7 +62,7 @@ module Elastomer
       # document - The document (as a Hash or JSON encoded String) to add to the index
       # params   - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-index_.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-index_.html
       #
       # Returns the response body as a Hash
       def index( document, params = {} )
@@ -88,7 +88,7 @@ module Elastomer
       # params - Parameters Hash
       #   :id - the ID of the document to delete
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-delete.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-delete.html
       #
       # Returns the response body as a Hash
       def delete( params = {} )
@@ -102,7 +102,7 @@ module Elastomer
       # params - Parameters Hash
       #   :id - the ID of the document to get
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-get.html#docs-get
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-get.html#docs-get
       #
       # Returns the response body as a Hash
       def get( params = {} )
@@ -116,7 +116,7 @@ module Elastomer
       # params - Parameters Hash
       #   :id - the ID of the document to check
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-get.html#docs-get
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-get.html#docs-get
       #
       # Returns true if the document exists
       def exists?( params = {} )
@@ -131,7 +131,7 @@ module Elastomer
       # params - Parameters Hash
       #   :id - the ID of the document
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-get.html#_source
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-get.html#_source
       #
       # Returns the response body as a Hash
       def source( params = {} )
@@ -139,12 +139,12 @@ module Elastomer
         response.body
       end
 
-      # Allows to get multiple documents based on an index, type, and id (and possibly routing).
+      # Allows you to get multiple documents based on an index, type, and id (and possibly routing).
       #
       # body   - The request body as a Hash or a JSON encoded String
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-multi-get.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-multi-get.html
       #
       # Returns the response body as a Hash
       def multi_get( body, params = {} )
@@ -161,7 +161,7 @@ module Elastomer
       # script - The script (as a Hash) used to update the document in place
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-update.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-update.html
       #
       # Returns the response body as a Hash
       def update( script, params = {} )
@@ -189,9 +189,9 @@ module Elastomer
       #   # same thing but using the URI request method
       #   search(:q => '*:*', :type => 'tweet')
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-search.html
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-uri-request.html
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-request-body.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-search.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-uri-request.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-body.html
       #
       # Returns the response body as a hash
       def search( query, params = nil )
@@ -211,7 +211,7 @@ module Elastomer
       #   :preference - which shard replicas to execute the search request on
       #   :local      - boolean value to use local cluster state
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-shards.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-shards.html
       #
       # Returns the response body as a hash
       def search_shards( params = {} )
@@ -236,7 +236,7 @@ module Elastomer
       #   # same thing but using the URI request method
       #   count(:q => '*:*', :type => 'tweet')
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-count.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-count.html
       #
       # Returns the response body as a Hash
       def count( query, params = nil )
@@ -300,7 +300,7 @@ module Elastomer
       # params - Parameters Hash
       #   :id - the ID of the document to get
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-termvectors.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-termvectors.html
       #
       # Returns the response body as a hash
       def termvector( params = {} )
@@ -311,14 +311,14 @@ module Elastomer
       alias_method :term_vector, :termvector
       alias_method :term_vectors, :termvector
 
-      # Multi termvectors API allows  you to get multiple termvectors based on
+      # Multi termvectors API allows you to get multiple termvectors based on
       # an index, type and id. The response includes a docs array with all the
       # fetched termvectors, each element having the structure provided by the
       # `termvector` API.
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-multi-termvectors.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-multi-termvectors.html
       #
       # Returns the response body as a hash
       def multi_termvectors( body, params = {} )
@@ -348,7 +348,7 @@ Percolate
       #   more_like_this({:from => 5, :size => 10}, :mlt_fields => "title",
       #                   :min_term_freq => 1, :type => "doc1", :id => 1)
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-more-like-this.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-more-like-this.html
       #
       # Returns the response body as a hash
       def more_like_this( query, params = nil )
@@ -372,7 +372,7 @@ Percolate
       #
       #   explain(:q => "message:search", :id => 1)
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-explain.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-explain.html
       #
       # Returns the response body as a hash
       def explain( query, params = nil )
@@ -397,7 +397,7 @@ Percolate
       #   # same thing but using the URI query parameter
       #   validate(:q => "post_date:foo", :explain => true)
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-validate.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-validate.html
       #
       # Returns the response body as a hash
       def validate( query, params = nil )
@@ -453,7 +453,7 @@ Percolate
       #     document['_source']
       #   end
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/guide/current/scan-scroll.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-scroll.html
       #
       # Returns a new Scroller instance
       def scroll( query, opts = {} )
@@ -509,7 +509,7 @@ Percolate
       #     ...
       #   end
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-multi-search.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-multi-search.html
       #
       # Returns the response body as a Hash
       def multi_search( params = {}, &block )

data/lib/elastomer/client/index.rb

@@ -2,7 +2,7 @@ module Elastomer
   class Client
 
     # Provides access to index-level API commands. An index name is required for
-    # these API calls. If you want to operate on all inidces - flushing all
+    # these API calls. If you want to operate on all indices - flushing all
     # indices, for example - then you will need to use the "_all" index name.
     #
     # You can override the index name for one-off calls by passing in the
@@ -17,7 +17,7 @@ module Elastomer
 
     class Index
       # Create a new index client for making API requests that pertain to
-      # the health and management individual indexes.
+      # the health and management of individual indexes.
       #
       # client - Elastomer::Client used for HTTP requests to the server
       # name   - The name of the index as a String or an Array of names
@@ -35,8 +35,8 @@ module Elastomer
       # params - Parameters Hash
       #   :type - optional type mapping as a String
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-exists.html
-      # and http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-types-exists.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-exists.html
+      # and https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-types-exists.html
       #
       # Returns true if the index (or type) exists
       def exists?( params = {} )
@@ -50,7 +50,7 @@ module Elastomer
       # body   - The index settings and mappings as a Hash or a JSON encoded String
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-create-index.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-create-index.html
       #
       # Returns the response body as a Hash
       def create( body, params = {} )
@@ -62,7 +62,7 @@ module Elastomer
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-delete-index.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-delete-index.html
       #
       # Returns the response body as a Hash
       def delete( params = {} )
@@ -74,7 +74,7 @@ module Elastomer
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-open-close.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-open-close.html
       #
       # Returns the response body as a Hash
       def open( params = {} )
@@ -86,7 +86,7 @@ module Elastomer
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-open-close.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-open-close.html
       #
       # Returns the response body as a Hash
       def close( params = {} )
@@ -98,7 +98,7 @@ module Elastomer
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-get-settings.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-get-settings.html
       #
       # Returns the response body as a Hash
       def get_settings( params = {} )
@@ -112,7 +112,7 @@ module Elastomer
       # body   - The index settings as a Hash or a JSON encoded String
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-update-settings.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-update-settings.html
       #
       # Returns the response body as a Hash
       def update_settings( body, params = {} )
@@ -126,7 +126,7 @@ module Elastomer
       # params - Parameters Hash
       #   :type - specific document type as a String or Array of Strings
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-get-mapping.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-get-mapping.html
       #
       # Returns the response body as a Hash
       def get_mapping( params = {} )
@@ -141,7 +141,7 @@ module Elastomer
       # body   - The mapping values to update as a Hash or a JSON encoded String
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-put-mapping.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-put-mapping.html
       #
       # Returns the response body as a Hash
       def update_mapping( type, body, params = {} )
@@ -156,7 +156,7 @@ module Elastomer
       # type   - Name of the mapping to update as a String
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-delete-mapping.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-delete-mapping.html
       #
       # Returns the response body as a Hash
       def delete_mapping( type, params = {} )
@@ -168,7 +168,7 @@ module Elastomer
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-aliases.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-aliases.html
       #
       # Returns the response body as a Hash
       def get_aliases( params = {} )
@@ -181,7 +181,7 @@ module Elastomer
       #
       # name   - Name of the alias to look up
       # params - Parameters Hash
-      #   :ignore_unavailable - What to do is an specified index name doesn’t
+      #   :ignore_unavailable - What to do if a specified index name doesn’t
       #                         exist. If set to `true` then those indices are ignored.
       #
       # Examples
@@ -189,7 +189,7 @@ module Elastomer
       #   index.get_alias("*")       # returns all aliases for the current index
       #   index.get_alias("issue*")  # returns all aliases starting with "issue"
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-aliases.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-aliases.html
       #
       # Returns the response body as a Hash
       def get_alias( name, params = {} )
@@ -208,7 +208,7 @@ module Elastomer
       #
       #   index.add_alias("foo", :routing => "foo")
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-aliases.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-aliases.html
       #
       # Returns the response body as a Hash
       def add_alias( name, params = {} )
@@ -226,7 +226,7 @@ module Elastomer
       #   index.delete_alias("foo")
       #   index.delete_alias(["foo", "bar"])
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-aliases.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-aliases.html
       #
       # Returns the response body as a Hash
       def delete_alias( name, params = {} )
@@ -234,12 +234,13 @@ module Elastomer
         response.body
       end
 
-      # Performs the analysis process on a text and return the tokens breakdown of the text.
+      # Perform the analysis process on some text and return the tokens
+      # breakdown of the text.
       #
       # text   - The text to analyze as a String
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-analyze.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-analyze.html
       #
       # Returns the response body as a Hash
       def analyze( text, params = {} )
@@ -253,7 +254,7 @@ module Elastomer
       # params - Parameters Hash
       #   :index - set to "_all" to refresh all indices
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-refresh.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-refresh.html
       #
       # Returns the response body as a Hash
       def refresh( params = {} )
@@ -266,7 +267,7 @@ module Elastomer
       # params - Parameters Hash
       #   :index - set to "_all" to flush all indices
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-flush.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-flush.html
       #
       # Returns the response body as a Hash
       def flush( params = {} )
@@ -280,7 +281,7 @@ module Elastomer
       # params - Parameters Hash
       #   :index - set to "_all" to optimize all indices
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-optimize.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-optimize.html
       #
       # Returns the response body as a Hash
       def optimize( params = {} )
@@ -296,7 +297,7 @@ module Elastomer
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/0.90/indices-gateway-snapshot.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/0.90/indices-gateway-snapshot.html
       #
       # Returns the response body as a Hash
       def snapshot( params = {} )
@@ -304,12 +305,12 @@ module Elastomer
         response.body
       end
 
-      # Provides insight into on-going index shard recoveries. Recovery status
+      # Provides insight into ongoing index shard recoveries. Recovery status
       # may be reported for specific indices, or cluster-wide.
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-recovery.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-recovery.html
       #
       # Returns the response body as a Hash
       def recovery( params = {} )
@@ -323,7 +324,7 @@ module Elastomer
       # params - Parameters Hash
       #   :index - set to "_all" to clear all index caches
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-clearcache.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-clearcache.html
       #
       # Returns the response body as a Hash
       def clear_cache( params = {} )
@@ -336,7 +337,7 @@ module Elastomer
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-stats.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-stats.html
       #
       # Returns the response body as a Hash
       def stats( params = {} )
@@ -351,7 +352,7 @@ module Elastomer
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-status.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-status.html
       #
       # Returns the response body as a Hash
       def status( params = {} )
@@ -364,7 +365,7 @@ module Elastomer
       #
       # params - Parameters Hash
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-segments.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-segments.html
       #
       # Returns the response body as a Hash
       def segments( params = {} )
@@ -377,13 +378,26 @@ module Elastomer
       #
       # type - The document type as a String
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs.html
       #
       # Returns a Docs instance.
       def docs( type = nil )
         client.docs name, type
       end
 
+      # Exposes the `/_suggest` endpoint of the Elasticsearch API.
+      #
+      # query  - The query body as a Hash
+      # params - Parameters Hash
+      #
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-suggesters.html
+      #
+      # Returns the response body as a Hash
+      def suggest(query, params = {})
+        response = client.post "{/index}/_suggest", update_params(params, :body => query, :action => "index.suggest")
+        response.body
+      end
+
       # Perform bulk indexing and/or delete operations. The current index name
       # will be passed to the bulk API call as part of the request parameters.
       #
@@ -403,7 +417,7 @@ module Elastomer
       #     ...
       #   end
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/docs-bulk.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-bulk.html
       #
       # Returns the response body as a Hash
       def bulk( params = {}, &block )
@@ -431,7 +445,7 @@ module Elastomer
       #     document['_source']
       #   end
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/guide/current/scan-scroll.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-scroll.html
       #
       # Returns a new Scroller instance
       def scroll( query, opts = {} )
@@ -460,7 +474,7 @@ module Elastomer
       #     document['_source']
       #   end
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/guide/current/scan-scroll.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-request-scroll.html
       #
       # Returns a new Scroller instance
       def scan( query, opts = {} )
@@ -473,7 +487,7 @@ module Elastomer
       # will be passed to the multi_search API call as part of the request
       # parameters.
       #
-      # See http://www.elasticsearch.org/guide/reference/api/multi-search/
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-multi-search.html
       #
       # params - Parameters Hash that will be passed to the API call.
       # block  - Required block that is used to accumulate searches.
@@ -491,7 +505,7 @@ module Elastomer
       #     ...
       #   end
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-multi-search.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/search-multi-search.html
       #
       # Returns the response body as a Hash
       def multi_search( params = {}, &block )
@@ -541,7 +555,7 @@ module Elastomer
       #   index.warmer('warmer1').get
       #   index.warmer('warmer1').delete
       #
-      # See http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/indices-warmers.html
+      # See https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-warmers.html
       #
       # Returns a new Warmer instance
       def warmer(warmer_name)