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:
Heather Halter 2023-05-04 10:44:02 -07:00 committed by GitHub
parent 20c87bb150
commit 8ed9a9505b
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
22 changed files with 56 additions and 24 deletions

View File

@ -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

View File

@ -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

View File

@ -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.

View File

@ -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.

View File

@ -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

View File

@ -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.

View File

@ -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`.

View File

@ -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 dont 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`.

View File

@ -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 }

View File

@ -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
:--- | :--- | :---
&lt;index-name&gt; | 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.
&lt;index-name&gt; | 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`.

View File

@ -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

View File

@ -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 (`-`).

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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

View File

@ -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. Its usually faster but less accurate. `dfs_query_then_fetch` scores documents using global term and document frequencies across all shards. Its 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. Its usually faster but less accurate. `dfs_query_then_fetch` scores documents using global term and document frequencies across all shards. Its 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 &lt;field&gt; : &lt;direction&gt; 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 &lt;index&gt; : &lt;boost-multiplier&gt;
indices_boost | Array of objects | Values used to boost the score of specified indexes. Specify in the format of &lt;index&gt; : &lt;boost-multiplier&gt;
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.

View File

@ -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**