Nota
Este complemento es parte del colección ansible.windows (versión 1.3.0).
Para instalarlo use: ansible-galaxy collection install ansible.windows
.
Para usarlo en un libro de jugadas, especifique: ansible.windows.win_get_url
.
- Sinopsis
- Parámetros
- Notas
- Ver también
- Ejemplos de
- Valores devueltos
Sinopsis
- Descarga archivos de HTTP, HTTPS o FTP al servidor remoto.
- El servidor remoto debe tener acceso directo al recurso remoto.
- Para destinos que no son de Windows, use el ansible.builtin.get_url módulo en su lugar.
Parámetros
Parámetro | Opciones / Valores predeterminados | Comentarios |
---|---|---|
suma de comprobacióncuerda | Si un suma de comprobación se pasa a este parámetro, el resumen del archivo de destino se calculará después de que se descargue para garantizar su integridad y verificar que la transferencia se haya completado correctamente. Esta opción no se puede configurar con checksum_url. | |
checksum_algorithmcuerda |
|
Especifica el algoritmo hash utilizado al calcular la suma de comprobación del archivo remoto y de destino. |
checksum_urlcuerda | Especifica una URL que contiene los valores de suma de comprobación para el recurso en url.Igual que checksum , esto se utiliza para verificar la integridad de la transferencia remota. Esta opción no se puede configurar con suma de comprobación. |
|
client_certcuerda | La ruta al certificado de cliente (.pfx) que se usa para la autenticación X509. Este camino puede ser el camino al pfx en el sistema de archivos o en la ruta del certificado de PowerShell Cert:CurrentUserMy .La conexión WinRM debe autenticarse con CredSSP o become se utiliza en la tarea si el archivo de certificado no está protegido con contraseña. Se pueden establecer otros tipos de autenticación client_cert_password cuando el certificado está protegido con contraseña. |
|
client_cert_passwordcuerda | La contraseña para client_cert si el certificado está protegido con contraseña. | |
destsendero / requerido | La ubicación para guardar el archivo en la URL. Asegúrese de incluir un nombre de archivo y una extensión según corresponda. | |
follow_redirectscuerda |
|
Si el módulo debe seguir redireccionamientos.all Seguirá todas las redirecciones.none no seguirá ninguna redirección.safe seguirá solo redireccionamientos “seguros”, donde “seguro” significa que el cliente solo está haciendo un GET o HEAD en la URI a la que se está redirigiendo. Cuando se sigue una URL redirigida, Authorization El encabezado y las credenciales establecidas se eliminarán y no se redirigirán. |
fuerzabooleano |
|
Si yes , descargará el archivo cada vez y reemplazará el archivo si el contenido cambia. Si no , solo descargará el archivo si no existe o si el archivo remoto se ha modificado más recientemente que el archivo local. Esto funciona enviando una solicitud http HEAD para recuperar la última hora de modificación del recurso solicitado, por lo que para que esto funcione, el El servidor web remoto debe admitir solicitudes HEAD. |
force_basic_authbooleano |
|
De forma predeterminada, el encabezado de autenticación solo se envía cuando un servicio web responde a una solicitud inicial con un estado 401. Dado que algunos servicios de autenticación básica no envían correctamente un 401, los inicios de sesión fallarán. Esta opción fuerza el envío del encabezado de autenticación básica en la solicitud original. |
encabezadosdiccionario | Encabezados adicionales para configurar en la solicitud. Debe ser un diccionario donde la clave es el nombre del encabezado y el valor es el valor para ese encabezado. | |
http_agentcuerda | Defecto: “ansible-httpget” |
El encabezado para identificar como, generalmente aparece en los registros del servidor web. User-Agent encabezado en una solicitud HTTP. |
redireccion_máximaentero | Defecto: 50 |
Especifique cuántas veces el módulo redirigirá una conexión a un URI alternativo antes de que falle la conexión. 0 o follow_redirects se establece en none , o safe cuando no está haciendo un GET o HEAD evita toda redirección. |
proxy_passwordcuerda | La contraseña para proxy_username. | |
proxy_urlcuerda | Un proxy explícito para usar en la solicitud De forma predeterminada, la solicitud usará el proxy definido por IE a menos que usa proxy se establece en no . |
|
proxy_use_default_credentialbooleano |
|
Utiliza las credenciales del usuario actual cuando se autentica con un host proxy protegido con NTLM , Kerberos , o Negotiate autenticación Proxies que utilizan Basic auth aún requerirá credenciales explícitas a través del proxy_username y proxy_password El módulo solo tendrá acceso a las credenciales del usuario si usa become con una contraseña, se está conectando con SSH usando una contraseña, o se está conectando con WinRM usando CredSSP o Kerberos with delegation .Si no está usando become o un método de autenticación diferente a los indicados anteriormente, no habrá credenciales predeterminadas disponibles y no ocurrirá autenticación de proxy. |
proxy_usernamecuerda | El nombre de usuario que se utilizará para la autenticación de proxy. | |
urlcuerda / requerido | La URL completa de un archivo para descargar. | |
url_methodcuerda | El método HTTP de la solicitud. alias: método |
|
url_passwordcuerda | La contraseña para url_username.El alias contraseña está en desuso y se eliminará en la versión principal después de 2022-07-01 .alias: contraseña |
|
url_timeoutentero | Defecto: 30 |
Especifica cuánto tiempo puede estar pendiente la solicitud antes de que se agote (en segundos). 0 para especificar un tiempo de espera infinito.alias: tiempo de espera |
url_usernamecuerda | El nombre de usuario que se utilizará para la autenticación. usuario y nombre de usuario está en desuso y se eliminará en la versión principal después de 2022-07-01 .alias: usuario, nombre de usuario |
|
use_default_credentialbooleano |
|
Utiliza las credenciales del usuario actual cuando se autentica con un servidor protegido con NTLM , Kerberos , o Negotiate autenticación.Sitios que utilizan Basic auth aún requerirá credenciales explícitas a través del url_username y url_password El módulo solo tendrá acceso a las credenciales del usuario si usa become con una contraseña, se está conectando con SSH usando una contraseña, o se está conectando con WinRM usando CredSSP o Kerberos with delegation .Si no está usando become o un método de autenticación diferente a los indicados anteriormente, no habrá credenciales predeterminadas disponibles y no se producirá ninguna autenticación. |
usa proxybooleano |
|
Si no , no utilizará el proxy definido en IE para el usuario actual. |
validate_certsbooleano |
|
Si no , Los certificados SSL no serán validados. Esto solo debe usarse en sitios controlados personalmente que utilicen certificados autofirmados. |
Notas
Nota
- Si su URL incluye un carácter de barra de escape (% 2F), este módulo lo convertirá en una barra real. Este es el resultado del comportamiento de la clase System.Uri como se describe en la documentación.
Ver también
Ver también
- ansible.builtin.get_url
-
La documentación oficial sobre el ansible.builtin.get_url módulo.
- ansible.builtin.uri
-
La documentación oficial sobre el ansible.builtin.uri módulo.
- ansible.windows.win_uri
-
La documentación oficial sobre el ansible.windows.win_uri módulo.
- community.windows.win_inet_proxy
-
La documentación oficial sobre el community.windows.win_inet_proxy módulo.
Ejemplos de
-name: Download earthrise.jpg to specified path ansible.windows.win_get_url:url: http://www.example.com/earthrise.jpg dest: C:UsersRandomUserearthrise.jpg -name: Download earthrise.jpg to specified path only if modified ansible.windows.win_get_url:url: http://www.example.com/earthrise.jpg dest: C:UsersRandomUserearthrise.jpg force: no -name: Download earthrise.jpg to specified path through a proxy server. ansible.windows.win_get_url:url: http://www.example.com/earthrise.jpg dest: C:UsersRandomUserearthrise.jpg proxy_url: http://10.0.0.1:8080proxy_username: username proxy_password: password -name: Download file from FTP with authentication ansible.windows.win_get_url:url: ftp://server/file.txt dest:'%TEMP%ftp-file.txt'url_username: ftp-user url_password: ftp-password -name: Download src with sha256 checksum url ansible.windows.win_get_url:url: http://www.example.com/earthrise.jpg dest: C:tempearthrise.jpg checksum_url: http://www.example.com/sha256sum.txt checksum_algorithm: sha256 force:True-name: Download src with sha256 checksum url ansible.windows.win_get_url:url: http://www.example.com/earthrise.jpg dest: C:tempearthrise.jpg checksum: a97e6837f60cec6da4491bab387296bbcd72bdba checksum_algorithm: sha1 force:True
Valores devueltos
Los valores de retorno comunes están documentados aquí, los siguientes son los campos exclusivos de este módulo:
Llave | Devuelto | Descripción |
---|---|---|
checksum_destcuerda | éxito y dest se han descargado | Muestra:6e642bb8dd5c2e027bf21dd923337cbb4214f827 |
checksum_srccuerda | force = yes o dest no existía | Muestra:6e642bb8dd5c2e027bf21dd923337cbb4214f827 |
destcuerda | siempre | archivo / ruta de destino Muestra:C: Users RandomUser earthrise.jpg |
transcurridoflotador | siempre | Los segundos transcurridos entre el inicio de la encuesta y el final del módulo. Muestra:2.1406487 |
msgcuerda | siempre | Mensaje de error o mensaje de estado HTTP de Servidor web Muestra:OK |
Tallaentero | éxito | tamaño del archivo dest Muestra:1220 |
código de estadoentero | siempre | Código de estado HTTP Muestra:200 |
urlcuerda | siempre | URL solicitada Muestra:http://www.example.com/earthrise.jpg |
Autores
- Paul Durivage (@angstwad)
- Takeshi Kuramochi (@tksarah)
Aquí tienes las comentarios y valoraciones
Si estás de acuerdo, eres capaz de dejar un ensayo acerca de qué le añadirías a este ensayo.
¡Haz clic para puntuar esta entrada!
(Votos: 0 Promedio: 0)