---
title: stack es ml put-trained-model cli command
description: Create a trained model. Behaviour flags: --dry-run — validate all inputs and exit without performing any action 
url: https://docs-v3-preview.elastic.dev/elastic/cli/pull/457/cli/stack/es/ml/put-trained-model
---

# stack es ml put-trained-model cli command
<cli-modifiers>
</cli-modifiers>

```bash
elastic stack es ml put-trained-model --model-id <model-id> [options]
```

Create a trained model.
**Behaviour flags:**
`--dry-run` — validate all inputs and exit without performing any action

## Options

<definitions>
  <definition term="--model-id string required">
    The unique identifier of the trained model.
  </definition>
  <definition term="--[no-]defer-definition-decompression">
    If set to `true` and a `compressed_definition` is provided, the request defers definition decompression and skips relevant validations.
  </definition>
  <definition term="--[no-]wait-for-completion">
    Whether to wait for all child operations (e.g. model download) to complete.
  </definition>
  <definition term="--compressed-definition string">
    The compressed (GZipped and Base64 encoded) inference definition of the model. If compressed_definition is specified, then definition cannot be specified.
  </definition>
  <definition term="--definition string">
    The inference definition for the model. If definition is specified, then compressed_definition cannot be specified.
  </definition>
  <definition term="--description string">
    A human-readable description of the inference trained model.
  </definition>
  <definition term="--inference-config string">
    The default configuration for inference. This can be either a regression or classification configuration. It must match the underlying definition.trained_model's target_type. For pre-packaged models such as ELSER the config is not required.
  </definition>
  <definition term="--input string">
    The input field names for the model definition.
  </definition>
  <definition term="--metadata string">
    An object map that contains metadata about the model.
  </definition>
  <definition term="--model-type string">
    The model type.
  </definition>
  <definition term="--model-size-bytes number">
    The estimated memory usage in bytes to keep the trained model in memory. This property is supported only if defer_definition_decompression is true or the model definition is not supplied.
  </definition>
  <definition term="--platform-architecture string">
    The platform architecture (if applicable) of the trained mode. If the model only works on one platform, because it is heavily optimized for a particular processor architecture and OS combination, then this field specifies which. The format of the string must match the platform identifiers used by Elasticsearch, so one of, `linux-x86_64`, `linux-aarch64`, `darwin-x86_64`, `darwin-aarch64`, or `windows-x86_64`. For portable models (those that work independent of processor architecture or OS features), leave this field unset.
  </definition>
  <definition term="--tags string[]">
    An array of tags to organize the model.
  </definition>
  <definition term="--prefix-strings string">
    Optional prefix strings applied at inference
  </definition>
  <definition term="--input-file string">
    path to a JSON file to use as command input
  </definition>
  <definition term="--[no-]dry-run">
    validate all inputs and exit without performing any action (preview changes without applying them)
  </definition>
</definitions>


## Global Options

<definitions>
  <definition term="--[no-]json">
    output as JSON
  </definition>
</definitions>