mirror of
https://github.com/iSharkFly-Docs/opensearch-docs-cn
synced 2025-03-08 15:59:12 +00:00
84e4ab158e
* Fix APIs File Signed-off-by: samipak458 <samipak458@gmail.com> * Update API files according to API template Signed-off-by: samipak458 <samipak458@gmail.com> * Update exec-stored-script.md Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> * Update cat-aliases.md Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> * Update cat-allocation.md Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> * Update cat-cluster_manager.md Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> * Update cat-count.md Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> * Update cat-field-data.md Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> * Update cat-health.md Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> * updated * updated * updated --------- Signed-off-by: samipak458 <samipak458@gmail.com> Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Signed-off-by: MUHAMMAD SAMIULLAH <samipak458@gmail.com> Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
88 lines
1.9 KiB
Markdown
88 lines
1.9 KiB
Markdown
---
|
|
layout: default
|
|
title: Dangling indexes
|
|
parent: index-apis
|
|
nav_order: 30
|
|
---
|
|
|
|
# Dangling indexes API
|
|
**Introduced 1.0**
|
|
{: .label .label-purple }
|
|
|
|
After a node joins a cluster, dangling indexes occur if any shards exist in the node's local directory that do not already exist in the cluster. Dangling indexes can be listed, deleted, or imported.
|
|
|
|
## Path and HTTP methods
|
|
|
|
List dangling indexes:
|
|
|
|
```
|
|
GET /_dangling
|
|
```
|
|
|
|
Import a dangling index:
|
|
|
|
```
|
|
POST /_dangling/<index-uuid>
|
|
```
|
|
|
|
Delete a dangling index:
|
|
|
|
```
|
|
DELETE /_dangling/<index-uuid>
|
|
```
|
|
|
|
## Path parameters
|
|
|
|
Path parameters are required.
|
|
|
|
Path parameter | Description
|
|
:--- | :---
|
|
index-uuid | UUID of index.
|
|
|
|
## Query parameters
|
|
|
|
Query parameters are optional.
|
|
|
|
Query parameter | Data type | Description
|
|
:--- | :--- | :---
|
|
accept_data_loss | Boolean | Must be set to `true` for an `import` or `delete` because OpenSearch is unaware of where the dangling index data came from.
|
|
timeout | Time units | The amount of time to wait for a response. If no response is received in the defined time period, an error is returned. Default is `30` seconds.
|
|
cluster_manager_timeout | Time units | The amount of time to wait for a connection to the cluster manager. If no response is received in the defined time period, an error is returned. Default is `30` seconds.
|
|
|
|
## Examples
|
|
|
|
The following are example requests and a example response.
|
|
|
|
#### Sample list
|
|
|
|
````bash
|
|
GET /_dangling
|
|
````
|
|
{% include copy-curl.html %}
|
|
|
|
#### Sample import
|
|
|
|
````bash
|
|
POST /_dangling/msdjernajxAT23RT-BupMB?accept_data_loss=true
|
|
````
|
|
{% include copy-curl.html %}
|
|
|
|
#### Sample delete
|
|
|
|
````bash
|
|
DELETE /_dangling/msdjernajxAT23RT-BupMB?accept_data_loss=true
|
|
````
|
|
|
|
#### Example response body
|
|
|
|
````json
|
|
{
|
|
"_nodes": {
|
|
"total": 1,
|
|
"successful": 1,
|
|
"failed": 0
|
|
},
|
|
"cluster_name": "opensearch-cluster",
|
|
"dangling_indices": [msdjernajxAT23RT-BupMB]
|
|
}
|
|
```` |