Simulate an index
- POST /_index_template/_simulate_index/{name}
Get the index configuration that would be applied to the specified index from an existing index template.
- Cluster privileges:
manage_index_templates
Path Parameters
-
namestring Namerequired -
Name of the index to simulate
Query Parameters
-
createboolean · default: false Whether the index template we optionally defined in the body should only be dry-run added if new or can also replace an existing one
-
causestring · default: false User defined reason for dry-run creating the new template for simulation purposes
-
master_timeoutstring Duration · default: 30s Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.
-
include_defaultsboolean · default: false If true, returns all relevant default configurations for the index template.
Request
-
index_patternsstring Namesrequired -
Array of wildcard (
*) expressions used to match the names of data streams and indices during creation. -
composed_ofstring Namerequired -
An ordered list of component template names. Component templates are merged in the order specified, meaning that the last component template specified has the highest precedence.
-
templateIndexTemplateSummary -
Template to be applied. It may optionally include an
aliases,mappings, orsettingsconfiguration. -
aliasesmap string to Alias -
Aliases to add. If the index template includes a
data_streamobject, these are data stream aliases. Otherwise, these are index aliases. Data stream aliases ignore theindex_routing,routing, andsearch_routingoptions. -
<string>Alias -
filterQueryContainer -
Query used to limit documents the alias can access.
-
index_routingstring -
Value used to route indexing operations to a specific shard. If specified, this overwrites the
routingvalue for indexing operations. -
If
true, the alias is hidden. All indices for the alias must have the sameis_hiddenvalue. -
is_write_indexboolean · default: false -
If
true, the index is the write index for the alias. -
routingstring -
Value used to route indexing and search operations to a specific shard.
-
search_routingstring -
Value used to route search operations to a specific shard. If specified, this overwrites the
routingvalue for search operations. -
mappingsTypeMapping -
Mapping for fields in the index. If specified, this mapping can include field names, field data types, and mapping parameters.
-
all_fieldAllField -
analyzerstringrequired -
enabledbooleanrequired -
omit_normsbooleanrequired -
search_analyzerstringrequired -
similaritystringrequired -
storebooleanrequired -
store_term_vector_offsetsbooleanrequired -
store_term_vector_payloadsbooleanrequired -
store_term_vector_positionsbooleanrequired -
store_term_vectorsbooleanrequired -
date_detectionboolean -
dynamicDynamicMapping -
Values:
strictruntimetruefalse -
dynamic_date_formatsstring -
dynamic_templatesstring to DynamicTemplate -
_field_namesFieldNamesField -
enabledbooleanrequired -
index_fieldIndexField -
enabledbooleanrequired -
_metaMetadata -
numeric_detectionboolean -
propertiesmap string to Property -
_sourceSourceField -
runtimemap string to RuntimeField -
<string>RuntimeField -
fieldsmap string to CompositeSubField -
For type
composite -
<string>CompositeSubField -
typeRuntimeFieldTyperequired -
Values:
booleancompositedatedoublegeo_pointgeo_shapeipkeywordlonglookup -
formatstring -
A custom format for
datetype runtime fields. -
input_fieldstring Field -
For type
lookup -
target_fieldstring Field -
For type
lookup -
target_indexstring IndexName -
For type
lookup -
scriptstring Script -
Painless script executed at query time.
-
on_script_errorOnScriptError -
Values:
failcontinue -
typeRuntimeFieldTyperequired -
Field type, which can be:
boolean,composite,date,double,geo_point,ip,keyword,long, orlookup. -
Values:
booleancompositedatedoublegeo_pointgeo_shapeipkeywordlonglookup -
enabledboolean -
subobjectsSubobjects -
Values:
truefalse -
_data_stream_timestampDataStreamTimestamp -
enabledbooleanrequired -
settingsIndexSettings -
Configuration options for the index.
-
lifecycleDataStreamLifecycle -
data_retentionstring Duration -
If defined, every document added to this data stream will be stored at least for this time frame. Any time after this duration the document could be deleted. When empty, every document in this data stream will be stored indefinitely.
-
effective_retentionstring Duration -
The least amount of time data should be kept by elasticsearch.
-
retention_determined_byRetentionSource -
Configuration source that can influence the retention of a data stream.
-
Values:
data_stream_configurationdefault_global_retentionmax_global_retentiondefault_failures_retention -
downsamplingDownsamplingRound -
The list of downsampling rounds to execute as part of this downsampling configuration
-
afterstring Durationrequired -
The duration since rollover when this downsampling round should execute
-
fixed_intervalstringrequired -
The downsample interval.
-
downsampling_methodSamplingMethod -
The method used to downsample the data. There are two options
aggregateandlast_value. It requiresdownsamplingto be defined. Defaults toaggregate. -
Values:
aggregatelast_value -
enabledboolean · default: true -
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. -
data_stream_optionsDataStreamOptions -
failure_storeDataStreamFailureStore -
If defined, it specifies configuration for the failure store of this data stream.
-
enabledboolean · default: true -
If defined, it turns the failure store on/off (
true/false) for this data stream. A data stream failure store that's disabled (enabled:false) will redirect no new failed indices to the failure store; however, it will not remove any existing data from the failure store. -
lifecycleFailureStoreLifecycle -
If defined, it specifies the lifecycle configuration for the failure store of this data stream.
-
data_retentionstring Duration -
If defined, every document added to this data stream will be stored at least for this time frame. Any time after this duration the document could be deleted. When empty, every document in this data stream will be stored indefinitely.
-
enabledboolean · default: true -
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. -
versionnumber VersionNumber -
Version number used to manage index templates externally. This number is not automatically generated by Elasticsearch.
-
prioritynumber -
Priority to determine index template precedence when a new data stream or index is created. The index template with the highest priority is chosen. If no priority is specified the template is treated as though it is of priority 0 (lowest priority). This number is not automatically generated by Elasticsearch.
-
_metaMetadata -
Optional user metadata about the index template. May have any contents. This map is not automatically generated by Elasticsearch.
-
allow_auto_createboolean -
data_streamIndexTemplateDataStreamConfiguration -
If this object is included, the template is used to create data streams and their backing indices. Supports an empty object. Data streams require a matching index template with a
data_streamobject. -
If true, the data stream is hidden.
-
allow_custom_routingboolean · default: false -
If true, the data stream supports custom routing.
-
deprecatedboolean -
Marks this index template as deprecated. When creating or updating a non-deprecated index template that uses deprecated components, Elasticsearch will emit a deprecation warning.
-
ignore_missing_component_templatesstring Names -
A list of component template names that are allowed to be absent.
-
created_dateDateTime -
Date and time when the index template was created. Only returned if the
humanquery parameter istrue. -
created_date_millisEpochTimeUnitMillis -
Date and time when the index template was created, in milliseconds since the epoch.
-
modified_dateDateTime -
Date and time when the index template was last modified. Only returned if the
humanquery parameter istrue. -
modified_date_millisEpochTimeUnitMillis -
Date and time when the index template was last modified, in milliseconds since the epoch.
Response
-
overlappingOverlapping -
namestring Namerequired -
index_patternsstringrequired -
templateTemplaterequired -
aliasesmap string to Aliasrequired -
<string>Alias -
filterQueryContainer -
Query used to limit documents the alias can access.
-
index_routingstring -
Value used to route indexing operations to a specific shard. If specified, this overwrites the
routingvalue for indexing operations. -
If
true, the alias is hidden. All indices for the alias must have the sameis_hiddenvalue. -
is_write_indexboolean · default: false -
If
true, the index is the write index for the alias. -
routingstring -
Value used to route indexing and search operations to a specific shard.
-
search_routingstring -
Value used to route search operations to a specific shard. If specified, this overwrites the
routingvalue for search operations. -
mappingsTypeMappingrequired -
settingsIndexSettingsrequired