root
/
elasticsearch
mirror of https://github.com/elastic/elasticsearch.git
1
0
Fork 0
Code Issues Actions 1 Packages Projects Releases Wiki Activity
elasticsearch/docs/reference/inference/delete-inference.asciidoc

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

85 lines
2.4 KiB
Plaintext
Raw Normal View History

[DOCS] Adds reference documentation for inference API (#99658) * [DOCS] Creates documentation structure. * [DOCS] Adds PUT inference API docs and part of GET inference API docs. * [DOCS] Fixes complaining CI. * [DOCS] Adds GET and DELETE API docs for inference API. * [DOCS] Adds POST inference API docs. * Apply suggestions from code review
2023-09-29 16:12:07 +08:00
[role="xpack"]
[[delete-inference-api]]
=== Delete {infer} API
[DOCS] More links to new API site (#119377)
2025-01-01 03:32:29 +08:00
.New API reference
[sidebar]
--
For the most up-to-date API details, refer to {api-es}/group/endpoint-inference[{infer-cap} APIs].
--
[DOCS] Makes Inference APIs main page more informative. (#107100)
2024-04-04 21:42:03 +08:00
Deletes an {infer} endpoint.
[DOCS] Documents watsonx service of the Inference API (#115088) Co-authored-by: Saikat Sarkar <132922331+saikatsarkar056@users.noreply.github.com>
2024-10-21 15:41:55 +08:00
IMPORTANT: The {infer} APIs enable you to use certain services, such as built-in {ml} models (ELSER, E5), models uploaded through Eland, Cohere, OpenAI, Azure, Google AI Studio, Google Vertex AI, Anthropic, Watsonx.ai, or Hugging Face.
For built-in models and models uploaded through Eland, the {infer} APIs offer an alternative way to use and manage trained models.
However, if you do not plan to use the {infer} APIs to use these models or if you want to use non-NLP models, use the <<ml-df-trained-models-apis>>.
[DOCS] Expands inference API docs (#104047) Co-authored-by: David Kyle <david.kyle@elastic.co>
2024-01-09 22:46:46 +08:00
[DOCS] Adds reference documentation for inference API (#99658) * [DOCS] Creates documentation structure. * [DOCS] Adds PUT inference API docs and part of GET inference API docs. * [DOCS] Fixes complaining CI. * [DOCS] Adds GET and DELETE API docs for inference API. * [DOCS] Adds POST inference API docs. * Apply suggestions from code review
2023-09-29 16:12:07 +08:00
[discrete]
[[delete-inference-api-request]]
==== {api-request-title}
[DOCS] Changes model_id path param to inference_id (#106719)
2024-03-26 15:20:34 +08:00
`DELETE /_inference/<inference_id>`
[ML] Create inference_user and inference_admin roles (#106371) Defines new inference_user and inference_admin roles with the related cluster privileges manage_inference and monitor_inference. inference_user can list the models and preform inference, inference_admin can do the same plus create and delete models
2024-03-20 19:15:21 +08:00
[DOCS] Changes model_id path param to inference_id (#106719)
2024-03-26 15:20:34 +08:00
`DELETE /_inference/<task_type>/<inference_id>`
[DOCS] Adds reference documentation for inference API (#99658) * [DOCS] Creates documentation structure. * [DOCS] Adds PUT inference API docs and part of GET inference API docs. * [DOCS] Fixes complaining CI. * [DOCS] Adds GET and DELETE API docs for inference API. * [DOCS] Adds POST inference API docs. * Apply suggestions from code review
2023-09-29 16:12:07 +08:00
[discrete]
[[delete-inference-api-prereqs]]
==== {api-prereq-title}
[ML] Create inference_user and inference_admin roles (#106371) Defines new inference_user and inference_admin roles with the related cluster privileges manage_inference and monitor_inference. inference_user can list the models and preform inference, inference_admin can do the same plus create and delete models
2024-03-20 19:15:21 +08:00
* Requires the `manage_inference` <<privileges-list-cluster,cluster privilege>>
(the built-in `inference_admin` role grants this privilege)
[DOCS] Adds reference documentation for inference API (#99658) * [DOCS] Creates documentation structure. * [DOCS] Adds PUT inference API docs and part of GET inference API docs. * [DOCS] Fixes complaining CI. * [DOCS] Adds GET and DELETE API docs for inference API. * [DOCS] Adds POST inference API docs. * Apply suggestions from code review
2023-09-29 16:12:07 +08:00
[discrete]
[[delete-inference-api-path-params]]
==== {api-path-parms-title}
[DOCS] Changes model_id path param to inference_id (#106719)
2024-03-26 15:20:34 +08:00
<inference_id>::
[DOCS] Adds reference documentation for inference API (#99658) * [DOCS] Creates documentation structure. * [DOCS] Adds PUT inference API docs and part of GET inference API docs. * [DOCS] Fixes complaining CI. * [DOCS] Adds GET and DELETE API docs for inference API. * [DOCS] Adds POST inference API docs. * Apply suggestions from code review
2023-09-29 16:12:07 +08:00
(Required, string)
[DOCS] Changes model_id path param to inference_id (#106719)
2024-03-26 15:20:34 +08:00
The unique identifier of the {infer} endpoint to delete.
[DOCS] Adds reference documentation for inference API (#99658) * [DOCS] Creates documentation structure. * [DOCS] Adds PUT inference API docs and part of GET inference API docs. * [DOCS] Fixes complaining CI. * [DOCS] Adds GET and DELETE API docs for inference API. * [DOCS] Adds POST inference API docs. * Apply suggestions from code review
2023-09-29 16:12:07 +08:00
<task_type>::
[ML] Make task_type optional (#104483) Makes the task_type element of the _inference API optional so that it is possible to GET, DELETE or POST to an inference entity without providing the task type
2024-02-07 00:15:24 +08:00
(Optional, string)
[DOCS] Adds reference documentation for inference API (#99658) * [DOCS] Creates documentation structure. * [DOCS] Adds PUT inference API docs and part of GET inference API docs. * [DOCS] Fixes complaining CI. * [DOCS] Adds GET and DELETE API docs for inference API. * [DOCS] Adds POST inference API docs. * Apply suggestions from code review
2023-09-29 16:12:07 +08:00
The type of {infer} task that the model performs.
[DOCS] Expands DELETE inference API docs (#109282) * [DOCS] Expands DELETE inference API docs. * [DOCS] Adds discrete flag.
2024-06-03 23:32:31 +08:00
[discrete]
[[delete-inference-query-parms]]
== {api-query-parms-title}
`dry_run`::
(Optional, Boolean)
[DOCS] Improves semantic text documentation. (#113606)
2024-09-26 22:09:28 +08:00
When `true`, checks the `semantic_text` fields and {infer} processors that reference the endpoint and returns them in a list, but does not delete the endpoint.
Defaults to `false`.
[DOCS] Expands DELETE inference API docs (#109282) * [DOCS] Expands DELETE inference API docs. * [DOCS] Adds discrete flag.
2024-06-03 23:32:31 +08:00
`force`::
(Optional, Boolean)
[DOCS] Improves semantic text documentation. (#113606)
2024-09-26 22:09:28 +08:00
Deletes the endpoint regardless if it's used in a `semantic_text` field or in an {infer} pipeline.
[DOCS] Expands DELETE inference API docs (#109282) * [DOCS] Expands DELETE inference API docs. * [DOCS] Adds discrete flag.
2024-06-03 23:32:31 +08:00
[DOCS] Adds reference documentation for inference API (#99658) * [DOCS] Creates documentation structure. * [DOCS] Adds PUT inference API docs and part of GET inference API docs. * [DOCS] Fixes complaining CI. * [DOCS] Adds GET and DELETE API docs for inference API. * [DOCS] Adds POST inference API docs. * Apply suggestions from code review
2023-09-29 16:12:07 +08:00
[discrete]
[[delete-inference-api-example]]
==== {api-examples-title}
[ML] Make task_type optional (#104483) Makes the task_type element of the _inference API optional so that it is possible to GET, DELETE or POST to an inference entity without providing the task type
2024-02-07 00:15:24 +08:00
The following API call deletes the `my-elser-model` {infer} model that can
[DOCS] Adds reference documentation for inference API (#99658) * [DOCS] Creates documentation structure. * [DOCS] Adds PUT inference API docs and part of GET inference API docs. * [DOCS] Fixes complaining CI. * [DOCS] Adds GET and DELETE API docs for inference API. * [DOCS] Adds POST inference API docs. * Apply suggestions from code review
2023-09-29 16:12:07 +08:00
perform `sparse_embedding` tasks.
[source,console]
------------------------------------------------------------
DELETE /_inference/sparse_embedding/my-elser-model
------------------------------------------------------------
// TEST[skip:TBD]
The API returns the following response:
[source,console-result]
------------------------------------------------------------
{
"acknowledged": true
}
------------------------------------------------------------
[ML] Make task_type optional (#104483) Makes the task_type element of the _inference API optional so that it is possible to GET, DELETE or POST to an inference entity without providing the task type
2024-02-07 00:15:24 +08:00
// NOTCONSOLE