浏览代码

[DOCS] Clarifies dataframe transform validations

lcawl 6 年之前
父节点
当前提交
f2a6dd7250

+ 8 - 5
docs/reference/data-frames/apis/put-transform.asciidoc

@@ -46,6 +46,13 @@ 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
 index pattern. You can use the `defer_validation` parameter to skip these
 checks.
 checks.
 
 
+Deferred validations are always run when the {dataframe-transform} is started,
+with the exception of privilege checks. When {es} {security-features} are
+enabled, the {dataframe-transform} remembers which roles the user that created
+it had at the time of creation and uses those same roles. If those roles do not
+have the required privileges on the source and destination indices, the
+{dataframe-transform} fails when it attempts unauthorized operations.
+
 IMPORTANT:  You must use {kib} or this API to create a {dataframe-transform}.
 IMPORTANT:  You must use {kib} or this API to create a {dataframe-transform}.
             Do not put a {dataframe-transform} directly into any
             Do not put a {dataframe-transform} directly into any
             `.data-frame-internal*` indices using the Elasticsearch index API.
             `.data-frame-internal*` indices using the Elasticsearch index API.
@@ -66,11 +73,7 @@ IMPORTANT:  You must use {kib} or this API to create a {dataframe-transform}.
 `defer_validation`::
 `defer_validation`::
   (Optional, boolean) When `true`, deferrable validations are not run. This
   (Optional, boolean) When `true`, deferrable validations are not run. This
   behavior may be desired if the source index does not exist until after the
   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`.
+  {dataframe-transform} is created.
 
 
 [[put-data-frame-transform-request-body]]
 [[put-data-frame-transform-request-body]]
 ==== {api-request-body-title}
 ==== {api-request-body-title}

+ 5 - 3
docs/reference/data-frames/apis/start-transform.asciidoc

@@ -44,9 +44,11 @@ index take precedence over dynamic mappings and templates.
 When the {dataframe-transform} starts, a series of validations occur to ensure
 When the {dataframe-transform} starts, a series of validations occur to ensure
 its success. If you deferred validation when you created the
 its success. If you deferred validation when you created the
 {dataframe-transform}, they occur when you start the transform--with the
 {dataframe-transform}, they occur when you start the transform--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.
+exception of privilege checks. When {es} {security-features} are enabled, the
+{dataframe-transform} remembers which roles the user that created it had at the
+time of creation and uses those same roles. If those roles do not have the
+required privileges on the source and destination indices, the
+{dataframe-transform} fails when it attempts unauthorized operations.
 
 
 [[start-data-frame-transform-path-parms]]
 [[start-data-frame-transform-path-parms]]
 ==== {api-path-parms-title}
 ==== {api-path-parms-title}