f5networks.f5_modules.bigip_snat_translation – Управление трансляциями SNAT на BIG-IP
Примечание
Этот плагин входит в коллекцию f5networks.f5_modules (версия 1.6.0).
Для его установки используйте: ansible-galaxy collection install f5networks.f5_modules.
Для использования в книге задач укажите: f5networks.f5_modules.bigip_snat_translation.
Новое в версии 1.0.0: из f5networks.f5_modules
Описание
- Управление трансляциями SNAT на системе BIG-IP.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| address строка | Указывает IP-адрес трансляции SNAT. Когда state равно present, enabled, или disabled, этот параметр обязателен.Этот параметр не может быть обновлен после его установки. псевдонимы: ip | ||
| arp логический тип |
| Если yes, указывает, что NAT отправляет запросы ARP. | |
| connection_limit целое число | Устанавливает ограничение на количество подключений, к которым должен подключиться адрес трансляции SNAT, прежде чем он больше не будет инициировать подключение. Значение по умолчанию 0 указывает, что настройка отключена.Допустимый диапазон значений 0 - 65535. | ||
| description строка | Описание трансляции snat. none or '' устанавливает описание по умолчанию null. | ||
| ip_idle_timeout строка | Устанавливает время, в течение которого подключения к IP-адресу, инициированному с помощью адреса SNAT, могут оставаться неактивными, прежде чем они будут автоматически отключены. indefinite предотвращает истечение времени ожидания подключения.Допустимый диапазон значений 0 - 4294967295 секунд. Указание indefinite устанавливает его в максимальное значение. | ||
| name строка / обязательно | Имя трансляции SNAT. | ||
| partition строка | Раздел устройства для управления ресурсами. Требуется со значением состояния absent, когда используется раздел, отличный от Common. | ||
| provider словарь добавлено в 1.0.0 f5networks.f5_modules | Объект словаря, содержащий данные соединения. | ||
| auth_provider строка | Настраивает поставщика аутентификации для получения маркеров аутентификации от удаленного устройства. Этот параметр используется при работе с устройствами BIG-IQ. | ||
| no_f5_teem логический тип |
| Если yes, данные телеметрии TEEM не отправляются в F5.Вы можете опустить этот параметр, установив переменную окружения F5_TEEM. | |
| password строка / обязательно | Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную окружения F5_PASSWORD.псевдонимы: pass, pwd | ||
| server строка / обязательно | Хост BIG-IP. Вы можете опустить этот параметр, установив переменную окружения F5_SERVER. | ||
| server_port целое число | Значение по умолчанию: 443 | Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную окружения F5_SERVER_PORT. | |
| timeout целое число | Устанавливает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истечет до завершения операции, модуль выдаст ошибку. | ||
| transport строка |
| Настраивает транспортное соединение для использования при подключении к удаленному устройству. | |
| user строка / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Вы можете опустить этот параметр, установив переменную окружения F5_USER. | ||
| validate_certs логический тип |
| Если no, сертификаты SSL не проверяются. Используйте это только на сайтах, контролируемых лично, с использованием самозаверяющих сертификатов.Вы можете опустить этот параметр, установив переменную окружения F5_VALIDATE_CERTS. | |
| state строка |
| Состояние трансляции SNAT. Если absent, удаляет трансляцию SNAT, если она существует. present создает трансляцию SNAT и включает ее. Если enabled, включает трансляцию SNAT, если она существует. Если disabled, создает трансляцию SNAT при необходимости и устанавливает состояние на disabled. | |
| tcp_idle_timeout строка | Устанавливает время, в течение которого TCP-соединения, инициированные с помощью адреса SNAT, могут оставаться неактивными, прежде чем они будут автоматически отключены. indefinite предотвращает истечение времени ожидания подключения.Допустимый диапазон значений 0 - 4294967295 секунд. Указание indefinite устанавливает его в максимальное значение. | ||
| traffic_group строка | Группа трафика для адреса snat-translation. При создании нового адреса, если это значение не указано, значение по умолчанию /Common/traffic-group-1. | ||
| udp_idle_timeout строка | Устанавливает время, в течение которого UDP-соединения, инициированные с помощью адреса SNAT, могут оставаться неактивными, прежде чем они будут автоматически отключены. indefinite предотвращает истечение времени ожидания подключения.Допустимый диапазон значений 0 - 4294967295 секунд. Указание indefinite устанавливает его в максимальное значение. | ||
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется версия программного обеспечения BIG-IP >= 12.
- Модули F5 манипулируют только рабочей конфигурацией продукта F5. Для обеспечения сохранения конфигурации BIG-IP на диске, убедитесь, что включен хотя бы один этап, использующий модуль f5networks.f5_modules.bigip_config для сохранения рабочей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения рабочей конфигурации.
Примеры
- name: Create a SNAT translation 'my-snat-translation'
bigip_snat_translation:
name: my-snat-pool
state: present
address: 10.10.10.10
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
- name: Modify a SNAT translation 'my-snat-translation'
bigip_snat_translation:
name: my-snat-pool
state: present
address: 10.10.10.10
arp: no
connection_limit: 300
ip_idle_timeout: 1800
tcp_idle_timeout: 1800
udp_idle_timeout: 1800
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
- name: Disable a SNAT translation 'my-snat-translation'
bigip_snat_translation:
name: my-snat-pool
state: disabled
address: 10.10.10.10
arp: no
connection_limit: 300
ip_idle_timeout: 1800
tcp_idle_timeout: 1800
udp_idle_timeout: 1800
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
- name: Enable a SNAT translation 'my-snat-translation'
bigip_snat_translation:
name: my-snat-pool
state: enabled
address: 10.10.10.10
arp: no
connection_limit: 300
ip_idle_timeout: 1800
tcp_idle_timeout: 1800
udp_idle_timeout: 1800
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
- name: Create using partition other then /Common on a SNAT translation 'my-new-snat-translation'
bigip_snat_translation:
name: my-new-snat-pool
state: enabled
address: 10.10.10.10
arp: no
connection_limit: 300
ip_idle_timeout: 1800
partition: ansible
tcp_idle_timeout: 1800
udp_idle_timeout: 1800
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
- name: Modify using traffic group other then /Common/traffic-group-1 on a SNAT translation 'my-new-snat-translation'
bigip_snat_translation:
name: my-new-snat-pool
state: enabled
address: 10.10.10.10
arp: no
connection_limit: 300
ip_idle_timeout: 1800
partition: ansible
tcp_idle_timeout: 1800
traffic_group: /Common/ansible
udp_idle_timeout: 1800
provider:
server: lb.mydomain.com
user: admin
password: secret
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| address строка | изменённое и успешно | IP-адрес, используемый для трансляции SNAT. Пример: 10.10.10.10 |
| arp логическое значение | изменённое | Указывает, отправляет ли snat-translation запросы ARP. Пример: True |
| connection_limit целое число | изменённое | Новый лимит подключений для виртуального адреса. Пример: 1000 |
| description строка | изменённое | Описание snat-translation. Пример: Моя snat-translation |
| ip_idle_timeout строка | изменённое | Значение тайм-аута бездействия IP для snat-translation. Пример: 300 |
| state строка | изменённое | Новое состояние snat-translation. Пример: выключено |
| tcp_idle_timeout строка | изменённое | Значение тайм-аута бездействия TCP для snat-translation. Пример: 1800 |
| traffic_group строка | изменённое | Назначенная группа трафика. Пример: /Common/traffic-group-1 |
| udp_idle_timeout строка | изменённое | Значение тайм-аута бездействия UDP для snat-translation. Пример: неопределённо |
Авторы
- Greg Crosby (@crosbygw)
- Wojciech Wypior (@wojtek0806)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/f5networks/f5_modules/bigip_snat_translation_module.html
