infoblox.nios_modules.nios_cname_record модуль — Настройка записей CNAME 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_cname_record.

Новинка в infoblox.nios_modules 1.0.0

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

Описание

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

Требования

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

infoblox-client

Параметры

Параметр	Комментарии
canonical псевдонимы: cname строка / обязательный	Настраивает каноническое имя для этого записей CNAME.
comment строка	Настраивает текстовый комментарий, который будет связан с экземпляром этого объекта. Предоставленная строка текста будет настроена для экземпляра объекта.
extattrs словарь	Позволяет настроить расширенные атрибуты для экземпляра объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки.
name строка / обязательный	Указывает полное доменное имя для добавления или удаления из системы. Пользователь также может обновить имя, передав словарь, содержащий new_name, old_name. См. примеры
provider словарь	Объект словаря, содержащий данные подключения.
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 string	Настраивает ожидаемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в `present`, объект настраивается на устройстве, а когда это значение установлено в `absent`, значение удаляется (при необходимости) с устройства. Варианты: `"present"` ← (по умолчанию) `"absent"`
ttl integer	Настраивает TTL, который будет связан с этим записы CNAME.
view aliases: dns_view string	Устанавливает область DNS для связи с этим записы CNAME. Область DNS должна быть уже настроена в системе. По умолчанию: `"default"`

Примечания

Примечание

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

Примеры

- name: Configure a CNAME record
  infoblox.nios_modules.nios_cname_record:
    name: cname.ansible.com
    canonical: realhost.ansible.com
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Add a comment to an existing CNAME record
  infoblox.nios_modules.nios_cname_record:
    name: cname.ansible.com
    canonical: realhost.ansible.com
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Update name of CNAME record
  infoblox.nios_modules.nios_cname_record:
    name: {old_name: cname.ansibletestzone.com, new_name: demo.ansibletestzone.com}
    canonical: realhost.ansible.com
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove a CNAME record from the system
  infoblox.nios_modules.nios_cname_record:
    name: cname.ansible.com
    canonical: realhost.ansible.com
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

Blair Rampling (@brampling)

Ссылки на сборку

© 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_cname_record_module.html