Get Bucket Logging

s3_get_bucket_logging

R Documentation

This operation is not supported for directory buckets

Description

This operation is not supported for directory buckets.

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

The following operations are related to get_bucket_logging:

• create_bucket

• put_bucket_logging

You must URL encode any signed header values that contain spaces. For example, if your header value is ⁠my file.txt⁠, containing two spaces after my, you must URL encode this value to ⁠my%20%20file.txt⁠.

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 account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code ⁠403 Forbidden⁠ (access denied).

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",
    TargetObjectKeyFormat = list(
      SimplePrefix = list(),
      PartitionedPrefix = list(
        PartitionDateSource = "EventTime"|"DeliveryTime"
      )
    )
  )
)

Request syntax

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