GetBucketDataAccelerator - Object Storage Service

調用GetBucketDataAccelerator介面查詢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	說明
GetBucketDataAccelerator	`oss:GetBucketDataAccelerator`	查看Bucket加速器資訊。

請求文法

GET /?dataAccelerator=&x-oss-datalake-cache-available-zone=cn-wulanchabu-b&verbose= 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

要求標頭

此介面涉及公用要求標頭。具體請參見公用要求標頭（Common Request Headers）。

請求參數

名稱	類型	是否必須	樣本值	描述
dataAccelerator	字串	是	無	OSS加速器AIP操作的標識參數，此參數值可取任意值。
x-oss-datalake-cache-available-zone	字串	否	`cn-wulanchabu-b`	若該參數存在則指定查看某個可用性區域的加速器資訊。否則返回該bucket的全部加速器資訊。
verbose	字串	否	無	若參數存在，則指定查看全部加速路徑資訊。否則只返回加速器基本資料，不返回加速路徑資訊。此參數值可取任意值。

回應標頭

此介面涉及公用回應標頭，具體請參見公用回應標頭（Common Response Headers）。

響應元素

名稱	類型	樣本值	描述
DataAccelerator	容器	不涉及	Bucket已設定的加速器資訊的容器。子節點： `Name` `Bucket` `BasicInfomation` 父節點：無
Name	字串	`mybucket_data-acc`	加速器名稱。子節點：無父節點：`DataAccelerator`
BucketName	字串	`mybucket`	Bucket名稱子節點：無父節點：`DataAccelerator`
BasicInfomation	容器	不涉及	具體某個加速器資訊的容器。子節點： `AvailableZone` `Quota` `AcceleratePaths` `CreationDate` `QuotaFrozenUntil` 父節點： `DataAccelerator`
Quota	正整數	100	加速器容量。子節點：無父節點：`BasicInfomation`
AvailableZone	字串	`cn-wulanchabu-b`	加速器的可用性區域。子節點：無父節點：`BasicInfomation`
CreationDate	正整數	`123456789123`	加速器建立時間戳記。子節點：無父節點：`BasicInfomation`
QuotaFrozenUntil	正整數	`123456789123`	加速器Quota解凍時間戳記，即該時間戳記之前Quota不允許修改。子節點：無父節點：`BasicInfomation`
AcceleratePaths	容器	不涉及	加速策略配置的容器。子節點： `DefaultCachePolicy` `Path` 父節點： `BasicInfomation`
Path	容器	不涉及	加速路徑配置的容器子節點： `CachePolicy` `Name` 父節點：`AcceleratePaths`
Name	字串	`test/dir/`	指定加速路徑首碼子節點：無父節點：`Path`
CachePolicy	字串	`sync-warmup`，`write-back`	路徑的加速策略，取值為以下參數之一，否則加速策略不生效。 `sync-warmup`（寫時同步預熱） `write-back`（讀時預熱）子節點：無父節點：`Path`
DefaultCachePolicy	字串	`sync-warmup`，`write-back`	整個Bucket的加速策略，取值為以下參數之一。 `sync-warmup`（寫時同步預熱） `write-back`（讀時預熱）子節點：無父節點：`AcceleratePaths`

樣本

查詢烏蘭察布地區目標Bucket的OSS加速器配置資訊。

請求樣本

GET /?dataAccelerator=&x-oss-datalake-cache-available-zone=cn-wulanchabu-b&verbose= HTTP/1.1
Date: Sun, 05 Sep 2021 23:00:00 GMT
Content-Length: 556
Authorization: OSS4-HMAC-SHA256 Credential=****
Host: http://BUCKETNAME.cn-wulanchabu-b-internal.oss-data-acc.aliyuncs.com

返回樣本

HTTP/1.1 200 OK
Server: AliyunOSS
Date: Fri, 27 Jun 2025 02:57:27 GMT
Content-Type: application/xml
Content-Length: 459
Connection: keep-alive
x-oss-request-id: 685E08978AB8A63836D81586

<?xml version="1.0" encoding="UTF-8"?>
<DataAccelerator>
  <Name>mybucket_data-acc</Name>
  <BucketName>mybucket</BucketName>
  <BasicInfomation>
    <Quota>200</Quota>
    <AvailableZone>cn-wulanchabu-b</AvailableZone>
    <AcceleratePaths>
      <Path>
        <Name>AccelerationPath</Name>
        <CachePolicy>sync-warmup</CachePolicy>
      </Path>
      <DefaultCachePolicy>write-back</DefaultCachePolicy>
    </AcceleratePaths>
    <CreationDate>1751013420658</CreationDate>
    <QuotaFrozenUntil>1751017020624</QuotaFrozenUntil>
  </BasicInfomation>
</DataAccelerator>

錯誤碼

錯誤碼	HTTP狀態代碼	描述
DataAcceleratorNotFound	404	當前Bucket沒有開通任何加速器。
NoSuchConfiguration	404	當前Bucket在對應可用性區域沒有開通加速器。