mirror of
https://github.com/iSharkFly-Docs/opensearch-docs-cn
synced 2025-02-17 20:14:46 +00:00
Merge pull request #117 from opensearch-project/introduced-labels
Add "introduced" labels for APIs
This commit is contained in:
commit
0ac341523a
@ -20,6 +20,8 @@ Use the index rollup operations to programmatically work with index rollup jobs.
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Create or update an index rollup job
|
## Create or update an index rollup job
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates or updates an index rollup job.
|
Creates or updates an index rollup job.
|
||||||
You must provide the `seq_no` and `primary_term` parameters.
|
You must provide the `seq_no` and `primary_term` parameters.
|
||||||
@ -134,6 +136,8 @@ Options | Description | Type | Required
|
|||||||
|
|
||||||
|
|
||||||
## Get an index rollup job
|
## Get an index rollup job
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Returns all information about an index rollup job based on the `rollup_id`.
|
Returns all information about an index rollup job based on the `rollup_id`.
|
||||||
|
|
||||||
@ -159,6 +163,8 @@ GET _plugins/_rollup/jobs/<rollup_id>
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Delete an index rollup job
|
## Delete an index rollup job
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Deletes an index rollup job based on the `rollup_id`.
|
Deletes an index rollup job based on the `rollup_id`.
|
||||||
|
|
||||||
@ -178,6 +184,8 @@ DELETE _plugins/_rollup/jobs/<rollup_id>
|
|||||||
|
|
||||||
|
|
||||||
## Start or stop an index rollup job
|
## Start or stop an index rollup job
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Start or stop an index rollup job.
|
Start or stop an index rollup job.
|
||||||
|
|
||||||
@ -199,6 +207,8 @@ POST _plugins/_rollup/jobs/<rollup_id>/_stop
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Explain an index rollup job
|
## Explain an index rollup job
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Returns detailed metadata information about the index rollup job and its current progress.
|
Returns detailed metadata information about the index rollup job and its current progress.
|
||||||
|
|
||||||
|
@ -15,6 +15,8 @@ Aside from using OpenSearch Dashboards, you can also use the REST API to create,
|
|||||||
{:toc}
|
{:toc}
|
||||||
|
|
||||||
## Create a transform job
|
## Create a transform job
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates a transform job.
|
Creates a transform job.
|
||||||
|
|
||||||
@ -139,6 +141,8 @@ source_field | String | The field(s) to transform | Yes
|
|||||||
aggregations | JSON | The aggregations to use in the transform job. Supported aggregations are: `sum`, `max`, `min`, `value_count`, `avg`, `scripted_metric`, and `percentiles`. For more information, see [Metric Aggregations]({{site.url}}{{site.baseurl}}/opensearch/metric-agg). | Yes if not using groups
|
aggregations | JSON | The aggregations to use in the transform job. Supported aggregations are: `sum`, `max`, `min`, `value_count`, `avg`, `scripted_metric`, and `percentiles`. For more information, see [Metric Aggregations]({{site.url}}{{site.baseurl}}/opensearch/metric-agg). | Yes if not using groups
|
||||||
|
|
||||||
## Update a transform job
|
## Update a transform job
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Updates a transform job if `transform_id` already exists.
|
Updates a transform job if `transform_id` already exists.
|
||||||
|
|
||||||
@ -254,6 +258,8 @@ Parameter | Description | Required
|
|||||||
`if_primary_term` | Only perform the transform operation if the last operation that changed the transform job has the specified sequence term. | No
|
`if_primary_term` | Only perform the transform operation if the last operation that changed the transform job has the specified sequence term. | No
|
||||||
|
|
||||||
## Get a transform job's details
|
## Get a transform job's details
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Returns a transform job's details.
|
Returns a transform job's details.
|
||||||
|
|
||||||
@ -520,6 +526,8 @@ GET _plugins/_transform?size=2&from=8
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Start a transform job
|
## Start a transform job
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Transform jobs created using the API are automatically enabled, but if you ever need to enable a job, you can use the `start` API operation.
|
Transform jobs created using the API are automatically enabled, but if you ever need to enable a job, you can use the `start` API operation.
|
||||||
|
|
||||||
@ -538,6 +546,8 @@ POST _plugins/_transform/<transform_id>/_start
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Stop a transform job
|
## Stop a transform job
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Stops/disables a transform job.
|
Stops/disables a transform job.
|
||||||
|
|
||||||
@ -556,6 +566,8 @@ POST _plugins/_transform/<transform_id>/_stop
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Get the status of a transform job
|
## Get the status of a transform job
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Returns the status and metadata of a transform job.
|
Returns the status and metadata of a transform job.
|
||||||
|
|
||||||
@ -589,6 +601,8 @@ GET _plugins/_transform/<transform_id>/_explain
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Preview a transform job's results
|
## Preview a transform job's results
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Returns a preview of what a transformed index would look like.
|
Returns a preview of what a transformed index would look like.
|
||||||
|
|
||||||
@ -674,6 +688,8 @@ POST _plugins/_transform/_preview
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Delete a transform job
|
## Delete a transform job
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Deletes a transform job. This operation does not delete the source or target indices.
|
Deletes a transform job. This operation does not delete the source or target indices.
|
||||||
|
|
||||||
|
@ -21,6 +21,8 @@ Use the index state management operations to programmatically work with policies
|
|||||||
|
|
||||||
|
|
||||||
## Create policy
|
## Create policy
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates a policy.
|
Creates a policy.
|
||||||
|
|
||||||
@ -138,6 +140,8 @@ PUT _plugins/_ism/policies/policy_1
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Add policy
|
## Add policy
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Adds a policy to an index. This operation does not change the policy if the index already has one.
|
Adds a policy to an index. This operation does not change the policy if the index already has one.
|
||||||
|
|
||||||
@ -168,6 +172,8 @@ Don't use the broad `*` wildcard, and instead add a prefix, such as `my-logs*`,
|
|||||||
|
|
||||||
|
|
||||||
## Update policy
|
## Update policy
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Updates a policy. Use the `seq_no` and `primary_term` parameters to update an existing policy. If these numbers don't match the existing policy or the policy doesn't exist, ISM throws an error.
|
Updates a policy. Use the `seq_no` and `primary_term` parameters to update an existing policy. If these numbers don't match the existing policy or the policy doesn't exist, ISM throws an error.
|
||||||
|
|
||||||
@ -285,6 +291,8 @@ PUT _plugins/_ism/policies/policy_1?if_seq_no=7&if_primary_term=1
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Get policy
|
## Get policy
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Gets the policy by `policy_id`.
|
Gets the policy by `policy_id`.
|
||||||
|
|
||||||
@ -355,6 +363,8 @@ GET _plugins/_ism/policies/policy_1
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Remove policy from index
|
## Remove policy from index
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Removes any ISM policy from the index.
|
Removes any ISM policy from the index.
|
||||||
|
|
||||||
@ -378,6 +388,8 @@ POST _plugins/_ism/remove/index_1
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Update managed index policy
|
## Update managed index policy
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Updates the managed index policy to a new policy (or to a new version of the policy). You can use an index pattern to update multiple indices at once. When updating multiple indices, you might want to include a state filter to only affect certain managed indices. The change policy filters out all the existing managed indices and only applies the change to the ones in the state that you specify. You can also explicitly specify the state that the managed index transitions to after the change policy takes effect.
|
Updates the managed index policy to a new policy (or to a new version of the policy). You can use an index pattern to update multiple indices at once. When updating multiple indices, you might want to include a state filter to only affect certain managed indices. The change policy filters out all the existing managed indices and only applies the change to the ones in the state that you specify. You can also explicitly specify the state that the managed index transitions to after the change policy takes effect.
|
||||||
|
|
||||||
@ -414,6 +426,8 @@ POST _plugins/_ism/change_policy/index_1
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Retry failed index
|
## Retry failed index
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Retries the failed action for an index. For the retry call to succeed, ISM must manage the index, and the index must be in a failed state. You can use index patterns (`*`) to retry multiple failed indices.
|
Retries the failed action for an index. For the retry call to succeed, ISM must manage the index, and the index must be in a failed state. You can use index patterns (`*`) to retry multiple failed indices.
|
||||||
|
|
||||||
@ -440,6 +454,8 @@ POST _plugins/_ism/retry/index_1
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Explain index
|
## Explain index
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Gets the current state of the index. You can use index patterns to get the status of multiple indices.
|
Gets the current state of the index. You can use index patterns to get the status of multiple indices.
|
||||||
|
|
||||||
@ -465,6 +481,8 @@ The `plugins.index_state_management.policy_id` setting is deprecated starting fr
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Delete policy
|
## Delete policy
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Deletes the policy by `policy_id`.
|
Deletes the policy by `policy_id`.
|
||||||
|
|
||||||
|
@ -19,6 +19,8 @@ Use these anomaly detection operations to programmatically create and manage det
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Create anomaly detector
|
## Create anomaly detector
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates an anomaly detector.
|
Creates an anomaly detector.
|
||||||
|
|
||||||
@ -306,6 +308,8 @@ Options | Description | Type | Required
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Preview detector
|
## Preview detector
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Passes a date range to the anomaly detector to return any anomalies within that date range.
|
Passes a date range to the anomaly detector to return any anomalies within that date range.
|
||||||
|
|
||||||
@ -445,6 +449,8 @@ If you specify a category field, each result is associated with an entity:
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Start detector job
|
## Start detector job
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Starts a real-time or historical anomaly detector job.
|
Starts a real-time or historical anomaly detector job.
|
||||||
|
|
||||||
@ -470,6 +476,8 @@ POST _plugins/_anomaly_detection/detectors/<detectorId>/_start
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Stop detector job
|
## Stop detector job
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Stops a real-time or historical anomaly detector job.
|
Stops a real-time or historical anomaly detector job.
|
||||||
|
|
||||||
@ -488,6 +496,8 @@ Stopped detector: m4ccEnIBTXsGi3mvMt9p
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Search detector result
|
## Search detector result
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Returns all results for a search query.
|
Returns all results for a search query.
|
||||||
|
|
||||||
@ -933,6 +943,8 @@ GET _plugins/_anomaly_detection/detectors/results/_search
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Delete detector
|
## Delete detector
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Deletes a detector based on the `detector_id`.
|
Deletes a detector based on the `detector_id`.
|
||||||
To delete a detector, you need to first stop the detector.
|
To delete a detector, you need to first stop the detector.
|
||||||
@ -968,6 +980,8 @@ DELETE _plugins/_anomaly_detection/detectors/<detectorId>
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Update detector
|
## Update detector
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Updates a detector with any changes, including the description or adding or removing of features.
|
Updates a detector with any changes, including the description or adding or removing of features.
|
||||||
To update a detector, you need to first stop the detector.
|
To update a detector, you need to first stop the detector.
|
||||||
@ -1139,6 +1153,8 @@ PUT _plugins/_anomaly_detection/detectors/<detectorId>
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Get detector
|
## Get detector
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Returns all information about a detector based on the `detector_id`.
|
Returns all information about a detector based on the `detector_id`.
|
||||||
|
|
||||||
@ -1485,6 +1501,8 @@ GET _plugins/_anomaly_detection/detectors/<detectorId>?task=true
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Search detector
|
## Search detector
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Returns all anomaly detectors for a search query.
|
Returns all anomaly detectors for a search query.
|
||||||
|
|
||||||
@ -1591,6 +1609,8 @@ Sample Input:
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Get detector stats
|
## Get detector stats
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Provides information about how the plugin is performing.
|
Provides information about how the plugin is performing.
|
||||||
|
|
||||||
@ -1691,6 +1711,8 @@ Historical detectors contain additional fields:
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Create monitor
|
## Create monitor
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Create a monitor to set up alerts for the detector.
|
Create a monitor to set up alerts for the detector.
|
||||||
|
|
||||||
@ -1909,6 +1931,8 @@ POST _plugins/_alerting/monitors
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Profile detector
|
## Profile detector
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Returns information related to the current state of the detector and memory usage, including current errors and shingle size, to help troubleshoot the detector.
|
Returns information related to the current state of the detector and memory usage, including current errors and shingle size, to help troubleshoot the detector.
|
||||||
|
|
||||||
|
@ -20,6 +20,8 @@ Use the alerting API to programmatically manage monitors and alerts.
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Create monitor
|
## Create monitor
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -246,6 +248,8 @@ For a full list of timezone names, refer to [Wikipedia](https://en.wikipedia.org
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Update monitor
|
## Update monitor
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
When you update a monitor, include the current version number as a parameter. OpenSearch increments the version number automatically (see the sample response).
|
When you update a monitor, include the current version number as a parameter. OpenSearch increments the version number automatically (see the sample response).
|
||||||
|
|
||||||
@ -368,6 +372,8 @@ PUT _plugins/_alerting/monitors/<monitor_id>
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Get monitor
|
## Get monitor
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -438,6 +444,8 @@ GET _plugins/_alerting/monitors/<monitor_id>
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Monitor stats
|
## Monitor stats
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Returns statistics about the alerting feature. Use `_plugins/_alerting/stats` to find node IDs and metrics. Then you can drill down using those values.
|
Returns statistics about the alerting feature. Use `_plugins/_alerting/stats` to find node IDs and metrics. Then you can drill down using those values.
|
||||||
|
|
||||||
@ -627,6 +635,8 @@ GET _plugins/_alerting/<node-id>/stats/<metric>
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Delete monitor
|
## Delete monitor
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -658,6 +668,8 @@ DELETE _plugins/_alerting/monitors/<monitor_id>
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Search monitors
|
## Search monitors
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -755,6 +767,8 @@ GET _plugins/_alerting/monitors/_search
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Run monitor
|
## Run monitor
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
You can add the optional `?dryrun=true` parameter to the URL to show the results of a run without actions sending any message.
|
You can add the optional `?dryrun=true` parameter to the URL to show the results of a run without actions sending any message.
|
||||||
|
|
||||||
@ -787,6 +801,8 @@ POST _plugins/_alerting/monitors/<monitor_id>/_execute
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Get alerts
|
## Get alerts
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Returns an array of all alerts.
|
Returns an array of all alerts.
|
||||||
|
|
||||||
@ -855,6 +871,8 @@ GET _plugins/_alerting/monitors/alerts
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Acknowledge alert
|
## Acknowledge alert
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
[After getting your alerts](#get-alerts/), you can acknowledge any number of active alerts in one call. If the alert is already in an ERROR, COMPLETED, or ACKNOWLEDGED state, it appears in the `failed` array.
|
[After getting your alerts](#get-alerts/), you can acknowledge any number of active alerts in one call. If the alert is already in an ERROR, COMPLETED, or ACKNOWLEDGED state, it appears in the `failed` array.
|
||||||
|
|
||||||
@ -882,6 +900,8 @@ POST _plugins/_alerting/monitors/<monitor-id>/_acknowledge/alerts
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Create destination
|
## Create destination
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Requests
|
#### Requests
|
||||||
|
|
||||||
@ -956,6 +976,8 @@ POST _plugins/_alerting/destinations
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Update destination
|
## Update destination
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -991,6 +1013,8 @@ PUT _plugins/_alerting/destinations/<destination-id>
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Get destination
|
## Get destination
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Retrieve one destination.
|
Retrieve one destination.
|
||||||
|
|
||||||
@ -1036,6 +1060,8 @@ GET _plugins/_alerting/destinations/<destination-id>
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Get destinations
|
## Get destinations
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Retrieve all destinations.
|
Retrieve all destinations.
|
||||||
|
|
||||||
@ -1081,6 +1107,8 @@ GET _plugins/_alerting/destinations
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Delete destination
|
## Delete destination
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -1110,6 +1138,8 @@ DELETE _plugins/_alerting/destinations/<destination-id>
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Create email account
|
## Create email account
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
```json
|
```json
|
||||||
@ -1142,6 +1172,8 @@ POST _plugins/_alerting/destinations/email_accounts
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Update email account
|
## Update email account
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
```json
|
```json
|
||||||
@ -1173,6 +1205,8 @@ PUT _plugins/_alerting/destinations/email_accounts/<email_account_id>
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Get email account
|
## Get email account
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
```json
|
```json
|
||||||
@ -1204,6 +1238,8 @@ GET _plugins/_alerting/destinations/email_accounts/<email_account_id>
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Delete email account
|
## Delete email account
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
```
|
```
|
||||||
@ -1230,6 +1266,8 @@ DELETE _plugins/_alerting/destinations/email_accounts/<email_account_id>
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Search email account
|
## Search email account
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -1296,6 +1334,8 @@ POST _plugins/_alerting/destinations/email_accounts/_search
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Create email group
|
## Create email group
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -1330,6 +1370,8 @@ POST _plugins/_alerting/destinations/email_groups
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Update email group
|
## Update email group
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -1363,6 +1405,8 @@ PUT _plugins/_alerting/destinations/email_groups/<email_group_id>
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Get email group
|
## Get email group
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
```json
|
```json
|
||||||
@ -1395,6 +1439,8 @@ GET _plugins/_alerting/destinations/email_groups/<email_group_id>
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Delete email group
|
## Delete email group
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
```
|
```
|
||||||
@ -1421,6 +1467,8 @@ DELETE _plugins/_alerting/destinations/email_groups/<email_group_id>
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Search email group
|
## Search email group
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
|
@ -6,6 +6,8 @@ nav_order: 1
|
|||||||
---
|
---
|
||||||
|
|
||||||
# Performance Analyzer API
|
# Performance Analyzer API
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Performance Analyzer uses a single HTTP method and URI for most requests:
|
Performance Analyzer uses a single HTTP method and URI for most requests:
|
||||||
|
|
||||||
|
@ -6,6 +6,8 @@ nav_order: 5
|
|||||||
---
|
---
|
||||||
|
|
||||||
# Alias
|
# Alias
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
An alias is a virtual pointer that you can use to reference one or more indices. Creating and updating aliases are atomic operations, so you can reindex your data and point an alias at it without any downtime.
|
An alias is a virtual pointer that you can use to reference one or more indices. Creating and updating aliases are atomic operations, so you can reindex your data and point an alias at it without any downtime.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat aliases
|
# cat aliases
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat aliases operation lists the mapping of aliases to indices, plus routing and filtering information.
|
The cat aliases operation lists the mapping of aliases to indices, plus routing and filtering information.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat allocation
|
# cat allocation
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat allocation operation lists the allocation of disk space for indices and the number of shards on each node.
|
The cat allocation operation lists the allocation of disk space for indices and the number of shards on each node.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat count
|
# cat count
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat count operation lists the number of documents in your cluster.
|
The cat count operation lists the number of documents in your cluster.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat fielddata
|
# cat fielddata
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat fielddata operation lists the memory size used by each field per node.
|
The cat fielddata operation lists the memory size used by each field per node.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat health
|
# cat health
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat health operation lists the status of the cluster, how long the cluster has been up, the number of nodes, and other useful information that helps you analyze the health of your cluster.
|
The cat health operation lists the status of the cluster, how long the cluster has been up, the number of nodes, and other useful information that helps you analyze the health of your cluster.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat indices
|
# cat indices
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat indices operation lists information related to indices—how much disk space they are using, how many shards they have, their health status, and so on.
|
The cat indices operation lists information related to indices—how much disk space they are using, how many shards they have, their health status, and so on.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat master
|
# cat master
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat master operation lists information that helps identify the elected master node.
|
The cat master operation lists information that helps identify the elected master node.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat nodeattrs
|
# cat nodeattrs
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat nodeattrs operation lists the attributes of custom nodes.
|
The cat nodeattrs operation lists the attributes of custom nodes.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat nodes
|
# cat nodes
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat nodes operation lists node-level information, including node roles and load metrics.
|
The cat nodes operation lists node-level information, including node roles and load metrics.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat pending tasks
|
# cat pending tasks
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat pending tasks operation lists the progress of all pending tasks, including task priority and time in queue.
|
The cat pending tasks operation lists the progress of all pending tasks, including task priority and time in queue.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat plugins
|
# cat plugins
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat plugins operation lists the names, components, and versions of the installed plugins.
|
The cat plugins operation lists the names, components, and versions of the installed plugins.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat recovery
|
# cat recovery
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat recovery operation lists all completed and ongoing index and shard recoveries.
|
The cat recovery operation lists all completed and ongoing index and shard recoveries.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat repositories
|
# cat repositories
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat repositories operation lists all completed and ongoing index and shard recoveries.
|
The cat repositories operation lists all completed and ongoing index and shard recoveries.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat segments
|
# cat segments
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat segments operation lists Lucene segment-level information for each index.
|
The cat segments operation lists Lucene segment-level information for each index.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat shards
|
# cat shards
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat shards operation lists the state of all primary and replica shards and how they are distributed.
|
The cat shards operation lists the state of all primary and replica shards and how they are distributed.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat snapshots
|
# cat snapshots
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat snapshots operation lists all snapshots for a repository.
|
The cat snapshots operation lists all snapshots for a repository.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat tasks
|
# cat tasks
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat tasks operation lists the progress of all tasks currently running on your cluster.
|
The cat tasks operation lists the progress of all tasks currently running on your cluster.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat templates
|
# cat templates
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat templates operation lists the names, patterns, order numbers, and version numbers of index templates.
|
The cat templates operation lists the names, patterns, order numbers, and version numbers of index templates.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ has_children: false
|
|||||||
---
|
---
|
||||||
|
|
||||||
# cat thread pool
|
# cat thread pool
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cat thread pool operation lists the active, queued, and rejected threads of different thread pools on each node.
|
The cat thread pool operation lists the active, queued, and rejected threads of different thread pools on each node.
|
||||||
|
|
||||||
|
@ -6,6 +6,8 @@ nav_order: 10
|
|||||||
---
|
---
|
||||||
|
|
||||||
# Cluster allocation explain
|
# Cluster allocation explain
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The most basic cluster allocation explain request finds an unassigned shard and explains why it can't be allocated to a node.
|
The most basic cluster allocation explain request finds an unassigned shard and explains why it can't be allocated to a node.
|
||||||
|
|
||||||
|
@ -6,6 +6,8 @@ nav_order: 15
|
|||||||
---
|
---
|
||||||
|
|
||||||
# Cluster health
|
# Cluster health
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The most basic cluster health request returns a simple status of the health of your cluster. OpenSearch expresses cluster health in three colors: green, yellow, and red. A green status means all primary shards and their replicas are allocated to nodes. A yellow status means all primary shards are allocated to nodes, but some replicas aren't. A red status means at least one primary shard is not allocated to any node.
|
The most basic cluster health request returns a simple status of the health of your cluster. OpenSearch expresses cluster health in three colors: green, yellow, and red. A green status means all primary shards and their replicas are allocated to nodes. A yellow status means all primary shards are allocated to nodes, but some replicas aren't. A red status means at least one primary shard is not allocated to any node.
|
||||||
|
|
||||||
|
@ -6,6 +6,8 @@ nav_order: 20
|
|||||||
---
|
---
|
||||||
|
|
||||||
# Cluster settings
|
# Cluster settings
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The cluster settings operation lets you check the current settings for your cluster, review default settings, and change settings. When you update a setting using the API, OpenSearch applies it to all nodes in the cluster.
|
The cluster settings operation lets you check the current settings for your cluster, review default settings, and change settings. When you update a setting using the API, OpenSearch applies it to all nodes in the cluster.
|
||||||
|
|
||||||
|
@ -6,6 +6,8 @@ nav_order: 3
|
|||||||
---
|
---
|
||||||
|
|
||||||
# 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 just create an empty index for use later.
|
||||||
|
|
||||||
|
@ -7,6 +7,8 @@ nav_order: 20
|
|||||||
---
|
---
|
||||||
|
|
||||||
# Bulk
|
# Bulk
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The bulk operation lets you add, update, or delete many documents in a single request. Compared to individual OpenSearch indexing requests, the bulk operation has significant performance benefits. Whenever practical, we recommend batching indexing operations into bulk requests.
|
The bulk operation lets you add, update, or delete many documents in a single request. Compared to individual OpenSearch indexing requests, the bulk operation has significant performance benefits. Whenever practical, we recommend batching indexing operations into bulk requests.
|
||||||
|
|
||||||
|
@ -6,7 +6,9 @@ grand_parent: REST API reference
|
|||||||
nav_order: 15
|
nav_order: 15
|
||||||
---
|
---
|
||||||
|
|
||||||
# Get document
|
# Delete document
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
If you no longer need a document in your index, you can use the delete document API operation to delete it.
|
If you no longer need a document in your index, you can use the delete document API operation to delete it.
|
||||||
|
|
||||||
|
@ -7,6 +7,8 @@ nav_order: 5
|
|||||||
---
|
---
|
||||||
|
|
||||||
# Get document
|
# Get document
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
After adding a JSON document to your index, you can use the get document API operation to retrieve the document's information and data.
|
After adding a JSON document to your index, you can use the get document API operation to retrieve the document's information and data.
|
||||||
|
|
||||||
|
@ -6,6 +6,8 @@ nav_order: 120
|
|||||||
---
|
---
|
||||||
|
|
||||||
# Scroll
|
# Scroll
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
You can use the `scroll` operation to retrieve a large number of results. For example, for machine learning jobs, you can request an unlimited number of results in batches.
|
You can use the `scroll` operation to retrieve a large number of results. For example, for machine learning jobs, you can request an unlimited number of results in batches.
|
||||||
|
|
||||||
|
@ -8,6 +8,8 @@ redirect_from:
|
|||||||
---
|
---
|
||||||
|
|
||||||
# Tasks
|
# Tasks
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
A task is any operation you run in a cluster. For example, searching your data collection of books for a title or author name is a task. When you run OpenSearch, a task is automatically created to monitor your cluster's health and performance. For more information about all of the tasks currently executing in your cluster, you can use the `tasks` API operation.
|
A task is any operation you run in a cluster. For example, searching your data collection of books for a title or author name is a task. When you run OpenSearch, a task is automatically created to monitor your cluster's health and performance. For more information about all of the tasks currently executing in your cluster, you can use the `tasks` API operation.
|
||||||
|
|
||||||
|
@ -205,19 +205,13 @@ td {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// Keeps labels high and tight next to headers
|
// Keeps labels high and tight next to headers
|
||||||
h1 + p.label {
|
h1 + p.label, h1 + p.label + p.label,
|
||||||
margin: -23px 0 0 0;
|
h2 + p.label, h2 + p.label + p.label,
|
||||||
}
|
h3 + p.label, h3 + p.label + p.label,
|
||||||
h2 + p.label {
|
h4 + p.label, h4 + p.label + p.label,
|
||||||
margin: -15px 0 0 0;
|
h5 + p.label, h5 + p.label + p.label,
|
||||||
}
|
h6 + p.label, h6 + p.label + p.label {
|
||||||
h3 + p.label {
|
margin: -20px 0 0 0;
|
||||||
margin: -10px 0 0 0;
|
|
||||||
}
|
|
||||||
h4 + p.label,
|
|
||||||
h5 + p.label,
|
|
||||||
h6 + p.label {
|
|
||||||
margin: -7px 0 0 0;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// Modifies margins in xl layout to support TOC
|
// Modifies margins in xl layout to support TOC
|
||||||
|
@ -15,6 +15,8 @@ Searching large volumes of data can take a long time, especially if you're searc
|
|||||||
Asynchronous search in OpenSearch lets you send search requests that run in the background. You can monitor the progress of these searches and get back partial results as they become available. After the search finishes, you can save the results to examine at a later time.
|
Asynchronous search in OpenSearch lets you send search requests that run in the background. You can monitor the progress of these searches and get back partial results as they become available. After the search finishes, you can save the results to examine at a later time.
|
||||||
|
|
||||||
## REST API
|
## REST API
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
To perform an asynchronous search, send requests to `_plugins/_asynchronous_search`, with your query in the request body:
|
To perform an asynchronous search, send requests to `_plugins/_asynchronous_search`, with your query in the request body:
|
||||||
|
|
||||||
@ -112,6 +114,8 @@ Options | Description
|
|||||||
`aggregations` | The partial aggregation results that have been completed by the shards so far.
|
`aggregations` | The partial aggregation results that have been completed by the shards so far.
|
||||||
|
|
||||||
## Get partial results
|
## Get partial results
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
After you submit an asynchronous search request, you can request partial responses with the ID that you see in the asynchronous search response.
|
After you submit an asynchronous search request, you can request partial responses with the ID that you see in the asynchronous search response.
|
||||||
|
|
||||||
@ -188,6 +192,8 @@ You can poll the ID with the `wait_for_completion_timeout` parameter to wait for
|
|||||||
For asynchronous searches with `keep_on_completion` as `true` and a sufficiently long `keep_alive` time, you can keep polling the IDs until the search finishes. If you don’t want to periodically poll each ID, you can retain the results in your cluster with the `keep_alive` parameter and come back to it at a later time.
|
For asynchronous searches with `keep_on_completion` as `true` and a sufficiently long `keep_alive` time, you can keep polling the IDs until the search finishes. If you don’t want to periodically poll each ID, you can retain the results in your cluster with the `keep_alive` parameter and come back to it at a later time.
|
||||||
|
|
||||||
## Delete searches and results
|
## Delete searches and results
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
You can use the DELETE API operation to delete any ongoing asynchronous search by its ID. If the search is still running, it’s canceled. If the search is complete, the saved search results are deleted.
|
You can use the DELETE API operation to delete any ongoing asynchronous search by its ID. If the search is still running, it’s canceled. If the search is complete, the saved search results are deleted.
|
||||||
|
|
||||||
@ -204,6 +210,8 @@ DELETE _plugins/_asynchronous_search/<ID>?pretty
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Monitor stats
|
## Monitor stats
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
You can use the stats API operation to monitor asynchronous searches that are running, completed, and/or persisted.
|
You can use the stats API operation to monitor asynchronous searches that are running, completed, and/or persisted.
|
||||||
|
|
||||||
|
@ -13,6 +13,8 @@ The k-NN plugin adds two API operations to help you better manage the plugin's f
|
|||||||
|
|
||||||
|
|
||||||
## Stats
|
## Stats
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The k-NN `stats` API provides information about the current status of the k-NN plugin. The plugin keeps track of both cluster-level and node-level statistics. Cluster-level statistics have a single value for the entire cluster. Node-level statistics have a single value for each node in the cluster. You can filter the query by `nodeId` and `statName`:
|
The k-NN `stats` API provides information about the current status of the k-NN plugin. The plugin keeps track of both cluster-level and node-level statistics. Cluster-level statistics have a single value for the entire cluster. Node-level statistics have a single value for each node in the cluster. You can filter the query by `nodeId` and `statName`:
|
||||||
```
|
```
|
||||||
@ -107,6 +109,8 @@ GET /_plugins/_knn/HYMrXXsBSamUkcAjhjeN0w/stats/circuit_breaker_triggered,graph_
|
|||||||
|
|
||||||
|
|
||||||
## Warmup operation
|
## Warmup operation
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
The Hierarchical Navigable Small World (HNSW) graphs used to perform an approximate k-Nearest Neighbor (k-NN) search are stored as `.hnsw` files with other Apache Lucene segment files. In order for you to perform a search on these graphs using the k-NN plugin, the plugin needs to load these files into native memory.
|
The Hierarchical Navigable Small World (HNSW) graphs used to perform an approximate k-Nearest Neighbor (k-NN) search are stored as `.hnsw` files with other Apache Lucene segment files. In order for you to perform a search on these graphs using the k-NN plugin, the plugin needs to load these files into native memory.
|
||||||
|
|
||||||
|
@ -7,6 +7,8 @@ redirect_from: /docs/ppl/endpoint/
|
|||||||
---
|
---
|
||||||
|
|
||||||
# Endpoint
|
# Endpoint
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
To send a query request to PPL plugin, use the HTTP POST request.
|
To send a query request to PPL plugin, use the HTTP POST request.
|
||||||
We recommend a POST request because it doesn't have any length limit and it allows you to pass other parameters to the plugin for other functionality.
|
We recommend a POST request because it doesn't have any length limit and it allows you to pass other parameters to the plugin for other functionality.
|
||||||
|
@ -8,6 +8,8 @@ redirect_from: /docs/sql/endpoints/
|
|||||||
|
|
||||||
|
|
||||||
# Endpoint
|
# Endpoint
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
To send query request to SQL plugin, you can either use a request
|
To send query request to SQL plugin, you can either use a request
|
||||||
parameter in HTTP GET or request body by HTTP POST request. POST request
|
parameter in HTTP GET or request body by HTTP POST request. POST request
|
||||||
|
@ -95,6 +95,8 @@ To add or remove these flags, you need to modify `plugins/opensearch-security/se
|
|||||||
## Account
|
## Account
|
||||||
|
|
||||||
### Get account details
|
### Get account details
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Returns account details for the current user. For example, if you sign the request as the `admin` user, the response includes details for that user.
|
Returns account details for the current user. For example, if you sign the request as the `admin` user, the response includes details for that user.
|
||||||
|
|
||||||
@ -132,6 +134,8 @@ GET _plugins/_security/api/account
|
|||||||
|
|
||||||
|
|
||||||
### Change password
|
### Change password
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Changes the password for the current user.
|
Changes the password for the current user.
|
||||||
|
|
||||||
@ -162,6 +166,8 @@ PUT _plugins/_security/api/account
|
|||||||
## Action groups
|
## Action groups
|
||||||
|
|
||||||
### Get action group
|
### Get action group
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Retrieves one action group.
|
Retrieves one action group.
|
||||||
|
|
||||||
@ -192,6 +198,8 @@ GET _plugins/_security/api/actiongroups/<action-group>
|
|||||||
|
|
||||||
|
|
||||||
### Get action groups
|
### Get action groups
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Retrieves all action groups.
|
Retrieves all action groups.
|
||||||
|
|
||||||
@ -224,6 +232,8 @@ GET _plugins/_security/api/actiongroups/
|
|||||||
|
|
||||||
|
|
||||||
### Delete action group
|
### Delete action group
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -242,6 +252,8 @@ DELETE _plugins/_security/api/actiongroups/<action-group>
|
|||||||
|
|
||||||
|
|
||||||
### Create action group
|
### Create action group
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates or replaces the specified action group.
|
Creates or replaces the specified action group.
|
||||||
|
|
||||||
@ -272,6 +284,8 @@ PUT _plugins/_security/api/actiongroups/<action-group>
|
|||||||
|
|
||||||
|
|
||||||
### Patch action group
|
### Patch action group
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Updates individual attributes of an action group.
|
Updates individual attributes of an action group.
|
||||||
|
|
||||||
@ -297,6 +311,8 @@ PATCH _plugins/_security/api/actiongroups/<action-group>
|
|||||||
|
|
||||||
|
|
||||||
### Patch action groups
|
### Patch action groups
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates, updates, or deletes multiple action groups in a single call.
|
Creates, updates, or deletes multiple action groups in a single call.
|
||||||
|
|
||||||
@ -332,6 +348,8 @@ These calls let you create, update, and delete internal users. If you use an ext
|
|||||||
|
|
||||||
|
|
||||||
### Get user
|
### Get user
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -357,6 +375,8 @@ GET _plugins/_security/api/internalusers/<username>
|
|||||||
|
|
||||||
|
|
||||||
### Get users
|
### Get users
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -381,6 +401,8 @@ GET _plugins/_security/api/internalusers/
|
|||||||
|
|
||||||
|
|
||||||
### Delete user
|
### Delete user
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -399,6 +421,8 @@ DELETE _plugins/_security/api/internalusers/<username>
|
|||||||
|
|
||||||
|
|
||||||
### Create user
|
### Create user
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates or replaces the specified user. You must specify either `password` (plain text) or `hash` (the hashed user password). If you specify `password`, the security plugin automatically hashes the password before storing it.
|
Creates or replaces the specified user. You must specify either `password` (plain text) or `hash` (the hashed user password). If you specify `password`, the security plugin automatically hashes the password before storing it.
|
||||||
|
|
||||||
@ -430,6 +454,8 @@ PUT _plugins/_security/api/internalusers/<username>
|
|||||||
|
|
||||||
|
|
||||||
### Patch user
|
### Patch user
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Updates individual attributes of an internal user.
|
Updates individual attributes of an internal user.
|
||||||
|
|
||||||
@ -460,6 +486,8 @@ PATCH _plugins/_security/api/internalusers/<username>
|
|||||||
```
|
```
|
||||||
|
|
||||||
### Patch users
|
### Patch users
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates, updates, or deletes multiple internal users in a single call.
|
Creates, updates, or deletes multiple internal users in a single call.
|
||||||
|
|
||||||
@ -496,6 +524,8 @@ PATCH _plugins/_security/api/internalusers
|
|||||||
|
|
||||||
|
|
||||||
### Get role
|
### Get role
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Retrieves one role.
|
Retrieves one role.
|
||||||
|
|
||||||
@ -542,6 +572,8 @@ GET _plugins/_security/api/roles/<role>
|
|||||||
|
|
||||||
|
|
||||||
### Get roles
|
### Get roles
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Retrieves all roles.
|
Retrieves all roles.
|
||||||
|
|
||||||
@ -582,6 +614,8 @@ GET _plugins/_security/api/roles/
|
|||||||
|
|
||||||
|
|
||||||
### Delete role
|
### Delete role
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
#### Request
|
#### Request
|
||||||
|
|
||||||
@ -600,6 +634,8 @@ DELETE _plugins/_security/api/roles/<role>
|
|||||||
|
|
||||||
|
|
||||||
### Create role
|
### Create role
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates or replaces the specified role.
|
Creates or replaces the specified role.
|
||||||
|
|
||||||
@ -645,6 +681,8 @@ PUT _plugins/_security/api/roles/<role>
|
|||||||
|
|
||||||
|
|
||||||
### Patch role
|
### Patch role
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Updates individual attributes of a role.
|
Updates individual attributes of a role.
|
||||||
|
|
||||||
@ -673,6 +711,8 @@ PATCH _plugins/_security/api/roles/<role>
|
|||||||
|
|
||||||
|
|
||||||
### Patch roles
|
### Patch roles
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates, updates, or deletes multiple roles in a single call.
|
Creates, updates, or deletes multiple roles in a single call.
|
||||||
|
|
||||||
@ -708,6 +748,8 @@ PATCH _plugins/_security/api/roles
|
|||||||
## Role mappings
|
## Role mappings
|
||||||
|
|
||||||
### Get role mapping
|
### Get role mapping
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Retrieves one role mapping.
|
Retrieves one role mapping.
|
||||||
|
|
||||||
@ -731,6 +773,8 @@ GET _plugins/_security/api/rolesmapping/<role>
|
|||||||
|
|
||||||
|
|
||||||
### Get role mappings
|
### Get role mappings
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Retrieves all role mappings.
|
Retrieves all role mappings.
|
||||||
|
|
||||||
@ -754,6 +798,8 @@ GET _plugins/_security/api/rolesmapping
|
|||||||
|
|
||||||
|
|
||||||
### Delete role mapping
|
### Delete role mapping
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Deletes the specified role mapping.
|
Deletes the specified role mapping.
|
||||||
|
|
||||||
@ -774,6 +820,8 @@ DELETE _plugins/_security/api/rolesmapping/<role>
|
|||||||
|
|
||||||
|
|
||||||
### Create role mapping
|
### Create role mapping
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates or replaces the specified role mapping.
|
Creates or replaces the specified role mapping.
|
||||||
|
|
||||||
@ -799,6 +847,8 @@ PUT _plugins/_security/api/rolesmapping/<role>
|
|||||||
|
|
||||||
|
|
||||||
### Patch role mapping
|
### Patch role mapping
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Updates individual attributes of a role mapping.
|
Updates individual attributes of a role mapping.
|
||||||
|
|
||||||
@ -827,6 +877,8 @@ PATCH _plugins/_security/api/rolesmapping/<role>
|
|||||||
|
|
||||||
|
|
||||||
### Patch role mappings
|
### Patch role mappings
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates or updates multiple role mappings in a single call.
|
Creates or updates multiple role mappings in a single call.
|
||||||
|
|
||||||
@ -859,6 +911,8 @@ PATCH _plugins/_security/api/rolesmapping
|
|||||||
## Tenants
|
## Tenants
|
||||||
|
|
||||||
### Get tenant
|
### Get tenant
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Retrieves one tenant.
|
Retrieves one tenant.
|
||||||
|
|
||||||
@ -883,6 +937,8 @@ GET _plugins/_security/api/tenants/<tenant>
|
|||||||
|
|
||||||
|
|
||||||
### Get tenants
|
### Get tenants
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Retrieves all tenants.
|
Retrieves all tenants.
|
||||||
|
|
||||||
@ -913,6 +969,8 @@ GET _plugins/_security/api/tenants/
|
|||||||
|
|
||||||
|
|
||||||
### Delete tenant
|
### Delete tenant
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Deletes the specified tenant.
|
Deletes the specified tenant.
|
||||||
|
|
||||||
@ -933,6 +991,8 @@ DELETE _plugins/_security/api/tenants/<tenant>
|
|||||||
|
|
||||||
|
|
||||||
### Create tenant
|
### Create tenant
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates or replaces the specified tenant.
|
Creates or replaces the specified tenant.
|
||||||
|
|
||||||
@ -956,6 +1016,8 @@ PUT _plugins/_security/api/tenants/<tenant>
|
|||||||
|
|
||||||
|
|
||||||
### Patch tenant
|
### Patch tenant
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Add, delete, or modify a single tenant.
|
Add, delete, or modify a single tenant.
|
||||||
|
|
||||||
@ -981,6 +1043,8 @@ PATCH _plugins/_security/api/tenants/<tenant>
|
|||||||
|
|
||||||
|
|
||||||
### Patch tenants
|
### Patch tenants
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Add, delete, or modify multiple tenants in a single call.
|
Add, delete, or modify multiple tenants in a single call.
|
||||||
|
|
||||||
@ -1018,6 +1082,8 @@ PATCH _plugins/_security/api/tenants/
|
|||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
### Get configuration
|
### Get configuration
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Retrieves the current security plugin configuration in JSON format.
|
Retrieves the current security plugin configuration in JSON format.
|
||||||
|
|
||||||
@ -1029,6 +1095,8 @@ GET _plugins/_security/api/securityconfig
|
|||||||
|
|
||||||
|
|
||||||
### Update configuration
|
### Update configuration
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates or updates the existing configuration using the REST API. This operation can easily break your existing configuration, so we recommend using `securityadmin.sh` instead, which is far safer. See [Access control for the API](#access-control-for-the-api) for how to enable this operation.
|
Creates or updates the existing configuration using the REST API. This operation can easily break your existing configuration, so we recommend using `securityadmin.sh` instead, which is far safer. See [Access control for the API](#access-control-for-the-api) for how to enable this operation.
|
||||||
|
|
||||||
@ -1087,6 +1155,8 @@ PUT _plugins/_security/api/securityconfig/config
|
|||||||
|
|
||||||
|
|
||||||
### Patch configuration
|
### Patch configuration
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Updates the existing configuration using the REST API. This operation can easily break your existing configuration, so we recommend using `securityadmin.sh` instead, which is far safer. See [Access control for the API](#access-control-for-the-api) for how to enable this operation.
|
Updates the existing configuration using the REST API. This operation can easily break your existing configuration, so we recommend using `securityadmin.sh` instead, which is far safer. See [Access control for the API](#access-control-for-the-api) for how to enable this operation.
|
||||||
|
|
||||||
@ -1116,6 +1186,8 @@ PATCH _plugins/_security/api/securityconfig
|
|||||||
## Certificates
|
## Certificates
|
||||||
|
|
||||||
### Get certificates
|
### Get certificates
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Retrieves the current security plugin configuration in JSON format.
|
Retrieves the current security plugin configuration in JSON format.
|
||||||
|
|
||||||
@ -1127,6 +1199,8 @@ GET _plugins/_security/api/securityconfig
|
|||||||
|
|
||||||
|
|
||||||
### Update configuration
|
### Update configuration
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Creates or updates the existing configuration using the REST API rather than `securityadmin.sh`. This operation can easily break your existing configuration, so we recommend using `securityadmin.sh` instead. See [Access control for the API](#access-control-for-the-api) for how to enable this operation.
|
Creates or updates the existing configuration using the REST API rather than `securityadmin.sh`. This operation can easily break your existing configuration, so we recommend using `securityadmin.sh` instead. See [Access control for the API](#access-control-for-the-api) for how to enable this operation.
|
||||||
|
|
||||||
@ -1185,6 +1259,8 @@ PUT _plugins/_security/api/securityconfig/config
|
|||||||
|
|
||||||
|
|
||||||
### Patch configuration
|
### Patch configuration
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Updates the existing configuration using the REST API rather than `securityadmin.sh`. This operation can easily break your existing configuration, so we recommend using `securityadmin.sh` instead. See [Access control for the API](#access-control-for-the-api) for how to enable this operation.
|
Updates the existing configuration using the REST API rather than `securityadmin.sh`. This operation can easily break your existing configuration, so we recommend using `securityadmin.sh` instead. See [Access control for the API](#access-control-for-the-api) for how to enable this operation.
|
||||||
|
|
||||||
@ -1213,6 +1289,8 @@ PATCH _plugins/_security/api/securityconfig
|
|||||||
## Cache
|
## Cache
|
||||||
|
|
||||||
### Flush cache
|
### Flush cache
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Flushes the security plugin user, authentication, and authorization cache.
|
Flushes the security plugin user, authentication, and authorization cache.
|
||||||
|
|
||||||
@ -1239,6 +1317,8 @@ DELETE _plugins/_security/api/cache
|
|||||||
## Health
|
## Health
|
||||||
|
|
||||||
### Health check
|
### Health check
|
||||||
|
Introduced 1.0
|
||||||
|
{: .label .label-purple }
|
||||||
|
|
||||||
Checks to see if the security plugin is up and running. If you operate your cluster behind a load balancer, this operation is useful for determining node health and doesn't require a signed request.
|
Checks to see if the security plugin is up and running. If you operate your cluster behind a load balancer, this operation is useful for determining node health and doesn't require a signed request.
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user