[comment]: # translation:outdated

[comment]: # ({3a2a8d58-3a2a8d58})
# script.execute

[comment]: # ({/3a2a8d58-3a2a8d58})

[comment]: # ({ac5defee-60a9dbe3})
### Apraksts

`object script.execute(object parameters)`

Šī metode ļauj izpildīt skriptu hostā vai notikumā. Izņemot URL tipa skriptus. Tie nav izpildāmi.

::: noteclassic
Šī metode ir pieejama jebkura tipa lietotājiem. Atļaujas
izsaukt šo metodi var tikt atsauktas lietotāja lomas iestatījumos. Plašāku informāciju skatiet sadaļā [Lietotāju
lomas](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/ac5defee-60a9dbe3})

[comment]: # ({4a3ef91f-e4fa8ac7})
### Parametri

`(object)` Parametri, kas satur izpildāmā skripta ID, vai nu
hosta ID, vai notikuma ID un manualinput vērtību.

|Parametrs|[Type](/manual/api/reference_commentary#data-types)|Apraksts|
|--|--|------|
|scriptid|ID|Izpildāmā [skripta](/manual/api/reference/script/object#script) ID.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*|
|hostid|ID|[Hosta](/manual/api/reference/host/object#host) ID, uz kura izpildīt skriptu.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja `eventid` nav iestatīts|
|eventid|ID|[Notikuma](/manual/api/reference/event/object#event) ID, uz kura izpildīt skriptu.<br><br>[Parametra darbība](/manual/api/reference_commentary#parameter-behavior):<br>- *obligāts*, ja `hostid` nav iestatīts|
|manualinput|string|Lietotāja norādīta vērtība skripta izpildei, aizstājot <br>makrosu {MANUALINPUT}.|

[comment]: # ({/4a3ef91f-e4fa8ac7})

[comment]: # ({abb1babb-dde54e60})
### Atgrieztās vērtības

`(object)` Atgriež skripta izpildes rezultātu.

|Īpašība|[Type](/manual/api/reference_commentary#data-types)|Apraksts|
|--|--|------|
|response|string|Vai skripts tika izpildīts veiksmīgi.<br><br>Iespējamā vērtība - `success`.|
|value|string|Skripta izvade.|
|debug|object|Satur [debug](/manual/api/reference/script/object#debug) objektu, ja tiek izpildīts webhook skripts. Citiem skriptu tipiem tas satur tukšu objektu.|

[comment]: # ({/abb1babb-dde54e60})

[comment]: # ({b41637d2-b41637d2})
### Piemēri

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({89444531-03cb1cf3})
#### Palaist webhook skriptu

Palaidiet webhook skriptu, kas nosūta HTTP pieprasījumu uz ārēju servisu.

[Pieprasījums](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "script.execute",
    "params": {
        "scriptid": "4",
        "hostid": "30079"
    },
    "id": 1
}
```

Atbilde:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "response": "success",
        "value": "{\"status\":\"sent\",\"timestamp\":\"1611235391\"}",
        "debug": {
            "logs": [
                 {
                     "level": 3,
                     "ms": 480,
                     "message": "[Webhook Script] HTTP status: 200."
                 }
             ],
             "ms": 495
        }
    },
    "id": 1
}
```

[comment]: # ({/89444531-03cb1cf3})

[comment]: # ({fc7b2309-baebff97})
#### Palaist pielāgotu skriptu

Palaidiet "ping" skriptu hostā.

[Pieprasījums](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "script.execute",
    "params": {
        "scriptid": "1",
        "hostid": "30079"
    },
    "id": 1
}
```

Atbilde:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "response": "success",
        "value": "PING 127.0.0.1 (127.0.0.1) 56(84) bytes of data.\n64 bytes from 127.0.0.1: icmp_req=1 ttl=64 time=0.074 ms\n64 bytes from 127.0.0.1: icmp_req=2 ttl=64 time=0.030 ms\n64 bytes from 127.0.0.1: icmp_req=3 ttl=64 time=0.030 ms\n\n--- 127.0.0.1 ping statistics ---\n3 packets transmitted, 3 received, 0% packet loss, time 1998ms\nrtt min/avg/max/mdev = 0.030/0.044/0.074/0.022 ms\n",
        "debug": []
    },
    "id": 1
}
```

[comment]: # ({/fc7b2309-baebff97})

[comment]: # ({7ff793a4-dae60a2d})
#### Palaidiet pielāgotu skriptu ar manuālu ievadi

Palaidiet "ping" skriptu ar komandu "ping -c {MANUALINPUT} {HOST.CONN}; case $? in [01]) true;; *)
false;; esac" hostā.

[Pieprasījums](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "script.execute",
    "params": {
        "scriptid": "7",
        "hostid": "30079",
        "manualinput": "2"
    },
    "id": 1
}
```

Atbilde:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "response": "success",
        "value": "PING 127.0.0.1 (127.0.0.1) 56(84) bytes of data.\n64 bytes from 127.0.0.1: icmp_seq=1 ttl=64 time=0.051 ms\n64 bytes from 127.0.0.1: icmp_seq=2 ttl=64 time=0.025 ms\n\n--- 127.0.0.1 ping statistics ---\n2 packets transmitted, 2 received, 0% packet loss, time 1021ms\nrtt min/avg/max/mdev = 0.025/0.038/0.051/0.013 ms\n",
        "debug": []
    },
    "id": 1
}
```

[comment]: # ({/7ff793a4-dae60a2d})

[comment]: # ({e7dc45a5-e7dc45a5})
### Avots

CScript::execute() failā *ui/include/classes/api/services/CScript.php*.

[comment]: # ({/e7dc45a5-e7dc45a5})