› › ›

API миграции функций

Эти API предназначены для косвенного использования помощником по обновлению Kibana Upgrade Assistant. Мы настоятельно рекомендуем использовать Upgrade Assistant для обновления с 7.17 до 8.0 и более поздних версий. Инструкции по обновлению см. в Обновление до Elastic 7.17.28.

Обновления версий иногда требуют изменений в том, как функции хранят конфигурационную информацию и данные в системных индексах. API миграции функций позволяют просмотреть, какие функции требуют изменений, инициировать автоматический процесс миграции и проверить статус миграции.

Некоторые функции могут быть временно недоступны во время процесса миграции.

Запрос

GET /_migration/system_features

POST /_migration/system_features

Предварительные условия

Если функции безопасности Elasticsearch включены, у вас должна быть manage право доступа на кластер, чтобы использовать этот API.

Описание

Отправьте GET-запрос к _migration/system_features конечной точке, чтобы узнать, какие функции необходимо мигрировать и статус любых миграций, которые находятся в процессе.

Отправьте POST-запрос к конечной точке, чтобы начать процесс миграции.

Примеры

При отправке GET-запроса на _migration/system_features конечную точку, ответ указывает статус любых функций, которые нуждаются в миграции.

GET /_migration/system_features

Пример ответа:

{
  "features" : [
    {
      "feature_name" : "async_search",
      "minimum_index_version" : "7.0.0",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "enrich",
      "minimum_index_version" : "7.0.0",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "fleet",
      "minimum_index_version" : "7.0.0",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "geoip",
      "minimum_index_version" : "7.0.0",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "kibana",
      "minimum_index_version" : "7.0.0",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "logstash_management",
      "minimum_index_version" : "7.0.0",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "machine_learning",
      "minimum_index_version" : "7.0.0",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "searchable_snapshots",
      "minimum_index_version" : "7.0.0",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "security",
      "minimum_index_version" : "7.0.0",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "tasks",
      "minimum_index_version" : "7.0.0",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "transform",
      "minimum_index_version" : "7.0.0",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    },
    {
      "feature_name" : "watcher",
      "minimum_index_version" : "7.0.0",
      "migration_status" : "NO_MIGRATION_NEEDED",
      "indices" : [ ]
    }
  ],
  "migration_status" : "NO_MIGRATION_NEEDED"
}

При отправке POST-запроса на _migration/system_features конечную точку для запуска процесса миграции, ответ указывает, какие функции будут мигрированы.

POST /_migration/system_features

Пример ответа:

{
  "accepted" : true,
  "features" : [
    {
      "feature_name" : "security" 
    }
  ]
}

Безопасность Elasticsearch будет мигрирована перед обновлением кластера.

Последующие GET-запросы вернут статус процесса миграции.

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/feature-migration-api.html