[comment]: # translation:outdated

[comment]: # ({4f2ac53b-4f2ac53b})
# script.update

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

[comment]: # ({3c9f3e07-3bbc6786})
### Descrizione

`object script.update(object/array scripts)`

Questo metodo consente di aggiornare script esistenti.

::: noteclassic
Questo metodo è disponibile solo per il tipo di utente *Super admin*.
I permessi per chiamare il metodo possono essere revocati nelle impostazioni del ruolo utente. Vedere
[Ruoli utente](/manual/web_interface/frontend_sections/users/user_roles)
per ulteriori informazioni.
:::

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

[comment]: # ({8f315bab-8f315bab})
### Parametri

`(object/array)` [Proprietà dello script](object#script) da aggiornare.

La proprietà `scriptid` deve essere definita per ciascuno script, tutte le altre
proprietà sono facoltative. Verranno aggiornate solo le proprietà passate, tutte
le altre rimarranno invariate. Fa eccezione la modifica della proprietà `type`
da 5 (Webhook) a un altro valore: la proprietà `parameters` verrà ripulita.

[comment]: # ({/8f315bab-8f315bab})

[comment]: # ({5062432a-5062432a})
### Valori di ritorno

`(object)` Restituisce un oggetto contenente gli ID degli script aggiornati
sotto la proprietà `scriptids`.

[comment]: # ({/5062432a-5062432a})

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

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

[comment]: # ({96417b97-4f3506ff})
#### Modificare il comando dello script

Modificare il comando dello script in "/bin/ping -c 10 {HOST.CONN}
2>&1".

[Richiesta](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "script.update",
    "params": {
        "scriptid": "1",
        "command": "/bin/ping -c 10 {HOST.CONN} 2>&1"
    },
    "id": 1
}
```

Risposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "scriptids": [
            "1"
        ]
    },
    "id": 1
}
```

[comment]: # ({/96417b97-4f3506ff})

[comment]: # ({7495fc5b-eb14467c})
#### Modificare il comando dello script e aggiungere input manuale

Modificare il comando dello script in "/bin/ping -c {MANUALINPUT}
{HOST.CONN} 2>&1".

[Richiesta](/manual/api#performing-requests):

```json
{
    "jsonrpc": "2.0",
    "method": "script.update",
    "params": {
      "scriptid": "1",
      "command": "/bin/ping -c {MANUALINPUT} {HOST.CONN} 2>&1",
      "manualinput": "1",
      "manualinput_prompt": "Specificare il numero di pacchetti ICMP da inviare con il comando ping",
      "manualinput_validator": "^(?:[1-9]|10)$",
      "manualinput_validator_type": "0",
      "manualinput_default_value": "10"
    },
    "id": 1
}
```

Risposta:

```json
{
    "jsonrpc": "2.0",
    "result": {
        "scriptids": [
            "1"
        ]
    },
    "id": 1
}
```

[comment]: # ({/7495fc5b-eb14467c})

[comment]: # ({cded8a11-cded8a11})
### Fonte

CScript::update() in *ui/include/classes/api/services/CScript.php*.

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