get_data_frame.asciidoc 1.6 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647
  1. --
  2. :api: get-data-frame-transform
  3. :request: GetDataFrameTransformRequest
  4. :response: GetDataFrameTransformResponse
  5. --
  6. [id="{upid}-{api}"]
  7. === Get Data Frame Transform API
  8. The Get Data Frame Transform API is used get one or more {dataframe-transform}.
  9. The API accepts a +{request}+ object and returns a +{response}+.
  10. [id="{upid}-{api}-request"]
  11. ==== Get Data Frame Request
  12. A +{request}+ requires either a data frame transform id, a comma separated list of ids or
  13. the special wildcard `_all` to get all {dataframe-transforms}
  14. ["source","java",subs="attributes,callouts,macros"]
  15. --------------------------------------------------
  16. include-tagged::{doc-tests-file}[{api}-request]
  17. --------------------------------------------------
  18. <1> Constructing a new GET request referencing an existing {dataframe-transform}
  19. ==== Optional Arguments
  20. The following arguments are optional.
  21. ["source","java",subs="attributes,callouts,macros"]
  22. --------------------------------------------------
  23. include-tagged::{doc-tests-file}[{api}-request-options]
  24. --------------------------------------------------
  25. <1> The page parameters `from` and `size`. `from` specifies the number of
  26. {dataframe-transforms} to skip. `size` specifies the maximum number of
  27. {dataframe-transforms} to get. Defaults to `0` and `100` respectively.
  28. include::../execution.asciidoc[]
  29. [id="{upid}-{api}-response"]
  30. ==== Response
  31. The returned +{response}+ contains the requested {dataframe-transform}s.
  32. ["source","java",subs="attributes,callouts,macros"]
  33. --------------------------------------------------
  34. include-tagged::{doc-tests-file}[{api}-response]
  35. --------------------------------------------------