Use GetBucketRequestPayment to query pay-by-requester configuration - Object Storage Service - Alibaba Cloud - Object Storage Service

You can call this operation to obtain pay-by-requester configurations for a bucket.

Request syntax

GET /?requestPayment HTTP/1.1
Date: GMT Date
Host: BucketName.oss.aliyuncs.com
Authorization: authorization string

Response elements

Element

Type

Description

RequestPaymentConfiguration

Container

The container that stores the pay-by-requester configuration of the bucket.

Child: Payer

Payer

String

Indicates who pays the download and request fees.

Valid values: BucketOwner and Requester

Parent: RequestPaymentConfiguration

Examples

Request sample

GET /?requestPayment
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 17 Apr 2025 01:23:20 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Response sample

200 (OK)
content-length: 129
server: AliyunOSS
x-oss-request-id: 5D366188B007B79097EC****
date: Tue, 23 Jul 2019 01:23:20 GMT
content-type: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<RequestPaymentConfiguration>
  <Payer>BucketOwner</Payer>
</RequestPaymentConfiguration>

OSS SDKs

You can use OSS SDKs for the following programming languages to call GetBucketRequestPayment:

ossutil

For information about the ossutil command that corresponds to the GetBucketRequestPayment operation, see get-bucket-request-payment.

Error codes

Error code	HTTP status code	Description
NoSuchBucket	404	The error message returned because the specified bucket does not exist.