stack es transform put-transform cli command

elastic stack es transform put-transform \
  --dest <dest> \
  --source <source> \
  --transform-id <transform-id> \
  [options]
		

Create a transform.

Behaviour flags:

--dry-run — validate all inputs and exit without performing any action

--dest string required

The destination for the transform.

--source string required

The source of the data for the transform.

--transform-id string required

Identifier for the transform. This identifier can contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores. It has a 64 character limit and must start and end with alphanumeric characters.

--defer-validation

When the transform is created, a series of validations occur to ensure its success. For example, there is a check for the existence of the source indices and a check that the destination index is not part of the source index pattern. You can use this parameter to skip the checks, for example when the source index does not exist until after the transform is created. The validations are always run when you start the transform, however, with the exception of privilege checks.

--timeout string

Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.

--description string

Free text description of the transform.

--frequency string

The interval between checks for changes in the source indices when the transform is running continuously. Also determines the retry interval in the event of transient failures while the transform is searching or indexing. The minimum value is 1s and the maximum is 1h.

--latest string

The latest method transforms the data by finding the latest document for each unique key.

--meta string

Defines optional transform metadata.

--pivot string

The pivot method transforms the data by aggregating and grouping it. These objects define the group by fields and the aggregation to reduce the data.

--retention-policy string

Defines a retention policy for the transform. Data that meets the defined criteria is deleted from the destination index.

--settings string

Defines optional transform settings.

--sync string

Defines the properties transforms require to run continuously.

--error-trace

When set to true Elasticsearch will include the full stack trace of errors when they occur.

--filter-path string

Comma-separated list of filters in dot notation which reduce the response returned by Elasticsearch.

Repeatable: pass --filter-path multiple times to supply more than one value

--human

When set to true will return statistics in a format suitable for humans. For example "exists_time": "1h" for humans and "exists_time_in_millis": 3600000 for computers. When disabled the human readable values will be omitted. This makes sense for responses being consumed only by machines.

--pretty

If set to true the returned JSON will be "pretty-formatted". Only use this option for debugging only.

--input-file string

path to a JSON file to use as command input

--dry-run

validate all inputs and exit without performing any action (preview changes without applying them)

--json

output as JSON