Documentation
Table of Contents
script.create
Description
object script.create(object/array scripts)
Cette m¨¦thode permet de cr¨¦er de nouveaux scripts.
Cette m¨¦thode est seulement disponible pour les utilisateurs du type Super admin. Les autorisations d'appeler la m¨¦thode peuvent ¨ºtre r¨¦voqu¨¦es dans les param¨¨tres de r?le d'utilisateur. Voir R?les utilisateur pour plus d'informations.
±Ê²¹°ù²¹³¾¨¨³Ù°ù±ð²õ
(object/array) Scripts ¨¤ cr¨¦er.
La m¨¦thode accepte les scripts avec les propri¨¦t¨¦s de script standard.
Valeurs retourn¨¦es
(object) Retourne un objet contenant les identifiants des scripts cr¨¦¨¦s sous la propri¨¦t¨¦ scriptids. L'ordre des ID retourn¨¦s correspond ¨¤ l'ordre des scripts transmis.
Exemples
Cr¨¦er un script de webhook
Cr¨¦ez un script de webhook qui envoie une requ¨ºte HTTP ¨¤ un service externe.
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "script.create",
"params": {
"name": "Webhook script",
"command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Áú»¢¶Ä²©.Log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Áú»¢¶Ä²©.Log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}",
"type": 5,
"timeout": "40s",
"parameters": [
{
"name": "token",
"value": "{$WEBHOOK.TOKEN}"
},
{
"name": "host",
"value": "{HOST.HOST}"
},
{
"name": "v",
"value": "2.2"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}R¨¦ponse :
Cr¨¦er un script SSH
Cr¨¦ez un script SSH avec une authentification par cl¨¦ publique pouvant ¨ºtre ex¨¦cut¨¦ sur un h?te et dot¨¦ d'un menu contextuel.
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "script.create",
"params": {
"name": "SSH script",
"command": "my script command",
"type": 2,
"username": "John",
"publickey": "pub.key",
"privatekey": "priv.key",
"password": "secret",
"port": "12345",
"scope": 2,
"menu_path": "All scripts/SSH",
"usrgrpid": "7",
"groupid": "4"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}R¨¦ponse :
Cr¨¦er un script personnalis¨¦
Cr¨¦ez un script personnalis¨¦ qui red¨¦marrera un serveur. Le script n¨¦cessitera un acc¨¨s en ¨¦criture ¨¤ l'h?te et affichera un message de configuration avant de s'ex¨¦cuter dans le frontend.
Requ¨ºte :
{
"jsonrpc": "2.0",
"method": "script.create",
"params": {
"name": "Reboot server",
"command": "reboot server 1",
"confirmation": "Are you sure you would like to reboot the server?",
"scope": 2,
"type": 0
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}R¨¦ponse :
Create an URL type script
Create an URL type script that for host scope and remains in same window and has confirmation text.
Request:
{
"jsonrpc": "2.0",
"method": "script.create",
"params": {
"name": "URL script",
"type": 6,
"scope": 2,
"url": "http://zabbix/ui/zabbix.php?action=host.edit&hostid={HOST.ID}",
"confirmation": "Edit host {HOST.NAME}?",
"new_window": 0
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Response:
Source
CScript::create() dans ui/include/classes/api/services/CScript.php.