Как управлять данными отчета о защищаемых виртуальных машинах и выгружать его
Статья обновлена: 18 декабря 2019
ID: 15307
На Сервере интеграции создается таблица, которая содержит информацию о включении и выключении защиты виртуальных машин клиентов. По умолчанию заполнение таблицы данными выключено, а записи хранятся 3 месяца.
Администратор может включать или выключать заполнение таблицы, настраивать срок хранения записей и выгружать таблицы в файл формата CSV.
Как включить или выключить запись данных в таблицу
- Откройте на редактирование конфигурационный файл Сервера интеграции. Для этого выполните команду:
- для 64-битных систем:
notepad "%ProgramFiles(x86)%\Kaspersky Lab\Kaspersky VIIS\viislaservice.exe.config"
- для 32-битных систем:
notepad "%ProgramFiles%\Kaspersky Lab\Kaspersky VIIS\viislaservice.exe.config"
- для 64-битных систем:
- Найдите параметр <add key="IsProtectionPeriodsSavingEnabled" value="false" />
- Замените значение value на:
- true — для включения записей данных в таблицу;
- false — для выключения записей данных в таблицу.
- Сохраните конфигурационный файл Сервера интеграции.
- Перезапустите сервис VIIS.
Запись данных в таблицу будет включена или выключена.
Как изменить срок хранения данных в таблице
- Откройте на редактирование конфигурационный файл Сервера интеграции. Для этого выполните команду:
- для 64-битных систем:
notepad "%ProgramFiles(x86)%\Kaspersky Lab\Kaspersky VIIS\viislaservice.exe.config"
- для 32-битных систем:
notepad "%ProgramFiles%\Kaspersky Lab\Kaspersky VIIS\viislaservice.exe.config"
- для 64-битных систем:
- Найдите параметр <add key="MaxProtectionPeriodRecordAgeSeconds" value="7776000" />
- Укажите необходимое значение для value в секундах.
- Сохраните конфигурационный файл Сервера интеграции.
- Перезапустите сервис VIIS.
Срок хранения данных в таблице будет изменен.
Как выгрузить отчет
Чтобы выгрузить данные из таблицы в отчет с необходимым набором параметров, выполните HTTP-запрос:
GET <логин>:<пароль> https://<IP-адрес>:<порт>/api/1.0/reports/protectionPeriods?[infraId=<ID инфраструктуры>&tenantId=<ID соответствия>&periodStart=<дата начала>&periodEnd=<дата окончания>]
Где:
- Логин и пароль — имя и пароль учетной записи администратора. Указываются, если Сервер интеграции расположен вне домена.
- IP-адрес и порт — указываются IP-адрес и порт, которые используются для подключения к Консоли Сервера интеграции.
- infraId — опциональный параметр для отчета по виртуальным машинам с указанной инфраструктурой. Указывается ID инфраструктуры.
Чтобы получить список всех инфраструктур, выполните команду:
GET /api/1.0/im/vsphere
, где ID инфраструктуры — атрибут id у элементов infrastructure. - tenantId — опциональный параметр для отчета по виртуальным машинам с указанным соответствием. Указывается ID соответствия или none (для виртуальных машинам, которые не относятся ни к одному из соответствий).
Чтобы получить список всех соответствий, выполните команду:
GET /api/1.0/mt/tenants
, где ID соответствия — атрибут id у элементов tenant (vKSC id). - periodStart — опциональный параметр для отчета по виртуальным машинам, начиная с указанной даты. Формат даты: ГГГГ-ММ-ДДTчч:мм:ссZ.
- periodEnd — опциональный параметр для отчета по виртуальным машинам, заканчивая указанной датой. Формат даты: ГГГГ-ММ-ДДTчч:мм:ссZ.
Пример выгрузки через команду curl
curl -i -S -s -o - --noproxy '*' --insecure -u admin:1 -X GET https://192.168.77.7:7271/api/1.0/reports/protectionPeriods?infraId=19e47e17-e7b9-4819-9495-284af29e86f7&tenantId=VSRV9e1a72ee-6b78-4f3d-a7d4-1025f1c18016
Пример отчета
