› › ›

API создания или обновления псевдонимов обученных моделей

Создаёт или обновляет псевдоним обученной модели.

Псевдоним обученной модели — это логическое имя, используемое для ссылки на одну обученную модель.

Запрос

PUT _ml/trained_models/<model_id>/model_aliases/<model_alias>

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

Требуется привилегия кластера manage_ml. Эта привилегия включена в встроенную роль machine_learning_admin.

Описание

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

Псевдоним должен быть уникальным и ссылаться только на одну обученную модель. Однако вы можете иметь несколько псевдонимов для каждой обученной модели.

Ограничения API:

Вам не разрешается обновлять псевдоним таким образом, чтобы он ссылался на другой идентификатор обученной модели, и модель использует другой тип аналитики на основе фреймов данных. Например, эта ситуация возникает, если у вас есть обученная модель для регрессионного анализа и обученная модель для классификационного анализа; вы не можете переназначить псевдоним от одного типа обученной модели к другому.
Вы не можете обновлять псевдоним из модели pytorch и модели аналитики на основе фреймов данных.
Вы не можете обновить псевдоним из развернутой модели pytorch на модель, которая в данный момент не развернута.

Если вы используете этот API для обновления псевдонима, и между старой и новой обученными моделями для псевдонима модели существует очень мало общих входных данных, API возвращает предупреждение.

Параметры пути

model_alias: (Обязательно, строка) Псевдоним для создания или обновления. Это значение не может заканчиваться цифрами.
model_id: (Обязательно, строка) Идентификатор обученной модели, на которую ссылается псевдоним.

Параметры запроса

reassign: (Необязательно, логическое значение) Указывает, переназначается ли псевдоним указанной обученной модели, если он уже назначен другой модели. Если псевдоним уже назначен, и этот параметр равен false, API возвращает ошибку. По умолчанию значение false.

Примеры

Создание псевдонима обученной модели

Следующий пример показывает, как создать псевдоним (flight_delay_model) для обученной модели (flight-delay-prediction-1574775339910):

resp = client.ml.put_trained_model_alias(
    model_id="flight-delay-prediction-1574775339910",
    model_alias="flight_delay_model",
)
print(resp)

response = client.ml.put_trained_model_alias(
  model_id: 'flight-delay-prediction-1574775339910',
  model_alias: 'flight_delay_model'
)
puts response

const response = await client.ml.putTrainedModelAlias({
  model_id: "flight-delay-prediction-1574775339910",
  model_alias: "flight_delay_model",
});
console.log(response);

PUT _ml/trained_models/flight-delay-prediction-1574775339910/model_aliases/flight_delay_model

Обновление псевдонима обученной модели

Следующий пример показывает, как переназначить псевдоним (flight_delay_model) другой обученной модели (flight-delay-prediction-1580004349800):

resp = client.ml.put_trained_model_alias(
    model_id="flight-delay-prediction-1580004349800",
    model_alias="flight_delay_model",
    reassign=True,
)
print(resp)

response = client.ml.put_trained_model_alias(
  model_id: 'flight-delay-prediction-1580004349800',
  model_alias: 'flight_delay_model',
  reassign: true
)
puts response

const response = await client.ml.putTrainedModelAlias({
  model_id: "flight-delay-prediction-1580004349800",
  model_alias: "flight_delay_model",
  reassign: "true",
});
console.log(response);

PUT _ml/trained_models/flight-delay-prediction-1580004349800/model_aliases/flight_delay_model?reassign=true

© 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/put-trained-models-aliases.html