翻訳
Ansible
一覧
モジュール

get_url

概要
HTTP、HTTPS、またはFTPからリモートサーバーにファイルをダウンロードします。リモートサーバーはリモートリソースに直接アクセスできる必要があります。
デフォルトでは、環境変数" _proxy"がターゲットホストに設定されている場合、そのプロキシを介して要求が送信されます。この動作は、このタスクの変数を設定するか(環境の設定を参照)、またはuse_proxyオプションを使用してオーバーライドできます。
HTTPリダイレクトはHTTPからHTTPSにリダイレクトできるため、両方のプロトコルのプロキシ環境が正しいことを確認する必要があります。

ansible2.4から--checkで実行すると、URLを検証するHEAD要求を行いますが、ファイル全体をダウンロードしたり、ハッシュに対して検証したりすることはありません。
Windowsターゲットの場合は、代わりにwin_get_urlモジュールを使用してください。

uri

概要

HTTPおよびHTTPS Webサービスと相互作用し、ダイジェスト、基本およびWSSE HTTP認証メカニズムをサポートします。

オプション

パラメータ 必須か デフォルト値 選択肢 コメント
HEADER_ no "HEADER_"で始まるパラメーターは、要求をヘッダーとして送信したものです。たとえば、HEADER_Content-Type = application/jsonというヘッダーは、application/jsonの値を持つリクエストとともにContent-Typeヘッダーを送信します。このオプションは2.1以降で廃止され、将来のリリースでは削除される可能性があります。代わりにheadersを使用してください。
body no Webサービスに対するhttpリクエスト/レスオンスの本体。 body_formatが 'json'に設定されている場合は、既にフォーマットされたJSON文字列を使用するか、データ構造体をJSONに変換します。
body_format(added in 2.0) no row -row
-json
本文のシリアライズフォーマット。 jsonに設定されている場合は、必要に応じてbody引数をエンコードし、自動的にContent-Typeヘッダを設定します。 2.3以降では、headersオプションを使用してjsonに設定すると、 Content-Typeヘッダをオーバーライドすることができます。
creates no そのファイル名が存在する場合このステップは実行されない
dest no ファイルをダウンロードする場所のパス(必要な場合). destがディレクトリの場合、リモートサーバー上のファイルの名前が使用されます。
follow_redirects no safe - all
- safe
- none
URIモジュールがリダイレクトに従うかどうか。allはすべてのリダイレクトに従います。 safeは "安全な"リダイレクトのみに従います。ここで、 "安全な"とは、クライアントがリダイレクト先のURIに対してGETまたはHEADを実行していることを意味します。noneはリダイレクトに従いません。下位互換性のためにyesnoの選択肢が使えることに注意してください。yesallと等しく、nosafeと等価です。 yesnoは廃止され、将来のバージョンのAnsibleでは削除されます。
force_basic_auth no no - yes
-no
uriモジュールは、Webサービスが最初のリクエストにステータス401で応答した場合にのみ、認証情報を送信します。一部のBASIC認証サービスは401を正しく送信しないため、ログインに失敗します。このオプションは、最初の要求時に基本認証ヘッダーの送信を強制します。
headers(2.0より) no リクエストにYAML連想配列の形式でカスタムHTTPヘッダーを追加します。 2.3の時点でContent-Typeを提供すると、body_formatのjsonを提供することによって生成されたヘッダーがオーバーライドされます。
method no GET -GET
-POST
-PUT
-HEAD
-DELETE
-OPTIONS
-PATCH
-TRACE
-CONNECT
-REFRESH
リクエストまたはレスポンスのHTTPメソッド。大文字である必要がある
others no fileモジュールによって許可される全引数もここで動作する
password no Digest、Basic、またはWSSE認証に使用するモジュールのパスワード。
removes no GET ファイル名が存在しない場合、このステップは実行されません。
return_content no no -yes
-no
レスポンスのbodyをcontentキーの辞書として返すかどうか。Content-type が application/jsonの場合、JSONデータが辞書結果のjsonというキーに追加的にロードされます。
status_code no 200 リクエストの成功を示す有効な数値のHTTPステータスコード。コンマ区切りのステータスコードのリストでもOK
timeout no 30 タイムアウトの秒数
url yes (http or https):host.domein[:port]/ath 形式のHTTPまたはHTTPSのURL
user no Digest、Basic、WSSE認証で使うユーザー名
validate_certs no yes -yes
-no
noの場合、SSL証明書は検証されません。これは、自己署名証明書を使用して個人的に管理されているサイトでのみnoに設定する必要があります。 1.9.2より前は、デフォルトでnoに設定されていました。