Usage
s3HTTP(verb = "GET", bucket = "", path = "", query = NULL,
headers = list(), request_body = "", accelerate = FALSE,
parse_response = TRUE, check_region = TRUE, url_style = c("path",
"virtual"), verbose = getOption("verbose", FALSE),
region = Sys.getenv("AWS_DEFAULT_REGION", "us-east-1"),
key = Sys.getenv("AWS_ACCESS_KEY_ID"),
secret = Sys.getenv("AWS_SECRET_ACCESS_KEY"),
session_token = Sys.getenv("AWS_SESSION_TOKEN"), ...)Arguments
verb
A character string containing an HTTP verb, defaulting to “GET”.
bucket
A character string with the name of the bucket, or an object of class “s3_bucket”. If the latter and a region can be inferred from the bucket object attributes, then that region is used instead of region.
path
A character string with the name of the object to put in the bucket (sometimes called the object or 'key name' in the AWS documentation.)
query
Any query arguments, passed as a named list of key-value pairs.
headers
A list of request headers for the REST call.
request_body
A character string containing request body data.
accelerate
A logical indicating whether to use AWS transfer acceleration, which can produce significant speed improvements for cross-country transfers. Acceleration only works with buckets that do not have dots in bucket name.
parse_response
A logical indicating whether to return the response as is, or parse and return as a list. Default is TRUE.
check_region
A logical indicating whether to check the value of region against the apparent bucket region. This is useful for avoiding (often confusing) out-of-region errors. Default is TRUE.
url_style
A character string specifying either “path” (the default), or “virtual”-style S3 URLs.
verbose
A logical indicating whether to be verbose. Default is given by options("verbose").
region
A character string containing the AWS region. Ignored if region can be inferred from bucket. If missing, defaults to “us-east-1”.
key
A character string containing an AWS Access Key ID. If missing, defaults to value stored in environment variable “AWS_ACCESS_KEY_ID”.
secret
A character string containing an AWS Secret Access Key. If missing, defaults to value stored in environment variable “AWS_SECRET_ACCESS_KEY”.
session_token
Optionally, a character string containing an AWS temporary Session Token. If missing, defaults to value stored in environment variable “AWS_SESSION_TOKEN”.
...
Additional arguments passed to an HTTP request function. such as GET.