script.create

Описание

object script.create(объект/массив scripts)

Этот метод позволяет создавать новые сценарии.

Этот метод доступен только пользователю с типом доступа Супер-администратор. Разрешения на вызов метода можно отозвать в настройках ролей пользователя. Дополнительную информацию см. в разделе Роли пользователей.

Параметры

(объект/массив) Создаваемые скрипты.

Этот метод принимает скрипты со стандартными свойствами скрипта.

Возвращаемые значения

(объект) Возвращает объект, который содержит ID созданных скриптов, указанных в свойстве scriptids. Порядок возвращаемых ID совпадает с порядком переданных скриптов.

Примеры

Создание скрипта

Создание скрипта, который перезапускает сервер. Этот скрипт будет требовать права записи к узлу сети и будет отображать сообщение подтверждения в веб-интерфейсе до выполнения команды.

Запрос:

{  "jsonrpc": "2.0",  "method": "script.create",  "params": {  "name": "Reboot server",  "command": "reboot server 1",  "host_access": 3,  "confirmation": "Are you sure you would like to reboot the server?"  },  "auth": "038e1d7b1735c6a5436ee9eae095879e",  "id": 1 }

Ответ:

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

Исходный код

CScript::create() в frontends/php/include/classes/api/services/CScript.php.

Create a custom script

Create a custom script that will reboot a server. The script will require write access to the host and will display a configuration message before running in the frontend.

Request:

{  "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 }

Response:

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

Create an URL type script

Create an URL type script that for host scope and remains in same window and has confirmation text.