community.fortios.fmgr_device_group – Изменение групп устройств FortiManager.
Примечание
Этот плагин входит в коллекцию community.fortios (версия 1.0.0).
Для его установки используйте: ansible-galaxy collection install community.fortios.
Для использования в плейбуке укажите: community.fortios.fmgr_device_group.
Обзор
- Добавление или редактирование групп устройств и назначение устройств группам устройств в FortiManager Device Manager с использованием API JSON RPC.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| adom строка | Значение по умолчанию: "root" | ADOM, к которому должна относиться конфигурация. |
| grp_desc строка | Описание группы устройств. | |
| grp_members строка | Список имён устройств или групп устройств, разделённых запятыми, которые должны быть добавлены в качестве членов группы устройств. Если члены группы определены, и mode="delete", то будут удалены только члены группы. Если вы хотите удалить саму группу, необходимо опустить этот параметр из задачи в плейбуке. | |
| grp_name строка | Имя группы устройств. | |
| mode строка |
| Устанавливает один из трёх режимов управления объектом. Позволяет использовать мягкие добавления вместо перезаписи существующих значений |
| vdom строка | Значение по умолчанию: "root" | VDOM Fortigate, который нужно добавить, должен соответствовать устройству в FMGR. Обычно root. |
Примечания
Примечание
- Полная документация по адресу https://ftnt-ansible-docs.readthedocs.io/en/latest/.
Примеры
- name: CREATE DEVICE GROUP
community.fortios.fmgr_device_group:
grp_name: "TestGroup"
grp_desc: "CreatedbyAnsible"
adom: "ansible"
mode: "add"
- name: CREATE DEVICE GROUP 2
community.fortios.fmgr_device_group:
grp_name: "AnsibleGroup"
grp_desc: "CreatedbyAnsible"
adom: "ansible"
mode: "add"
- name: ADD DEVICES TO DEVICE GROUP
community.fortios.fmgr_device_group:
mode: "add"
grp_name: "TestGroup"
grp_members: "FGT1,FGT2"
adom: "ansible"
vdom: "root"
- name: REMOVE DEVICES TO DEVICE GROUP
community.fortios.fmgr_device_group:
mode: "delete"
grp_name: "TestGroup"
grp_members: "FGT1,FGT2"
adom: "ansible"
- name: DELETE DEVICE GROUP
community.fortios.fmgr_device_group:
grp_name: "AnsibleGroup"
grp_desc: "CreatedbyAnsible"
mode: "delete"
adom: "ansible"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| api_result строка | всегда | полный ответ API, включает код состояния и сообщение |
Авторы
- Luke Weighall (@lweighall)
- Andrew Welsh (@Ghilli3)
- Jim Huber (@p4r4n0y1ng)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/fortios/fmgr_device_group_module.html