All Products
Search
Document Center

Object Storage Service:GetBucketRequestPayment

Last Updated:Aug 25, 2023

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: Tue, 23 Jul 2019 01:23:20 GMT
Authorization: OSS LTAICQmy1********:Rk7tT30yhDO3D************
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>

SDKs

SDKs that support this operation use the following languages:

Error codes

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