› › ›

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

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

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

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

Запрос

GET /_migration/system_features

POST /_migration/system_features

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

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

Описание

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

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

Примеры

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

resp = client.migration.get_feature_upgrade_status()
print(resp)

response = client.migration.get_feature_upgrade_status
puts response

const response = await client.migration.getFeatureUpgradeStatus();
console.log(response);

GET /_migration/system_features

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

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

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

resp = client.migration.post_feature_upgrade()
print(resp)

response = client.migration.post_feature_upgrade
puts response

const response = await client.migration.postFeatureUpgrade();
console.log(response);

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/8.17/feature-migration-api.html