/AWS1/CL_S3=>PUTBUCKETLOGGING()
¶
About PutBucketLogging¶
This operation is not supported by directory buckets.
Set the logging parameters for a bucket and to specify permissions for who can view and modify the logging parameters. All logs are saved to buckets in the same Amazon Web Services Region as the source bucket. To set the logging status of a bucket, you must be the bucket owner.
The bucket owner is automatically granted FULL_CONTROL to all logs. You use the
Grantee
request element to grant access to other people. The
Permissions
request element specifies the kind of access the grantee has to
the logs.
If the target bucket for log delivery uses the bucket owner enforced setting for S3
Object Ownership, you can't use the Grantee
request element to grant access
to others. Permissions can only be granted using policies. For more information, see
Permissions for server access log delivery in the
Amazon S3 User Guide.
- Grantee Values
-
You can specify the person (grantee) to whom you're assigning access rights (by using request elements) in the following ways:
-
By the person's ID:
<>ID<> <>GranteesEmail<> DisplayName
is optional and ignored in the request. -
By Email address:
<>Grantees@email.com<> The grantee is resolved to the
CanonicalUser
and, in a response to aGETObjectAcl
request, appears as the CanonicalUser. -
By URI:
<>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<>
-
To enable logging, you use LoggingEnabled
and its children request
elements. To disable logging, you use an empty BucketLoggingStatus
request
element:
For more information about server access logging, see Server Access Logging in the Amazon S3 User Guide.
For more information about creating a bucket, see CreateBucket. For more information about returning the logging status of a bucket, see GetBucketLogging.
The following operations are related to PutBucketLogging
:
Method Signature¶
IMPORTING¶
Required arguments:¶
IV_BUCKET
TYPE /AWS1/S3_BUCKETNAME
/AWS1/S3_BUCKETNAME
¶
The name of the bucket for which to set the logging parameters.
IO_BUCKETLOGGINGSTATUS
TYPE REF TO /AWS1/CL_S3_BUCKETLOGSTATUS
/AWS1/CL_S3_BUCKETLOGSTATUS
¶
Container for logging status information.
Optional arguments:¶
IV_CONTENTMD5
TYPE /AWS1/S3_CONTENTMD5
/AWS1/S3_CONTENTMD5
¶
The MD5 hash of the
PutBucketLogging
request body.For requests made using the Amazon Web Services Command Line Interface (CLI) or Amazon Web Services SDKs, this field is calculated automatically.
IV_CHECKSUMALGORITHM
TYPE /AWS1/S3_CHECKSUMALGORITHM
/AWS1/S3_CHECKSUMALGORITHM
¶
Indicates the algorithm used to create the checksum for the object when you use the SDK. This header will not provide any additional functionality if you don't use the SDK. When you send this header, there must be a corresponding
x-amz-checksum
orx-amz-trailer
header sent. Otherwise, Amazon S3 fails the request with the HTTP status code400 Bad Request
. For more information, see Checking object integrity in the Amazon S3 User Guide.If you provide an individual checksum, Amazon S3 ignores any provided
ChecksumAlgorithm
parameter.
IV_EXPECTEDBUCKETOWNER
TYPE /AWS1/S3_ACCOUNTID
/AWS1/S3_ACCOUNTID
¶
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).