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

In dataone: R Interface to the DataONE REST API

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.