Files
elasticsearch-js/docs/reference/api/IndicesSimulateTemplateRequest.md
2025-05-28 10:02:30 -05:00

4.3 KiB

IndicesSimulateTemplateRequest [interface-IndicesSimulateTemplateRequest]

Name Type Description
_meta Metadata Optional user metadata about the index template. May have any contents. This map is not automatically generated by Elasticsearch.
allow_auto_create boolean This setting overrides the value of the action.auto_create_index cluster setting. If set to true in a template, then indices can be automatically created using that template even if auto-creation of indices is disabled via actions.auto_create_index. If set to false, then indices or data streams matching the template must always be explicitly created, and may never be automatically created.
body string ({ [key: string]: any; } & { name?: never; create?: never; cause?: never; master_timeout?: never; include_defaults?: never; allow_auto_create?: never; index_patterns?: never; composed_of?: never; template?: never; data_stream?: never; priority?: never; version?: never; _meta?: never; ignore_missing_component_templates?: never; deprecated?: never; })
cause string User defined reason for dry-run creating the new template for simulation purposes
composed_of Name[] 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.
create boolean If true, the template passed in the body is only used if no existing templates match the same index patterns. If false, the simulation uses the template with the highest priority. Note that the template is not permanently added or updated in either case; it is only used for the simulation.
data_stream IndicesDataStreamVisibility 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_stream object.
deprecated boolean 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_templates string[] The configuration option ignore_missing_component_templates can be used when an index template references a component template that might not exist
include_defaults boolean If true, returns all relevant default configurations for the index template.
index_patterns Indices Array of wildcard ( *) expressions used to match the names of data streams and indices during creation.
master_timeout Duration 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.
name Name Name of the index template to simulate. To test a template configuration before you add it to the cluster, omit this parameter and specify the template configuration in the request body.
priority long 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.
querystring { [key: string]: any; } & { name?: never; create?: never; cause?: never; master_timeout?: never; include_defaults?: never; allow_auto_create?: never; index_patterns?: never; composed_of?: never; template?: never; data_stream?: never; priority?: never; version?: never; _meta?: never; ignore_missing_component_templates?: never; deprecated?: never; } All values in querystring will be added to the request querystring.
template IndicesPutIndexTemplateIndexTemplateMapping Template to be applied. It may optionally include an aliases, mappings, or settings configuration.
version VersionNumber Version number used to manage index templates externally. This number is not automatically generated by Elasticsearch.