Spec-Zone.ru › Ansible 2.5

nxos_aaa_server_host - Управляет конфигурацией хоста сервера AAA.

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

  • Обзор
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус
    • Поддержка
    • Автор

Обзор

  • Управляет конфигурацией хоста сервера AAA.

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
acct_port
Альтернативный UDP-порт для RADIUS-учета или ключевое слово 'default'.
address
обязательно
Адрес или имя хоста radius или tacacs.
auth_port
Альтернативный UDP-порт для RADIUS-аутентификации или ключевое слово 'default'.
encrypt_type
    Варианты:
  • 0
  • 7
Состояние шифрования, примененное к введенному ключу. 0 - открытый текст, 7 - зашифрованный. Шифрование типа 6 не поддерживается.
host_timeout
Срок ожидания для указанного хоста в секундах или ключевое слово 'default'. Диапазон от 1 до 60.
key
Общий секрет для указанного хоста или ключевое слово 'default'.
provider По умолчанию:
Нет
Устарело
Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli.
Этот параметр необходим только при использовании NX-API.
Дополнительную информацию можно найти в руководстве NXOS Platform Options.
Объект словаря с деталями подключения.
username
Настраивает имя пользователя для аутентификации подключения к удаленному устройству. Это значение используется для аутентификации входа в командную строку или аутентификации nxapi в зависимости от используемого транспорта. Если значение не указано в задаче, вместо него будет использовано значение переменной среды ANSIBLE_NET_USERNAME.
authorize
(добавлен в 2.5.3)
    Варианты:
  • нет ←
  • да
Указывает модулю перейти в привилегированный режим на удаленном устройстве перед отправкой любых команд. Если не указано, устройство попытается выполнить все команды в режиме без привилегий. Если значение не указано в задаче, вместо него будет использовано значение переменной среды ANSIBLE_NET_AUTHORIZE.
ssh_keyfile
Указывает SSH-ключ для аутентификации подключения к удаленному устройству. Этот аргумент используется только для транспорта cli. Если значение не указано в задаче, вместо него будет использовано значение переменной среды ANSIBLE_NET_SSH_KEYFILE.
use_proxy
(добавлен в 2.5)
    Варианты:
  • да ←
  • нет
Если no, переменные среды http_proxy и https_proxy будут проигнорированы.
auth_pass
(добавлен в 2.5.3)
По умолчанию:
нет
Указывает пароль, необходимый для входа в привилегированный режим на удаленном устройстве. Если authorize ложно, этот аргумент ничего не делает. Если значение не указано в задаче, вместо него будет использовано значение переменной среды ANSIBLE_NET_AUTH_PASS.
host
обязательно
Указывает имя хоста DNS или адрес для подключения к удаленному устройству по указанному транспорту. Значение host используется в качестве целевого адреса для транспорта.
timeout
(добавлен в 2.3)
По умолчанию:
10
Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истекает до завершения операции, модуль выдаст ошибку. NX-API может быть медленным при возврате на длительных командах (sh mac, sh bgp и т. д.).
use_ssl
    Варианты:
  • да
  • нет ←
Настраивает transport на использование SSL, если установлено в true только когда transport=nxapi, в противном случае это значение игнорируется.
password По умолчанию:
Нет
Указывает пароль для аутентификации подключения к удаленному устройству. Это общий аргумент, используемый для транспортов cli или nxapi. Если значение не указано в задаче, вместо него будет использовано значение переменной среды ANSIBLE_NET_PASSWORD.
validate_certs
    Варианты:
  • да
  • нет
По умолчанию:
Нет
Если no, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах, использующих самозаверяющие сертификаты. Если аргумент transport не nxapi, это значение игнорируется.
port По умолчанию:
0 (используйте общий порт)
Указывает порт для подключения к удаленному устройству. Это значение относится к cli или nxapi. Значение порта будет по умолчанию соответствовать общему порту для транспорта, если в задаче не указано другое значение (cli=22, http=80, https=443).
transport
обязательно
По умолчанию:
cli
Настраивает транспортное подключение для подключения к удаленному устройству. Аргумент transport поддерживает подключение к устройству по cli (ssh) или nxapi.
server_type
обязательно
    Варианты:
  • radius
  • tacacs
Тип сервера - либо radius, либо tacacs.
state
    Варианты:
  • present ←
  • absent
Управляет состоянием ресурса.
tacacs_port
Альтернативный TCP-порт сервера TACACS или ключевое слово 'default'.

Примечания

Примечание

  • Проверено на NXOSv 7.3.(0)D1(1) на VIRL
  • Изменения ключа хоста (общего секрета) не идемпотентны для типа 0.
  • Если state=absent удаляет всю конфигурацию хоста.
  • Дополнительную информацию об использовании командной строки и NX-API можно найти в руководстве NXOS Platform Options
  • Дополнительную информацию об использовании Ansible для управления сетевыми устройствами можно найти в руководстве Ansible Network Guide
  • Дополнительную информацию об использовании Ansible для управления устройствами Cisco можно найти на странице интеграции Cisco https://www.ansible.com/integrations/networks/cisco.

Примеры

# Radius Server Host Basic settings
  - name: "Radius Server Host Basic settings"
    nxos_aaa_server_host:
        state: present
        server_type: radius
        address: 1.2.3.4
        acct_port: 2084
        host_timeout: 10
        host: "{{ inventory_hostname }}"
        username: "{{ un }}"
        password: "{{ pwd }}"

# Radius Server Host Key Configuration
  - name: "Radius Server Host Key Configuration"
    nxos_aaa_server_host:
        state: present
        server_type: radius
        address: 1.2.3.4
        key: hello
        encrypt_type: 7
        host:  inventory_hostname }}
        username: "{{ un }}"
        password: "{{ pwd }}"

# TACACS Server Host Configuration
  - name: "Tacacs Server Host Configuration"
    nxos_aaa_server_host:
        state: present
        server_type: tacacs
        tacacs_port: 89
        host_timeout: 10
        address: 5.6.7.8
        host:  inventory_hostname }}
        username:  un }}
        password:  pwd }}

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

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

Ключ Возвращаемое значение Описание
changed
boolean
всегда
проверка, были ли внесены изменения на устройстве

Пример:
True
end_state
dict
всегда
параметры конфигурации после выполнения модуля

Пример:
{'host_timeout': '10', 'address': '1.2.3.4', 'auth_port': '2084', 'server_type': 'radius'}
existing
dict
всегда
параметры существующей конфигурации

proposed
dict
всегда
параметры, переданные в модуль

Пример:
{'host_timeout': '10', 'address': '1.2.3.4', 'auth_port': '2084', 'server_type': 'radius'}
updates
list
всегда
команда, отправленная на устройство

Пример:
['radius-server host 1.2.3.4 auth-port 2084 timeout 10']


Статус

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

Поддержка

Дополнительную информацию о поддержке этого модуля Red Hat можно найти в этой статье базы знаний

Автор

  • Jason Edelman (@jedelman8)

Подсказка

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

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

Spec-Zone.ru

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