API создания индекса

Каждый созданный индекс может иметь определённые настройки, которые определяются в теле запроса:

PUT /my-index-000001
{
  "settings": {
    "index": {
      "number_of_shards": 3,  
      "number_of_replicas": 2 
    }
  }
}

или более упрощённо

PUT /my-index-000001
{
  "settings": {
    "number_of_shards": 3,
    "number_of_replicas": 2
  }
}

Для получения дополнительной информации о всех различных настройках уровня индекса, которые можно задать при создании индекса, см. раздел модули индексов.

API для создания индекса позволяет задавать определение карты:

PUT /test
{
  "settings": {
    "number_of_shards": 1
  },
  "mappings": {
    "properties": {
      "field1": { "type": "text" }
    }
  }
}

API для создания индекса также позволяет задать набор псевдонимов:

PUT /test
{
  "aliases": {
    "alias_1": {},
    "alias_2": {
      "filter": {
        "term": { "user.id": "kimchy" }
      },
      "routing": "shard-1"
    }
  }
}

Имена псевдонимов индексов также поддерживают date math.

PUT /logs
{
  "aliases": {
    "<logs_{now/M}>": {}
  }
}

По умолчанию создание индекса вернёт ответ клиенту только когда будут запущены первичные копии каждого фрагмента или истечёт время ожидания. Ответ на создание индекса укажет, что произошло:

{
  "acknowledged": true,
  "shards_acknowledged": true,
  "index": "logs"
}

acknowledged указывает, был ли индекс успешно создан в кластере, а shards_acknowledged указывает, было ли запущено требуемое количество копий фрагментов для каждого фрагмента в индексе до истечения времени ожидания. Обратите внимание, что acknowledged или shards_acknowledged могут быть false, но создание индекса было успешным. Эти значения просто указывают, завершилась ли операция до истечения времени ожидания. Если acknowledged равно false, тогда время ожидания истекло до того, как состояние кластера было обновлено с созданным индексом, но он, вероятно, будет создан вскоре. Если shards_acknowledged равно false, тогда время ожидания истекло до того, как было запущено требуемое количество фрагментов (по умолчанию только первичные), даже если состояние кластера было успешно обновлено, чтобы отразить недавно созданный индекс (т.е. acknowledged=true).

Мы можем изменить стандартное ожидание только первичных фрагментов через настройку индекса index.write.wait_for_active_shards (обратите внимание, что изменение этой настройки также повлияет на значение wait_for_active_shards во всех последующих операциях записи):

PUT /test
{
  "settings": {
    "index.write.wait_for_active_shards": "2"
  }
}

или через параметр запроса wait_for_active_shards:

PUT /test?wait_for_active_shards=2

Подробное объяснение wait_for_active_shards и его возможных значений можно найти здесь.