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

Torch Object Storage

Copy page
Download PDF
Requester pays
PutBucketRequestPayment
Copy page
Download PDF
PutBucketRequestPayment
Feature description​
This interface sets the payment mode for the bucket.​
Request syntax​
​
PUT /?requestPayment HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string ​
{​
"Payer": "Requester"​
}​
​
Request parameters and headers​
This request uses public request headers. See Public Parameters.​
​
Name​
Location​
Parameter Type​
Required​
Sample value​
Description​
requestPayment​
Query​
String​
Yes​
-​
Represents the special identifier for the PutBucketRequestPayment request.​
​
Request body elements​
​
Name​
Type​
Required​
Sample value​
Description​
Payer​
String​
Yes​
Requester​
Specify the bucket payment mode. The values are as follows:​
  • BucketOwner: Owner pays all fees under this mode.​
  • Requester: Requester pays traffic and request fees during access, while the bucket owner only pays storage and other fees. For details, see Fees Description.​
​
Response headers​
This request returns public response headers. See Public Parameters.​
Response body elements​
No elements are used in this request response.​
Sample request​
​
PUT /?requestPayment HTTP/1.1​
Host: bucketname.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string ​
{​
"Payer": "Requester"​
}​
​
Sample response​
​
HTTP/1.1 200 OK​
x-tos-id-2: f91b0c03a01300c1-a444ed0 ​
x-tos-request-id: f91b0c03a01300c1-a444ed0 ​
Date: Thu, 19 Jun 2025 07:25:27 GMT​
server: TosServer​
Content-Length: 0​
​
​
Last updated: 2025.09.08 17:32:51