paws.storage (version 0.1.12)

s3_get_bucket_ownership_controls: Retrieves OwnershipControls for an Amazon S3 bucket

Description

Retrieves OwnershipControls for an Amazon S3 bucket. To use this operation, you must have the s3:GetBucketOwnershipControls 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 get_bucket_ownership_controls:

• put_bucket_ownership_controls

• delete_bucket_ownership_controls

Usage

s3_get_bucket_ownership_controls(Bucket, ExpectedBucketOwner)

Value

A list with the following syntax:

list(
  OwnershipControls = list(
    Rules = list(
      list(
        ObjectOwnership = "BucketOwnerPreferred"|"ObjectWriter"
      )
    )
  )
)

Arguments

Bucket

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

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.

Request syntax

svc$get_bucket_ownership_controls(
  Bucket = "string",
  ExpectedBucketOwner = "string"
)