Stop transforms API

edit

Stops one or more transforms.

This functionality is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features.

Request

edit

POST _transform/<transform_id>/_stop

POST _transform/<transform_id1>,<transform_id2>/_stop

POST _transform/_all/_stop

Prerequisites

edit
  • If the Elasticsearch security features are enabled, you must have manage_transform cluster privileges to use this API. The built-in transform_admin role has these privileges. For more information, see Security privileges and Built-in roles.

Description

edit

You can stop multiple transforms in a single API request by using a comma-separated list of transforms or a wildcard expression. All transforms can be stopped by using _all or * as the <transform_id>.

Path parameters

edit
<transform_id>
(Required, string) Identifier for the transform. This identifier can contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores. It must start and end with alphanumeric characters.

Query parameters

edit
allow_no_match

(Optional, boolean) Specifies what to do when the request:

  • Contains wildcard expressions and there are no transforms that match.
  • Contains the _all string or no identifiers and there are no matches.
  • Contains wildcard expressions and there are only partial matches.

The default value is true, which returns a successful acknowledgement message when there are no matches. When there are only partial matches, the API stops the appropriate transforms. For example, if the request contains test-id1*,test-id2* as the identifiers and there are no transforms that match test-id2*, the API nonetheless stops the transforms that match test-id1*.

If this parameter is false, the request returns a 404 status code when there are no matches or only partial matches.

force
(Optional, boolean) Set to true to stop a failed transform or to forcefully stop a transform that did not respond to the initial stop request.
timeout
(Optional, time value) If wait_for_completion=true, the API blocks for (at maximum) the specified duration while waiting for the transform to stop. If more than timeout time has passed, the API throws a timeout exception. Even if a timeout exception is thrown, the stop request is still processing and eventually moves the transform to STOPPED. The timeout simply means the API call itself timed out while waiting for the status change. Defaults to 30s
wait_for_completion
(Optional, boolean) If set to true, causes the API to block until the indexer state completely stops. If set to false, the API returns immediately and the indexer will be stopped asynchronously in the background. Defaults to false.

Response codes

edit
404 (Missing resources)
If allow_no_match is false, this code indicates that there are no resources that match the request or only partial matches for the request.

Examples

edit
POST _transform/ecommerce_transform/_stop

When the transform stops, you receive the following results:

{
  "acknowledged" : true
}