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.