Spec-Zone.ru › Ansible 2.7

httpapi – Использование httpapi для выполнения команд на сетевых устройствах

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

  • Описание
  • Параметры
  • Статус

Описание

  • Этот плагин подключения обеспечивает подключение к удаленным устройствам через HTTP(S)-базированный API.

Параметры

Параметр Варианты/Значения по умолчанию Конфигурация Комментарии
become
логический тип
Значение по умолчанию:
"нет"
записи ini:

[]
= нет

[]
= нет

переменная среды:ANSIBLE_BECOME
переменная: ansible_become
Параметр become укажет сессии CLI на попытку повышения привилегий на платформах, которые ее поддерживают. Обычно это означает переход от пользовательского режима к enable режиму в сессии CLI. Если become установлено в True, а удаленное устройство не поддерживает повышение привилегий или привилегии уже повышены, этот параметр будет проигнорирован.
Может быть сконфигурирован через CLI с помощью параметров --become или -b
become_method
-
Значение по умолчанию:
"sudo"
записи ini:

[]
= sudo

[]
= sudo

переменная среды:ANSIBLE_BECOME_METHOD
переменная: ansible_become_method
Этот параметр позволяет указать метод повышения привилегий для обработки повышения привилегий. Обычно значение become_method устанавливается в enable, но может быть определено и другими значениями.
host
-
Значение по умолчанию:
"inventory_hostname"
переменная: ansible_host
Указывает FQDN или IP-адрес удаленного устройства для установления HTTP(S)-соединения.
network_os
-
переменная: ansible_network_os
Конфигурирует сетевую операционную систему платформы устройства. Это значение используется для загрузки правильных плагинов httpapi и cliconf для связи с удаленным устройством.
password
-
переменная: ansible_password
переменная: ansible_httpapi_pass
Секрет, используемый для аутентификации
persistent_command_timeout
целое число
Значение по умолчанию:
10
записи ini:

[persistent_connection]
command_timeout = 10

переменная среды:ANSIBLE_PERSISTENT_COMMAND_TIMEOUT
Устанавливает, в секундах, время ожидания возврата команды с удалённого устройства. Если этот таймер истечёт до возврата команды, плагин подключения генерирует исключение и закрывает соединение
persistent_connect_timeout
целое число
Значение по умолчанию:
30
записи ini:

[persistent_connection]
connect_timeout = 30

переменная среды:ANSIBLE_PERSISTENT_CONNECT_TIMEOUT
переменная: ansible_connect_timeout
Устанавливает, в секундах, время ожидания при попытке первоначального установления постоянного подключения. Если это значение истечёт до завершения подключения к удалённому устройству, подключение завершится с ошибкой
port
целое число
записи ini:

[defaults]
remote_port = ЗНАЧЕНИЕ

переменная среды:ANSIBLE_REMOTE_PORT
переменная: ansible_httpapi_port
Указывает порт на удаленном устройстве, слушающий подключения при установлении HTTP(S)-соединения. Если не указан, будет выбран 80 или 443 в зависимости от значения use_ssl
remote_user
-
записи ini:

[defaults]
remote_user = ЗНАЧЕНИЕ

переменная среды:ANSIBLE_REMOTE_USER
переменная: ansible_user
Имя пользователя, используемое для аутентификации на удалённом устройстве при первом установлении соединения API. Если remote_user не указан, для подключения будет использован логин текущего пользователя.
Может быть сконфигурирован через CLI с помощью параметров --user или -u
timeout
целое число
Значение по умолчанию:
120
Устанавливает время подключения, в секундах, для связи с удалённым устройством. Этот таймаут используется как значение таймаута по умолчанию для команд при выполнении команды в сетевой CLI. Если команда не вернётся в течение timeout секунд, генерируется ошибка.
use_ssl
логический тип
Значение по умолчанию:
"нет"
переменная: ansible_httpapi_use_ssl
Использовать ли SSL (HTTPS) или нет (HTTP)
validate_certs
логический тип
добавлен в 2.7
Значение по умолчанию:
"да"
переменная: ansible_httpapi_validate_certs
Требовать ли проверку SSL-сертификатов

Статус

Авторы

  • Команда Ansible Networking

Подсказка

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

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

Spec-Zone.ru

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