s3_put_bucket_ownership_controls: Creates or modifies OwnershipControls for an Amazon S3 bucket

Description

Creates or modifies OwnershipControls for an Amazon S3 bucket. To use this operation, you must have the s3:PutBucketOwnershipControls permission. For more information about Amazon S3 permissions, see Specifying Permissions in a Policy.

For information about Amazon S3 Object Ownership, see Using Object Ownership.

The following operations are related to put_bucket_ownership_controls:

get_bucket_ownership_controls
delete_bucket_ownership_controls

Usage

s3_put_bucket_ownership_controls(Bucket, ContentMD5,
  ExpectedBucketOwner, OwnershipControls)

Value

An empty list.

Arguments

Bucket

[required] The name of the Amazon S3 bucket whose OwnershipControls you want to set.

ContentMD5

The MD5 hash of the OwnershipControls request body.

For requests made using the AWS Command Line Interface (CLI) or AWS SDKs, this field is calculated automatically.

ExpectedBucketOwner

The account id of the expected bucket owner. If the bucket is owned by a different account, the request will fail with an HTTP 403 (Access Denied) error.

OwnershipControls

[required] The OwnershipControls (BucketOwnerPreferred or ObjectWriter) that you want to apply to this Amazon S3 bucket.

Request syntax

svc$put_bucket_ownership_controls(
  Bucket = "string",
  ContentMD5 = "string",
  ExpectedBucketOwner = "string",
  OwnershipControls = list(
    Rules = list(
      list(
        ObjectOwnership = "BucketOwnerPreferred"|"ObjectWriter"
      )
    )
  )
)