http get for network
Fetch the contents from a URL.
Signature
> http get {flags} (URL)
Flags
--user, -u {any}: The username when authenticating.--password, -p {any}: The password when authenticating.--max-time, -m {duration}: Max duration before timeout occurs.--headers, -H {any}: Custom headers you want to add.--raw, -r: Fetch contents as text rather than a table.--insecure, -k: Allow insecure server connections when using SSL.--full, -f: Returns the full response instead of only the body.--allow-errors, -e: Do not fail if the server returns an error code.--pool: Using a global pool as a client.--redirect-mode, -R {string}: What to do when encountering redirects. Default: 'follow'. Valid options: 'follow' ('f'), 'manual' ('m'), 'error' ('e').--unix-socket, -U {path}: Connect to the specified Unix socket instead of using TCP.
Parameters
URL: The URL to fetch the contents from.
Input/output types:
| input | output |
|---|---|
| nothing | any |
Examples
Get content from example.com.
> http get https://www.example.comGet content from example.com, with username and password.
> http get --user myuser --password mypass https://www.example.comGet content from example.com, with custom header using a record.
> http get --headers {my-header-key: my-header-value} https://www.example.comGet content from example.com, with custom headers using a list.
> http get --headers [my-header-key-A my-header-value-A my-header-key-B my-header-value-B] https://www.example.comGet the response status code.
> http get https://www.example.com | metadata | get http_response.statusCheck response status while streaming.
> http get --allow-errors https://example.com/file | metadata access {|m| if $m.http_response.status != 200 { error make {msg: "failed"} } else { } } | linesGet from Docker daemon via Unix socket.
> http get --unix-socket /var/run/docker.sock http://localhost/containers/jsonNotes
Performs HTTP GET operation.