about: Get meta-information about S3 file or bucket

Description Usage Arguments Value Author(s) References See Also

Description

This function retrieves meta-information for an S3 file/object or bucket. This information includes the date last modified and explicitly added meta data in 'x-amz-meta-*' headers. These can be specified when storing an object (via the meta parameter of addFile).

Usage

1
2
3
about(bucket, name = character(), auth = getOption("AmazonS3"),
       curl = getCurlHandle(), virtual = (tolower(bucket) == bucket),
        asHeader = FALSE)

Arguments

bucket

the name of the AWS bucket. One can also specify the bucket and object/file name as "bucket/name".

name

the name of the object within the bucket to remove

auth

a named character vector giving the AWS key and secret as a c(key = secret).

curl

a curl handle that the caller can specif to reuse an existing object that is resused across different libcurl calls.

virtual

a logical value indicating whether to use the virtual host mechanism or s3.amazonaws.com/bucket/obj format. The default argument is most likely the appropriate value.

asHeader

a logical indicating that the parsed HTTP header should be returned directly and not filtered.

Value

a named character vector giving the meta-information

Author(s)

Duncan Temple Lang <duncan@wald.ucdavis.edu>

References

http://docs.amazonwebservices.com/AmazonS3/latest/gsg/

See Also

listBuckets listBucket getFile


duncantl/RAmazonS3 documentation built on May 15, 2019, 5:26 p.m.