get-trained-models.asciidoc

Get trained models API

<titleabbrev>Get trained models</titleabbrev>

Retrieves configuration information for a trained model. [[ml-get-trained-models-request]] == {api-request-title} `GET _ml/trained_models/` + `GET _ml/trained_models/` + `GET _ml/trained_models/_all` + `GET _ml/trained_models/,` + `GET _ml/trained_models/` [[ml-get-trained-models-prereq]] == {api-prereq-title} Requires the `monitor_ml` cluster privilege. This privilege is included in the `machine_learning_user` built-in role. //[[ml-get-trained-models-desc]] //== {api-description-title} [[ml-get-trained-models-path-params]] == {api-path-parms-title} ``:: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + You can get information for multiple trained models in a single API request by using a comma-separated list of model IDs or a wildcard expression. [[ml-get-trained-models-query-params]] == {api-query-parms-title} `allow_no_match`:: (Optional, Boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `decompress_definition`:: (Optional, Boolean) Specifies whether the included model definition should be returned as a JSON map (`true`) or in a custom compressed format (`false`). Defaults to `true`. `exclude_generated`:: (Optional, Boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `from`:: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `include`:: (Optional, string) A comma delimited string of optional fields to include in the response body. The default value is empty, indicating no optional fields are included. Valid options are: - `definition`: Includes the model definition. - `feature_importance_baseline`: Includes the baseline for {feat-imp} values. - `hyperparameters`: Includes the information about hyperparameters used to train the model. This information consists of the value, the absolute and relative importance of the hyperparameter as well as an indicator of whether it was specified by the user or tuned during hyperparameter optimization. - `total_feature_importance`: Includes the total {feat-imp} for the training data set. - `definition_status`: Includes the field `fully_defined` indicating if the full model definition is present. The baseline and total {feat-imp} values are returned in the `metadata` field in the response body. `size`:: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `tags`:: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] [role="child_attributes"] [[ml-get-trained-models-results]] == {api-response-body-title} `trained_model_configs`:: (array) An array of trained model resources, which are sorted by the `model_id` value in ascending order. + .Properties of trained model resources [%collapsible%open] ==== `created_by`::: (string) The creator of the trained model. `create_time`::: (<>) The time when the trained model was created. `default_field_map` ::: (object) A string object that contains the default field map to use when inferring against the model. For example, {dfanalytics} may train the model on a specific multi-field `foo.keyword`. The analytics job would then supply a default field map entry for `"foo" : "foo.keyword"`. + Any field map described in the inference configuration takes precedence. `description`::: (string) The free-text description of the trained model. `model_size_bytes`::: (integer) The estimated model size in bytes to keep the trained model in memory. `estimated_operations`::: (integer) The estimated number of operations to use the trained model. `inference_config`::: (object) The default configuration for inference. This can be either a `regression` or `classification` configuration. It must match the `target_type` of the underlying `definition.trained_model`. + .Properties of `inference_config` [%collapsible%open] ===== `classification`:::: (object) Classification configuration for inference. + .Properties of classification inference [%collapsible%open] ====== `num_top_classes`::: (integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `num_top_feature_importance_values`::: (integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `prediction_field_type`::: (string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `results_field`::: (string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `top_classes_results_field`::: (string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ====== `fill_mask`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of fill_mask inference [%collapsible%open] ====== `tokenization`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of tokenization [%collapsible%open] ======= `bert`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of roberta [%collapsible%open] ======== `add_prefix_space`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `mpnet`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of mpnet [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `xlm_roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of xlm_roberta [%collapsible%open] ======== `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `bert_ja`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert_ja [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== ======= `vocabulary`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of vocabulary [%collapsible%open] ======= `index`:::: (Required, string) The index where the vocabulary is stored. ======= ====== `ner`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of ner inference [%collapsible%open] ====== `classification_labels`:::: (Optional, string) An array of classification labels. NER supports only Inside-Outside-Beginning labels (IOB) and only persons, organizations, locations, and miscellaneous. For example: `["O", "B-PER", "I-PER", "B-ORG", "I-ORG", "B-LOC", "I-LOC", "B-MISC", "I-MISC"]`. `tokenization`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of tokenization [%collapsible%open] ======= `bert`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of roberta [%collapsible%open] ======== `add_prefix_space`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `mpnet`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of mpnet [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `xlm_roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of xlm_roberta [%collapsible%open] ======== `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `bert_ja`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert_ja [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== ======= `vocabulary`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of vocabulary [%collapsible%open] ======= `index`:::: (Required, string) The index where the vocabulary is stored ======= ====== `pass_through`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of pass_through inference [%collapsible%open] ====== `tokenization`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of tokenization [%collapsible%open] ======= `bert`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of roberta [%collapsible%open] ======== `add_prefix_space`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `mpnet`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of mpnet [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `xlm_roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of xlm_roberta [%collapsible%open] ======== `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `bert_ja`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert_ja [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== ======= `vocabulary`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of vocabulary [%collapsible%open] ======= `index`:::: (Required, string) The index where the vocabulary is stored. ======= ====== `regression`:::: (object) Regression configuration for inference. + .Properties of regression inference [%collapsible%open] ====== `num_top_feature_importance_values`::: (integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `results_field`::: (string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ====== `text_classification`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of text_classification inference [%collapsible%open] ====== `classification_labels`:::: (Optional, string) An array of classification labels. `num_top_classes`:::: (Optional, integer) Specifies the number of top class predictions to return. Defaults to all classes (-1). `tokenization`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of tokenization [%collapsible%open] ======= `bert`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `span`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of roberta [%collapsible%open] ======== `add_prefix_space`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `span`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `mpnet`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of mpnet [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `span`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `xlm_roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of xlm_roberta [%collapsible%open] ======== `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `span`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `bert_ja`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert_ja [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `span`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== ======= `vocabulary`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of vocabulary [%collapsible%open] ======= `index`:::: (Required, string) The index where the vocabulary is stored. ======= ====== `text_embedding`:::: (Object, optional) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of text_embedding inference [%collapsible%open] ====== `embedding_size`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `results_field`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `tokenization`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of tokenization [%collapsible%open] ======= `bert`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of roberta [%collapsible%open] ======== `add_prefix_space`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `mpnet`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of mpnet [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `xlm_roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of xlm_roberta [%collapsible%open] ======== `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `bert_ja`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert_ja [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== ======= `vocabulary`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of vocabulary [%collapsible%open] ======= `index`:::: (Required, string) The index where the vocabulary is stored. ======= ====== `text_similarity`:::: (Object, optional) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of text_similarity inference [%collapsible%open] ====== `span_score_combination_function`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `tokenization`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of tokenization [%collapsible%open] ======= `bert`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `span`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of roberta [%collapsible%open] ======== `add_prefix_space`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `span`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `mpnet`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of mpnet [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `span`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `xlm_roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of xlm_roberta [%collapsible%open] ======== `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `span`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `bert_ja`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert_ja [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `span`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== ======= `vocabulary`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of vocabulary [%collapsible%open] ======= `index`:::: (Required, string) The index where the vocabulary is stored. ======= ====== `zero_shot_classification`:::: (Object, optional) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of zero_shot_classification inference [%collapsible%open] ====== `classification_labels`:::: (Required, array) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `hypothesis_template`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `labels`:::: (Optional, array) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `multi_label`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `tokenization`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of tokenization [%collapsible%open] ======= `bert`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of roberta [%collapsible%open] ======== `add_prefix_space`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `mpnet`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of mpnet [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `xlm_roberta`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of xlm_roberta [%collapsible%open] ======== `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== `bert_ja`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of bert_ja [%collapsible%open] ======== `do_lower_case`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max_sequence_length`:::: (Optional, integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `truncate`:::: (Optional, string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `with_special_tokens`:::: (Optional, boolean) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== ======= `vocabulary`:::: (Optional, object) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] + .Properties of vocabulary [%collapsible%open] ======= `index`:::: (Required, string) The index where the vocabulary is stored. ======= ====== ===== `input`::: (object) The input field names for the model definition. + .Properties of `input` [%collapsible%open] ===== `field_names`:::: (string) An array of input field names for the model. ===== `fully_defined`:: (boolean) True if the full model definition is present. This field is only present if `include=definition_status` was specified in the request. // Begin location `location`:: (Optional, object) The model definition location. Must be provided if the `definition` or `compressed_definition` are not provided. + .Properties of `location` [%collapsible%open] ===== `index`::: (Required, object) Indicates that the model definition is stored in an index. It is required to be empty as the index for storing model definitions is configured automatically. ===== // End location `license_level`:: (string) The license level of the trained model. `metadata`:: (object) An object containing metadata about the trained model. For example, models created by {dfanalytics} contain `analysis_config` and `input` objects. + .Properties of metadata [%collapsible%open] ===== `feature_importance_baseline`::: (object) An object that contains the baseline for {feat-imp} values. For {reganalysis}, it is a single value. For {classanalysis}, there is a value for each class. `hyperparameters`::: (array) List of the available hyperparameters optimized during the `fine_parameter_tuning` phase as well as specified by the user. + .Properties of hyperparameters [%collapsible%open] ====== `absolute_importance`:::: (double) A positive number showing how much the parameter influences the variation of the {ml-docs}/dfa-regression-lossfunction.html[loss function]. For hyperparameters with values that are not specified by the user but tuned during hyperparameter optimization. `max_trees`:::: (integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `name`:::: (string) Name of the hyperparameter. `relative_importance`:::: (double) A number between 0 and 1 showing the proportion of influence on the variation of the loss function among all tuned hyperparameters. For hyperparameters with values that are not specified by the user but tuned during hyperparameter optimization. `supplied`:::: (Boolean) Indicates if the hyperparameter is specified by the user (`true`) or optimized (`false`). `value`:::: (double) The value of the hyperparameter, either optimized or specified by the user. ====== `total_feature_importance`::: (array) An array of the total {feat-imp} for each feature used from the training data set. This array of objects is returned if {dfanalytics} trained the model and the request includes `total_feature_importance` in the `include` request parameter. + .Properties of total {feat-imp} [%collapsible%open] ====== `feature_name`::: (string) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `importance`::: (object) A collection of {feat-imp} statistics related to the training data set for this particular feature. + .Properties of {feat-imp} [%collapsible%open] ======= `mean_magnitude`::: (double) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max`::: (integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `min`::: (integer) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======= `classes`::: (array) If the trained model is a classification model, {feat-imp} statistics are gathered per target class value. + .Properties of class {feat-imp} [%collapsible%open] ======= `class_name`::: (string) The target class value. Could be a string, boolean, or number. `importance`::: (object) A collection of {feat-imp} statistics related to the training data set for this particular feature. + .Properties of {feat-imp} [%collapsible%open] ======== `mean_magnitude`::: (double) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `max`::: (int) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] `min`::: (int) link:{es-repo-dir}/ml/ml-shared.asciidoc[role=include] ======== ======= ====== ===== `model_id`:: (string) Identifier for the trained model. `model_type`:: (Optional, string) The created model type. By default the model type is `tree_ensemble`. Appropriate types are: + -- * `tree_ensemble`: The model definition is an ensemble model of decision trees. * `lang_ident`: A special type reserved for language identification models. * `pytorch`: The stored definition is a PyTorch (specifically a TorchScript) model. Currently only NLP models are supported. -- `tags`:: (string) A comma delimited string of tags. A trained model can have many tags, or none. `version`:: (string) The {es} version number in which the trained model was created. ==== [[ml-get-trained-models-response-codes]] == {api-response-codes-title} `400`:: If `include_model_definition` is `true`, this code indicates that more than one models match the ID pattern. `404` (Missing resources):: If `allow_no_match` is `false`, this code indicates that there are no resources that match the request or only partial matches for the request. [[ml-get-trained-models-example]] == {api-examples-title} The following example gets configuration information for all the trained models: [source,console] -------------------------------------------------- GET _ml/trained_models/ -------------------------------------------------- // TEST[skip:TBD]