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, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых лично, с самозаверяющими сертификатами. Можно опустить этот параметр, если переменная среды F5_VALIDATE_CERTS задана. | |
| transport обязательно |
| Настраивает транспортное соединение для использования при подключении к удаленному устройству. | |
| server обязательно | Хост BIG-IP. Можно опустить этот параметр, если переменная среды F5_SERVER задана. | ||
| server_port (добавлено в 2.2) | По умолчанию: 443 | Порт сервера BIG-IP. Можно опустить этот параметр, если переменная среды F5_SERVER_PORT задана. | |
| state (добавлено в 2.5) |
| Когда present, гарантирует, что список адресов и записи существуют.Когда absent, гарантирует удаление списка адресов. | |
| user обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Можно опустить этот параметр, если переменная среды F5_USER задана. | ||
| validate_certs (добавлено в 2.0) |
| Если 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