API создания или обновления шаблона индекса

Вы можете использовать комментарии блочного типа /* */ в стиле C в шаблонах индексов. Вы можете включать комментарии в любом месте тела запроса, кроме части перед открывающей фигурной скобкой.

См. API получения шаблона индекса (устаревшая версия).

Вы можете включить псевдонимы индексов в шаблон индекса.

PUT _template/template_1
{
  "index_patterns" : ["te*"],
  "settings" : {
    "number_of_shards" : 1
  },
  "aliases" : {
    "alias1" : {},
    "alias2" : {
      "filter" : {
        "term" : {"user.id" : "kimchy" }
      },
      "routing" : "shard-1"
    },
    "{index}-alias" : {} 
  }
}

Несколько шаблонов индексов могут потенциально соответствовать индексу, в этом случае настройки и сопоставления объединяются в окончательную конфигурацию индекса. Порядок объединения можно контролировать с помощью параметра order, при этом шаблоны с более низким порядком применяются первыми, а шаблоны с более высоким порядком переопределяют их. Например:

PUT /_template/template_1
{
  "index_patterns" : ["te*"],
  "order" : 0,
  "settings" : {
    "number_of_shards" : 1
  },
  "mappings" : {
    "_source" : { "enabled" : false }
  }
}

PUT /_template/template_2
{
  "index_patterns" : ["tes*"],
  "order" : 1,
  "settings" : {
    "number_of_shards" : 1
  },
  "mappings" : {
    "_source" : { "enabled" : true }
  }
}

Вышеуказанное действие отключит сохранение _source, но для индексов, начинающихся с tes*, _source по-прежнему будет включено. Обратите внимание, что для сопоставлений объединение выполняется «глубоко», что означает, что специфические сопоставления на основе объектов/свойств могут легко добавляться/переопределяться в шаблонах более высокого порядка, при этом шаблоны более низкого порядка предоставляют базу.

Вы можете использовать параметр version, чтобы добавить необязательный номер версии к шаблону индекса. Внешние системы могут использовать эти номера версий для упрощения управления шаблонами.

Параметр version полностью необязателен и не генерируется автоматически Elasticsearch.

Для отмены version замените шаблон без указания номера версии.

PUT /_template/template_1
{
  "index_patterns" : ["my-index-*"],
  "order" : 0,
  "settings" : {
    "number_of_shards" : 1
  },
  "version": 123
}

Чтобы проверить version, можно использовать API получения шаблона индекса с параметром запроса filter_path для возвращения только номера версии:

GET /_template/template_1?filter_path=*.version

API возвращает следующий ответ:

{
  "template_1" : {
    "version" : 123
  }
}