stack es cluster put-component-template cli command
Auth required
Idempotent
Scope: global
elastic stack es cluster put-component-template \
--template <template> \
--name <name> \
[options]
Create or update a component template.
Behaviour flags:
--dry-run — validate all inputs and exit without performing any action
--templatestringrequired- The template to be applied which includes mappings, settings, or aliases configuration.
--namestringrequired- Name of the component template to create.
Elasticsearch includes the following built-in component templates:
logs-mappings;logs-settings;metrics-mappings;metrics-settings;synthetics-mapping;synthetics-settings. Elastic Agent uses these templates to configure backing indices for its data streams. If you use Elastic Agent and want to overwrite one of these templates, set theversionfor your replacement template higher than the current version. If you don’t use Elastic Agent and want to disable all built-in component and index templates, setstack.templates.enabledtofalseusing the cluster update settings API. --create- If
true, this request cannot replace or update existing component templates. --causestring- User defined reason for create the component template.
--master-timeoutstring- 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.
--versionnumber- Version number used to manage component templates externally. This number isn't automatically generated or incremented by Elasticsearch. To unset a version, replace the template without specifying a version.
--metastring- Optional user metadata about the component template.
It may have any contents. This map is not automatically generated by Elasticsearch.
This information is stored in the cluster state, so keeping it short is preferable.
To unset
_meta, replace the template without specifying this information. --deprecated- 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.
--error-trace- When set to
trueElasticsearch will include the full stack trace of errors when they occur. --filter-pathstring-
Comma-separated list of filters in dot notation which reduce the response returned by Elasticsearch.
Repeatable: pass
--filter-pathmultiple times to supply more than one value --human- When set to
truewill return statistics in a format suitable for humans. For example"exists_time": "1h"for humans and"exists_time_in_millis": 3600000for computers. When disabled the human readable values will be omitted. This makes sense for responses being consumed only by machines. --pretty- If set to
truethe returned JSON will be "pretty-formatted". Only use this option for debugging only. --input-filestring- path to a JSON file to use as command input
--dry-run- validate all inputs and exit without performing any action (preview changes without applying them)
--json-
output as JSON