More redirect fixes - index and ingestion APIs (#3975)
* more redirect fixes to index and ingest apis Signed-off-by: Heather Halter <hdhalter@amazon.com> * one more Signed-off-by: Heather Halter <hdhalter@amazon.com> --------- Signed-off-by: Heather Halter <hdhalter@amazon.com> Signed-off-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
This commit is contained in:
parent
20c87bb150
commit
8ed9a9505b
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Clone index
|
||||
parent: Index APIs
|
||||
nav_order: 70
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/index-apis/clone/
|
||||
---
|
||||
|
||||
# Clone index
|
||||
|
|
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Close index
|
||||
parent: Index APIs
|
||||
nav_order: 30
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/index-apis/close-index/
|
||||
---
|
||||
|
||||
# Close index
|
||||
|
|
|
@ -4,14 +4,14 @@ title: Create index
|
|||
parent: Index APIs
|
||||
nav_order: 1
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/index-apis/create-index/
|
||||
- /opensearch/rest-api/index-apis/create-index/
|
||||
---
|
||||
|
||||
# Create index
|
||||
Introduced 1.0
|
||||
{: .label .label-purple }
|
||||
|
||||
While you can create an index by using a document as a base, you can also just create an empty index for use later.
|
||||
While you can create an index by using a document as a base, you can also create an empty index for use later.
|
||||
|
||||
## Example
|
||||
|
||||
|
@ -92,7 +92,7 @@ index.hidden | Whether the index should be hidden. Hidden indices are not return
|
|||
Setting | Description
|
||||
:--- | :---
|
||||
index.number_of_replicas | The number of replica shards each primary shard should have. For example, if you have 4 primary shards and set `index.number_of_replicas` to 3, the index has 12 replica shards. Default is 1.
|
||||
index.auto_expand_replicas | Whether the cluster should automatically add replica shards based on the number of data nodes. Specify a lower and upper bound (for example, `0-9`). You can use `all` for the upper bound. For example, if you have 5 data nodes and set `index.auto_expand_replicas` to `0-3`, then the cluster does not automatically add another replica shard. However, if you set this value to `0-all` and add 2 more nodes for a total of 7, the cluster will expand to now have 6 replica shards. Default is `false` (disabled).
|
||||
index.auto_expand_replicas | Whether the cluster should automatically add replica shards based on the number of data nodes. Specify a lower bound and upper limit (for example, 0-9), or `all` for the upper limit. For example, if you have 5 data nodes and set `index.auto_expand_replicas` to 0-3, then the cluster does not automatically add another replica shard. However, if you set this value to `0-all` and add 2 more nodes for a total of 7, the cluster will expand to now have 6 replica shards. Default is disabled.
|
||||
index.search.idle.after | Amount of time a shard should wait for a search or get request until it goes idle. Default is `30s`.
|
||||
index.refresh_interval | How often the index should refresh, which publishes its most recent changes and makes them available for searching. Can be set to `-1` to disable refreshing. Default is `1s`.
|
||||
index.max_result_window | The maximum value of `from` + `size` for searches to the index. `from` is the starting index to search from, and `size` is the amount of results to return. Default: 10000.
|
||||
|
|
|
@ -43,7 +43,7 @@ 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.
|
||||
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.
|
||||
master_timeout | Time units | The amount of time to wait for the connection to the cluster manager. If no response is received in the defined time period, an error is returned. Default is `30` seconds.
|
||||
|
||||
|
|
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Delete index
|
||||
parent: Index APIs
|
||||
nav_order: 10
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/index-apis/delete-index/
|
||||
---
|
||||
|
||||
# Delete index
|
||||
|
|
|
@ -3,8 +3,8 @@ layout: default
|
|||
title: Index exists
|
||||
parent: Index APIs
|
||||
nav_order: 5
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/index-apis/exists/
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/index-apis/exists/
|
||||
---
|
||||
|
||||
# Index exists
|
||||
|
@ -32,11 +32,11 @@ All parameters are optional.
|
|||
|
||||
Parameter | Type | Description
|
||||
:--- | :--- | :---
|
||||
allow_no_indices | Boolean | Whether to ignore wildcards that don't match any indices. Default is true.
|
||||
expand_wildcards | String | Expands wildcard expressions to different indices. Combine multiple values with commas. Available values are all (match all indices), open (match open indices), closed (match closed indices), hidden (match hidden indices), and none (do not accept wildcard expressions). Default is open.
|
||||
allow_no_indices | Boolean | Whether to ignore wildcards that don't match any indexes. Default is true.
|
||||
expand_wildcards | String | Expands wildcard expressions to different indexes. Combine multiple values with commas. Available values are all (match all indexes), open (match open indexes), closed (match closed indexes), hidden (match hidden indexes), and none (do not accept wildcard expressions). Default is open.
|
||||
flat_settings | Boolean | Whether to return settings in the flat form, which can improve readability, especially for heavily nested settings. For example, the flat form of "index": { "creation_date": "123456789" } is "index.creation_date": "123456789".
|
||||
include_defaults | Boolean | Whether to include default settings as part of the response. This parameter is useful for identifying the names and current values of settings you want to update.
|
||||
ignore_unavailable | Boolean | If true, OpenSearch does not search for missing or closed indices. Default is false.
|
||||
ignore_unavailable | Boolean | If true, OpenSearch does not search for missing or closed indexes. Default is false.
|
||||
local | Boolean | Whether to return information from only the local node instead of from the master node. Default is false.
|
||||
|
||||
|
||||
|
|
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Get index
|
||||
parent: Index APIs
|
||||
nav_order: 20
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/index-apis/get-index/
|
||||
---
|
||||
|
||||
# Get index
|
||||
|
@ -30,11 +32,11 @@ All parameters are optional.
|
|||
|
||||
Parameter | Type | Description
|
||||
:--- | :--- | :---
|
||||
allow_no_indices | Boolean | Whether to ignore wildcards that don't match any indices. Default is true.
|
||||
expand_wildcards | String | Expands wildcard expressions to different indices. Combine multiple values with commas. Available values are all (match all indices), open (match open indices), closed (match closed indices), hidden (match hidden indices), and none (do not accept wildcard expressions), which must be used with open, closed, or both. Default is open.
|
||||
allow_no_indices | Boolean | Whether to ignore wildcards that don't match any indexes. Default is true.
|
||||
expand_wildcards | String | Expands wildcard expressions to different indexes. Combine multiple values with commas. Available values are all (match all indexes), open (match open indexes), closed (match closed indexes), hidden (match hidden indexes), and none (do not accept wildcard expressions), which must be used with open, closed, or both. Default is open.
|
||||
flat_settings | Boolean | Whether to return settings in the flat form, which can improve readability, especially for heavily nested settings. For example, the flat form of "index": { "creation_date": "123456789" } is "index.creation_date": "123456789".
|
||||
include_defaults | Boolean | Whether to include default settings as part of the response. This parameter is useful for identifying the names and current values of settings you want to update.
|
||||
ignore_unavailable | Boolean | If true, OpenSearch does not include missing or closed indices in the response.
|
||||
ignore_unavailable | Boolean | If true, OpenSearch does not include missing or closed indexes in the response.
|
||||
local | Boolean | Whether to return information from only the local node instead of from the master node. Default is false.
|
||||
master_timeout | Time | How long to wait for a connection to the master node. Default is `30s`.
|
||||
|
||||
|
|
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Get settings
|
||||
parent: Index APIs
|
||||
nav_order: 100
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/index-apis/get-index/
|
||||
---
|
||||
|
||||
# Get settings
|
||||
|
@ -37,7 +39,7 @@ Parameter | Data type | Description
|
|||
allow_no_indices | Boolean | Whether to ignore wildcards that don’t match any indexes. Default is `true`.
|
||||
expand_wildcards | String | Expands wildcard expressions to different indexes. Combine multiple values with commas. Available values are `all` (match all indexes), `open` (match open indexes), `closed` (match closed indexes), `hidden` (match hidden indexes), and `none` (do not accept wildcard expressions), which must be used with `open`, `closed`, or both. Default is `open`.
|
||||
flat_settings | Boolean | Whether to return settings in the flat form, which can improve readability, especially for heavily nested settings. For example, the flat form of “index”: { “creation_date”: “123456789” } is “index.creation_date”: “123456789”.
|
||||
include_defaults | String | Whether to include default settings, including settings used within OpenSearch's plugins, in the response. Default is false.
|
||||
include_defaults | String | Whether to include default settings, including settings used within OpenSearch plugins, in the response. Default is false.
|
||||
ignore_unavailable | Boolean | If true, OpenSearch does not include missing or closed indexes in the response.
|
||||
local | Boolean | Whether to return information from the local node only instead of the master node. Default is false.
|
||||
master_timeout | Time | How long to wait for a connection to the master node. Default is `30s`.
|
||||
|
|
|
@ -9,7 +9,7 @@ redirect_from:
|
|||
|
||||
# Index APIs
|
||||
|
||||
The index API operations let you interact with indices in your cluster. Using these operations, you can create, delete, close, and complete other index-related operations.
|
||||
The index API operations let you interact with indexes in your cluster. Using these operations, you can create, delete, close, and complete other index-related operations.
|
||||
|
||||
If you use the Security plugin, make sure you have the appropriate permissions.
|
||||
{: .note }
|
||||
|
|
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Open index
|
||||
parent: Index APIs
|
||||
nav_order: 40
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/index-apis/open-index/
|
||||
---
|
||||
|
||||
# Open index
|
||||
|
@ -30,10 +32,10 @@ All parameters are optional.
|
|||
|
||||
Parameter | Type | Description
|
||||
:--- | :--- | :---
|
||||
<index-name> | String | The index to open. Can be a comma-separated list of multiple index names. Use `_all` or * to open all indices.
|
||||
allow_no_indices | Boolean | Whether to ignore wildcards that don't match any indices. Default is true.
|
||||
expand_wildcards | String | Expands wildcard expressions to different indices. Combine multiple values with commas. Available values are all (match all indices), open (match open indices), closed (match closed indices), hidden (match hidden indices), and none (do not accept wildcard expressions). Default is open.
|
||||
ignore_unavailable | Boolean | If true, OpenSearch does not search for missing or closed indices. Default is false.
|
||||
<index-name> | String | The index to open. Can be a comma-separated list of multiple index names. Use `_all` or * to open all indexes.
|
||||
allow_no_indices | Boolean | Whether to ignore wildcards that don't match any indexes. Default is true.
|
||||
expand_wildcards | String | Expands wildcard expressions to different indexes. Combine multiple values with commas. Available values are all (match all indexes), open (match open indexes), closed (match closed indexes), hidden (match hidden indexes), and none (do not accept wildcard expressions). Default is open.
|
||||
ignore_unavailable | Boolean | If true, OpenSearch does not search for missing or closed indexes. Default is false.
|
||||
wait_for_active_shards | String | Specifies the number of active shards that must be available before OpenSearch processes the request. Default is 1 (only the primary shard). Set to all or a positive integer. Values greater than 1 require replicas. For example, if you specify a value of 3, the index must have two replicas distributed across two additional nodes for the request to succeed.
|
||||
master_timeout | Time | How long to wait for a connection to the master node. Default is `30s`.
|
||||
timeout | Time | How long to wait for a response from the cluster. Default is `30s`.
|
||||
|
|
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Create or update mappings
|
||||
parent: Index APIs
|
||||
nav_order: 220
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/index-apis/put-mapping/
|
||||
---
|
||||
|
||||
# Create or update mappings
|
||||
|
|
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Shrink index
|
||||
parent: Index APIs
|
||||
nav_order: 50
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/index-apis/shrink-index/
|
||||
---
|
||||
|
||||
# Shrink index
|
||||
|
@ -32,7 +34,7 @@ POST /<index-name>/_shrink/<target-index>
|
|||
PUT /<index-name>/_shrink/<target-index>
|
||||
```
|
||||
|
||||
When creating new indices with this operation, remember that OpenSearch indices have the following naming restrictions:
|
||||
When creating new indexes with this operation, remember that OpenSearch indexes have the following naming restrictions:
|
||||
|
||||
- All letters must be lowercase.
|
||||
- Index names can't begin with underscores (`_`) or hyphens (`-`).
|
||||
|
|
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Split index
|
||||
parent: Index APIs
|
||||
nav_order: 80
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/index-apis/split/
|
||||
---
|
||||
|
||||
# Split index
|
||||
|
|
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Update settings
|
||||
parent: Index APIs
|
||||
nav_order: 120
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/index-apis/update-settings/
|
||||
---
|
||||
|
||||
# Update settings
|
||||
|
|
|
@ -4,7 +4,7 @@ title: REST API reference
|
|||
nav_order: 1
|
||||
has_toc: true
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/
|
||||
- /opensearch/rest-api/index/
|
||||
---
|
||||
|
||||
# REST API reference
|
||||
|
|
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Create or update ingest pipeline
|
||||
parent: Ingest APIs
|
||||
nav_order: 11
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/ingest-apis/create-update-ingest/
|
||||
---
|
||||
|
||||
# Create and update a pipeline
|
||||
|
|
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Delete a pipeline
|
||||
parent: Ingest APIs
|
||||
nav_order: 14
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/ingest-apis/delete-ingest/
|
||||
---
|
||||
|
||||
# Delete a pipeline
|
||||
|
|
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Get ingest pipeline
|
||||
parent: Ingest APIs
|
||||
nav_order: 10
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/ingest-apis/get-ingest/
|
||||
---
|
||||
|
||||
## Get ingest pipeline
|
||||
|
|
|
@ -4,7 +4,7 @@ title: Ingest APIs
|
|||
has_children: true
|
||||
nav_order: 40
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/ingest-apis/
|
||||
- /opensearch/rest-api/ingest-apis/index/
|
||||
---
|
||||
|
||||
# Ingest APIs
|
||||
|
|
|
@ -3,6 +3,8 @@ layout: default
|
|||
title: Simulate an ingest pipeline
|
||||
parent: Ingest APIs
|
||||
nav_order: 13
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/ingest-apis/simulate-ingest/
|
||||
---
|
||||
|
||||
# Simulate a pipeline
|
||||
|
|
|
@ -2,6 +2,8 @@
|
|||
layout: default
|
||||
title: Search
|
||||
nav_order: 75
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/search/
|
||||
---
|
||||
|
||||
# Search
|
||||
|
@ -64,7 +66,7 @@ request_cache | Boolean | Specifies whether OpenSearch should use the request ca
|
|||
rest_total_hits_as_int | Boolean | Whether to return `hits.total` as an integer. Returns an object otherwise. Default is false.
|
||||
routing | String | Value used to route the update by query operation to a specific shard.
|
||||
scroll | Time | How long to keep the search context open.
|
||||
search_type | String | Whether OpenSearch should use global term and document frequencies when calculating revelance scores. Valid choices are `query_then_fetch` and `dfs_query_then_fetch`. `query_then_fetch` scores documents using local term and document frequencies for the shard. It’s usually faster but less accurate. `dfs_query_then_fetch` scores documents using global term and document frequencies across all shards. It’s usually slower but more accurate. Default is `query_then_fetch`.
|
||||
search_type | String | Whether OpenSearch should use global term and document frequencies when calculating relevance scores. Valid choices are `query_then_fetch` and `dfs_query_then_fetch`. `query_then_fetch` scores documents using local term and document frequencies for the shard. It’s usually faster but less accurate. `dfs_query_then_fetch` scores documents using global term and document frequencies across all shards. It’s usually slower but more accurate. Default is `query_then_fetch`.
|
||||
seq_no_primary_term | Boolean | Whether to return sequence number and primary term of the last operation of each document hit.
|
||||
size | Integer | How many results to include in the response.
|
||||
sort | List | A comma-separated list of <field> : <direction> pairs to sort by.
|
||||
|
@ -94,7 +96,7 @@ docvalue_fields | Array of objects | The fields that OpenSearch should return us
|
|||
fields | Array | The fields to search for in the request. Specify a format to return results in a certain format, such as date and time.
|
||||
explain | String | Whether to return details about how OpenSearch computed the document's score. Default is false.
|
||||
from | Integer | The starting index to search from. Default is 0.
|
||||
indices_boost | Array of objects | Scores used to boost specified indices' scores. Specify in the format of <index> : <boost-multiplier>
|
||||
indices_boost | Array of objects | Values used to boost the score of specified indexes. Specify in the format of <index> : <boost-multiplier>
|
||||
min_score | Integer | Specify a score threshold to return only documents above the threshold.
|
||||
query | Object | The [DSL query]({{site.url}}{{site.baseurl}}/opensearch/query-dsl/index) to use in the request.
|
||||
seq_no_primary_term | Boolean | Whether to return sequence number and primary term of the last operation of each document hit.
|
||||
|
|
|
@ -2,6 +2,8 @@
|
|||
layout: default
|
||||
title: Tasks
|
||||
nav_order: 85
|
||||
redirect_from:
|
||||
- /opensearch/rest-api/tasks/
|
||||
---
|
||||
|
||||
# Tasks
|
||||
|
@ -146,7 +148,7 @@ GET /_tasks?nodes=opensearch-node1
|
|||
}
|
||||
```
|
||||
|
||||
The following request will return detailed information about active search tasks:
|
||||
The following request returns detailed information about active search tasks:
|
||||
|
||||
**Sample Request**
|
||||
|
||||
|
|
Loading…
Reference in New Issue