Be sure to include a filename and extension as appropriate.
force
(added in 2.0)
no
yes
yes
no
If yes, will always download the file. If no, will only download the file if it does not exist or the remote file has been modified more recently than the local file.
This works by sending an http HEAD request to retrieve last modified time of the requested resource, so for this to work, the remote web server must support HEAD requests.
headers
(added in 2.4)
no
Add custom HTTP headers to a request (as a dictionary).
proxy_password
(added in 2.0)
no
Proxy authentication password.
proxy_url
(added in 2.0)
no
The full URL of the proxy server to download through.
proxy_username
(added in 2.0)
no
Proxy authentication username.
skip_certificate_validation
no
no
yes
no
This option is deprecated since v2.4, please use validate_certs instead.
If yes, SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.
timeout
(added in 2.4)
no
10
Timeout in seconds for URL request.
url
yes
The full URL of a file to download.
url_password
no
Basic authentication password.
aliases: password
url_username
no
Basic authentication username.
aliases: username
use_proxy
(added in 2.4)
no
yes
yes
no
If no, it will not use a proxy, even if one is defined in an environment variable on the target hosts.
validate_certs
(added in 2.4)
no
yes
yes
no
If no, SSL certificates will not be validated. This should only be used on personally controlled sites using self-signed certificates.
If skip_certificate_validation was set, it overrides this option.
-name:Download earthrise.jpg to specified pathwin_get_url:url:http://www.example.com/earthrise.jpgdest:C:\Users\RandomUser\earthrise.jpg-name:Download earthrise.jpg to specified path only if modifiedwin_get_url:url:http://www.example.com/earthrise.jpgdest:C:\Users\RandomUser\earthrise.jpgforce:no-name:Download earthrise.jpg to specified path through a proxy server.win_get_url:url:http://www.example.com/earthrise.jpgdest:C:\Users\RandomUser\earthrise.jpgproxy_url:http://10.0.0.1:8080proxy_username:usernameproxy_password:password
This module is flagged as stableinterface which means that the maintainers for this module guarantee that no backward incompatible interface changes will be made.
For more information about Red Hat’s this support of this module, please
refer to this knowledge base article<https://access.redhat.com/articles/rhel-top-support-policies>