unfreeze_index.asciidoc 2.3 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. --
  2. :api: unfreeze-index
  3. :request: UnfreezeIndexRequest
  4. :response: UnfreezeIndexResponse
  5. --
  6. [id="{upid}-{api}"]
  7. === Unfreeze Index API
  8. [id="{upid}-{api}-request"]
  9. ==== Unfreeze Index Request
  10. An +{request}+ requires an `index` argument:
  11. ["source","java",subs="attributes,callouts,macros"]
  12. --------------------------------------------------
  13. include-tagged::{doc-tests-file}[{api}-request]
  14. --------------------------------------------------
  15. <1> The index to unfreeze
  16. ==== Optional arguments
  17. The following arguments can optionally be provided:
  18. ["source","java",subs="attributes,callouts,macros"]
  19. --------------------------------------------------
  20. include-tagged::{doc-tests-file}[{api}-request-timeout]
  21. --------------------------------------------------
  22. <1> Timeout to wait for the all the nodes to acknowledge the index is frozen
  23. as a `TimeValue`
  24. ["source","java",subs="attributes,callouts,macros"]
  25. --------------------------------------------------
  26. include-tagged::{doc-tests-file}[{api}-request-masterTimeout]
  27. --------------------------------------------------
  28. <1> Timeout to connect to the master node as a `TimeValue`
  29. ["source","java",subs="attributes,callouts,macros"]
  30. --------------------------------------------------
  31. include-tagged::{doc-tests-file}[{api}-request-waitForActiveShards]
  32. --------------------------------------------------
  33. <1> The number of active shard copies to wait for before the unfreeze index API
  34. returns a response, as an `ActiveShardCount`
  35. ["source","java",subs="attributes,callouts,macros"]
  36. --------------------------------------------------
  37. include-tagged::{doc-tests-file}[{api}-request-indicesOptions]
  38. --------------------------------------------------
  39. <1> Setting `IndicesOptions` controls how unavailable indices are resolved and
  40. how wildcard expressions are expanded
  41. include::../execution.asciidoc[]
  42. [id="{upid}-{api}-response"]
  43. ==== Unfreeze Index Response
  44. The returned +{response}+ allows to retrieve information about the
  45. executed operation as follows:
  46. ["source","java",subs="attributes,callouts,macros"]
  47. --------------------------------------------------
  48. include-tagged::{doc-tests-file}[{api}-response]
  49. --------------------------------------------------
  50. <1> Indicates whether all of the nodes have acknowledged the request
  51. <2> Indicates whether the requisite number of shard copies were started for
  52. each shard in the index before timing out