url – возврат содержимого из URL
Описание
- Возвращает содержимое запрошенного URL-адреса, используемого в качестве данных в play.
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
|
_terms
-
|
URL-адреса для запроса
|
||
|
password
строка
добавлен в 2.8
|
По умолчанию: "None" |
Пароль для аутентификации HTTP.
|
|
|
split_lines
логическое значение
|
По умолчанию: "yes" |
Флаг, определяющий, будет ли содержимое возвращаться как список строк или как один текстовый блок.
|
|
|
use_proxy
логическое значение
|
По умолчанию: "yes" |
Флаг, определяющий, будет ли поиск использовать переменные окружения HTTP-прокси, если они присутствуют.
|
|
|
username
строка
добавлен в 2.8
|
По умолчанию: "None" |
Имя пользователя для аутентификации HTTP.
|
|
|
validate_certs
логическое значение
|
По умолчанию: "yes" |
Флаг, управляющий проверкой сертификатов 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') }}"
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого поиска:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
|
_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.8/plugins/lookup/url.html
