PutBucketRequestPayment--对象存储-火山引擎

文档中心

立即注册

导航

对象存储

PutBucketRequestPayment

最近更新时间：2025.07.07 18:46:37首次发布时间：2025.07.07 18:46:37

功能描述

此接口用于设置存储桶的付费模式。

请求消息样式

PUT /?requestPayment HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string 
{
    "Payer": "Requester"
}

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
requestPayment	Query	String	是	-	代表 PutBucketRequestPayment 请求的特殊标识。

请求元素

名称	参数类型	是否必填	示例值	说明
Payer	String	是	Requester	指定存储桶的付费模式，取值说明如下： `BucketOwner`：所有者付费模式，存储桶拥有者支付全部费用。 `Requester`：请求者付费模式，请求者支付访问过程中产生的流量费用、请求次数费用，存储桶拥有者只需支付存储费用等其他费用。详细介绍，请参见费用说明。

名称

参数类型

是否必填

示例值

说明

Payer

String

是

Requester

指定存储桶的付费模式，取值说明如下：

BucketOwner：所有者付费模式，存储桶拥有者支付全部费用。
Requester：请求者付费模式，请求者支付访问过程中产生的流量费用、请求次数费用，存储桶拥有者只需支付存储费用等其他费用。详细介绍，请参见费用说明。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

该请求响应中无消息元素。

请求示例

PUT /?requestPayment HTTP/1.1
Host: bucketname.tos-cn-beijing.volces.com
Date: GMT Date
Authorization: authorization string 
{
    "Payer": "Requester"
}

响应示例

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