[OpenAPI] Edit rethrottle APIs

Author: lcawl

docs/overlays/elasticsearch-shared-overlays.yaml

@@ -55,10 +55,6 @@ actions:
           externalDocs:
             description: Reading and writing documents
             url: https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-replication.html
-        - name: delete_by_query_rethrottle
-          x-displayName: Document - Rethrottle delete by query
-        - name: update_by_query_rethrottle
-          x-displayName: Document - Rethrottle update by query
       # E  
         - name: enrich
           x-displayName: Enrich

specification/_global/delete_by_query_rethrottle/DeleteByQueryRethrottleRequest.ts

@@ -22,9 +22,14 @@ import { TaskId } from '@_types/common'
 import { float } from '@_types/Numeric'
 
 /**
+ * Throttle a delete by query operation.
+ *
+ * Change the number of requests per second for a particular delete by query operation.
+ * Rethrottling that speeds up the query takes effect immediately but rethrotting that slows down the query takes effect after completing the current batch to prevent scroll timeouts.
  * @rest_spec_name delete_by_query_rethrottle
  * @availability stack since=6.5.0 stability=stable
  * @availability serverless stability=stable visibility=private
+ * @doc_tag document
  */
 export interface Request extends RequestBase {
   path_parts: {

specification/_global/reindex_rethrottle/ReindexRethrottleRequest.ts

@@ -22,7 +22,9 @@ import { Id } from '@_types/common'
 import { float } from '@_types/Numeric'
 
 /**
- * Copies documents from a source to a destination.
+ * Throttle a reindex operation.
+ *
+ * Change the number of requests per second for a particular reindex operation.
  * @rest_spec_name reindex_rethrottle
  * @availability stack since=2.4.0 stability=stable
  * @availability serverless stability=stable visibility=private

specification/_global/update_by_query_rethrottle/UpdateByQueryRethrottleRequest.ts

@@ -22,9 +22,14 @@ import { Id } from '@_types/common'
 import { float } from '@_types/Numeric'
 
 /**
+ * Throttle an update by query operation.
+ *
+ * Change the number of requests per second for a particular update by query operation.
+ * Rethrottling that speeds up the query takes effect immediately but rethrotting that slows down the query takes effect after completing the current batch to prevent scroll timeouts.
  * @rest_spec_name update_by_query_rethrottle
  * @availability stack since=6.5.0 stability=stable
  * @availability serverless stability=stable visibility=private
+ * @doc_tag document
  */
 export interface Request extends RequestBase {
   path_parts: {