follow-request-body.asciidoc 3.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105
  1. `settings`::
  2. (object) Settings to override from the leader index. Note that certain
  3. settings can not be overrode (e.g., `index.number_of_shards`).
  4. // tag::ccr-resume-follow-request-body[]
  5. `max_read_request_operation_count`::
  6. (integer) The maximum number of operations to pull per read from the remote
  7. cluster.
  8. `max_outstanding_read_requests`::
  9. (long) The maximum number of outstanding reads requests from the remote
  10. cluster.
  11. `max_read_request_size`::
  12. (<<byte-units,byte value>>) The maximum size in bytes of per read of a batch
  13. of operations pulled from the remote cluster.
  14. `max_write_request_operation_count`::
  15. (integer) The maximum number of operations per bulk write request executed on
  16. the follower.
  17. `max_write_request_size`::
  18. (<<byte-units,byte value>>) The maximum total bytes of operations per bulk write request
  19. executed on the follower.
  20. `max_outstanding_write_requests`::
  21. (integer) The maximum number of outstanding write requests on the follower.
  22. `max_write_buffer_count`::
  23. (integer) The maximum number of operations that can be queued for writing.
  24. When this limit is reached, reads from the remote cluster will be deferred
  25. until the number of queued operations goes below the limit.
  26. `max_write_buffer_size`::
  27. (<<byte-units,byte value>>) The maximum total bytes of operations that can be
  28. queued for
  29. writing. When this limit is reached, reads from the remote cluster will be
  30. deferred until the total bytes of queued operations goes below the limit.
  31. `max_retry_delay`::
  32. (<<time-units,time value>>) The maximum time to wait before retrying an
  33. operation that failed exceptionally. An exponential backoff strategy is
  34. employed when retrying.
  35. `read_poll_timeout`::
  36. (<<time-units,time value>>) The maximum time to wait for new operations on the
  37. remote cluster when the follower index is synchronized with the leader index.
  38. When the timeout has elapsed, the poll for operations will return to the
  39. follower so that it can update some statistics. Then the follower will
  40. immediately attempt to read from the leader again.
  41. ===== Default values
  42. //////////////////////////
  43. [source,console]
  44. --------------------------------------------------
  45. PUT /follower_index/_ccr/follow?wait_for_active_shards=1
  46. {
  47. "remote_cluster" : "remote_cluster",
  48. "leader_index" : "leader_index"
  49. }
  50. --------------------------------------------------
  51. // TESTSETUP
  52. // TEST[setup:remote_cluster_and_leader_index]
  53. [source,console]
  54. --------------------------------------------------
  55. POST /follower_index/_ccr/pause_follow
  56. --------------------------------------------------
  57. // TEARDOWN
  58. [source,console]
  59. --------------------------------------------------
  60. GET /follower_index/_ccr/info?filter_path=follower_indices.parameters
  61. --------------------------------------------------
  62. //////////////////////////
  63. The following output from the follow info api describes all the default
  64. values for the above described index follow request parameters:
  65. [source,console-result]
  66. --------------------------------------------------
  67. {
  68. "follower_indices" : [
  69. {
  70. "parameters" : {
  71. "max_read_request_operation_count" : 5120,
  72. "max_read_request_size" : "32mb",
  73. "max_outstanding_read_requests" : 12,
  74. "max_write_request_operation_count" : 5120,
  75. "max_write_request_size" : "9223372036854775807b",
  76. "max_outstanding_write_requests" : 9,
  77. "max_write_buffer_count" : 2147483647,
  78. "max_write_buffer_size" : "512mb",
  79. "max_retry_delay" : "500ms",
  80. "read_poll_timeout" : "1m"
  81. }
  82. }
  83. ]
  84. }
  85. --------------------------------------------------
  86. // end::ccr-resume-follow-request-body[]