Skip to content

Get Bucket Logging

s3_get_bucket_logging R Documentation

This operation is not supported by directory buckets

Description

This operation is not supported by 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

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"
)