PutBucketDataAccelerator_对象存储(OSS)-阿里云帮助中心

调用PutBucketDataAccelerator接口可创建OSS加速器或修改其配置。

注意事项

OSS加速器API仅支持在与OSS同地域的内网环境中调用，且必须使用对应的加速器域名。例如，可通过与OSS同处乌兰察布地域的ECS实例，使用API操作OSS加速器。以下是各区域支持的可用区及对应的OSS加速器域名。

地域	可用区	OSS加速器域名
北京	`cn-beijing-h`	`cn-beijing-h-internal.oss-data-acc.aliyuncs.com`
上海	`cn-shanghai-g`	`cn-shanghai-g-internal.oss-data-acc.aliyuncs.com`
深圳	`cn-shenzhen-c`	`cn-shenzhen-c-internal.oss-data-acc.aliyuncs.com`
杭州	`cn-hangzhou-j`	`cn-hangzhou-j-internal.oss-data-acc.aliyuncs.com`
乌兰察布	`cn-wulanchabu-b`	`cn-wulanchabu-b-internal.oss-data-acc.aliyuncs.com`
新加坡	`ap-southeast-1c`	`ap-southeast-1c-internal.oss-data-acc.aliyuncs.com`

权限说明

阿里云账号默认拥有全部权限。阿里云账号下的RAM用户或RAM角色默认没有任何权限，需要阿里云账号或账号管理员通过RAM Policy或Bucket Policy授予操作权限。

API	Action	说明
PutBucketDataAccelerator	`oss:PutBucketDataAccelerator`	创建Bucket加速器或修改其配置。

请求语法

PUT /?dataAccelerator HTTP/1.1
Date: GMT Date
Content-Length：ContentLength
Content-Type: application/xml
Authorization: SignatureValue 
Host: BUCKETNAME.cn-wulanchabu-b-internal.oss-data-acc.aliyuncs.com

<DataAcceleratorConfiguration>
  <AvailableZone>cn-wulanchabu-b</AvailableZone>
  <Quota>200</Quota>
  <AcceleratePaths>
    <DefaultCachePolicy>write-back</DefaultCachePolicy>
    <Path>
      <Name>AccelerationPath</Name>
      <CachePolicy>sync-warmup</CachePolicy>
    </Path>
  </AcceleratePaths>
</DataAcceleratorConfiguration>

请求头

此接口涉及公共请求头。具体请参见公共请求头（Common Request Headers）。

请求参数

名称	类型	是否必须	示例值	描述
dataAccelerator	字符串	是	无	OSS加速器AIP操作的标识参数，此参数值可取任意值。

请求体

名称	类型	是否必选	示例值	描述
DataAcceleratorConfiguration	容器	是	不涉及	加速器配置的容器子节点： `AvailableZone` `Quota` `AcceleratePaths` 父节点：无
AvailableZone	字符串	是	`cn-wulanchabu-b`	加速器的可用区，目前支持的可用区： `cn-beijing-h`（北京） `cn-shanghai-g`（上海） `cn-shenzhen-c`（深圳） `cn-hangzhou-j`（杭州） `cn-wulanchabu-b`（乌兰察布） `ap-southeast-1c`（新加坡）
Quota	正整数	是	100	加速器容量，单位GB。加速器容量在创建或修改后的一小时内不可重复修改。
AcceleratePaths	容器	是	不涉及	加速策略配置的容器子节点： `DefaultCachePolicy` `Path` 父节点： `DataAcceleratorConfiguration`
Path	容器	否	不涉及	加速路径配置的容器子节点： `Name` `CachePolicy` 父节点： `AcceleratePaths`
Name	字符串	是	`test/dir/`	指定加速路径前缀子节点：无父节点：`Path`
CachePolicy	字符串	是	`sync-warmup`，`write-back`	路径的加速策略，可选加速策略： `sync-warmup`（写时同步预热） `write-back`（读时预热）子节点：无父节点：`Path`
DefaultCachePolicy	字符串	是	`sync-warmup`，`write-back`	整个Bucket的默认加速策略，仅当没有配置任何Path时生效。可选加速策略： `sync-warmup`（写时同步预热） `write-back`（读时预热）子节点：无父节点：`AcceleratePaths`

响应头

此接口涉及公共响应头，具体请参见公共响应头（Common Response Headers）。

示例

创建OSS加速器

请求示例

PUT /?dataAccelerator= HTTP/1.1
Date: Sun, 05 Sep 2021 23:00:00 GMT
Content-Length: 556
Content-Type: application/xml
Authorization: OSS4-HMAC-SHA256 Credential=****
Host: http://BUCKETNAME.cn-wulanchabu-b-internal.oss-data-acc.aliyuncs.com

<DataAcceleratorConfiguration>
  <AvailableZone>cn-wulanchabu-b</AvailableZone>
  <Quota>200</Quota>
  <AcceleratePaths>
    <DefaultCachePolicy>write-back</DefaultCachePolicy>
    <Path>
      <Name>AccelerationPath</Name>
      <CachePolicy>sync-warmup</CachePolicy>
    </Path>
  </AcceleratePaths>
</DataAcceleratorConfiguration>

返回示例

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 27 Jun 2025 02:19:45 GMT
Content-Length: 0
Connection: keep-alive
x-oss-request-id: 685DFFC18AB8A63132C65285

错误码

错误码	HTTP状态码	描述
TooManyAccelerationPolicyPaths	400	配置过多加速路径。
InvalidCachePathPolicy	400	非法的加速策略。
InvalidQuota	400	非法的加速器容量。
DataAcceleratorQuotaFrozen	403	加速器容量处于锁定状态，不能修改。
DataAcceleratorAvailableZoneNotSupported	400	加速器不支持在该可用区创建。