Preview a transform | Elasticsearch API documentation (original) (raw)
Dismiss highlight Show more
Query parameters
- Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
application/json
Body
- Hide dest attributes Show dest attributes object
- The unique identifier for an ingest pipeline.
- Free text description of the transform.
- A duration. Units can be
nanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value. - Hide pivot attributes Show pivot attributes object
- Defines how to aggregate the grouped data. The following aggregations are currently supported: average, bucket script, bucket selector, cardinality, filter, geo bounds, geo centroid, geo line, max, median absolute deviation, min, missing, percentiles, rare terms, scripted metric, stats, sum, terms, top metrics, value count, weighted average.
- Defines how to group the data. More than one grouping can be defined per pivot. The following groupings are currently supported: date histogram, geotile grid, histogram, terms.
Hide group_by attribute Show group_by attribute object
* *
object Additional properties
Hide * attributes Show * attributes object
* Hide date_histogram attributes Show date_histogram attributes object
* Values aresecond
,1s
,minute
,1m
,hour
,1h
,day
,1d
,week
,1w
,month
,1M
,quarter
,1q
,year
, or1y
.
* Hide extended_bounds attributes Show extended_bounds attributes object
* Hide hard_bounds attributes Show hard_bounds attributes object
* Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* The date format used to formatkey_as_string
in the response. If noformat
is specified, the first date format specified in the field mapping is used.
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Only returns buckets that havemin_doc_count
number of documents. By default, all buckets between the first bucket that matches documents and the last one are returned.
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* #### order object | array[object]
* Hide params attribute Show params attribute object
* *
object Additional properties
* Hide script attributes Show script attributes object
* Specifies any named parameters that are passed into the script as variables. Use parameters instead of hard-coded values to decrease compile time.
* Set totrue
to associate a unique string key with each bucket and return the ranges as a hash rather than an array.
* Hide geotile_grid attributes Show geotile_grid attributes object
* Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
* Allows for more accurate counting of the top cells returned in the final result the aggregation. Defaults to returningmax(10,(size x number-of-shards))
buckets from each shard.
* The maximum number of buckets to return.
* #### bounds object
A geo bounding box. It can be represented in various ways:
* as 4 top/bottom/left/right coordinates
* as 2 top_left / bottom_right points
* as 2 top_right / bottom_left points
* as a WKT bounding box
* Hide histogram attributes Show histogram attributes object
* Hide extended_bounds attributes Show extended_bounds attributes object
* Maximum value for the bound.
* Minimum value for the bound.
* Hide hard_bounds attributes Show hard_bounds attributes object
* Maximum value for the bound.
* Minimum value for the bound.
* Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
* The interval for the buckets. Must be a positive decimal.
* Only returns buckets that havemin_doc_count
number of documents. By default, the response will fill gaps in the histogram with empty buckets.
* The value to apply to documents that do not have a value. By default, documents without a value are ignored.
* By default, the bucket keys start with 0 and then continue in even spaced steps ofinterval
. The bucket boundaries can be shifted by using theoffset
option.
* #### order object | array[object]
* Hide script attributes Show script attributes object
* Specifies any named parameters that are passed into the script as variables. Use parameters instead of hard-coded values to decrease compile time.
* Iftrue
, returns buckets as a hash instead of an array, keyed by the bucket keys.
- Hide source attributes Show source attributes object
- index
string | array[string] Required - Hide runtime_mappings attribute Show runtime_mappings attribute object
* *
object Additional properties
Hide * attributes Show * attributes object
* For typecomposite
Hide fields attribute Show fields attribute object
* *
object Additional properties
Hide * attribute Show * attribute object
* Values areboolean
,composite
,date
,double
,geo_point
,geo_shape
,ip
,keyword
,long
, orlookup
.
* For typelookup
Hide fetch_fields attributes Show fetch_fields attributes object
* Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
* A custom format fordate
type runtime fields.
* Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
* Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
* Hide script attributes Show script attributes object
* Specifies any named parameters that are passed into the script as variables. Use parameters instead of hard-coded values to decrease compile time.
Hide params attribute Show params attribute object
* *
object Additional properties
* #### lang string
Values arepainless
,expression
,mustache
, orjava
.
* Hide options attribute Show options attribute object
* *
string Additional properties
* Values areboolean
,composite
,date
,double
,geo_point
,geo_shape
,ip
,keyword
,long
, orlookup
. - A query clause that retrieves a subset of data from the source index.
Query DSL
- index
- Hide settings attributes Show settings attributes object
- Specifies whether the transform checkpoint ranges should be optimized for performance. Such optimization can align checkpoint ranges with the date histogram interval when date histogram is specified as a group source in the transform config. As a result, less document updates in the destination index will be performed thus improving overall performance.
- Defines if dates in the ouput should be written as ISO formatted string or as millis since epoch. epoch_millis was the default for transforms created before version 7.11. For compatible output set this value to
true
. - Specifies whether the transform should deduce the destination index mappings from the transform configuration.
- Specifies a limit on the number of input documents per second. This setting throttles the transform by adding a wait time between search requests. The default value is null, which disables throttling.
- Defines the initial page size to use for the composite aggregation for each checkpoint. If circuit breaker exceptions occur, the page size is dynamically adjusted to a lower value. The minimum value is
10
and the maximum is65,536
. - If
true
, the transform runs in unattended mode. In unattended mode, the transform retries indefinitely in case of an error which means the transform never fails. Setting the number of retries other than infinite fails in validation.
- Hide sync attribute Show sync attribute object
- Hide time attributes Show time attributes object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
- Hide time attributes Show time attributes object
- Hide retention_policy attribute Show retention_policy attribute object
- Hide time attributes Show time attributes object
* Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
- Hide time attributes Show time attributes object
- Hide latest attributes Show latest attributes object
- Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
- Specifies an array of one or more fields that are used to group the data.
Responses
- 200 application/json
Hide response attributes Show response attributes object- Hide generated_dest_index attributes Show generated_dest_index attributes object
* Hide aliases attribute Show aliases attribute object
* *
object Additional properties
Hide * attributes Show * attributes object
* An Elasticsearch Query DSL (Domain Specific Language) object that defines a query.
External documentation
* Iftrue
, the alias is hidden. All indices for the alias must have the sameis_hidden
value.
* Iftrue
, the index is the write index for the alias.
* Hide mappings attributes Show mappings attributes object
* Hide all_field attributes Show all_field attributes object
* Values arestrict
,runtime
,true
, orfalse
.
* Hide _field_names attribute Show _field_names attribute object
* Hide index_field attribute Show index_field attribute object
* Hide _meta attribute Show _meta attribute object
* *
object Additional properties
* Hide _routing attribute Show _routing attribute object
* Hide _size attribute Show _size attribute object
* Hide _source attributes Show _source attributes object
* Values aredisabled
,stored
, orsynthetic
.
* Hide runtime attribute Show runtime attribute object
* *
object Additional properties
Hide * attributes Show * attributes object
* For typecomposite
Hide fields attribute Show fields attribute object
* *
object Additional properties
* For typelookup
* A custom format fordate
type runtime fields.
* Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
* Path to field or array of paths. Some API's support wildcards in the path to select multiple fields.
* Hide script attributes Show script attributes object
* Specifies any named parameters that are passed into the script as variables. Use parameters instead of hard-coded values to decrease compile time.
* Values areboolean
,composite
,date
,double
,geo_point
,geo_shape
,ip
,keyword
,long
, orlookup
.
* Values aretrue
orfalse
.
* Hide _data_stream_timestamp attribute Show _data_stream_timestamp attribute object
* Hide settings attributes Show settings attributes object
* Hide soft_deletes attributes Show soft_deletes attributes object
* Indicates whether soft deletes are enabled on the index.
* Hide retention_lease attribute Show retention_lease attribute object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Hide sort attributes Show sort attributes object
* field
string | array[string]
* #### order string | array[string]
Supported values include:asc
(orASC
),desc
(orDESC
)
Values areasc
,ASC
,desc
, orDESC
.
Values areasc
,ASC
,desc
, orDESC
.
* #### mode string | array[string]
Supported values include:min
(orMIN
),max
(orMAX
)
Values aremin
,MIN
,max
, orMAX
.
Values aremin
,MIN
,max
, orMAX
.
* #### missing string | array[string]
Supported values include:_last
,_first
Values are_last
or_first
.
Values are_last
or_first
.
* Values aretrue
,false
, orchecksum
.
* #### routing_partition_size number | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* #### auto_expand_replicas string | null
Anull
value that is to be interpreted as an actual value, unless other uses ofnull
that are equivalent to a missing value. It is used for exemple in settings, where using theNullValue
for a setting will reset it to its default value.
* Hide merge attribute Show merge attribute object
* Hide scheduler attributes Show scheduler attributes object
* #### max_thread_count number | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* #### max_merge_count number | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* Hide search attributes Show search attributes object
* Hide idle attribute Show idle attribute object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Hide slowlog attributes Show slowlog attributes object
* Hide threshold attributes Show threshold attributes object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Hide blocks attributes Show blocks attributes object
* #### read_only boolean | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* #### read_only_allow_delete boolean | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* #### read boolean | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* #### write boolean | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* #### metadata boolean | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* Hide analyze attribute Show analyze attribute object
* #### max_token_count number | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* Hide highlight attribute Show highlight attribute object
* Hide routing attributes Show routing attributes object
* Hide allocation attributes Show allocation attributes object
* Values areall
,primaries
,new_primaries
, ornone
.
* Hide include attributes Show include attributes object
* Hide initial_recovery attribute Show initial_recovery attribute object
* Hide disk attribute Show disk attribute object
* Hide rebalance attribute Show rebalance attribute object
* Values areall
,primaries
,replicas
, ornone
.
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Hide lifecycle attributes Show lifecycle attributes object
* #### indexing_complete boolean | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* If specified, this is the timestamp used to calculate the index age for its phase transitions. Use this setting if you create a new index that contains old data and want to use the original creation date to calculate the index age. Specified as a Unix epoch value in milliseconds.
* Set to true to parse the origination date from the index name. This origination date is used to calculate the index age for its phase transitions. The index name must match the pattern .*-{date_format}-\d+, where the date_format is yyyy.MM.dd and the trailing digits are optional. An index that was rolled over would normally match the full format, for example logs-2016.10.31-000002). If the index name doesn’t match the pattern, index creation fails.
* Hide step attribute Show step attribute object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* The index alias to update when the index rolls over. Specify when using a policy that contains a rollover action. When the index rolls over, the alias is updated to reflect that the index is no longer the write index. For more information about rolling indices, see Rollover.
* #### prefer_ilm boolean | string
Preference for the system that manages a data stream backing index (preferring ILM when both ILM and DLM are applicable for an index).
* #### creation_date number | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
Time unit for milliseconds
* #### creation_date_string string | number
A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
Time unit for milliseconds
* Hide version attributes Show version attributes object
* Hide translog attributes Show translog attributes object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Values arerequest
,REQUEST
,async
, orASYNC
.
* Hide retention attributes Show retention attributes object
* #### size number | string
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Hide query_string attribute Show query_string attribute object
* #### lenient boolean | string Required
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* Hide analysis attributes Show analysis attributes object
* Hide time_series attributes Show time_series attributes object
* #### end_time string | number
A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
Time unit for milliseconds
* #### start_time string | number
A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
Time unit for milliseconds
* Hide queries attribute Show queries attribute object
* Hide cache attribute Show cache attribute object
* Configure custom similarity settings to customize how search results are scored.
* Hide mapping attributes Show mapping attributes object
* Hide total_fields attributes Show total_fields attributes object
* #### limit number | string
The maximum number of fields in an index. Field and object mappings, as well as field aliases count towards this limit. The limit is in place to prevent mappings and searches from becoming too large. Higher values can lead to performance degradations and memory issues, especially in clusters with a high load or few resources.
* #### ignore_dynamic_beyond_limit boolean | string
This setting determines what happens when a dynamically mapped field would exceed the total fields limit. When set to false (the default), the index request of the document that tries to add a dynamic field to the mapping will fail with the message Limit of total fields [X] has been exceeded. When set to true, the index request will not fail. Instead, fields that would exceed the limit are not added to the mapping, similar to dynamic: false. The fields that were not added to the mapping will be added to the _ignored field.
* Hide depth attribute Show depth attribute object
* The maximum depth for a field, which is measured as the number of inner objects. For instance, if all fields are defined at the root object level, then the depth is 1. If there is one object mapping, then the depth is 2, etc.
* Hide nested_fields attribute Show nested_fields attribute object
* The maximum number of distinct nested mappings in an index. The nested type should only be used in special cases, when arrays of objects need to be queried independently of each other. To safeguard against poorly designed mappings, this setting limits the number of unique nested types per index.
* Hide nested_objects attribute Show nested_objects attribute object
* The maximum number of nested JSON objects that a single document can contain across all nested types. This limit helps to prevent out of memory errors when a document contains too many nested objects.
* Hide field_name_length attribute Show field_name_length attribute object
* Setting for the maximum length of a field name. This setting isn’t really something that addresses mappings explosion but might still be useful if you want to limit the field length. It usually shouldn’t be necessary to set this setting. The default is okay unless a user starts to add a huge number of fields with really long names. Default isLong.MAX_VALUE
(no limit).
* Hide dimension_fields attribute Show dimension_fields attribute object
* [preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.
* Hide source attribute Show source attribute object
* Values aredisabled
,stored
, orsynthetic
.
* Hide indexing.slowlog attributes Show indexing.slowlog attributes object
* Hide threshold attribute Show threshold attribute object
* Hide index attributes Show index attributes object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Hide indexing_pressure attribute Show indexing_pressure attribute object
* Hide memory attribute Show memory attribute object
* Number of outstanding bytes that may be consumed by indexing requests. When this limit is reached or exceeded, the node will reject new coordinating and primary operations. When replica operations consume 1.5x this limit, the node will reject new replica operations. Defaults to 10% of the heap.
* Hide store attributes Show store attributes object
* #### type string Required
Values arefs
,niofs
,mmapfs
, orhybridfs
.
* You can restrict the use of the mmapfs and the related hybridfs store type via the setting node.store.allow_mmap. This is a boolean setting indicating whether or not memory-mapping is allowed. The default is to allow it. This setting is useful, for example, if you are in an environment where you can not control the ability to create a lot of memory maps so you need disable the ability to use memory-mapping.
* Hide defaults attributes Show defaults attributes object
* Hide soft_deletes attributes Show soft_deletes attributes object
* Indicates whether soft deletes are enabled on the index.
* Hide retention_lease attribute Show retention_lease attribute object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Hide sort attributes Show sort attributes object
* field
string | array[string]
* #### order string | array[string]
Supported values include:asc
(orASC
),desc
(orDESC
)
Values areasc
,ASC
,desc
, orDESC
.
Values areasc
,ASC
,desc
, orDESC
.
* #### mode string | array[string]
Supported values include:min
(orMIN
),max
(orMAX
)
Values aremin
,MIN
,max
, orMAX
.
Values aremin
,MIN
,max
, orMAX
.
* #### missing string | array[string]
Supported values include:_last
,_first
Values are_last
or_first
.
Values are_last
or_first
.
* Values aretrue
,false
, orchecksum
.
* #### routing_partition_size number | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* #### auto_expand_replicas string | null
Anull
value that is to be interpreted as an actual value, unless other uses ofnull
that are equivalent to a missing value. It is used for exemple in settings, where using theNullValue
for a setting will reset it to its default value.
* Hide merge attribute Show merge attribute object
* Hide scheduler attributes Show scheduler attributes object
* #### max_thread_count number | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* #### max_merge_count number | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* Hide search attributes Show search attributes object
* Hide idle attribute Show idle attribute object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Hide slowlog attributes Show slowlog attributes object
* Hide threshold attributes Show threshold attributes object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Hide blocks attributes Show blocks attributes object
* #### read_only boolean | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* #### read_only_allow_delete boolean | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* #### read boolean | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* #### write boolean | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* #### metadata boolean | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* Hide analyze attribute Show analyze attribute object
* #### max_token_count number | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* Hide highlight attribute Show highlight attribute object
* Hide routing attributes Show routing attributes object
* Hide allocation attributes Show allocation attributes object
* Values areall
,primaries
,new_primaries
, ornone
.
* Hide include attributes Show include attributes object
* Hide initial_recovery attribute Show initial_recovery attribute object
* Hide disk attribute Show disk attribute object
* Hide rebalance attribute Show rebalance attribute object
* Values areall
,primaries
,replicas
, ornone
.
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Hide lifecycle attributes Show lifecycle attributes object
* #### indexing_complete boolean | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* If specified, this is the timestamp used to calculate the index age for its phase transitions. Use this setting if you create a new index that contains old data and want to use the original creation date to calculate the index age. Specified as a Unix epoch value in milliseconds.
* Set to true to parse the origination date from the index name. This origination date is used to calculate the index age for its phase transitions. The index name must match the pattern .*-{date_format}-\d+, where the date_format is yyyy.MM.dd and the trailing digits are optional. An index that was rolled over would normally match the full format, for example logs-2016.10.31-000002). If the index name doesn’t match the pattern, index creation fails.
* Hide step attribute Show step attribute object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* The index alias to update when the index rolls over. Specify when using a policy that contains a rollover action. When the index rolls over, the alias is updated to reflect that the index is no longer the write index. For more information about rolling indices, see Rollover.
* #### prefer_ilm boolean | string
Preference for the system that manages a data stream backing index (preferring ILM when both ILM and DLM are applicable for an index).
* #### creation_date number | string
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
Time unit for milliseconds
* #### creation_date_string string | number
A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
Time unit for milliseconds
* Hide version attributes Show version attributes object
* Hide translog attributes Show translog attributes object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Values arerequest
,REQUEST
,async
, orASYNC
.
* Hide retention attributes Show retention attributes object
* #### size number | string
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Hide query_string attribute Show query_string attribute object
* #### lenient boolean | string Required
Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.
Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.
* Hide analysis attributes Show analysis attributes object
* Hide time_series attributes Show time_series attributes object
* #### end_time string | number
A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
Time unit for milliseconds
* #### start_time string | number
A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.
Time unit for milliseconds
* Hide queries attribute Show queries attribute object
* Hide cache attribute Show cache attribute object
* Configure custom similarity settings to customize how search results are scored.
* Hide mapping attributes Show mapping attributes object
* Hide total_fields attributes Show total_fields attributes object
* #### limit number | string
The maximum number of fields in an index. Field and object mappings, as well as field aliases count towards this limit. The limit is in place to prevent mappings and searches from becoming too large. Higher values can lead to performance degradations and memory issues, especially in clusters with a high load or few resources.
* #### ignore_dynamic_beyond_limit boolean | string
This setting determines what happens when a dynamically mapped field would exceed the total fields limit. When set to false (the default), the index request of the document that tries to add a dynamic field to the mapping will fail with the message Limit of total fields [X] has been exceeded. When set to true, the index request will not fail. Instead, fields that would exceed the limit are not added to the mapping, similar to dynamic: false. The fields that were not added to the mapping will be added to the _ignored field.
* Hide depth attribute Show depth attribute object
* The maximum depth for a field, which is measured as the number of inner objects. For instance, if all fields are defined at the root object level, then the depth is 1. If there is one object mapping, then the depth is 2, etc.
* Hide nested_fields attribute Show nested_fields attribute object
* The maximum number of distinct nested mappings in an index. The nested type should only be used in special cases, when arrays of objects need to be queried independently of each other. To safeguard against poorly designed mappings, this setting limits the number of unique nested types per index.
* Hide nested_objects attribute Show nested_objects attribute object
* The maximum number of nested JSON objects that a single document can contain across all nested types. This limit helps to prevent out of memory errors when a document contains too many nested objects.
* Hide field_name_length attribute Show field_name_length attribute object
* Setting for the maximum length of a field name. This setting isn’t really something that addresses mappings explosion but might still be useful if you want to limit the field length. It usually shouldn’t be necessary to set this setting. The default is okay unless a user starts to add a huge number of fields with really long names. Default isLong.MAX_VALUE
(no limit).
* Hide dimension_fields attribute Show dimension_fields attribute object
* [preview] This functionality is in technical preview and may be changed or removed in a future release. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features.
* Hide source attribute Show source attribute object
* Values aredisabled
,stored
, orsynthetic
.
* Hide indexing.slowlog attributes Show indexing.slowlog attributes object
* Hide threshold attribute Show threshold attribute object
* Hide index attributes Show index attributes object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Hide indexing_pressure attribute Show indexing_pressure attribute object
* Hide memory attribute Show memory attribute object
* Number of outstanding bytes that may be consumed by indexing requests. When this limit is reached or exceeded, the node will reject new coordinating and primary operations. When replica operations consume 1.5x this limit, the node will reject new replica operations. Defaults to 10% of the heap.
* Hide store attributes Show store attributes object
* #### type string Required
Values arefs
,niofs
,mmapfs
, orhybridfs
.
* You can restrict the use of the mmapfs and the related hybridfs store type via the setting node.store.allow_mmap. This is a boolean setting indicating whether or not memory-mapping is allowed. The default is to allow it. This setting is useful, for example, if you are in an environment where you can not control the ability to create a lot of memory maps so you need disable the ability to use memory-mapping.
* Hide lifecycle attributes Show lifecycle attributes object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* Hide downsampling attribute Show downsampling attribute object
* The list of downsampling rounds to execute as part of this downsampling configuration
Hide rounds attributes Show rounds attributes object
* A duration. Units can benanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.
* If defined, it turns data stream lifecycle on/off (true
/false
) for this data stream. A data stream lifecycle that's disabled (enabled:false
) will have no effect on the data stream.
- Hide generated_dest_index attributes Show generated_dest_index attributes object