elasticsearch/docs/reference/scripting/apis/get-stored-script-api.asciidoc
James Rodewig 3845a41804
[DOCS] Fix stored script example snippet (#83056)
Changes:

* Updates the example Painless script to be valid and aligns it with the example in [How to write a script](https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting-using.html#script-stored-scripts).
* Adds a hidden snippets to delete the script for cleanup.

Relates to https://github.com/elastic/elasticsearch/issues/83038
2022-01-25 10:30:48 -05:00

58 lines
1.1 KiB
Text

[[get-stored-script-api]]
=== Get stored script API
++++
<titleabbrev>Get stored script</titleabbrev>
++++
Retrieves a <<script-stored-scripts,stored script>> or <<search-template,search
template>>.
////
[source,console]
----
PUT _scripts/my-stored-script
{
"script": {
"lang": "painless",
"source": "Math.log(_score * 2) + params['my_modifier']"
}
}
----
////
[source,console]
----
GET _scripts/my-stored-script
----
// TEST[continued]
////
[source,console]
----
DELETE _scripts/my-stored-script
----
// TEST[continued]
////
[[get-stored-script-api-request]]
==== {api-request-title}
`GET _scripts/<script-id>`
[[get-stored-script-api-prereqs]]
==== {api-prereq-title}
* If the {es} {security-features} are enabled, you must have the `manage`
<<privileges-list-cluster,cluster privilege>> to use this API.
[[get-stored-script-api-path-params]]
==== {api-path-parms-title}
`<script-id>`::
(Required, string)
Identifier for the stored script or search template.
[[get-stored-script-api-query-params]]
==== {api-query-parms-title}
include::{es-repo-dir}/rest-api/common-parms.asciidoc[tag=master-timeout]