bigiq_utility_license_assignment – Управление назначением лицензий на BIG-IP из BIG-IQ
Новая версия с 2.7.
Обзор
- Управляет назначением лицензий на BIG-IQ. Назначение означает, что лицензия назначена BIG-IP, или, что она должна быть назначена BIG-IP. Кроме того, этот модуль поддерживает отозвать назначения с устройств BIG-IP.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- f5-sdk >= 3.0.16
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| device - | Если managed равно no, указывает адрес или имя хоста, по которому BIG-IQ может обратиться к удалённому устройству для регистрации.Если managed равно yes, указывает управляемое устройство или UUID устройства, которое необходимо зарегистрировать.Если managed равно yes, очень важно, чтобы не было более одного устройства с одинаковым именем. BIG-IQ внутренне распознаёт устройства по их ID, поэтому этот модуль не гарантирует, что будет зарегистрировано правильное устройство. Возвращённое устройство будет использоваться. | ||
| device_password - | Пароль от device_username.Если managed равно no, этот параметр обязателен. | ||
| device_port - | По умолчанию: 443 | Указывает порт удалённого устройства для подключения. Если этот параметр не указан, используется значение по умолчанию 443. | |
| device_username - | Имя пользователя для подключения к удалённому устройству. Этот пользователь должен иметь достаточные права для лицензирования на удалённом устройстве. Обычно это роль Administrator.Если managed равно no, этот параметр обязателен. | ||
| key - / обязательно | Ключ регистрации, с помощью которого нужно выбрать предложение. | ||
| managed boolean |
| Указывает, является ли указанное устройство управляемым или нет. Если state равно present, этот параметр обязателен. | |
| offering - | Имя предложения лицензии, которое нужно назначить устройству. | ||
| password - / обязательно | Пароль учётной записи для подключения к BIG-IP. Этот параметр можно опустить, задав переменную окружения F5_PASSWORD.Псевдонимы: pass, pwd | ||
| provider - добавлен в 2.5 | По умолчанию: null | Объект типа dict, содержащий данные подключения. | |
| password - / обязательно | Пароль учётной записи для подключения к BIG-IP. Этот параметр можно опустить, задав переменную окружения F5_PASSWORD.Псевдонимы: pass, pwd | ||
| server - / обязательно | Хост BIG-IP. Этот параметр можно опустить, задав переменную окружения F5_SERVER. | ||
| server_port - | По умолчанию: 443 | Порт сервера BIG-IP. Этот параметр можно опустить, задав переменную окружения F5_SERVER_PORT. | |
| ssh_keyfile - | Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспортов типа cli. Этот параметр можно опустить, задав переменную окружения ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout - | По умолчанию: 10 | Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль вернёт ошибку. | |
| transport - / обязательно |
| Настраивает тип транспортного подключения при подключении к удалённому устройству. | |
| user - / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Этот параметр можно опустить, задав переменную окружения F5_USER. | ||
| validate_certs boolean |
| Если no, сертификаты SSL не проверяются. Используйте только на сайтах, контролируемых лично, и использующих самозаверенные сертификаты.Этот параметр можно опустить, задав переменную окружения F5_VALIDATE_CERTS. | |
| server - / обязательно | Хост BIG-IP. Этот параметр можно опустить, задав переменную окружения F5_SERVER. | ||
| server_port - добавлен в 2.2 | По умолчанию: 443 | Порт сервера BIG-IP. Этот параметр можно опустить, задав переменную окружения F5_SERVER_PORT. | |
| state - |
| Если present, гарантирует, что указанному устройству назначена указанная лицензия.Если absent, гарантирует, что лицензия аннулируется с удалённого устройства и освобождается на BIG-IQ. | |
| unit_of_measure - |
| Устанавливает частоту выставления счетов за использование лицензии. В зависимости от вашей лицензии, доступны разные единицы измерения. Если конкретная единица недоступна, модуль уведомит вас во время лицензирования. | |
| user - / обязательно | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Этот параметр можно опустить, задав переменную окружения F5_USER. | ||
| validate_certs boolean добавлен в 2.0 |
| Если no, сертификаты SSL не проверяются. Используйте только на сайтах, контролируемых лично, и использующих самозаверенные сертификаты.Этот параметр можно опустить, задав переменную окружения F5_VALIDATE_CERTS. | |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
- Требуется пакет f5-sdk Python на хосте. Это так же просто, как
pip install f5-sdk. - Требуется версия программного обеспечения BIG-IP ≥ 12.
- Модули F5 обрабатывают только рабочую конфигурацию продукта F5. Чтобы убедиться, что конфигурация, специфичная для BIG-IP, сохраняется на диске, необходимо включить по крайней мере одну задачу, использующую модуль bigip_config для сохранения рабочей конфигурации. Обратитесь к документации модуля для правильного использования модуля для сохранения рабочей конфигурации.
Примеры
- name: Register an unmanaged device
bigiq_utility_license_assignment:
key: XXXX-XXXX-XXXX-XXXX-XXXX
offering: F5-BIG-MSP-AFM-10G-LIC
device: 1.1.1.1
managed: no
device_username: admin
device_password: secret
state: present
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
- name: Register a managed device, by name
bigiq_utility_license_assignment:
key: XXXX-XXXX-XXXX-XXXX-XXXX
offering: F5-BIG-MSP-AFM-10G-LIC
device: bigi1.foo.com
managed: yes
state: present
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
- name: Register a managed device, by UUID
bigiq_utility_license_assignment:
key: XXXX-XXXX-XXXX-XXXX-XXXX
offering: F5-BIG-MSP-AFM-10G-LIC
device: 7141a063-7cf8-423f-9829-9d40599fa3e0
managed: yes
state: present
provider:
password: secret
server: lb.mydomain.com
user: admin
delegate_to: localhost
Статус
- Этот модуль не гарантирует обратную совместимость. [превью]
- Этот модуль поддерживается партнёром Ansible. [сертифицированный]
Авторы
- 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.7/modules/bigiq_utility_license_assignment_module.html
