All Products
Search

This Product

    Object Storage Service:GetBucketRequestPayment

    Document Center

    Object Storage Service:GetBucketRequestPayment

    Last Updated:Jul 15, 2026

    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

    Indicates the container for the payer.

    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.