url – возврат содержимого из URL
Описание
- Возвращает содержимое запрошенного URL для использования в качестве данных в play.
Параметры
| Параметр | Варианты/Значения по умолчанию | Настройка | Комментарии |
|---|---|---|---|
| _terms - | URL для запроса | ||
| headers словарь добавлен в 2.9 | Значение по умолчанию: {} | Заголовки HTTP-запроса | |
| password строка добавлен в 2.8 | Пароль для аутентификации по HTTP. | ||
| split_lines логическое значение | Значение по умолчанию: "да" | Флаг, определяющий, возвращается ли содержимое в виде списка строк или единого текстового блока. | |
| use_proxy логическое значение | Значение по умолчанию: "да" | Флаг, определяющий, будет ли поиск учитывать переменные окружения HTTP-прокси, если они присутствуют. | |
| username строка добавлен в 2.8 | Имя пользователя для аутентификации по HTTP. | ||
| validate_certs логическое значение | Значение по умолчанию: "да" | Флаг, определяющий проверку сертификатов SSL. |
Примеры
- name: url lookup splits lines by default
debug: msg="{{item}}"
loop: "{{ lookup('url', 'https://github.com/gremlin.keys', wantlist=True) }}"
- name: display ip ranges
debug: msg="{{ lookup('url', 'https://ip-ranges.amazonaws.com/ip-ranges.json', split_lines=False) }}"
- name: url lookup using authentication
debug: msg="{{ lookup('url', 'https://some.private.site.com/file.txt', username='bob', password='hunter2') }}"
- name: url lookup using headers
debug: msg="{{ lookup('url', 'https://some.private.site.com/api/service', headers={'header1':'value1', 'header2':'value2'} ) }}"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного поиска:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| _list - | список списков строк или содержимого URL(ов) |
Статус
- Гарантии обратной совместимости данного поиска нет. [превью]
- Этот поиск поддерживается сообществом Ansible. [сообщество]
Авторы
- Brian Coca (@bcoca)
Подсказка
Если вы обнаружите какие-либо проблемы в этой документации, вы можете изменить этот документ, чтобы улучшить его.
Подсказка
Элементы конфигурации для каждого типа имеют порядок приоритетов от низкого к высокому. Например, переменная, которая расположена ниже в списке, переопределит переменную, расположенную выше.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/plugins/lookup/url.html
