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

Примечание

Этот модуль входит в состав коллекции infoblox.nios_modules (версия 1.7.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 string	Настраивает текстовый комментарий, который будет связан с экземпляром этого объекта. Предоставленная текстовая строка будет настроена в экземпляре объекта.
default_value string	Настраивает значение по умолчанию, которое предварительно заполняется в графическом интерфейсе пользователя, когда используется этот атрибут. Для типов «Электронная почта», «URL» и «Строка» значение представляет собой строку максимум из 256 символов.
flags string	Это поле содержит флаги расширяемых атрибутов. Возможные значения: (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 list / elements=string	Настраивает список предопределенных значений, связанных с экземпляром этого объекта. Применимо только тогда, когда тип атрибута установлен в ENUM.
max integer	Настраивает максимальное значение, которое будет связано с экземпляром этого объекта. Когда предоставляется для расширяемого атрибута типа STRING, значение представляет максимальное количество символов, которое может содержать строка. Когда предоставляется для расширяемого атрибута типа INTEGER, значение представляет максимальное допустимое целочисленное значение. Не применимо для других типов атрибутов.
min integer	Настраивает минимальное значение, которое будет связано с экземпляром этого объекта. Когда предоставляется для расширяемого атрибута типа STRING, значение представляет минимальное количество символов, которое может содержать строка. Когда предоставляется для расширяемого атрибута типа INTEGER, значение представляет минимальное допустимое целочисленное значение. Не применимо для других типов атрибутов.
name string / required	Настраивает предполагаемое имя экземпляра объекта на сервере NIOS.
provider dictionary	Объект dict, содержащий данные подключения.
cert string	Указывает файл клиентского сертификата с дайджестом конфигурации x509 для дополнительного уровня безопасного подключения к удаленному экземпляру NIOS. Значение также может быть указано с помощью переменной среды `INFOBLOX_CERT`.
host string	Указывает имя хоста DNS или адрес для подключения к удаленному экземпляру NIOS WAPI через REST Значение также может быть указано с помощью переменной среды `INFOBLOX_HOST`.
http_pool_connections integer	Вставьте описание здесь По умолчанию: `10`
http_pool_maxsize integer	Вставьте описание здесь По умолчанию: `10`
http_request_timeout integer	Время ожидания перед получением ответа Значение также может быть указано с помощью переменной среды `INFOBLOX_HTTP_REQUEST_TIMEOUT`. По умолчанию: `10`
key string	Указывает файл закрытого ключа для шифрования с сертификатом для подключения к удаленному экземпляру NIOS. Значение также может быть указано с помощью переменной среды `INFOBLOX_KEY`.
max_results integer	Указывает максимальное количество объектов, которые должны быть возвращены; если установлено отрицательное число, устройство вернет ошибку, когда количество возвращаемых объектов превысит настройку. Значение также может быть указано с помощью переменной среды `INFOBLOX_MAX_RESULTS`. По умолчанию: `1000`
max_retries integer	Настраивает количество попыток повторных подключений, прежде чем соединение будет объявлено работоспособным Значение также может быть указано с помощью переменной среды `INFOBLOX_MAX_RETRIES`. По умолчанию: `3`
password string	Указывает пароль, который будет использоваться для проверки подлинности подключения к удаленному экземпляру NIOS. Значение также может быть указано с помощью переменной среды `INFOBLOX_PASSWORD`.
silent_ssl_warnings boolean	Вставьте описание здесь Варианты: `false` `true` ← (по умолчанию)

username string	Настраивает имя пользователя для аутентификации подключения к удалённому экземпляру NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_USERNAME`.
validate_certs aliases: ssl_verify boolean	Логическое значение для включения или отключения проверки сертификатов SSL. Значение также можно указать с помощью переменной среды `INFOBLOX_SSL_VERIFY`. Варианты: `false` ← (по умолчанию) `true`
wapi_version string	Указывает используемую версию WAPI. Значение также можно указать с помощью переменной среды `INFOBLOX_WAPI_VERSION`. До версии ansible 2.8 по умолчанию использовалась версия WAPI 1.4. По умолчанию: `"2.12.3"`
state string	Настраивает желаемое состояние экземпляра объекта на сервере NIOS. При значении `present`, объект настраивается на устройстве; при значении `absent` значение удаляется (при необходимости) с устройства. Варианты: `"present"` ← (по умолчанию) `"absent"`
type string	Настраивает предполагаемый тип определения объекта атрибута на сервере NIOS. Варианты: `"DATE"` `"EMAIL"` `"ENUM"` `"INTEGER"` `"STRING"` ← (по умолчанию) `"URL"`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Этот модуль должен выполняться локально, что можно сделать, указав connection: local.
Обратитесь к :ref:`nios_guide`, чтобы получить более подробную информацию о работе с Infoblox в Ansible.

Примеры

- 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/infoblox/nios_modules/nios_extensible_attribute_module.html