瀏覽代碼

Document 429 handling generically (#105700)

We only had a few mentions of 429 handling, now documenting our expectation generically.

Co-authored-by: David Turner <david.turner@elastic.co>
Co-authored-by: Liam Thompson <32779855+leemthompo@users.noreply.github.com>
Henning Andersen 1 年之前
父節點
當前提交
07ae23aad3
共有 1 個文件被更改,包括 8 次插入0 次删除
  1. 8 0
      docs/reference/api-conventions.asciidoc

+ 8 - 0
docs/reference/api-conventions.asciidoc

@@ -302,6 +302,14 @@ Content-Type: application/vnd.elasticsearch+json; compatible-with=7
 Accept: application/vnd.elasticsearch+json; compatible-with=7
 ----------------------------------------------------------------------
 
+[discrete]
+[[api-push-back]]
+=== HTTP `429 Too Many Requests` status code push back
+
+{es} APIs may respond with the HTTP `429 Too Many Requests` status code, indicating that the cluster is too busy
+to handle the request. When this happens, consider retrying after a short delay. If the retry also receives
+a `429 Too Many Requests` response, extend the delay by backing off exponentially before each subsequent retry.
+
 [discrete]
 [[api-url-access-control]]
 === URL-based access control