Управление атрибутами устройств

Пользовательские атрибуты расширяют стандартные свойства устройств, получая значения из пользовательских grain-модулей SaltStack. Используются для фильтрации устройств в коллекциях на основе SQL-запросов или правил.

Для управления пользовательскими атрибутами устройств доступны операции добавления, редактирования и удаления.

При попытке удаления атрибута, на который ссылаются коллекции (созданные на основе SQL-запроса или правил), операция блокируется и выводится список зависимых коллекций с возможностью перехода к ним для редактирования.

Добавление атрибута устройства

Для добавления атрибута устройства:

  1. В меню навигации выберите Настройки > Инвентаризация устройств > Управление пользовательскими атрибутами > Управление атрибутами.

  2. Нажмите Добавить атрибут:

    set atrib1

  3. В открывшейся форме заполните поля.

    Пример:

    set atrib2

    Требования к полям атрибута (все поля обязательные):

    • Название — не более 50 символов;

    • Код — уникальный, не более 30 символов;

    • Json Path — JSON-путь в формате dot notation;

      Если возвращаемый grain-модулем результат имеет более сложную структуру, то необходимо указать JSON-путь для доступа к значениям типа строка или дата в этой структуре, например, $.os_info.version (подробнее см. в разделе «Работа с пользовательскими модулями grain, state и execution»).

    • Тип данных — выбрать из выпадающего списка.

  4. Нажмите Создать:

    • если заполненные поля не отвечают обязательным требованиям, то выводится предупреждение:

      set atrib3

    • если заполненные поля отвечают обязательным требованиям:

      • будет выведено сообщение об успешном создании атрибута;

      • значение атрибута добавится на страницу информации об устройстве;

      • если для атрибута не был задан раздел, то он отобразится в разделе Другое; при необходимости можно перенести атрибуты в один из существующих разделов или создать для них новый раздел (подробнее см. раздел «Управление разделами атрибутов устройств»).

Редактирование атрибута устройства

Для изменения атрибута устройства:

  1. В меню навигации выберите Настройки > Инвентаризация устройств > Управление пользовательскими атрибутами > Управление атрибутами.

  2. Выберите атрибут.

  3. На панели быстрого просмотра параметров атрибута нажмите Редактировать:

    set atrib5

  4. Отредактируйте поля атрибута и нажмите Сохранить:

    set atrib6

Удаление атрибута устройства

Для удаления атрибута устройства:

  1. В меню навигации выберите Настройки > Инвентаризация устройств > Управление пользовательскими атрибутами > Управление атрибутами.

  2. Выберите атрибут.

  3. На панели быстрого просмотра параметров атрибута нажмите Удалить.

  4. Подтвердите удаление.

Перед удалением автоматически проверяется наличие зависимостей: если атрибут используется в SQL-запросах или правилах любых коллекций (в виде ("machines"."attributes"->'uuid_атрибута')->>'value'), удаление запрещено.

Если зависимости обнаружены, отображается диалоговое окно:

set atrib7

В окне отображается список коллекций, зависящих от атрибута. Для каждой коллекции отображается имя, тип и идентификатор.

Для устранения зависимости нажмите edit 2 в строке с именем коллекции и в окне редактирования коллекции удалите ссылки на атрибут из SQL-запроса или правил. Затем повторите попытку удаления атрибута.

Если зависимости отсутствуют, запрашивается подтверждение удаления. Нажмите Удалить для завершения операции.

Обновлено: