Объект веб-сценария
Следующие объекты напрямую связаны с API webcheck.
Веб-сценарий
Объект веб-сценария имеет следующие свойства.
| Property | Type | Description |
|---|---|---|
| httptestid | ID | Идентификатор веб-сценария. Поведение свойства: - только для чтения - обязательно для операций обновления |
| hostid | ID | Идентификатор узла сети, которому принадлежит веб-сценарий. Поведение свойства: - постоянное - обязательно для операций создания |
| name | string | Имя веб-сценария. Поведение свойства: - обязательно для операций создания |
| agent | string | Строка агента пользователя, которая будет использоваться веб-сценарием. По умолчанию: Zabbix |
| authentication | integer | Метод аутентификации, который будет использоваться веб-сценарием. Возможные значения: 0 - (по умолчанию) отсутствует; 1 - базовая HTTP-аутентификация; 2 - аутентификация NTLM; 3 - аутентификация Kerberos; 4 - дайджест-аутентификация. |
| delay | string | Интервал выполнения веб-сценария. Принимает количество секунд (например, 1, 60, 300), значение с суффиксом времени (например, 30s, 1m, 2h, 1d) или пользовательский макрос.По умолчанию: 1m. |
| headers | array | HTTP-заголовки, которые будут отправляться при выполнении запроса. |
| http_password | string | Пароль, используемый для базовой HTTP-аутентификации, аутентификации NTLM, Kerberos или дайджест-аутентификации. |
| http_proxy | string | Прокси, который будет использоваться веб-сценарием, в формате http://\[username\[:password\]@\]proxy.example.com\[:port]. |
| http_user | string | Имя пользователя, используемое для базовой HTTP-аутентификации, аутентификации NTLM, Kerberos или дайджест-аутентификации. |
| retries | integer | Количество попыток, которые веб-сценарий выполнит для каждого шага перед сбоем. По умолчанию: 1. |
| ssl_cert_file | string | Имя файла сертификата SSL, используемого для аутентификации клиента (должен быть в формате PEM). |
| ssl_key_file | string | Имя файла закрытого ключа SSL, используемого для аутентификации клиента (должен быть в формате PEM). |
| ssl_key_password | string | Пароль закрытого ключа SSL. |
| status | integer | Определяет, включен ли веб-сценарий. Возможные значения: 0 - (по умолчанию) включен; 1 - отключен. |
| templateid | ID | Идентификатор родительского веб-сценария шаблона. Поведение свойства: - только для чтения |
| variables | array | Переменные веб-сценария. |
| verify_host | integer | Определяет, проверять ли соответствие имени узла сети для подключения имени, указанному в сертификате узла сети. Возможные значения: 0 - (по умолчанию) не проверять узел сети; 1 - проверять узел сети. |
| verify_peer | integer | Определяет, проверять ли подлинность сертификата узла сети. Возможные значения: 0 - (по умолчанию) не проверять узел; 1 - проверять узел. |
| uuid | string | Глобальный уникальный идентификатор, используемый для связывания импортированных веб-сценариев с уже существующими. Создается автоматически, если не указан. Поведение свойства: - поддерживается, если веб-сценарий принадлежит шаблону |
Шаг сценария
Объект шага сценария определяет конкретную проверку веб-сценария. Он имеет следующие свойства.
| Property | Type | Description |
|---|---|---|
| name | string | Имя шага сценария. Поведение свойства: - обязательное |
| no | integer | Порядковый номер шага в веб-сценарии. Поведение свойства: - обязательное |
| url | string | URL для проверки. Поведение свойства: - обязательное |
| follow_redirects | integer | Следует ли переходить по HTTP-перенаправлениям. Возможные значения: 0 - не переходить по перенаправлениям; 1 - (по умолчанию) переходить по перенаправлениям. |
| headers | array | HTTP-заголовки, которые будут отправлены при выполнении запроса. Заголовки шага сценария заменяют заголовки, указанные для веб-сценария. |
| posts | string/array | Переменные HTTP POST в виде строки (необработанные данные POST) или массива HTTP-полей (данные полей формы). |
| required | string | Текст, который должен присутствовать в ответе. |
| retrieve_mode | integer | Часть HTTP-ответа, которую должен получить шаг сценария. Возможные значения: 0 - (по умолчанию) только тело; 1 - только заголовки; 2 - заголовки и тело. |
| status_codes | string | Диапазоны требуемых кодов состояния HTTP, разделенные запятыми. |
| timeout | string | Тайм-аут запроса в секундах. Принимает количество секунд (например, 1, 60, 300), значение с суффиксом времени (например, 30s, 1m, 1h) или пользовательский макрос.Значение по умолчанию: 15s. Максимум: 1h. Минимум: 1s. |
| variables | array | Переменные шага сценария. |
| query_fields | array | Поля запроса - массив HTTP-полей, которые будут добавлены в URL при выполнении запроса. |
Поле HTTP
Объект поля HTTP определяет имя и значение, которые используются для указания переменных веб-сценария, HTTP-заголовков, а также полей POST или полей запроса. Он имеет следующие свойства.
| Property | Type | Description |
|---|---|---|
| name | string | Имя заголовка/переменной/поля POST или GET. Property behavior: - required |
| value | string | Значение заголовка/переменной/поля POST или GET. Property behavior: - required |
Тег веб-сценария
Объект тега веб-сценария имеет следующие свойства.
| Property | Type | Description |
|---|---|---|
| tag | string | Имя тега веб-сценария. Поведение свойства: - обязательно |
| value | string | Значение тега веб-сценария. |