bigiq_regkey_license_assignment - Управление назначением лицензий regkey на BIG-IP из BIG-IQ.

Новое в версии 2.6.

Обзор
- Требования
Параметры
Примечания
Примеры
Статус
Техническое обслуживание
- Автор

Обзор

Управляет назначением лицензий regkey на BIG-IQ. Назначение означает, что лицензия назначена BIG-IP или должна быть назначена BIG-IP. Кроме того, этот модуль поддерживает отмену назначений с устройств BIG-IP.

Требования

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

f5-sdk >= 3.0.9

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
device			Когда `managed` равно `no`, указывает адрес или имя хоста, по которому BIG-IQ может связаться с удалённым устройством для регистрации. Когда `managed` равно `yes`, указывает управляемое устройство или UUID устройства, которое требуется зарегистрировать. Если `managed` равно `yes`, крайне важно, чтобы не было более одного устройства с одинаковым именем. BIG-IQ внутренне распознаёт устройства по их идентификатору, и поэтому этот модуль не может гарантировать, что будет зарегистрировано правильное устройство. Возвращаемое устройство — это устройство, которое будет использоваться.
device_password			Пароль `device_username`. Когда `managed` равно `no`, этот параметр обязателен.
device_port		По умолчанию: 443	Указывает порт удалённого устройства для подключения. Если этот параметр не указан, используется значение по умолчанию `443`.
device_username			Имя пользователя для подключения к удалённому устройству. Этот пользователь должен иметь достаточные привилегии на удалённом устройстве для работы с лицензированием. Обычно это роль `Administrator`. Когда `managed` равно `no`, этот параметр обязателен.
key обязательно			Ключ регистрации, который требуется назначить из пула.
managed bool		Варианты: no yes	Указывает, является ли указанное устройство управляемым или неуправляемым. Когда `state` равно `present`, этот параметр обязателен.
password обязательно			Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, если переменная среды `F5_PASSWORD` задана. псевдонимы: pass, pwd
pool обязательно			Пул ключей регистрации для использования.
provider (добавлено в 2.5)			Объект типа dict, содержащий данные подключения.
	password обязательно		Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, если переменная среды `F5_PASSWORD` задана. псевдонимы: pass, pwd
	server обязательно		Хост BIG-IP. Этот параметр можно опустить, если переменная среды `F5_SERVER` задана.
	server_port	По умолчанию: 443	Порт сервера BIG-IP. Этот параметр можно опустить, если переменная среды `F5_SERVER_PORT` задана.
	user обязательно		Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Этот параметр можно опустить, если переменная среды `F5_USER` задана.
	validate_certs bool	Варианты: no да ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах, находящихся под вашим контролем, с самозаверенными сертификатами. Этот параметр можно опустить, если переменная среды `F5_VALIDATE_CERTS` задана.
	timeout	По умолчанию: 10	Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль выдаст ошибку.
	ssh_keyfile		Указывает SSH-ключевой файл для аутентификации подключения к удалённому устройству. Этот аргумент используется только для транспортов cli. Если значение не указано в задаче, используется значение переменной среды `ANSIBLE_NET_SSH_KEYFILE`.
	transport обязательно	Варианты: rest cli ←	Настраивает транспортное соединение для использования при подключении к удалённому устройству.
server обязательно			Хост BIG-IP. Этот параметр можно опустить, если переменная среды `F5_SERVER` задана.
server_port (добавлено в 2.2)		По умолчанию: 443	Порт сервера BIG-IP. Этот параметр можно опустить, если переменная среды `F5_SERVER_PORT` задана.
state		Варианты: present ← absent	Если `present`, гарантирует, что устройству назначена указанная лицензия. Если `absent`, гарантирует, что лицензия аннулируется с удалённого устройства и освобождается в BIG-IQ.
user обязательно			Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Этот параметр можно опустить, если переменная среды `F5_USER` задана.
validate_certs bool (добавлено в 2.0)		Варианты: no да ←	Если `no`, сертификаты SSL не будут проверены. Используйте только на сайтах, находящихся под вашим контролем, с самозаверенными сертификатами. Этот параметр можно опустить, если переменная среды `F5_VALIDATE_CERTS` задана.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на сайте https://www.ansible.com/integrations/networks/f5.
Требуется пакет f5-sdk Python на хосте. Это можно сделать так же просто, как pip install f5-sdk.

Примеры

- name: Register an unmanaged device
  bigiq_regkey_license_assignment:
    pool: my-regkey-pool
    key: XXXX-XXXX-XXXX-XXXX-XXXX
    device: 1.1.1.1
    managed: no
    device_username: admin
    device_password: secret
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

- name: Register an managed device, by name
  bigiq_regkey_license_assignment:
    pool: my-regkey-pool
    key: XXXX-XXXX-XXXX-XXXX-XXXX
    device: bigi1.foo.com
    managed: yes
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

- name: Register an managed device, by UUID
  bigiq_regkey_license_assignment:
    pool: my-regkey-pool
    key: XXXX-XXXX-XXXX-XXXX-XXXX
    device: 7141a063-7cf8-423f-9829-9d40599fa3e0
    managed: yes
    password: secret
    server: lb.mydomain.com
    state: present
    user: admin
  delegate_to: localhost

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, поддерживаемых сообществом 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.6/modules/bigiq_regkey_license_assignment_module.html