opensearch-docs-cn/_api-reference/script-apis/get-stored-script.md

1.6 KiB

layout title parent nav_order
default Get Stored Script Script APIs 3

Get stored script

Introduced 1.0 {: .label .label-purple }

Retrieves a stored 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-script

{% include copy-curl.html %}

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 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.