mirror of
https://github.com/elastic/kibana.git
synced 2025-06-28 03:01:21 -04:00
eb2ddcd7c6
* initial pass at changing urls and anchors * update api.asciidoc * upate a few more anchor tags * upate a few more anchor tags * update data view api docs * Update delete.asciidoc * Update default-get.asciidoc * add redirects * fix redirects * remove duplicate redirect Co-authored-by: Kibana Machine <42973632+kibanamachine@users.noreply.github.com>
61 lines
1.6 KiB
Text
61 lines
1.6 KiB
Text
[[data-views-runtime-field-api-upsert]]
|
|
=== Upsert runtime field API
|
|
++++
|
|
<titleabbrev>Upsert runtime field</titleabbrev>
|
|
++++
|
|
|
|
experimental[] Create or update an existing runtime field
|
|
|
|
[[data-views-runtime-field-upsert-request]]
|
|
==== Request
|
|
|
|
`PUT <kibana host>:<port>/api/index_patterns/index_pattern/<index_pattern_id>/runtime_field`
|
|
|
|
`PUT <kibana host>:<port>/s/<space_id>/api/index_patterns/index_pattern/<index_pattern_id>/runtime_field`
|
|
|
|
[[data-views-runtime-field-upsert-params]]
|
|
==== Path parameters
|
|
|
|
`space_id`::
|
|
(Optional, string) An identifier for the space. If `space_id` is not provided in the URL, the default space is used.
|
|
|
|
`index_pattern_id`::
|
|
(Required, string) The ID of the data view.
|
|
|
|
[[data-views-runtime-field-upsert-body]]
|
|
==== Request body
|
|
|
|
`name`:: (Required, string) The name for a new runtime field or a name of an existing runtime field.
|
|
|
|
`runtimeField`:: (Required, object) The runtime field definition object.
|
|
|
|
|
|
[[data-views-runtime-field-upsert-example]]
|
|
==== Examples
|
|
|
|
Create or update an existing runtime field on a data view:
|
|
|
|
[source,sh]
|
|
--------------------------------------------------
|
|
$ curl -X PUT api/index_patterns/index_pattern/<index_pattern_id>/runtime_field
|
|
{
|
|
"name": "runtimeFoo",
|
|
"runtimeField": {
|
|
"type": "long",
|
|
"script": {
|
|
"source": "emit(doc["foo"].value)"
|
|
}
|
|
}
|
|
}
|
|
--------------------------------------------------
|
|
// KIBANA
|
|
|
|
The API returns created or updated runtime field object and updated data view object:
|
|
|
|
[source,sh]
|
|
--------------------------------------------------
|
|
{
|
|
"index_pattern": {...},
|
|
"field": {...}
|
|
}
|
|
--------------------------------------------------
|