Spec-Zone.ru › Ansible 2.4

panos_object - создание/чтение/обновление/удаление объекта в PAN-OS или Panorama

Новое в версии 2.4.

  • Описание
  • Требования (к хосту, на котором выполняется модуль)
  • Параметры
  • Примеры
  • Примечания
    • Статус

Описание

  • Объекты политики образуют критерии сопоставления для правил политики и многих других функций в PAN-OS. Они могут включать объекты адресов, группы адресов, объекты служб, группы служб и метки.

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

  • pan-python можно получить с PyPi https://pypi.python.org/pypi/pan-python
  • pandevice можно получить с PyPi https://pypi.python.org/pypi/pandevice

Параметры

Параметр Обязательно По умолчанию Варианты Комментарии
адрес
нет
IP-адрес хоста или сети в нотации CIDR.
тип_адреса
нет
Тип определения объекта адреса. Допустимые типы: ip-netmask и ip-range.
группа_адресов
нет
Статическая группа объектов адресов или динамическая группа адресов.
объект_адреса
нет
Имя объекта адреса.
ключ_api
нет
Ключ API, который можно использовать вместо учетных данных имя_пользователя/пароль.
цвет
нет
- Цвет объекта метки. Допустимые значения: красный, зеленый, синий, желтый, медный, оранжевый, фиолетовый, серый, светло-зеленый, голубой, светло-серый, сине-серый, лайм, черный, золотой и коричневый.
описание
нет
Описание объекта.
порт_назначения
нет
Порт назначения, используемый в определении объекта службы.
группа_устройств
нет None
- Имя группы устройств Panorama. Группа должна существовать в Panorama. Если группа устройств не определена, предполагается, что мы обращаемся к брандмауэру.
динамическое_значение
нет
Критерии сопоставления фильтра, используемые в определении динамической группы адресов.
ip_адрес
да
IP-адрес (или имя хоста) устройства PAN-OS или консоли управления Panorama.
операция
да
Выполняемая операция. Поддерживаемые значения: добавить/удалить/найти.
пароль
да
Учетные данные пароля для аутентификации.
протокол
нет
IP-протокол, используемый в определении объекта службы. Допустимые значения: tcp или udp.
группа_служб
нет
Группа объектов служб.
объект_службы
нет
Имя объекта службы.
службы
нет
Группа объектов служб, используемых в определении группы служб.
порт_источника
нет
Порт источника, используемый в определении объекта службы.
статическое_значение
нет
Группа объектов адресов, используемых в определении группы адресов.
имя_метки
нет
Имя метки объекта или правила.
имя_пользователя
нет admin
Учетные данные имени пользователя для аутентификации.

Примеры

- name: search for shared address object
  panos_object:
    ip_address: '{{ ip_address }}'
    username: '{{ username }}'
    password: '{{ password }}'
    operation: 'find'
    address: 'DevNet'

- name: create an address group in devicegroup using API key
  panos_object:
    ip_address: '{{ ip_address }}'
    api_key: '{{ api_key }}'
    operation: 'add'
    addressgroup: 'Prod_DB_Svrs'
    static_value: ['prod-db1', 'prod-db2', 'prod-db3']
    description: 'Production DMZ database servers'
    tag_name: 'DMZ'
    devicegroup: 'DMZ Firewalls'

- name: create a global service for TCP 3306
  panos_object:
    ip_address: '{{ ip_address }}'
    api_key: '{{ api_key }}'
    operation: 'add'
    serviceobject: 'mysql-3306'
    destination_port: '3306'
    protocol: 'tcp'
    description: 'MySQL on tcp/3306'

- name: create a global tag
  panos_object:
    ip_address: '{{ ip_address }}'
    username: '{{ username }}'
    password: '{{ password }}'
    operation: 'add'
    tag_name: 'ProjectX'
    color: 'yellow'
    description: 'Associated with Project X'

- name: delete an address object from a devicegroup using API key
  panos_object:
    ip_address: '{{ ip_address }}'
    api_key: '{{ api_key }}'
    operation: 'delete'
    addressobject: 'Win2K test'

Примечания

Примечание

  • Режим проверки недоступен.
  • Panorama поддерживается.

Статус

Этот модуль помечен как предварительная версия, что означает, что он не гарантирует обратную совместимость интерфейса.

Для получения помощи в разработке модулей, если вас это заинтересует, пожалуйста, ознакомьтесь с Справочной информацией сообщества и сотрудничеством, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/panos_object_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API