getS3Access: Query and set the access to a bucket or an object

Description Usage Arguments Value Author(s) References See Also

Description

These functions provide facilities to query or set who can access an S3 object or bucket. One can find out who is entitled to read/write the object or specify either general access properties (e.g. only the owner, everyone can read, everyone can read and write or authenticated reading). Alternatively, one can specify more specific access by detailing the users or groups that can access the object in what manner.

Usage

1
2
getS3Access(bucket, name, auth = getOption("AmazonS3"), curl = getCurlHandle(),
            virtual = (tolower(bucket) == bucket), asXML = 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.

asXML

a logical value that allows the caller to indicate that they want the parsed XML document containing the response and not to bother converting it to a data frame. This allows the caller to extract the information in the way she wants it.

Value

A data frame with ...

Author(s)

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

References

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

See Also

setS3Access The setACL function is not currently working correctly but will allow one to specify access control at the level of individual groups.


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