f5networks.f5_modules.bigip_gtm_topology_region модуль — Управляет областями топологии GTM

Примечание

Этот модуль входит в коллекцию f5networks.f5_modules (версия 1.31.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install f5networks.f5_modules.

Чтобы использовать его в playbook, укажите: f5networks.f5_modules.bigip_gtm_topology_region.

Новинка в f5networks.f5_modules 1.0.0

Описание
Параметры
Примечания
Примеры
Возвращаемые значения

Описание

Управляет областями топологии GTM (теперь BIG-IP DNS).

Параметры

Параметр	Комментарии
name строка / обязательно	Указывает имя региона.
partition строка	Раздел устройства для управления ресурсами. Параметр раздела также учитывается при совместном использовании с параметрами `pool`, `data_center`, и `region`. По умолчанию: `"Common"`
provider словарь добавлен в f5networks.f5_modules 1.0.0	Объект типа dict, содержащий данные подключения.
auth_provider строка	Настраивает поставщика аутентификации для получения токенов аутентификации с удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
no_f5_teem логическое	Если `yes`, данные телеметрии TEEM не отправляются на F5. Вы можете опустить этот параметр, установив переменную среды `F5_TELEMETRY_OFF`. Предыдущая переменная `F5_TEEM`, устарела, так как её название было запутанным. Варианты: `false` ← (по умолчанию) `true`
password псевдонимы: pass, pwd строка / обязательно	Пароль учетной записи пользователя, используемой для подключения к BIG-IP или BIG-IQ. Вы можете опустить этот параметр, установив переменную среды `F5_PASSWORD`.
server строка / обязательно	Хост BIG-IP или хост BIG-IQ. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER`.
server_port целое число	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную среды `F5_SERVER_PORT`. По умолчанию: `443`
timeout целое число	Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истекает до завершения операции, модуль выдаст ошибку.
transport строка	Настраивает транспортное соединение для использования при подключении к удаленному устройству. Варианты: `"rest"` ← (по умолчанию)
user строка / обязательно	Имя пользователя для подключения к BIG-IP или BIG-IQ. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную среды `F5_USER`.
validate_certs логическое	Если `no`, сертификаты SSL не будут проверены. Используйте это только на сайтах, контролируемых вами, с использованием самозаверяемых сертификатов. Вы можете опустить этот параметр, установив переменную среды `F5_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)
region_members список / элементы=словарь	Указывает список участников региона. Этот список участников — это все или ничего, для добавления или удаления участника необходимо указать весь список участников. Список перепишет то, что есть на устройстве, если они отличаются. Если вы укажите пустой список, список участников региона будет удален.
continent строка	Указывает один из семи континентов вместе с настройкой `Unknown`. Указание `Unknown` заставляет систему использовать стандартное разрешение, если система не может определить расположение локального DNS-сервера, который делает запрос. Поддерживаются полные названия континентов и их сокращенные варианты.
country строка	Название или код страны для использования. Помимо полных названий стран, можно указать также их сокращенную форму, например `US` вместо `United States`. Список допустимых кодов стран можно найти здесь https://countrycode.org/.
datacenter строка	Указывает имя центра обработки данных GTM, уже определенного в конфигурации.
geo_isp строка	Указывает геолокационную компанию-провайдера интернет-услуг.

isp string	Указывает интернет-провайдера. Варианты: `"AOL"` `"BeijingCNC"` `"CNC"` `"ChinaEducationNetwork"` `"ChinaMobilNetwork"` `"ChinaRailwayTelcom"` `"ChinaTelecom"` `"ChinaUnicom"` `"Comcast"` `"Earthlink"` `"ShanghaiCNC"` `"ShanghaiTelecom"`
negate boolean	При установке в c(true) система выбирает эту топологическую область, когда источник запроса не соответствует. Может быть указана только одна запись списка вместе с negate. Варианты: `false` ← (по умолчанию) `true`
pool string	Указывает имя пула GTM, уже определенного в конфигурации.
region string	Указывает имя региона, уже определенного в конфигурации.
state string	Указывает область в данной стране.
subnet string	IP-адрес и маска сети в формате CIDR.
state string	Если `state` равно `present`, гарантирует существование региона. Если `state` равно `absent`, гарантирует удаление региона. Варианты: `"present"` ← (по умолчанию) `"absent"`

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на сайте https://www.ansible.com/integrations/networks/f5.
Требуется версия ПО BIG-IP >= 12.
Модули F5 манипулируют только рабочей конфигурацией продукта F5. Чтобы убедиться, что определенная для BIG-IP конфигурация сохраняется на диске, убедитесь, что включен хотя бы один task, использующий модуль f5networks.f5_modules.bigip_config для сохранения рабочей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения вашей рабочей конфигурации.

Примеры

- name: Create topology region
  bigip_gtm_topology_region:
    name: foobar
    region_members:
      - country: CN
        negate: true
      - datacenter: baz
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

- name: Modify topology region
  bigip_gtm_topology_region:
    name: foobar
    region_members:
      - continent: EU
      - country: PL
    provider:
      password: secret
      server: lb.mydomain.com
      user: admin
  delegate_to: localhost

Значения возврата

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

Ключ	Описание
name string	Значение имени области GTM. Возвращено: changed Пример: `"foobar"`
region_members list / elements=string	Список членов области GTM. Возвращено: changed Пример: `[{"continent": "EU"}, {"country": "PL"}]`

Авторы

Wojciech Wypior (@wojtek0806)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/f5networks/f5_modules/bigip_gtm_topology_region_module.html