金山云-文档中心-PUT Bucket DataAccelerator

对象存储(KS3)

查看更多结果

未找到含当前关键字的文档标题

页面目录

全部展开全部收起

产品更新动态

未找到含该关键词的产品

文档中心

对象存储(KS3)

API文档

Bucket相关

KS3加速器（KS3 Accelerator ）

PUT Bucket DataAccelerator

最近更新时间：2026-04-16 21:17:04



该接口用于在指定桶上创建加速器或修改加速器规则，调用该接口的用户必须是主账号或具有ks3:PutBucketDataAccelerator权限。

1. 新建或修改加速器规则成功后，预计5分钟内生效。

2. 仅支持标准、低频、归档、冷归档类型桶上创建加速器，不支持极速类型桶上创建加速器。

3. 创建或修改加速器规则请求仅支持使用专属加速器域名：ks3-data-acc-cn-beijing-e-internal.ksyuncs.com，创建成功后，对加速器内文件进行读写操作同样仅支持使用专属加速器域名。

4. 有关KS3加速器的更多详情请参见文档：加速器概述。

请求

请求语法

PUT /?dataAccelerator HTTP/1.1 
Host: {BucketName}.{endpoint} 
Date: {date} 
Authorization: {SignatureValue} 
Content-length: {length} 

Bucket dataAccelerator written in XML

请求参数

该接口不使用请求参数。

请求头

该请求仅使用公共请求头。

请求体

<DataAcceleratorConfiguration>
    <AvailableZone>cn-beijing-e</AvailableZone>
    <Quota>200</Quota>
    <AcceleratePaths>
        <Path>
            <Prefix>aaa/</Prefix>
            <SyncWarmup>true</SyncWarmup>
        </Path>
        <Path>
            <Prefix>bbb/</Prefix>
            <SyncWarmup>false</SyncWarmup>
        </Path>
        <Path>
            <Prefix>ccc/</Prefix>
        </Path>
    </AcceleratePaths>
</DataAcceleratorConfiguration>

XML中的节点具体描述如下：

名称	描述	是否必选
DataAcceleratorConfiguration	是	加速器配置的容器。类型：容器
AvailableZone	是	加速器的可用区，当前仅支持北京逸仙园可用区。类型：String 取值：`cn-beijing-e` 父节点：DataAcceleratorConfiguration
Quota	是	加速器容量，单位GB。父节点：DataAcceleratorConfiguration 类型：Integer 取值范围：[50, 51200] 加速器容量在创建或修改后的1小时内不可重复修改。
AcceleratePaths	否	加速策略配置的容器。类型：容器父节点：DataAcceleratorConfiguration
Path	否	存放加速前缀的容器，不填写Path时，表示加速的路径是整个桶。类型：容器父节点：AcceleratePaths 单个加速器规则最多支持填写10个Path，且前缀之间不能重叠。
Prefix	否	加速前缀。类型：String 取值范围：1-1024 父节点：Path 单个规则内的Prefix不允许重叠。
SyncWarmup	否	前缀是否开启同步预热，取值为：`true`、`false`。类型：Boolean 默认值：false 父节点：Path

响应

响应头

该接口只返回常用响应头部。

响应体

该接口不返回响应体。

示例

请求示例1

如下所示为针对整个桶开启加速器功能，不开启同步预热：

PUT /?dataAccelerator HTTP/1.1 
Host: bucketname.ks3-data-acc-cn-beijing-e-internal.ksyuncs.com
Date: Wed, 14 May 2014 02:11:21 GMT
Authorization: authorization string
Content-Length: yyy
Content-type: application/xml 

<DataAcceleratorConfiguration>
    <AvailableZone>cn-beijing-e</AvailableZone>
    <Quota>200</Quota>
</DataAcceleratorConfiguration>

请求示例2

如下所示为针对整个桶开启加速器功能，并开启同步预热：

PUT /?dataAccelerator HTTP/1.1 
Host: bucketname.ks3-data-acc-cn-beijing-e-internal.ksyuncs.com
Date: Wed, 14 May 2014 02:11:21 GMT
Authorization: authorization string
Content-Length: yyy
Content-type: application/xml 

<DataAcceleratorConfiguration>
    <AvailableZone>cn-beijing-e</AvailableZone>
    <Quota>200</Quota>
    <AcceleratePaths>
        <Path>
            <SyncWarmup>true</SyncWarmup>
        </Path>
    </AcceleratePaths>
</DataAcceleratorConfiguration>

请求示例3

如下所示为只针对prefix1/和prefix2/前缀的文件创建加速器，且prefix1/前缀的文件开启同步预热，prefix2/前缀的文件不开启同步预热：

PUT /?dataAccelerator HTTP/1.1 
Host: bucketname.ks3-data-acc-cn-beijing-e-internal.ksyuncs.com
Date: Wed, 14 May 2014 02:11:21 GMT
Authorization: authorization string
Content-Length: yyy
Content-type: application/xml 

<DataAcceleratorConfiguration>
    <AvailableZone>cn-beijing-e</AvailableZone>
    <Quota>200</Quota>
    <AcceleratePaths>
        <Path>
            <Prefix>prefix1/</Prefix>
            <SyncWarmup>true</SyncWarmup>
        </Path>
        <Path>
            <Prefix>prefix2/</Prefix>
            <SyncWarmup>false</SyncWarmup>
        </Path>
    </AcceleratePaths>
</DataAcceleratorConfiguration>

响应示例

HTTP/1.1 200 OK
Content-Length: 0
Connection: keep-alive
Date: Tue, 19 Jul 2017 09:14:23 GMT
Server: KS3
x-kss-request-id: 54a47bda18ac4e6e91de369add5421****

错误码

HTTP状态码	错误码	描述
400 Bad Request	MalformedXML	XML格式不正确，元素重复或缺少。
403 Forbidden	AccessDenied	缺少权限。
404 Not Found	NoSuchBucket	桶不存在。
400 Bad Request	InvalidArgument	存在以下场景时：极速存储类型桶创建加速器。 Path填写的数量超过10个。 Quota超过取值范围。修改Quota的频率大于1次/小时。 Prefix前缀重叠。

文档导读

上一篇：KS3加速器（KS3 Accelerator ）

下一篇：GET Bucket DataAccelerator

纯净模式常规模式

纯净模式

点击可全屏预览文档内容