f5networks.f5_modules.bigip_apm_policy_import – Управление импортом политики BIG-IP APM или профиля доступа APM

Примечание

Этот плагин является частью коллекции f5networks.f5_modules (версия 1.6.0).

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

Для использования в книге задач укажите: f5networks.f5_modules.bigip_apm_policy_import.

Новый в версии 1.0.0: of f5networks.f5_modules

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

Обзор

Управление импортом политики BIG-IP APM или профиля доступа APM.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
force boolean		Варианты: no ← yes	При установке в значение `yes` любая существующая политика с тем же именем будет перезаписана новым импортом. Если политика не существует, это значение игнорируется.
name string / обязательно			Имя APM-политики или APM-профиля доступа для создания или перезаписи.
partition string		По умолчанию: "Common"	Раздел устройства для управления ресурсами.
provider dictionary добавлен в 1.0.0 of f5networks.f5_modules			Объект типа dict, содержащий данные подключения.
	auth_provider string		Настройка поставщика аутентификации для получения токенов аутентификации с удаленного устройства. Этот параметр действительно используется при работе с устройствами BIG-IQ.
	no_f5_teem boolean	Варианты: no yes	Если `yes`, данные телеметрии TEEM не отправляются в F5. Вы можете опустить этот параметр, установив переменную окружения `F5_TEEM`.
	password string / обязательно		Пароль учетной записи пользователя для подключения к BIG-IP. Вы можете опустить этот параметр, установив переменную окружения `F5_PASSWORD`. псевдонимы: pass, pwd
	server string / обязательно		Хост BIG-IP. Вы можете опустить этот параметр, установив переменную окружения `F5_SERVER`.
	server_port integer	По умолчанию: 443	Порт сервера BIG-IP. Вы можете опустить этот параметр, установив переменную окружения `F5_SERVER_PORT`.
	timeout integer		Устанавливает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истекает до завершения операции, модуль вернет ошибку.
	transport string	Варианты: rest ←	Настройка транспортного подключения для подключения к удаленному устройству.
	user string / обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, установив переменную окружения `F5_USER`.
	validate_certs boolean	Варианты: no yes ←	Если `no`, сертификаты SSL не проверяются. Используйте только на контролируемых вами сайтах с самозаверенными сертификатами. Вы можете опустить этот параметр, установив переменную окружения `F5_VALIDATE_CERTS`.
reuse_objects boolean		Варианты: no yes ←	При установке в `yes`, и если объекты, на которые ссылается политика, существуют на BIG-IP, они будут использоваться вместо объектов, определенных в политике. Использование существующих объектов уменьшает размер конфигурации. Конфигурация существующих объектов может отличаться от конфигурации объектов, определенных в политике!
source path			Полный путь к файлу, который необходимо импортировать в BIG-IP APM.
type string		Варианты: profile_access ← access_policy profile_api_protection	Указывает тип импортируемого элемента.

Примечания

Примечание

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

Примеры

- name: Import APM profile
  bigip_apm_policy_import:
    name: new_apm_profile
    source: /root/apm_profile.tar.gz
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Import APM policy
  bigip_apm_policy_import:
    name: new_apm_policy
    source: /root/apm_policy.tar.gz
    type: access_policy
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Override existing APM policy
  bigip_asm_policy:
    name: new_apm_policy
    source: /root/apm_policy.tar.gz
    force: yes
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

- name: Import APM profile without re-using existing configuration objects
  bigip_apm_policy_import:
    name: new_apm_profile
    source: /root/apm_profile.tar.gz
    reuse_objects: false
    provider:
      server: lb.mydomain.com
      user: admin
      password: secret
  delegate_to: localhost

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

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

Ключ	Возвращаемое значение	Описание
force boolean	изменено	Устанавливается при перезаписи существующей политики или профиля. Пример: True
name string	изменено	Имя APM-политики или APM-профиля доступа, подлежащего созданию/перезаписи. Пример: APM_policy_global
reuse_objects boolean	изменено	Устанавливается при использовании существующих объектов на BIG-IP. Пример: True
source string	изменено	Локальный путь к файлу APM-политики. Пример: /root/some_policy.tar.gz
type string	изменено	Устанавливается для указания типа импортируемого элемента. Пример: access_policy

Авторы

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