Queries the information about shards that are being restored or shards that are restored. By default, this operation returns only the information about shards that are being restored after you call this operation.
Debugging
Request headers
This operation uses only common request headers. For more information, see Common request headers.
Request syntax
GET /openapi/instances/{InstanceId}/cat-recovery HTTP/1.1
Request parameters
Element |
Type |
Position |
Required |
Example |
Description |
InstanceId | String | Path | Yes | es-cn-7mz293m9a003j**** | The instance ID. |
activeOnly | Boolean | Query | No | true | Specifies whether to return information about data restoration of shards. Valid values:
|
Response parameters
Element |
Type |
Example |
Description |
RequestId | String | F99407AB-2FA9-489E-A259-40CF6DCC47D9 | The request ID. |
Result | Array of Result | The response parameters. |
|
index | String | my-index-000001 | The name of the index in the Elasticsearch cluster. |
sourceHost | String | 192.168.XX.XX | The IP address of the source node. |
sourceNode | String | 2Kni3dJ | The name of the source node. |
filesTotal | Long | 79 | The total number of files. |
bytesPercent | String | 80% | The data restoration progress. |
translogOps | Long | 12086 | The number of translog operations to be restored. |
translogOpsPercent | String | 80% | The restoration progress of translog operations. |
bytesTotal | Long | 12086 | The total amount of data that is restored. |
targetHost | String | 192.168.XX.XX | The IP address of the destination node. |
targetNode | String | YVVKLmW | The name of the destination node. |
filesPercent | String | 80.0% | The file execution progress. |
stage | String | done | The data restoration status. Indicates that whether the request was successful. Valid values:
|
Examples
Sample requests
GET /openapi/instances/es-cn-7mz293m9a003j****/cat-recovery HTTP/1.1
Sample success responses
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "F99407AB-2FA9-489E-A259-40CF6DCC47D9",
"Result" : [ {
"index" : "my-index-000001",
"sourceHost" : "192.168.XX.XX",
"sourceNode" : "2Kni3dJ",
"targetHost" : "192.168.XX.XX",
"targetNode" : "YVVKLmW",
"stage" : "index",
"filesTotal" : 79,
"filesPercent" : "80.0%",
"bytesTotal" : 12086,
"bytesPercent" : "80%",
"translogOps" : 12086,
"translogOpsPercent" : "80%"
}, {
"index" : "my-index-000002",
"sourceHost" : "192.168.XX.XX",
"sourceNode" : "2Kni3dJ",
"targetHost" : "192.168.XX.XX",
"targetNode" : "YVVKLmW",
"stage" : "index",
"filesTotal" : 56,
"filesPercent" : "100%",
"bytesTotal" : 11086,
"bytesPercent" : "100%",
"translogOps" : 11086,
"translogOpsPercent" : "100%"
} ]
}
Error code
For a list of error codes, see Service error codes.