You need to enable JavaScript to run this app.
Torch Object Storage

Torch Object Storage

Copy page
Download PDF
Requester pays
GetBucketRequestPayment
Copy page
Download PDF
GetBucketRequestPayment
Feature description​
This API checks the payment mode of a bucket.​
Request syntax​
​
GET /?requestPayment HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string ​
​
Request parameters and headers​
This request uses common request headers. See Common Parameters.​
​
Name​
Location​
Type​
Required​
Sample value​
Description​
requestPayment​
Query​
String​
Yes​
-​
Represents a special identifier for the PutBucketRequestPayment request.​
​
Request body elements​
This request does not require body elements.​
Response headers​
This request returns common response headers. See Common Parameters.​
Response body elements​
​
Name​
Type​
Sample value​
Description​
Payer​
String​
Requester​
The payment mode of the bucket is explained as follows:​
  • BucketOwner: owner pays all fees.​
  • Requester: requester pays the traffic and request fees generated during access, while the bucket owner only pays storage and other fees. For details, see Billing Details.​
​
Sample request​
​
GET /?requestPayment HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string ​
​
Sample response​
​
HTTP/1.1 204 No Content​
Date: Thu, 19 Jun 2025 07:22:28 GMT​
Server: TosServer​
x-tos-id-2: 1e89f203b2d00006-a444ed0​
x-tos-request-id: 1e89f203b2d00006-a444ed0​
{​
"Payer": "Requester"​
}​
​
​
Last updated: 2025.09.08 17:32:51