Get Stored Script API
Introduced 1.0
Retrieves a stored script from the cluster state.
Endpoints
GET _scripts/my-first-script
Path parameters
| Parameter | Data type | Description |
|---|---|---|
script | String | Stored script or search template name. Required. |
Query parameters
| Parameter | Data type | Description |
|---|---|---|
cluster_manager_timeout | Time | Amount of time to wait for a connection to the cluster manager. Optional, defaults to 30s. |
Example request
The following retrieves the my-first-script stored script.
GET /_scripts/my-first-scriptresponse = client.get_script(
id = "my-first-script"
)Example response
The GET _scripts/my-first-script request returns the following fields:
{
"_id" : "my-first-script",
"found" : true,
"script" : {
"lang" : "painless",
"source" : """
int total = 0;
for (int i = 0; i < doc['ratings'].length; ++i) {
total += doc['ratings'][i];
}
return total;
"""
}
}
Response body fields
The GET _scripts/my-first-script request returns the following response fields:
| Field | Data type | Description |
|---|---|---|
_id | String | The script’s name. |
found | Boolean | The requested script exists and was retrieved. |
script | Object | The script definition. See Script object. |
Script object
| Field | Data type | Description |
|---|---|---|
lang | String | The script’s language. |
source | String | The script’s body. |
Required permissions
If you use the Security plugin, make sure you have the appropriate permissions: cluster:admin/script/get.