s3_create_bucket: This action creates an Amazon S3 bucket

Description

This action creates an Amazon S3 bucket. To create an Amazon S3 on Outposts bucket, see create_bucket .

See https://www.paws-r-sdk.com/docs/s3_create_bucket/ for full documentation.

Usage

s3_create_bucket(
  ACL = NULL,
  Bucket,
  CreateBucketConfiguration = NULL,
  GrantFullControl = NULL,
  GrantRead = NULL,
  GrantReadACP = NULL,
  GrantWrite = NULL,
  GrantWriteACP = NULL,
  ObjectLockEnabledForBucket = NULL,
  ObjectOwnership = NULL
)

Arguments

ACL

The canned ACL to apply to the bucket.

This functionality is not supported for directory buckets.

Bucket

[required] The name of the bucket to create.

General purpose buckets - For information about bucket naming restrictions, see Bucket naming rules in the Amazon S3 User Guide.

Directory buckets - When you use this operation with a directory bucket, you must use path-style requests in the format https://s3express-control.region_code.amazonaws.com/bucket-name . Virtual-hosted-style requests aren't supported. Directory bucket names must be unique in the chosen Availability Zone. Bucket names must also follow the format bucket_base_name--az_id--x-s3 (for example, DOC-EXAMPLE-BUCKET--usw2-az2--x-s3). For information about bucket naming restrictions, see Directory bucket naming rules in the Amazon S3 User Guide

CreateBucketConfiguration

The configuration information for the bucket.

GrantFullControl

Allows grantee the read, write, read ACP, and write ACP permissions on the bucket.

This functionality is not supported for directory buckets.

GrantRead

Allows grantee to list the objects in the bucket.

This functionality is not supported for directory buckets.

GrantReadACP

Allows grantee to read the bucket ACL.

This functionality is not supported for directory buckets.

GrantWrite

Allows grantee to create new objects in the bucket.

For the bucket and object owners of existing objects, also allows deletions and overwrites of those objects.

This functionality is not supported for directory buckets.

GrantWriteACP

Allows grantee to write the ACL for the applicable bucket.

This functionality is not supported for directory buckets.

ObjectLockEnabledForBucket

Specifies whether you want S3 Object Lock to be enabled for the new bucket.

This functionality is not supported for directory buckets.

ObjectOwnership