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: [] [] переменная среды: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] переменная среды:ANSIBLE_PERSISTENT_COMMAND_TIMEOUT | Устанавливает, в секундах, время ожидания возврата команды с удалённого устройства. Если этот таймер истечёт до возврата команды, плагин подключения генерирует исключение и закрывает соединение |
| persistent_connect_timeout целое число | Значение по умолчанию: 30 | записи ini: [persistent_connection] переменная среды:ANSIBLE_PERSISTENT_CONNECT_TIMEOUT переменная: ansible_connect_timeout | Устанавливает, в секундах, время ожидания при попытке первоначального установления постоянного подключения. Если это значение истечёт до завершения подключения к удалённому устройству, подключение завершится с ошибкой |
| port целое число | записи 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 целое число | Значение по умолчанию: 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