paws.storage (version 0.1.11)

s3_get_bucket_logging: Returns the logging status of a bucket and the permissions users have to view and modify that status

Description

Returns the logging status of a bucket and the permissions users have to view and modify that status. To use GET, you must be the bucket owner.

The following operations are related to get_bucket_logging:

• create_bucket

• put_bucket_logging

Usage

s3_get_bucket_logging(Bucket, ExpectedBucketOwner)

Arguments

Bucket

[required] The bucket name for which to get the logging information.

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.

Value

A list with the following syntax:

list(
  LoggingEnabled = list(
    TargetBucket = "string",
    TargetGrants = list(
      list(
        Grantee = list(
          DisplayName = "string",
          EmailAddress = "string",
          ID = "string",
          Type = "CanonicalUser"|"AmazonCustomerByEmail"|"Group",
          URI = "string"
        ),
        Permission = "FULL_CONTROL"|"READ"|"WRITE"
      )
    ),
    TargetPrefix = "string"
  )
)

Request syntax

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