create_bucket: Create a new S3 bucket

In hrbrmstr/roto.s3: Access and Orchestrate Amazon Simple Storage Service

Description

To create a bucket, you must register with Amazon S3 and have a valid AWS Access Key ID to authenticate requests. Anonymous requests are never allowed to create buckets. By creating the bucket, you become the bucket owner.

Usage

create_bucket(bucket, acl = c("bucket-owner-full-control", "private",
  "public-read", "public-read-write", "aws-exec-read", "authenticated-read",
  "bucket-owner-read"), location_constraint = NULL, grant_full_control = "",
  grant_read = "", grant_read_acp = "", grant_write = "",
  grant_write_acp = "", aws_access_key_id = NULL,
  aws_secret_access_key = NULL, aws_session_token = NULL,
  region_name = NULL, profile_name = NULL)

Arguments

bucket	name of the bucket. Not every string is an acceptable bucket name. For information on bucket naming restrictions, see Working with Amazon S3 Buckets.
acl	the canned ACL to apply to the bucket. Options are "private", "public-read", "public-read-write", "aws-exec-read", "authenticated-read", "bucket-owner-read", "bucket-owner-full-control". The default is "bucket-owner-full-control".
location_constraint	Specifies the region where the bucket will be created. If you don't specify a region, the bucket will be created in US Standard.
grant_full_control, grant_read, grant_read_acp, grant_write, grant_write_acp	grantee strings (optional)
aws_access_key_id	AWS access key id
aws_secret_access_key	AWS secret access key
aws_session_token	AWS session token
profile_name	profile name

Details

By default, the bucket is created in the US East (N. Virginia) region. You can optionally specify a region in the request body.

Value

the API call result structure (invisibly). The Location element will have the bucket name if the call was successful.

References

https://boto3.readthedocs.io/en/latest/reference/services/s3.html#S3.Client.create_bucket

hrbrmstr/roto.s3 documentation built on May 29, 2019, 11:42 a.m.