|
@@ -31,6 +31,12 @@ information, see {stack-ov}/security-privileges.html[Security privileges] and
|
|
|
[[put-data-frame-transform-desc]]
|
|
|
==== {api-description-title}
|
|
|
|
|
|
+When the {dataframe-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 the `defer_validation` parameter to skip these
|
|
|
+checks.
|
|
|
+
|
|
|
IMPORTANT: You must use {kib} or this API to create a {dataframe-transform}.
|
|
|
Do not put a {dataframe-transform} directly into any
|
|
|
`.data-frame-internal*` indices using the Elasticsearch index API.
|
|
@@ -49,13 +55,13 @@ IMPORTANT: You must use {kib} or this API to create a {dataframe-transform}.
|
|
|
==== {api-query-parms-title}
|
|
|
|
|
|
`defer_validation`::
|
|
|
- (Optional, boolean) When `true`, deferrable validations are not run. This
|
|
|
- behavior may be desired if the source index does not exist until after the
|
|
|
-{dataframe-transform} is created. Deferred validations are always run when the
|
|
|
-{dataframe-transform} is started, with the exception of privilege checks. If the
|
|
|
-user who created the transform does not have the required privileges on the
|
|
|
-source and destination indices, the transform starts but then fails when it
|
|
|
-attempts the unauthorized operation. The default value is `false`.
|
|
|
+ (Optional, boolean) When `true`, deferrable validations are not run. This
|
|
|
+ behavior may be desired if the source index does not exist until after the
|
|
|
+ {dataframe-transform} is created. Deferred validations are always run when the
|
|
|
+ {dataframe-transform} is started, with the exception of privilege checks. If
|
|
|
+ the user who created the transform does not have the required privileges on
|
|
|
+ the source and destination indices, the transform starts but then fails when
|
|
|
+ it attempts the unauthorized operation. The default value is `false`.
|
|
|
|
|
|
[[put-data-frame-transform-request-body]]
|
|
|
==== {api-request-body-title}
|