Merge pull request #117 from opensearch-project/introduced-labels

Add "introduced" labels for APIs
This commit is contained in:
Andrew Etter 2021-07-28 10:13:30 -07:00 committed by GitHub
commit 0ac341523a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
41 changed files with 283 additions and 17 deletions

View File

@ -20,6 +20,8 @@ Use the index rollup operations to programmatically work with index rollup jobs.
---
## Create or update an index rollup job
Introduced 1.0
{: .label .label-purple }
Creates or updates an index rollup job.
You must provide the `seq_no` and `primary_term` parameters.
@ -134,6 +136,8 @@ Options | Description | Type | Required
## Get an index rollup job
Introduced 1.0
{: .label .label-purple }
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
Introduced 1.0
{: .label .label-purple }
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
Introduced 1.0
{: .label .label-purple }
Start or stop an index rollup job.
@ -199,6 +207,8 @@ POST _plugins/_rollup/jobs/<rollup_id>/_stop
---
## Explain an index rollup job
Introduced 1.0
{: .label .label-purple }
Returns detailed metadata information about the index rollup job and its current progress.

View File

@ -15,6 +15,8 @@ Aside from using OpenSearch Dashboards, you can also use the REST API to create,
{:toc}
## Create a transform job
Introduced 1.0
{: .label .label-purple }
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
## Update a transform job
Introduced 1.0
{: .label .label-purple }
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
## Get a transform job's details
Introduced 1.0
{: .label .label-purple }
Returns a transform job's details.
@ -520,6 +526,8 @@ GET _plugins/_transform?size=2&from=8
```
## 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.
@ -538,6 +546,8 @@ POST _plugins/_transform/<transform_id>/_start
```
## Stop a transform job
Introduced 1.0
{: .label .label-purple }
Stops/disables a transform job.
@ -556,6 +566,8 @@ POST _plugins/_transform/<transform_id>/_stop
```
## Get the status of a transform job
Introduced 1.0
{: .label .label-purple }
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
Introduced 1.0
{: .label .label-purple }
Returns a preview of what a transformed index would look like.
@ -674,6 +688,8 @@ POST _plugins/_transform/_preview
```
## Delete a transform job
Introduced 1.0
{: .label .label-purple }
Deletes a transform job. This operation does not delete the source or target indices.

View File

@ -21,6 +21,8 @@ Use the index state management operations to programmatically work with policies
## Create policy
Introduced 1.0
{: .label .label-purple }
Creates a policy.
@ -138,6 +140,8 @@ PUT _plugins/_ism/policies/policy_1
---
## 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.
@ -168,6 +172,8 @@ Don't use the broad `*` wildcard, and instead add a prefix, such as `my-logs*`,
## 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.
@ -285,6 +291,8 @@ PUT _plugins/_ism/policies/policy_1?if_seq_no=7&if_primary_term=1
---
## Get policy
Introduced 1.0
{: .label .label-purple }
Gets the policy by `policy_id`.
@ -355,6 +363,8 @@ GET _plugins/_ism/policies/policy_1
---
## Remove policy from index
Introduced 1.0
{: .label .label-purple }
Removes any ISM policy from the index.
@ -378,6 +388,8 @@ POST _plugins/_ism/remove/index_1
---
## 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.
@ -414,6 +426,8 @@ POST _plugins/_ism/change_policy/index_1
---
## 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.
@ -440,6 +454,8 @@ POST _plugins/_ism/retry/index_1
---
## 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.
@ -465,6 +481,8 @@ The `plugins.index_state_management.policy_id` setting is deprecated starting fr
---
## Delete policy
Introduced 1.0
{: .label .label-purple }
Deletes the policy by `policy_id`.

View File

@ -19,6 +19,8 @@ Use these anomaly detection operations to programmatically create and manage det
---
## Create anomaly detector
Introduced 1.0
{: .label .label-purple }
Creates an anomaly detector.
@ -306,6 +308,8 @@ Options | Description | Type | Required
---
## Preview detector
Introduced 1.0
{: .label .label-purple }
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
Introduced 1.0
{: .label .label-purple }
Starts a real-time or historical anomaly detector job.
@ -470,6 +476,8 @@ POST _plugins/_anomaly_detection/detectors/<detectorId>/_start
---
## Stop detector job
Introduced 1.0
{: .label .label-purple }
Stops a real-time or historical anomaly detector job.
@ -488,6 +496,8 @@ Stopped detector: m4ccEnIBTXsGi3mvMt9p
---
## Search detector result
Introduced 1.0
{: .label .label-purple }
Returns all results for a search query.
@ -933,6 +943,8 @@ GET _plugins/_anomaly_detection/detectors/results/_search
---
## Delete detector
Introduced 1.0
{: .label .label-purple }
Deletes a detector based on the `detector_id`.
To delete a detector, you need to first stop the detector.
@ -968,6 +980,8 @@ DELETE _plugins/_anomaly_detection/detectors/<detectorId>
---
## Update detector
Introduced 1.0
{: .label .label-purple }
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.
@ -1139,6 +1153,8 @@ PUT _plugins/_anomaly_detection/detectors/<detectorId>
---
## Get detector
Introduced 1.0
{: .label .label-purple }
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
Introduced 1.0
{: .label .label-purple }
Returns all anomaly detectors for a search query.
@ -1591,6 +1609,8 @@ Sample Input:
---
## Get detector stats
Introduced 1.0
{: .label .label-purple }
Provides information about how the plugin is performing.
@ -1691,6 +1711,8 @@ Historical detectors contain additional fields:
---
## Create monitor
Introduced 1.0
{: .label .label-purple }
Create a monitor to set up alerts for the detector.
@ -1909,6 +1931,8 @@ POST _plugins/_alerting/monitors
---
## 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.

View File

@ -20,6 +20,8 @@ Use the alerting API to programmatically manage monitors and alerts.
---
## Create monitor
Introduced 1.0
{: .label .label-purple }
#### Request
@ -246,6 +248,8 @@ For a full list of timezone names, refer to [Wikipedia](https://en.wikipedia.org
---
## 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).
@ -368,6 +372,8 @@ PUT _plugins/_alerting/monitors/<monitor_id>
---
## Get monitor
Introduced 1.0
{: .label .label-purple }
#### Request
@ -438,6 +444,8 @@ GET _plugins/_alerting/monitors/<monitor_id>
---
## 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.
@ -627,6 +635,8 @@ GET _plugins/_alerting/<node-id>/stats/<metric>
---
## Delete monitor
Introduced 1.0
{: .label .label-purple }
#### Request
@ -658,6 +668,8 @@ DELETE _plugins/_alerting/monitors/<monitor_id>
---
## Search monitors
Introduced 1.0
{: .label .label-purple }
#### Request
@ -755,6 +767,8 @@ GET _plugins/_alerting/monitors/_search
---
## 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.
@ -787,6 +801,8 @@ POST _plugins/_alerting/monitors/<monitor_id>/_execute
---
## Get alerts
Introduced 1.0
{: .label .label-purple }
Returns an array of all alerts.
@ -855,6 +871,8 @@ GET _plugins/_alerting/monitors/alerts
---
## 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.
@ -882,6 +900,8 @@ POST _plugins/_alerting/monitors/<monitor-id>/_acknowledge/alerts
---
## Create destination
Introduced 1.0
{: .label .label-purple }
#### Requests
@ -956,6 +976,8 @@ POST _plugins/_alerting/destinations
---
## Update destination
Introduced 1.0
{: .label .label-purple }
#### Request
@ -991,6 +1013,8 @@ PUT _plugins/_alerting/destinations/<destination-id>
---
## Get destination
Introduced 1.0
{: .label .label-purple }
Retrieve one destination.
@ -1036,6 +1060,8 @@ GET _plugins/_alerting/destinations/<destination-id>
---
## Get destinations
Introduced 1.0
{: .label .label-purple }
Retrieve all destinations.
@ -1081,6 +1107,8 @@ GET _plugins/_alerting/destinations
---
## Delete destination
Introduced 1.0
{: .label .label-purple }
#### Request
@ -1110,6 +1138,8 @@ DELETE _plugins/_alerting/destinations/<destination-id>
---
## Create email account
Introduced 1.0
{: .label .label-purple }
#### Request
```json
@ -1142,6 +1172,8 @@ POST _plugins/_alerting/destinations/email_accounts
```
## Update email account
Introduced 1.0
{: .label .label-purple }
#### Request
```json
@ -1173,6 +1205,8 @@ PUT _plugins/_alerting/destinations/email_accounts/<email_account_id>
```
## Get email account
Introduced 1.0
{: .label .label-purple }
#### Request
```json
@ -1204,6 +1238,8 @@ GET _plugins/_alerting/destinations/email_accounts/<email_account_id>
```
## Delete email account
Introduced 1.0
{: .label .label-purple }
#### Request
```
@ -1230,6 +1266,8 @@ DELETE _plugins/_alerting/destinations/email_accounts/<email_account_id>
```
## Search email account
Introduced 1.0
{: .label .label-purple }
#### Request
@ -1296,6 +1334,8 @@ POST _plugins/_alerting/destinations/email_accounts/_search
---
## Create email group
Introduced 1.0
{: .label .label-purple }
#### Request
@ -1330,6 +1370,8 @@ POST _plugins/_alerting/destinations/email_groups
```
## Update email group
Introduced 1.0
{: .label .label-purple }
#### Request
@ -1363,6 +1405,8 @@ PUT _plugins/_alerting/destinations/email_groups/<email_group_id>
```
## Get email group
Introduced 1.0
{: .label .label-purple }
#### Request
```json
@ -1395,6 +1439,8 @@ GET _plugins/_alerting/destinations/email_groups/<email_group_id>
```
## Delete email group
Introduced 1.0
{: .label .label-purple }
#### Request
```
@ -1421,6 +1467,8 @@ DELETE _plugins/_alerting/destinations/email_groups/<email_group_id>
```
## Search email group
Introduced 1.0
{: .label .label-purple }
#### Request

View File

@ -6,6 +6,8 @@ nav_order: 1
---
# Performance Analyzer API
Introduced 1.0
{: .label .label-purple }
Performance Analyzer uses a single HTTP method and URI for most requests:

View File

@ -6,6 +6,8 @@ nav_order: 5
---
# 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.

View File

@ -8,6 +8,8 @@ has_children: false
---
# cat aliases
Introduced 1.0
{: .label .label-purple }
The cat aliases operation lists the mapping of aliases to indices, plus routing and filtering information.

View File

@ -8,6 +8,8 @@ has_children: false
---
# 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.

View File

@ -8,6 +8,8 @@ has_children: false
---
# cat count
Introduced 1.0
{: .label .label-purple }
The cat count operation lists the number of documents in your cluster.

View File

@ -8,6 +8,8 @@ has_children: false
---
# cat fielddata
Introduced 1.0
{: .label .label-purple }
The cat fielddata operation lists the memory size used by each field per node.

View File

@ -8,6 +8,8 @@ has_children: false
---
# 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.

View File

@ -8,6 +8,8 @@ has_children: false
---
# 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.

View File

@ -8,6 +8,8 @@ has_children: false
---
# cat master
Introduced 1.0
{: .label .label-purple }
The cat master operation lists information that helps identify the elected master node.

View File

@ -8,6 +8,8 @@ has_children: false
---
# cat nodeattrs
Introduced 1.0
{: .label .label-purple }
The cat nodeattrs operation lists the attributes of custom nodes.

View File

@ -8,6 +8,8 @@ has_children: false
---
# cat nodes
Introduced 1.0
{: .label .label-purple }
The cat nodes operation lists node-level information, including node roles and load metrics.

View File

@ -8,6 +8,8 @@ has_children: false
---
# 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.

View File

@ -8,6 +8,8 @@ has_children: false
---
# cat plugins
Introduced 1.0
{: .label .label-purple }
The cat plugins operation lists the names, components, and versions of the installed plugins.

View File

@ -8,6 +8,8 @@ has_children: false
---
# cat recovery
Introduced 1.0
{: .label .label-purple }
The cat recovery operation lists all completed and ongoing index and shard recoveries.

View File

@ -8,6 +8,8 @@ has_children: false
---
# cat repositories
Introduced 1.0
{: .label .label-purple }
The cat repositories operation lists all completed and ongoing index and shard recoveries.

View File

@ -8,6 +8,8 @@ has_children: false
---
# cat segments
Introduced 1.0
{: .label .label-purple }
The cat segments operation lists Lucene segment-level information for each index.

View File

@ -8,6 +8,8 @@ has_children: false
---
# 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.

View File

@ -8,6 +8,8 @@ has_children: false
---
# cat snapshots
Introduced 1.0
{: .label .label-purple }
The cat snapshots operation lists all snapshots for a repository.

View File

@ -8,6 +8,8 @@ has_children: false
---
# cat tasks
Introduced 1.0
{: .label .label-purple }
The cat tasks operation lists the progress of all tasks currently running on your cluster.

View File

@ -8,6 +8,8 @@ has_children: false
---
# cat templates
Introduced 1.0
{: .label .label-purple }
The cat templates operation lists the names, patterns, order numbers, and version numbers of index templates.

View File

@ -8,6 +8,8 @@ has_children: false
---
# 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.

View File

@ -6,6 +6,8 @@ nav_order: 10
---
# 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.

View File

@ -6,6 +6,8 @@ nav_order: 15
---
# 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.

View File

@ -6,6 +6,8 @@ nav_order: 20
---
# 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.

View File

@ -6,6 +6,8 @@ nav_order: 3
---
# 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.

View File

@ -7,6 +7,8 @@ nav_order: 20
---
# 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.

View File

@ -6,7 +6,9 @@ grand_parent: REST API reference
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.

View File

@ -7,6 +7,8 @@ nav_order: 5
---
# 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.

View File

@ -6,6 +6,8 @@ nav_order: 120
---
# 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.

View File

@ -8,6 +8,8 @@ redirect_from:
---
# 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.

View File

@ -205,19 +205,13 @@ td {
}
// Keeps labels high and tight next to headers
h1 + p.label {
margin: -23px 0 0 0;
}
h2 + p.label {
margin: -15px 0 0 0;
}
h3 + p.label {
margin: -10px 0 0 0;
}
h4 + p.label,
h5 + p.label,
h6 + p.label {
margin: -7px 0 0 0;
h1 + p.label, h1 + p.label + p.label,
h2 + p.label, h2 + p.label + p.label,
h3 + p.label, h3 + p.label + p.label,
h4 + p.label, h4 + p.label + p.label,
h5 + p.label, h5 + p.label + p.label,
h6 + p.label, h6 + p.label + p.label {
margin: -20px 0 0 0;
}
// Modifies margins in xl layout to support TOC

View File

@ -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.
## 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:
@ -112,6 +114,8 @@ Options | Description
`aggregations` | The partial aggregation results that have been completed by the shards so far.
## 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.
@ -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 dont 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
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, its canceled. If the search is complete, the saved search results are deleted.
@ -204,6 +210,8 @@ DELETE _plugins/_asynchronous_search/<ID>?pretty
```
## 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.

View File

@ -13,6 +13,8 @@ The k-NN plugin adds two API operations to help you better manage the plugin's f
## 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`:
```
@ -107,6 +109,8 @@ GET /_plugins/_knn/HYMrXXsBSamUkcAjhjeN0w/stats/circuit_breaker_triggered,graph_
## 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.

View File

@ -7,6 +7,8 @@ redirect_from: /docs/ppl/endpoint/
---
# Endpoint
Introduced 1.0
{: .label .label-purple }
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.

View File

@ -8,6 +8,8 @@ redirect_from: /docs/sql/endpoints/
# Endpoint
Introduced 1.0
{: .label .label-purple }
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

View File

@ -95,6 +95,8 @@ To add or remove these flags, you need to modify `plugins/opensearch-security/se
## Account
### 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.
@ -132,6 +134,8 @@ GET _plugins/_security/api/account
### Change password
Introduced 1.0
{: .label .label-purple }
Changes the password for the current user.
@ -162,6 +166,8 @@ PUT _plugins/_security/api/account
## Action groups
### Get action group
Introduced 1.0
{: .label .label-purple }
Retrieves one action group.
@ -192,6 +198,8 @@ GET _plugins/_security/api/actiongroups/<action-group>
### Get action groups
Introduced 1.0
{: .label .label-purple }
Retrieves all action groups.
@ -224,6 +232,8 @@ GET _plugins/_security/api/actiongroups/
### Delete action group
Introduced 1.0
{: .label .label-purple }
#### Request
@ -242,6 +252,8 @@ DELETE _plugins/_security/api/actiongroups/<action-group>
### Create action group
Introduced 1.0
{: .label .label-purple }
Creates or replaces the specified action group.
@ -272,6 +284,8 @@ PUT _plugins/_security/api/actiongroups/<action-group>
### Patch action group
Introduced 1.0
{: .label .label-purple }
Updates individual attributes of an action group.
@ -297,6 +311,8 @@ PATCH _plugins/_security/api/actiongroups/<action-group>
### Patch action groups
Introduced 1.0
{: .label .label-purple }
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
Introduced 1.0
{: .label .label-purple }
#### Request
@ -357,6 +375,8 @@ GET _plugins/_security/api/internalusers/<username>
### Get users
Introduced 1.0
{: .label .label-purple }
#### Request
@ -381,6 +401,8 @@ GET _plugins/_security/api/internalusers/
### Delete user
Introduced 1.0
{: .label .label-purple }
#### Request
@ -399,6 +421,8 @@ DELETE _plugins/_security/api/internalusers/<username>
### 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.
@ -430,6 +454,8 @@ PUT _plugins/_security/api/internalusers/<username>
### Patch user
Introduced 1.0
{: .label .label-purple }
Updates individual attributes of an internal user.
@ -460,6 +486,8 @@ PATCH _plugins/_security/api/internalusers/<username>
```
### Patch users
Introduced 1.0
{: .label .label-purple }
Creates, updates, or deletes multiple internal users in a single call.
@ -496,6 +524,8 @@ PATCH _plugins/_security/api/internalusers
### Get role
Introduced 1.0
{: .label .label-purple }
Retrieves one role.
@ -542,6 +572,8 @@ GET _plugins/_security/api/roles/<role>
### Get roles
Introduced 1.0
{: .label .label-purple }
Retrieves all roles.
@ -582,6 +614,8 @@ GET _plugins/_security/api/roles/
### Delete role
Introduced 1.0
{: .label .label-purple }
#### Request
@ -600,6 +634,8 @@ DELETE _plugins/_security/api/roles/<role>
### Create role
Introduced 1.0
{: .label .label-purple }
Creates or replaces the specified role.
@ -645,6 +681,8 @@ PUT _plugins/_security/api/roles/<role>
### Patch role
Introduced 1.0
{: .label .label-purple }
Updates individual attributes of a role.
@ -673,6 +711,8 @@ PATCH _plugins/_security/api/roles/<role>
### Patch roles
Introduced 1.0
{: .label .label-purple }
Creates, updates, or deletes multiple roles in a single call.
@ -708,6 +748,8 @@ PATCH _plugins/_security/api/roles
## Role mappings
### Get role mapping
Introduced 1.0
{: .label .label-purple }
Retrieves one role mapping.
@ -731,6 +773,8 @@ GET _plugins/_security/api/rolesmapping/<role>
### Get role mappings
Introduced 1.0
{: .label .label-purple }
Retrieves all role mappings.
@ -754,6 +798,8 @@ GET _plugins/_security/api/rolesmapping
### Delete role mapping
Introduced 1.0
{: .label .label-purple }
Deletes the specified role mapping.
@ -774,6 +820,8 @@ DELETE _plugins/_security/api/rolesmapping/<role>
### Create role mapping
Introduced 1.0
{: .label .label-purple }
Creates or replaces the specified role mapping.
@ -799,6 +847,8 @@ PUT _plugins/_security/api/rolesmapping/<role>
### Patch role mapping
Introduced 1.0
{: .label .label-purple }
Updates individual attributes of a role mapping.
@ -827,6 +877,8 @@ PATCH _plugins/_security/api/rolesmapping/<role>
### Patch role mappings
Introduced 1.0
{: .label .label-purple }
Creates or updates multiple role mappings in a single call.
@ -859,6 +911,8 @@ PATCH _plugins/_security/api/rolesmapping
## Tenants
### Get tenant
Introduced 1.0
{: .label .label-purple }
Retrieves one tenant.
@ -883,6 +937,8 @@ GET _plugins/_security/api/tenants/<tenant>
### Get tenants
Introduced 1.0
{: .label .label-purple }
Retrieves all tenants.
@ -913,6 +969,8 @@ GET _plugins/_security/api/tenants/
### Delete tenant
Introduced 1.0
{: .label .label-purple }
Deletes the specified tenant.
@ -933,6 +991,8 @@ DELETE _plugins/_security/api/tenants/<tenant>
### Create tenant
Introduced 1.0
{: .label .label-purple }
Creates or replaces the specified tenant.
@ -956,6 +1016,8 @@ PUT _plugins/_security/api/tenants/<tenant>
### Patch tenant
Introduced 1.0
{: .label .label-purple }
Add, delete, or modify a single tenant.
@ -981,6 +1043,8 @@ PATCH _plugins/_security/api/tenants/<tenant>
### Patch tenants
Introduced 1.0
{: .label .label-purple }
Add, delete, or modify multiple tenants in a single call.
@ -1018,6 +1082,8 @@ PATCH _plugins/_security/api/tenants/
## Configuration
### Get configuration
Introduced 1.0
{: .label .label-purple }
Retrieves the current security plugin configuration in JSON format.
@ -1029,6 +1095,8 @@ GET _plugins/_security/api/securityconfig
### 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.
@ -1087,6 +1155,8 @@ PUT _plugins/_security/api/securityconfig/config
### 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.
@ -1116,6 +1186,8 @@ PATCH _plugins/_security/api/securityconfig
## Certificates
### Get certificates
Introduced 1.0
{: .label .label-purple }
Retrieves the current security plugin configuration in JSON format.
@ -1127,6 +1199,8 @@ GET _plugins/_security/api/securityconfig
### 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.
@ -1185,6 +1259,8 @@ PUT _plugins/_security/api/securityconfig/config
### 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.
@ -1213,6 +1289,8 @@ PATCH _plugins/_security/api/securityconfig
## Cache
### Flush cache
Introduced 1.0
{: .label .label-purple }
Flushes the security plugin user, authentication, and authorization cache.
@ -1239,6 +1317,8 @@ DELETE _plugins/_security/api/cache
## Health
### 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.