Spec-Zone.ru › Ansible 2.4

iosxr_system - Управление системными атрибутами на устройствах Cisco IOS XR

Новая версия 2.3.

  • Описание
  • Параметры
  • Примеры
  • Возвращаемые значения
  • Примечания
    • Статус
    • Информация о техническом обслуживании

Описание

  • Этот модуль обеспечивает декларативное управление атрибутами системы узла на устройствах Cisco IOS XR. Он предоставляет возможность настроить параметры системы хоста или удалить эти параметры из активной конфигурации устройства.

Параметры

параметр обязательный по умолчанию варианты комментарии
domain_name
нет
Настройте имя домена IP на удалённом устройстве на предоставленное значение. Значение должно быть в виде доменного имени и будет добавлено к hostname для создания полностью квалифицированного доменного имени.
domain_search
нет
Предоставляет список суффиксов домена для добавления к имени хоста для целей разрешения имён. Этот аргумент принимает список имён и будет согласован с текущей активной конфигурацией на рабочем узле.
hostname
нет
Настройте параметр имени хоста устройства. Этот параметр принимает значение ASCII строки.
lookup_enabled
нет
  • да
  • нет
Предоставляет административный контроль для включения или отключения разрешений DNS. Когда этот аргумент установлен в True, разрешения выполняются, а когда он установлен в False, разрешения не выполняются.
lookup_source
нет
Аргумент lookup_source предоставляет один или несколько исходных интерфейсов для использования при выполнении разрешений DNS. Интерфейс, предоставленный в lookup_source, должен быть допустимым интерфейсом, настроенным на устройстве.
name_servers
нет
Аргумент name_serves принимает список серверов имен DNS через FQDN или IP-адрес для использования для выполнения разрешений поиска имён. Этот аргумент принимает список серверов DNS. Смотрите примеры.
provider
нет
Объект dict, содержащий данные подключения.
Объект словаря provider
параметр обязательный по умолчанию варианты комментарии
username
нет
Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_USERNAME.
host
да
Указывает имя хоста DNS или адрес для подключения к удалённому устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
ssh_keyfile
нет
Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Это значение - путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_SSH_KEYFILE.
timeout
нет 10
Указывает таймаут в секундах для связи с сетевым устройством для подключения или отправки команд. Если таймаут истекает до завершения операции, модуль выдаст ошибку.
password
нет
Указывает пароль для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_PASSWORD.
port
нет 22
Указывает порт для построения подключения к удалённому устройству.
state
нет present
  • present
  • absent
Состояние значений конфигурации в текущей активной конфигурации устройства. При установке в present значения должны быть настроены в активной конфигурации устройства, а при установке в absent значения не должны быть в активной конфигурации устройства.

Примеры

- name: configure hostname and domain-name
  iosxr_system:
    hostname: iosxr01
    domain_name: test.example.com
    domain-search:
      - ansible.com
      - redhat.com
      - cisco.com
- name: remove configuration
  iosxr_system:
    state: absent
- name: configure DNS lookup sources
  iosxr_system:
    lookup_source: MgmtEth0/0/CPU0/0
    lookup_enabled: yes
- name: configure name servers
  iosxr_system:
    name_servers:
      - 8.8.8.8
      - 8.8.4.4

Возвращаемые значения

Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:

имя описание возвращаемое тип пример
commands
Список команд режима конфигурации для отправки на устройство
всегда список ['hostname iosxr01', 'ip domain-name test.example.com']

Примечания

Примечание

  • Проверено на IOS XR 6.1.2

Статус

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

Информация о техническом обслуживании

Для получения дополнительной информации о поддержке данного модуля компанией Red Hat обратитесь к knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/iosxr_system_module.html

Spec-Zone.ru

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