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

文档中心

对象存储(KS3)

API文档

Bucket相关

KS3加速器（KS3 Accelerator ）

GET Bucket DataAccelerator

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



该接口用于获取加速器规则，调用该接口的用户必须是主账号或具有ks3:GetBucketDataAccelerator权限。

调用该接口必须使用专属加速器域名：ks3-data-acc-cn-beijing-e-internal.ksyuncs.com。

请求

请求语法

GET /?dataAccelerator HTTP/1.1
Host: {BucketName}.{endpoint}
Date: {date}
Authorization: {SignatureValue}

1. Endpoint与Region对应关系。

2. SignatureValue签名算法。

请求参数

该接口不使用请求参数。

请求头

该接口仅使用常用请求头部。

请求体

该接口不使用请求体。

响应

响应头

该接口仅返回常用响应头。

响应体

<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>
    </AcceleratePaths>
</DataAcceleratorConfiguration>

响应体中的参数描述如下所示：

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

示例

请求示例

GET /?dataAccelerator HTTP/1.1
Host: ks3-example.ks3-data-acc-cn-beijing-e-internal.ksyuncs.com
Date: Wed, 01 Mar 2016 12:00:00 GMT
Authorization: authorization string

响应示例

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 312
Connection: keep-alive
Date: Wed, 16 Aug 2017 12:23:54 GMT
Server: KS3
x-kss-request-id: NTk5NDM5NWFfMjQ4OGY3Xzc3NGRf****

<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>
    </AcceleratePaths>
</DataAcceleratorConfiguration>

错误码

HTTP状态码	错误码	描述
404 Not Found	NoSuchBucketDataAccelerator	加速器规则不存在。
400 Bad Request	InvalidRequest	请求不合法。
403 Forbidden	AccessDenied	缺少权限。
404 Not Found	NoSuchBucket	桶不存在。

文档导读

上一篇：PUT Bucket DataAccelerator

下一篇：DELETE Bucket DataAccelerator

纯净模式常规模式

纯净模式

点击可全屏预览文档内容