All Products
Search
Document Center

Object Storage Service:GetBucketRequestPayment

Last Updated:Apr 29, 2024

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 qn6q**************:77Dv****************

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.