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

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

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

Обзор

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

Требования

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

f5-sdk >= 3.0.9

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
address_lists			Простой список существующих списков адресов для добавления в этот список. Списки адресов можно указать либо в полном имени (/Common/foo), либо в кратком имени (foo). Если используется короткое имя, аргумент `partition` будет автоматически добавлен перед коротким именем.
address_ranges			Список диапазонов адресов, где диапазон начинается с номера порта, за которым следует дефис (-) и затем второе число. Если первый адрес больше второго числа, числа будут переставлены для правильного форматирования. Например, `2.2.2.2-1.1.1`. станет `1.1.1.1-2.2.2.2`.
addresses			Отдельные адреса, которые вы хотите добавить в список. Эти адреса отличаются от диапазонов и списков списков, таких как те, которые могут быть использованы в `address_ranges` и `address_lists` соответственно.
description			Описание списка адресов
fqdns			Список полных доменных имен (FQDN). FQDN содержит по крайней мере одну десятичную точку, отделяющую хост от домена. Чтобы добавить FQDN в список, необходимо настроить глобальный разрешитель FQDN. В настоящее время это можно сделать либо через `bigip_command`, либо в пользовательском интерфейсе BIG-IP. Если используется `bigip_command`, это можно сделать с помощью `tmsh modify security firewall global-fqdn-policy FOO`, где `FOO` — это DNS-разрешитель, настроенный в `tmsh create net dns-resolver FOO`.
geo_locations			Список геолокаций, указанных по их `country` и `region`.
	country обязательно	Варианты: Любой допустимый 2-символьный код страны ISO. Любое допустимое полное название страны.	Название или код страны геолокации для использования. В дополнение к полным названиям стран, вы также можете указать их сокращенную форму, например, `US` вместо `United States`. Допустимые коды стран можно найти здесь https://countrycode.org/.
	region		Название региона страны для использования.
name обязательно			Указывает имя списка адресов.
partition		Значение по умолчанию: Common	Раздел устройства для управления ресурсами.
password обязательно			Пароль учетной записи пользователя, используемой для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная окружения `F5_PASSWORD` установлена. псевдонимы: pass, pwd
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		Варианты: 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 an address list
  bigip_security_address_list:
    name: foo
    addresses:
      - 3.3.3.3
      - 4.4.4.4
      - 5.5.5.5
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

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

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

Ключ		Возвращаемое значение	Описание
address_lists список		изменённое	Новый список имён списков адресов, применённых к списку адресов. Пример: ['/Common/list1', '/Common/list2']
address_ranges список		изменённое	Новый список диапазонов адресов, применённых к списку адресов. Пример: ['1.1.1.1-2.2.2.2', '3.3.3.3-4.4.4.4']
addresses список		изменённое	Новый список адресов, применённых к списку адресов. Пример: ['1.1.1.1', '2.2.2.2']
description строка		изменённое	Новое описание списка адресов. Пример: Мой список адресов
fqdns список		изменённое	Новый список имён FQDN, применённых к списку адресов. Пример: ['google.com', 'mit.edu']
geo_locations сложное		изменённое	Новый список геолокаций, применённых к списку адресов.
	country строка	изменённое	Страна геолокации. Пример: US
	region строка	изменённое	Регион геолокации. Пример: Калифорния

Статус

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

Автор

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_address_list_module.html