Модуль infoblox.nios_modules.nios_extensible_attribute – Настройка определения расширяемого атрибута Infoblox NIOS

Примечание

Этот модуль входит в коллекцию infoblox.nios_modules (версия 1.9.0).

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

Для установки используйте: ansible-galaxy collection install infoblox.nios_modules. Для использования этого модуля требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: infoblox.nios_modules.nios_extensible_attribute.

Добавлено в infoblox.nios_modules 1.7.0

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

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

Добавляет и/или удаляет объекты определений расширяемых атрибутов на серверах Infoblox NIOS. Этот модуль управляет объектами NIOS extensibleattributedef с помощью интерфейса Infoblox WAPI через REST.

Требования

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

infoblox-client

Параметры

Параметр	Описание
comment строка	Задает текстовый комментарий, связанный с экземпляром этого объекта. Указанный текст будет сохранен в экземпляре объекта.
default_value строка	Задает значение по умолчанию, которое предварительно заполняется в графическом интерфейсе при использовании этого атрибута. Для типов Email, URL и string значение может содержать не более 256 символов.
flags строка	Это поле содержит флаги расширяемого атрибута. Возможные значения: (A)udited, (C)loud API, Cloud (G)master, (I)nheritable, (L)isted, (M)andatory value, MGM (P)rivate, (R)ead Only, (S)ort enum values, Multiple (V)alues. Если поле содержит два или более флагов, их необходимо перечислить в указанном выше порядке. Например, «CR» — допустимое значение поля «flags», поскольку C = Cloud API указано перед R = Read only. Однако значение «RC» недопустимо, так как нарушает порядок флагов в поле «flags».
list_values список / элементы=строка	Задает список предустановленных значений, связанных с экземпляром этого объекта. Применяется только при типе атрибута ENUM.
max целое число	Задает максимальное значение для экземпляра этого объекта. Для расширяемого атрибута типа STRING это значение задает максимальное количество символов в строке. Для расширяемого атрибута типа INTEGER оно задает максимально допустимое целое число. Не применяется к атрибутам других типов.
min целое число	Задает минимальное значение для экземпляра этого объекта. Для расширяемого атрибута типа STRING это значение задает минимальное количество символов в строке. Для расширяемого атрибута типа INTEGER оно задает минимальное допустимое целое число. Не применяется к атрибутам других типов.
name строка / обязательный	Задает имя экземпляра объекта на сервере NIOS.
provider словарь	Объект dict, содержащий сведения о подключении.
cert строка	Указывает файл клиентского сертификата с дайджестом конфигурации x509 для дополнительного уровня защиты соединения с удаленным экземпляром NIOS. Значение также можно задать с помощью переменной среды `INFOBLOX_CERT`.
host строка	Указывает DNS-имя узла или адрес для подключения к удаленному экземпляру NIOS WAPI через REST. Значение также можно задать с помощью переменной среды `INFOBLOX_HOST`.
http_pool_connections целое число	Вставьте описание здесь По умолчанию: `10`
http_pool_maxsize целое число	Вставьте описание здесь По умолчанию: `10`
http_request_timeout целое число	Время ожидания ответа Значение также можно задать с помощью переменной среды `INFOBLOX_HTTP_REQUEST_TIMEOUT`. По умолчанию: `10`
key строка	Указывает файл закрытого ключа для шифрования с помощью сертификата, необходимого для подключения к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной среды `INFOBLOX_KEY`.
max_results целое число	Указывает максимальное количество возвращаемых объектов. Если задано отрицательное число, устройство вернет ошибку, когда количество возвращаемых объектов превысит указанное значение. Значение также можно задать с помощью переменной среды `INFOBLOX_MAX_RESULTS`. По умолчанию: `1000`
max_retries целое число	Задает количество повторных попыток до признания соединения работоспособным. Значение также можно задать с помощью переменной среды `INFOBLOX_MAX_RETRIES`. По умолчанию: `3`
password строка	Указывает пароль для аутентификации при подключении к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной среды `INFOBLOX_PASSWORD`.
silent_ssl_warnings логическое значение	Вставьте описание здесь Варианты: `false` `true` ← (по умолчанию)
username строка	Задает имя пользователя для аутентификации при подключении к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной среды `INFOBLOX_USERNAME`.
validate_certs псевдонимы: ssl_verify логическое значение	Логическое значение, включающее или отключающее проверку SSL-сертификатов. Значение также можно задать с помощью переменной среды `INFOBLOX_SSL_VERIFY`. Варианты: `false` ← (по умолчанию) `true`
wapi_version строка	Указывает версию WAPI, которую следует использовать. Значение также можно задать с помощью переменной среды `INFOBLOX_WAPI_VERSION`. До Ansible 2.8 версией WAPI по умолчанию была 1.4. По умолчанию: `"2.12.3"`
state строка	Задает требуемое состояние экземпляра объекта на сервере NIOS. Если это значение задано как `present`, объект настраивается на устройстве; если значение задано как `absent`, объект удаляется с устройства (при необходимости). Варианты: `"present"` ← (по умолчанию) `"absent"`
type строка	Задает требуемый тип определения этого объекта атрибута на сервере NIOS. Варианты: `"DATE"` `"EMAIL"` `"ENUM"` `"INTEGER"` `"STRING"` ← (по умолчанию) `"URL"`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Этот модуль необходимо запускать локально; для этого можно указать connection: local.
Подробные сведения об использовании Infoblox с Ansible см. в :ref:`nios_guide`.

Примеры

- name: Configure an extensible attribute
  infoblox.nios_modules.nios_extensible_attribute:
    name: my_string
    type: STRING
    comment: Created by ansible
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Update an extensible attribute to accept multiple values
  infoblox.nios_modules.nios_extensible_attribute:
    name: my_string
    type: STRING
    flags: V
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove a extensible attribute
  infoblox.nios_modules.nios_extensible_attribute:
    name: my_string
    type: INTEGER
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Create INT extensible attribute
  infoblox.nios_modules.nios_extensible_attribute:
    name: my_int
    type: INTEGER
    comment: Created by ansible
    min: 10
    max: 20
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Update an extensible attribute
  infoblox.nios_modules.nios_extensible_attribute:
    name: my_int
    type: INTEGER
    comment: Updated by ansible
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Create an list extensible attribute
  infoblox.nios_modules.nios_extensible_attribute:
    name: my_list
    type: ENUM
    state: present
    list_values:
      - one
      - two
      - three
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

Matthew Dennett (@matthewdennett)
Hugues Malphettes (@hmalphettes)

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

© 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/infoblox/nios_modules/nios_extensible_attribute_module.html