S3 / Client / get_bucket_request_payment

get_bucket_request_payment#

S3.Client.get_bucket_request_payment(**kwargs)#

Note

This operation is not supported for directory buckets.

Returns the request payment configuration of a bucket. To use this version of the operation, you must be the bucket owner. For more information, see Requester Pays Buckets.

The following operations are related to GetBucketRequestPayment:

ListObjects

Request Syntax

response = client.get_bucket_request_payment(
    Bucket='string',
    ExpectedBucketOwner='string'
)

Parameters:

Bucket (string) –
[REQUIRED]

The name of the bucket for which to get the payment request configuration
ExpectedBucketOwner (string) – 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).

Return type:

dict

Returns:

Response Syntax

{
    'Payer': 'Requester'|'BucketOwner'
}

Response Structure

(dict) –
- Payer (string) –
  
  Specifies who pays for the download and request fees.

Examples

The following example retrieves bucket versioning configuration.

response = client.get_bucket_request_payment(
    Bucket='examplebucket',
)

print(response)

Expected Output:

{
    'Payer': 'BucketOwner',
    'ResponseMetadata': {
        '...': '...',
    },
}