Spec-Zone.ru › Ansible

Модуль f5networks.f5_modules.bigiq_utility_license_assignment — управление назначением лицензий Utility на BIG-IP с BIG-IQ

Примечание

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

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

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

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

Добавлено в f5networks.f5_modules 1.0.0

  • Краткое описание
  • Параметры
  • Примечания
  • Примеры

Краткое описание

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

Параметры

Параметр

Комментарии

device

string / обязательный

Если managed равно false, указывает адрес или имя хоста, по которому BIG-IQ может подключиться к удалённому устройству для его регистрации.

Если managed равно true, указывает управляемое устройство или UUID устройства, которое требуется зарегистрировать.

Если managed равно true, крайне важно, чтобы у вас не было нескольких устройств с одинаковым именем. BIG-IQ распознаёт устройства внутри системы по их идентификатору, поэтому этот модуль не может гарантировать регистрацию нужного устройства. Будет использовано возвращённое устройство.

device_password

string

Пароль для device_username.

Если managed равно false, этот параметр обязателен.

device_port

integer

Указывает порт удалённого устройства для подключения.

Если этот параметр не указан, используется значение по умолчанию 443.

По умолчанию: 443

device_username

string

Имя пользователя для подключения к удалённому устройству.

У этой учётной записи должны быть достаточные привилегии для выполнения лицензирования на удалённом устройстве. Обычно это роль Administrator.

Если managed равно false, этот параметр обязателен.

key

string / обязательный

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

managed

boolean

Указывает, является ли указанное устройство управляемым.

Если state равно present, этот параметр обязателен.

Варианты:

  • false
  • true

offering

string / обязательный

Название предложения лицензии, назначаемой устройству.

provider

dictionary

добавлено в f5networks.f5_modules 1.0.0

Объект dict с данными для подключения.

auth_provider

string

Настраивает поставщика аутентификации для получения токенов аутентификации с удалённого устройства.

Этот параметр используется при работе с устройствами BIG-IQ.

no_f5_teem

boolean

Если yes, данные телеметрии TEEM не отправляются в F5.

Этот параметр можно не указывать, задав переменную среды F5_TELEMETRY_OFF.

Ранее использовавшаяся переменная F5_TEEM объявлена устаревшей, так как её название вводило в заблуждение.

Варианты:

  • false ← (по умолчанию)
  • true

password

псевдонимы: pass, pwd

string / обязательный

Пароль учётной записи пользователя для подключения к BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную среды F5_PASSWORD.

server

string / обязательный

Узел BIG-IP или BIG-IQ.

Этот параметр можно не указывать, задав переменную среды F5_SERVER.

server_port

integer

Порт сервера BIG-IP.

Этот параметр можно не указывать, задав переменную среды F5_SERVER_PORT.

По умолчанию: 443

timeout

integer

Задаёт тайм-аут в секундах для подключения к сетевому устройству или отправки ему команд. Если время ожидания истекает до завершения операции, модуль выдаёт ошибку.

transport

string

Настраивает транспортное соединение для подключения к удалённому устройству.

Варианты:

  • "rest" ← (по умолчанию)

user

string / обязательный

Имя пользователя для подключения к BIG-IP или BIG-IQ. У пользователя должны быть права администратора на устройстве.

Этот параметр можно не указывать, задав переменную среды F5_USER.

validate_certs

boolean

Если no, SSL-сертификаты не проверяются. Используйте этот параметр только на сайтах под вашим контролем, где используются самоподписанные сертификаты.

Этот параметр можно не указывать, задав переменную среды F5_VALIDATE_CERTS.

Варианты:

  • false
  • true ← (по умолчанию)

state

string

Если present, гарантирует, что устройству назначена указанная лицензия.

Если absent, гарантирует отзыв лицензии для удалённого устройства и её освобождение на BIG-IQ.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

unit_of_measure

string

Задаёт периодичность оплаты использования этой лицензии.

В зависимости от вашей лицензии могут быть доступны разные единицы измерения. Если конкретная единица измерения недоступна, модуль сообщит об этом при лицензировании.

Варианты:

  • "hourly" ← (по умолчанию)
  • "daily"
  • "monthly"
  • "yearly"

Примечания

Примечание

  • Дополнительные сведения об использовании Ansible для управления устройствами F5 Networks см. на странице https://www.ansible.com/integrations/networks/f5.
  • Требуется версия программного обеспечения BIG-IP >= 12.
  • Модули F5 изменяют только текущую конфигурацию продукта F5. Чтобы настройки, относящиеся к BIG-IP, сохранялись на диске, обязательно добавьте хотя бы одну задачу, использующую модуль f5networks.f5_modules.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: false
    device_username: admin
    device_password: secret
    state: present
    provider:
      password: secret
      server: cm.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: true
    state: present
    provider:
      password: secret
      server: cm.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: true
    state: present
    provider:
      password: secret
      server: cm.mydomain.com
      user: admin
  delegate_to: localhost

Авторы

  • Tim Rupp (@caphrim007)

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

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API