PutBucketDataAccelerator - Object Storage Service

調用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	加速器不支援在該可用性區域建立。