aws.s3 (version 0.3.1)

put_bucket: Create bucket

Description

Creates a new S3 bucket.

Usage

put_bucket(bucket, region = Sys.getenv("AWS_DEFAULT_REGION"),
  headers = list(), ...)

Arguments

bucket

Character string with the name of the bucket, or an object of class “s3_bucket”.

region

A character string containing the AWS region. If missing, defaults to value of environment variable AWS_DEFAULT_REGION.

headers

List of request headers for the REST call.

…

Additional arguments passed to s3HTTP.

Value

TRUE if successful.

Details

Bucket policies regulate who has what access to a bucket and its contents. The header argument can beused to specify “canned” policies and put_bucket_policy can be used to specify a more complex policy. The AWS Policy Generator can be useful for creating the appropriate JSON policy structure.

References

API Documentation AWS Policy Generator

See Also

bucketlist, get_bucket, delete_bucket, put_object

Examples

  put_bucket("examplebucket")
  
  # set a "canned" ACL to, e.g., make bucket publicly readable
  put_bucket("examplebucket", headers = list(`x-amz-acl` = "public-read")