auth_head: Send a http HEAD request for a resource with authenticated...

View source: R/auth_request.R

auth_headR Documentation

Send a http HEAD request for a resource with authenticated credentials if available.

Description

Retrieve http header information for a URL using an HTTP HEAD request using authentication credentials provided in a client certificate or token. Authenticated access depends on the suggested openssl package. If the openssl package is not installed, then the request falls back to an unauthenticated request, which may fail due to insufficient permissions. Configuration options for httr/RCurl can be passed using the normal config() mechanisms to generate a config option. Use httr_options() to see a complete list of available options. Note: The HEAD method is identical to GET except that the server MUST NOT return a message-body in the response.

Usage

auth_head(url, nconfig = config(), node)

Arguments

url

The URL to be accessed via authenticated HEAD.

nconfig

HTTP configuration options as used by curl, defaults to empty list

node

The D1Node object that the request will be made to.

Value

the response object from the method


dataone documentation built on June 11, 2022, 1:06 a.m.