Create part of a trained model definition

PUT /_ml/trained_models/{model_id}/definition/{part}

Required authorization

Authentication

Authorization: <value>

Elasticsearch APIs use key-based authentication. You must create an API key and use the encoded value in the request header. For example:

		curl -X GET "${ES_URL}/_cat/indices?v=true" \
  -H "Authorization: ApiKey ${API_KEY}"

For more information about where to find API keys for the Elasticsearch endpoint (${ES_URL}) for a project, go to Get started with Elasticsearch Serverless.

Path parameters

Request body

Response

application/json

Examples

Request Console 1 / 8 languages

An example body for a PUT _ml/trained_models/elastic__distilbert-base-uncased-finetuned-conll03-english/definition/0 request.

Console Kibana Dev Tools

PUT _ml/trained_models/elastic__distilbert-base-uncased-finetuned-conll03-english/definition/0
{
    "definition": "...",
    "total_definition_length": 265632637,
    "total_parts": 64
}

JavaScript Elasticsearch JavaScript Client

const response = await client.ml.putTrainedModelDefinitionPart({
  model_id: "elastic__distilbert-base-uncased-finetuned-conll03-english",
  part: 0,
  definition: "...",
  total_definition_length: 265632637,
  total_parts: 64,
});

Python Elasticsearch Python Client

resp = client.ml.put_trained_model_definition_part(
    model_id="elastic__distilbert-base-uncased-finetuned-conll03-english",
    part="0",
    definition="...",
    total_definition_length=265632637,
    total_parts=64,
)

curl Shell

curl -X PUT "$ELASTICSEARCH_URL/_ml/trained_models/elastic__distilbert-base-uncased-finetuned-conll03-english/definition/0" \
  -H "Authorization: ApiKey $ELASTIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "definition": "...",
    "total_definition_length": 265632637,
    "total_parts": 64
  }'

Java Elasticsearch Java Client

client.ml().putTrainedModelDefinitionPart(p -> p
    .definition("...")
    .modelId("elastic__distilbert-base-uncased-finetuned-conll03-english")
    .part(0)
    .totalDefinitionLength(265632637L)
    .totalParts(64)
);

C# Elasticsearch .NET Client

var response = await client.MachineLearning
    .PutTrainedModelDefinitionPartAsync(modelId: "elastic__distilbert-base-uncased-finetuned-conll03-english", part: 0, d1 => d1
        .Definition("...")
        .TotalDefinitionLength(265632637L)
        .TotalParts(64)
    );

PHP Elasticsearch PHP Client

$resp = $client->ml()->putTrainedModelDefinitionPart([
    "model_id" => "elastic__distilbert-base-uncased-finetuned-conll03-english",
    "part" => "0",
    "body" => [
        "definition" => "...",
        "total_definition_length" => 265632637,
        "total_parts" => 64,
    ],
]);

Ruby Elasticsearch Ruby Client

response = client.ml.put_trained_model_definition_part(
  model_id: "elastic__distilbert-base-uncased-finetuned-conll03-english",
  part: "0",
  body: {
    "definition": "...",
    "total_definition_length": 265632637,
    "total_parts": 64
  }
)

Response

No example

Required authorization

Authentication

Path parameters

Request body { }

Response

Request body