Upsert runtime field APIedit
[preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will apply best effort to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Create or update an existing runtime field
Requestedit
PUT <kibana host>:<port>/api/data_views/data_view/<data_view_id>/runtime_field
PUT <kibana host>:<port>/s/<space_id>/api/data_views/data_view/<data_view_id>/runtime_field
Path parametersedit
-
space_id -
(Optional, string) An identifier for the space. If
space_idis not provided in the URL, the default space is used. -
data_view_id - (Required, string) The ID of the data view.
Request bodyedit
-
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.
Examplesedit
Create or update an existing runtime field on a data view:
$ curl -X PUT api/data_views/data_view/<data_view_id>/runtime_field
{
"name": "runtimeFoo",
"runtimeField": {
"type": "long",
"script": {
"source": "emit(doc["foo"].value)"
}
}
}
The API returns created or updated runtime field object array and updated data view object:
{
"data_view": {...},
"fields": [...]
}