Spec-Zone.ru › Ansible 2.5

bigip_security_port_list - Управление списками портов на BIG-IP AFM

Новая версия с 2.5.

  • Обзор
    • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус
    • Автор

Обзор

  • Управляет списками портов AFM на BIG-IP. Этот модуль может использоваться для добавления и удаления записей в списке портов.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

  • f5-sdk >= 3.0.9

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
description
Описание списка портов
name
обязательно
Указывает имя списка портов.
partition
(добавлено в 2.5)
По умолчанию:
Common
Раздел устройства для управления ресурсами.
password
обязательно
Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Можно опустить этот параметр, если переменная среды F5_PASSWORD задана.

псевдонимы: pass, pwd
port_lists
Простой список существующих списков портов для добавления в этот список. Список портов может быть указан в полном имени (/Common/foo) или сокращенном имени (foo). Если используется сокращенное имя, аргумент partition будет автоматически добавлен к сокращенному имени.
port_ranges
Список диапазонов портов, где диапазон начинается с номера порта, за которым следует дефис (-) и затем второе число.
Если первое число больше второго, числа будут перевернуты, чтобы быть правильно отформатированными. Например, 90-78 станет 78-90.
ports
Простой список значений портов для добавления в список
provider
(добавлено в 2.5)
По умолчанию:
None
Объект словаря, содержащий данные подключения.
ssh_keyfile
Указывает файл SSH-ключа для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспортов cli. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_SSH_KEYFILE.
timeout По умолчанию:
10
Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истекает до завершения операции, модуль выдаст ошибку.
server
обязательно
Хост BIG-IP. Можно опустить этот параметр, если переменная среды F5_SERVER задана.
user
обязательно
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Можно опустить этот параметр, если переменная среды F5_USER задана.
server_port По умолчанию:
443
Порт сервера BIG-IP. Можно опустить этот параметр, если переменная среды F5_SERVER_PORT задана.
password
обязательно
Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Можно опустить этот параметр, если переменная среды F5_PASSWORD задана.

псевдонимы: pass, pwd
validate_certs
    Варианты:
  • no
  • yes ←
Если no, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых лично, с самозаверяющими сертификатами. Можно опустить этот параметр, если переменная среды F5_VALIDATE_CERTS задана.
transport
обязательно
    Варианты:
  • rest
  • cli ←
Настраивает транспортное соединение для использования при подключении к удаленному устройству.
server
обязательно
Хост BIG-IP. Можно опустить этот параметр, если переменная среды F5_SERVER задана.
server_port
(добавлено в 2.2)
По умолчанию:
443
Порт сервера BIG-IP. Можно опустить этот параметр, если переменная среды F5_SERVER_PORT задана.
state
(добавлено в 2.5)
    Варианты:
  • present ←
  • absent
Когда present, гарантирует, что список адресов и записи существуют.
Когда absent, гарантирует удаление списка адресов.
user
обязательно
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Можно опустить этот параметр, если переменная среды F5_USER задана.
validate_certs
(добавлено в 2.0)
    Варианты:
  • no
  • yes ←
Если no, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых лично, с самозаверяющими сертификатами. Можно опустить этот параметр, если переменная среды F5_VALIDATE_CERTS задана.

Примечания

Примечание

  • Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
  • Требуется пакет f5-sdk Python на хосте. Это так же просто, как pip install f5-sdk.

Примеры

- name: Create a simple port list
  bigip_security_port_list:
    name: foo
    ports:
      - 80
      - 443
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

- name: Override the above list of ports with a new list
  bigip_security_port_list:
    name: foo
    ports:
      - 3389
      - 8080
      - 25
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

- name: Create port list with series of ranges
  bigip_security_port_list:
    name: foo
    port_ranges:
      - 25-30
      - 80-500
      - 50-78
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

- name: Use multiple types of port arguments
  bigip_security_port_list:
    name: foo
    port_ranges:
      - 25-30
      - 80-500
      - 50-78
    ports:
      - 8080
      - 443
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

- name: Remove port list
  bigip_security_port_list:
    name: foo
    password: secret
    server: lb.mydomain.com
    state: absent
    user: admin
  delegate_to: localhost

- name: Create port list from a file with one port per line
  bigip_security_port_list:
    name: lot-of-ports
    ports: "{{ lookup('file', 'my-large-port-list.txt').split('\n') }}"
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ Возвращаемое значение Описание
description
строка
изменено
Новое описание списка портов.

Пример:
Мой список портов
port_lists
список
изменено
Новый список имен списков портов, примененных к списку портов.

Пример:
['/Common/list1', '/Common/list2']
port_ranges
список
изменено
Новый список диапазонов портов, примененных к списку портов.

Пример:
['80-100', '200-8080']
ports
список
изменено
Новый список портов, примененных к списку портов.

Пример:
[80, 443]


Статус

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

Автор

  • Tim Rupp (@caphrim007)

Подсказка

Если вы заметите какие-либо проблемы в этой документации, вы можете редактировать этот документ, чтобы улучшить его.

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

Spec-Zone.ru

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