httpapi — Использование httpapi для выполнения команд на сетевых устройствах
Новое в версии 2.6.
Обзор
- Этот плагин подключения обеспечивает подключение к удаленным устройствам через API на основе HTTP(S).
Параметры
| Параметр | Варианты/Значения по умолчанию | Настройка | Комментарии |
|---|---|---|---|
| become boolean | По умолчанию: "нет" | Записи в ini: [ ] [ ] переменная среды:ANSIBLE_BECOME переменная: ansible_become | Параметр become укажет сессии CLI на попытку повышения привилегий на платформах, которые ее поддерживают. Обычно это означает переход из пользовательского режима в enable режим в сессии CLI. Если become установлено в True и удаленное устройство не поддерживает повышение привилегий или привилегии уже повышены, этот параметр будет проигнорирован.Можно настроить из CLI с помощью опций --become или -b |
| become_method | По умолчанию: "sudo" | Записи в ini: [ ] [ ] переменная среды:ANSIBLE_BECOME_METHOD переменная: ansible_become_method | Этот параметр позволяет указать метод become для обработки повышения привилегий. Обычно значение 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 int | По умолчанию: 10 | Записи в ini: [persistent_connection ] переменная среды:ANSIBLE_PERSISTENT_COMMAND_TIMEOUT | Настраивает, в секундах, время ожидания возврата команды с удаленного устройства. Если этот таймер истечет до возврата команды, плагин подключения сгенерирует исключение и закроет соединение. |
| persistent_connect_timeout int | По умолчанию: 30 | Записи в ini: [persistent_connection ] переменная среды:ANSIBLE_PERSISTENT_CONNECT_TIMEOUT | Настраивает, в секундах, время ожидания при попытке первоначального установления постоянного соединения. Если это значение истечет до завершения подключения к удаленному устройству, подключение будет прервано. |
| port int | Записи в ini: [defaults ] переменная среды:ANSIBLE_REMOTE_PORT переменная: ansible_httpapi_port | Указывает порт на удаленном устройстве для прослушивания подключений при установлении HTTP(S) подключения. Если не указано, будет выбран порт 80 или 443, в зависимости от значения use_ssl. | |
| remote_user | Записи в ini: [defaults ] переменная среды:ANSIBLE_REMOTE_USER переменная: ansible_user | Имя пользователя, используемое для аутентификации на удаленном устройстве при первом установлении подключения к API. Если remote_user не указан, подключение будет использовать имя пользователя пользователя, вошедшего в систему. Можно настроить из CLI с помощью опций --user или -u | |
| timeout int | По умолчанию: 120 | Устанавливает время подключения, в секундах, для связи с удаленным устройством. Этот таймаут используется как значение таймаута по умолчанию для команд при отправке команды в сетевой CLI. Если команда не вернется в течение timeout секунд, генерируется ошибка. | |
| use_ssl boolean | По умолчанию: "нет" | переменная: ansible_httpapi_use_ssl | Подключаться ли по SSL (HTTPS) или нет (HTTP) |
Статус
Автор
- Команда 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.6/plugins/connection/httpapi.html