[comment]: # translation:outdated

[comment]: # ({e5a46c74-e5a46c74})
# script.getscriptsbyhosts

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

[comment]: # ({dfaa829b-dfaa829b})
### Description

`object script.getscriptsbyhosts(array hostIds)`

Cette méthode permet de récupérer les scripts disponibles sur les hosts donnés.

::: noteclassic
Cette méthode est disponible à tous les types d'utilisateurs. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres du le rôle d'utilisateur. Voir [Rôles Utilisateur](/manual/web_interface/frontend_sections/administration/user_roles) pour plus d'informations.
:::

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

[comment]: # ({080ad0f7-080ad0f7})
### Paramètres

`(string/array)` ID des hôtes pour lesquels renvoyer les scripts.

[comment]: # ({/080ad0f7-080ad0f7})

[comment]: # ({1c891d1a-1c891d1a})
### Valeurs retournées

`(object)` Renvoie un objet avec des ID d'hôte en tant que propriétés et des tableaux de scripts disponibles en tant que valeurs.

::: notetip
La méthode développera automatiquement les macros dans le texte de `confirmation`.
:::

[comment]: # ({/1c891d1a-1c891d1a})

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

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

[comment]: # ({4b630539-4b630539})
#### Récupération des scripts par ID d'hôte

Récupérer tous les scripts disponibles sur les hôtes "30079" et "30073".

Requête :

``` {.java}
{
 "jsonrpc": "2.0",
 "method": "script.getscriptsbyhosts",
 "params": [
 "30079",
 "30073"
 ],
 "auth": "038e1d7b1735c6a5436ee9eae095879e",
 "id": 1
}
```

Réponse :

``` {.java}
{
 "jsonrpc": "2.0",
 "result": {
 "30079": [
 {
 "scriptid": "3",
 "name": "Detect operating system",
 "command": "sudo /usr/bin/nmap -O {HOST.CONN} 2>&1",
 "host_access": "2",
 "usrgrpid": "7",
 "groupid": "0",
 "description": "",
 "confirmation": "",
 "type": "0",
 "execute_on": "1",
 "hostid": "10001"
 },
 {
 "scriptid": "1",
 "name": "Ping",
 "command": "/bin/ping -c 3 {HOST.CONN} 2>&1",
 "host_access": "2",
 "usrgrpid": "0",
 "groupid": "0",
 "description": "",
 "confirmation": "",
 "type": "0",
 "execute_on": "1",
 "hostid": "10001"
 },
 {
 "scriptid": "2",
 "name": "Traceroute",
 "command": "/usr/bin/traceroute {HOST.CONN} 2>&1",
 "host_access": "2",
 "usrgrpid": "0",
 "groupid": "0",
 "description": "",
 "confirmation": "",
 "type": "0",
 "execute_on": "1",
 "hostid": "10001"
 }
 ],
 "30073": [
 {
 "scriptid": "3",
 "name": "Detect operating system",
 "command": "sudo /usr/bin/nmap -O {HOST.CONN} 2>&1",
 "host_access": "2",
 "usrgrpid": "7",
 "groupid": "0",
 "description": "",
 "confirmation": "",
 "type": "0",
 "execute_on": "1",
 "hostid": "10001"
 },
 {
 "scriptid": "1",
 "name": "Ping",
 "command": "/bin/ping -c 3 {HOST.CONN} 2>&1",
 "host_access": "2",
 "usrgrpid": "0",
 "groupid": "0",
 "description": "",
 "confirmation": "",
 "type": "0",
 "execute_on": "1",
 "hostid": "10001"
 },
 {
 "scriptid": "2",
 "name": "Traceroute",
 "command": "/usr/bin/traceroute {HOST.CONN} 2>&1",
 "host_access": "2",
 "usrgrpid": "0",
 "groupid": "0",
 "description": "",
 "confirmation": "",
 "type": "0",
 "execute_on": "1",
 "hostid": "10001"
 }
 ]
 },
 "id": 1
}
```

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

[comment]: # ({a62657e4-a62657e4})
### Source

CScript::getScriptsByHosts() dans *ui/include/classes/api/services/CScript.php*.

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