anchor.diff:  // TESTRESPONSE[s/bU_KLGJISbW0RejwnwDPKw/$body.shards.3.0.allocation_id.id/]
   // TESTRESPONSE[s/DMs7_giNSwmdqVukF7UydA/$body.shards.4.0.allocation_id.id/]
   
  -And specifying the same request, this time with a routing value:
  +Specifying the same request, this time with a routing value:
   
   [source,js]
   --------------------------------------------------
  
positive.code: [[search-shards]]
  === Search Shards API
  
  The search shards api returns the indices and shards that a search request would
  be executed against. This can give useful feedback for working out issues or
  planning optimizations with routing and shard preferences. When filtered aliases
  are used, the filter is returned as part of the `indices` section [5.1.0] Added in 5.1.0.
  
  The `index` may be a single value, or comma-separated.
  
  [float]
  ==== Usage
  
  Full example:
  
  [source,js]
  --------------------------------------------------
  
negative.code: // CONSOLE
  // TEST[s/^/PUT twitter\n{"settings":{"index.number_of_shards":5}}\n/]
  
  
  [[search-shards-api-request]]
  ==== {api-request-title}
  
  `GET /<index>/_search_shards`
  
  
  [[search-shards-api-desc]]
  ==== {api-description-title}
  
  The search shards api returns the indices and shards that a search request would
  be executed against. This can give useful feedback for working out issues or
  planning optimizations with routing and shard preferences. When filtered aliases
  are used, the filter is returned as part of the `indices` section.
  
  
  [[search-shards-api-path-params]]
  ==== {api-path-parms-title}
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=index]
  
  
  [[search-shards-api-query-params]]
  ==== {api-query-parms-title}
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=allow-no-indices]
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=expand-wildcards]
  +
  --
  Defaults to `open`.
  --
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=index-ignore-unavailable]
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=local]
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=preference]
  
  include::{docdir}/rest-api/common-parms.asciidoc[tag=routing]
  
  
  [[search-shards-api-example]]
  ==== {api-examples-title}
  
  [source,js]
  --------------------------------------------------
  GET /twitter/_search_shards
  --------------------------------------------------
  // CONSOLE
  // TEST[s/^/PUT twitter\n{"settings":{"index.number_of_shards":5}}\n/]
  
  The API returns the following result:
  
  [source,js]
  --------------------------------------------------
  