Stop transforms APIedit

Stops one or more transforms.

Requestedit

POST _transform/<transform_id>/_stop

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

POST _transform/_all/_stop

Prerequisitesedit

Requires the manage_transform cluster privilege. This privilege is included in the transform_admin built-in role.

Path parametersedit

<transform_id>
(Required, string) Identifier for the transform. To stop multiple transforms, use a comma-separated list or a wildcard expression. To stop all transforms, use _all or * as the identifier.

Query parametersedit

allow_no_match
(Optional, Boolean) include::/tmp/docsbuild/D3STBKrO1g/elasticsearch/docs/reference/rest-api/common-parms.asciidoc[tag=allow-no-match-transforms2]
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_checkpoint
(Optional, Boolean) If set to true, the transform will not completely stop until the current checkpoint is completed. If set to false, the transform stops as soon as possible. Defaults to false.
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 codesedit

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.

Examplesedit

POST _transform/ecommerce_transform/_stop

When the transform stops, you receive the following results:

{
  "acknowledged" : true
}