Throttle a delete by query operation
Added in 6.5.0
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.
Path parameters
-
task_id
string | number Required The ID for the task.
Query parameters
-
requests_per_second
number The throttle for this request in sub-requests per second. To disable throttling, set it to
-1
.
POST
/_delete_by_query/{task_id}/_rethrottle
curl \
--request POST 'http://api.example.com/_delete_by_query/{task_id}/_rethrottle' \
--header "Authorization: $API_KEY"
Response examples (200)
{
"node_failures": [
{
"type": "string",
"reason": "string",
"stack_trace": "string",
"caused_by": {},
"root_cause": [
{}
],
"suppressed": [
{}
]
}
],
"task_failures": [
{
"task_id": 42.0,
"node_id": "string",
"status": "string",
"reason": {
"type": "string",
"reason": "string",
"stack_trace": "string",
"caused_by": {},
"root_cause": [
{}
],
"suppressed": [
{}
]
}
}
],
"nodes": {
"additionalProperty1": {
"name": "string",
"transport_address": "string",
"host": "string",
"ip": "string",
"roles": [
"string"
],
"attributes": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"tasks": {
"additionalProperty1": {
"action": "string",
"cancelled": true,
"cancellable": true,
"description": "string",
"headers": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"id": 42.0,
"node": "string",
"running_time": "string",
"": "string",
"status": {},
"type": "string"
},
"additionalProperty2": {
"action": "string",
"cancelled": true,
"cancellable": true,
"description": "string",
"headers": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"id": 42.0,
"node": "string",
"running_time": "string",
"": "string",
"status": {},
"type": "string"
}
}
},
"additionalProperty2": {
"name": "string",
"transport_address": "string",
"host": "string",
"ip": "string",
"roles": [
"string"
],
"attributes": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"tasks": {
"additionalProperty1": {
"action": "string",
"cancelled": true,
"cancellable": true,
"description": "string",
"headers": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"id": 42.0,
"node": "string",
"running_time": "string",
"": "string",
"status": {},
"type": "string"
},
"additionalProperty2": {
"action": "string",
"cancelled": true,
"cancellable": true,
"description": "string",
"headers": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"id": 42.0,
"node": "string",
"running_time": "string",
"": "string",
"status": {},
"type": "string"
}
}
}
},
"": [
{
"action": "string",
"cancelled": true,
"cancellable": true,
"description": "string",
"headers": {
"additionalProperty1": "string",
"additionalProperty2": "string"
},
"id": 42.0,
"node": "string",
"running_time": "string",
"": "string",
"status": {},
"type": "string"
}
]
}