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

调用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在对应可用区没有开通加速器。