GetBucketDataAccelerator - Object Storage Service: Central de Documentação do Alibaba Cloud

Notas de uso

A API do acelerador OSS só pode ser chamada a partir de uma rede interna na mesma região do OSS, sendo obrigatório o uso do nome de domínio do acelerador correspondente. Por exemplo, é possível chamar a API de uma instância ECS na região de Ulanqab. A tabela a seguir lista as zonas suportadas e os nomes de domínio do acelerador OSS para cada região.

Região	Zona	Nome de domínio do acelerador OSS
Beijing	`cn-beijing-h`	`cn-beijing-h-internal.oss-data-acc.aliyuncs.com`
Shanghai	`cn-shanghai-g`	`cn-shanghai-g-internal.oss-data-acc.aliyuncs.com`
Shenzhen	`cn-shenzhen-c`	`cn-shenzhen-c-internal.oss-data-acc.aliyuncs.com`
Hangzhou	`cn-hangzhou-j`	`cn-hangzhou-j-internal.oss-data-acc.aliyuncs.com`
Ulanqab	`cn-wulanchabu-b`	`cn-wulanchabu-b-internal.oss-data-acc.aliyuncs.com`
Singapore	`ap-southeast-1c`	`ap-southeast-1c-internal.oss-data-acc.aliyuncs.com`

Permissões

Por padrão, uma conta Alibaba Cloud possui permissões totais. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm permissões por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas RAM ou Bucket Policy.

API	Ação	Descrição
GetBucketDataAccelerator	`oss:GetBucketDataAccelerator`	Visualize as informações do acelerador do bucket.

Sintaxe da solicitação

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

Cabeçalhos da solicitação

Esta operação utiliza cabeçalhos de solicitação comuns. Para mais informações, consulte Cabeçalhos de solicitação comuns.

Parâmetros da solicitação

Nome	Tipo	Obrigatório	Exemplo	Descrição
dataAccelerator	string	Sim	Nenhum	Identifica esta operação como uma API do acelerador OSS. Qualquer valor é aceito.
x-oss-datalake-cache-available-zone	string	Não	`cn-wulanchabu-b`	Se especificado, retorna as informações do acelerador apenas para essa zona. Se omitido, retorna todas as informações do acelerador do bucket.
verbose	string	Não	Nenhum	Quando especificado, retorna todas as informações de caminho de aceleração além dos detalhes básicos do acelerador. Se omitido, apenas as informações básicas do acelerador são retornadas. Este parâmetro aceita qualquer valor.

Cabeçalhos da resposta

Esta operação utiliza cabeçalhos de resposta comuns. Para mais informações, consulte Cabeçalhos de resposta comuns.

Elementos da resposta

Nome	Tipo	Exemplo	Descrição
DataAccelerator	container	Nenhum	Contém as informações do acelerador do bucket. Nós filhos: `Name` `Bucket` `BasicInfomation` Nós pais: nenhum
Name	string	`mybucket_data-acc`	Nome do acelerador. Nós filhos: nenhum Nós pais: `DataAccelerator`
BucketName	string	`mybucket`	Nome do bucket. Nós filhos: nenhum Nós pais: `DataAccelerator`
BasicInfomation	container	Nenhum	Armazena informações detalhadas sobre um acelerador específico. Nós filhos: `AvailableZone` `Quota` `AcceleratePaths` `CreationDate` `QuotaFrozenUntil` Nós pais: `DataAccelerator`
Quota	inteiro positivo	100	Capacidade do acelerador. Nós filhos: nenhum Nós pais: `BasicInfomation`
AvailableZone	string	`cn-wulanchabu-b`	Zona do acelerador. Nós filhos: nenhum Nós pais: `BasicInfomation`
CreationDate	inteiro positivo	`123456789123`	Timestamp de criação do acelerador. Nós filhos: nenhum Nós pais: `BasicInfomation`
QuotaFrozenUntil	inteiro positivo	`123456789123`	Timestamp em que a cota do acelerador será descongelada. Não é possível modificar a cota antes deste timestamp. Nós filhos: nenhum Nós pais: `BasicInfomation`
AcceleratePaths	container	Nenhum	Contém as configurações da política de aceleração. Nós filhos: `DefaultCachePolicy` `Path` Nós pais: `BasicInfomation`
Path	container	Nenhum	Armazena as configurações do caminho de aceleração. Nós filhos: `CachePolicy` `Name` Nós pais: `AcceleratePaths`
Name	string	`test/dir/`	Prefixo do caminho de aceleração especificado. Nós filhos: nenhum Nós pais: `Path`
CachePolicy	string	`sync-warmup`, `write-back`	Política de aceleração para o caminho. Deve ser um dos valores a seguir; caso contrário, a política não terá efeito. `sync-warmup` (aquecimento síncrono durante escrita) `write-back` (aquecimento durante leitura) Nós filhos: nenhum Nós pais: `Path`
DefaultCachePolicy	string	`sync-warmup`, `write-back`	Política de aceleração para todo o bucket. Deve ser um dos valores a seguir. `sync-warmup` (aquecimento síncrono durante escrita) `write-back` (aquecimento durante leitura) Nós filhos: nenhum Nós pais: `AcceleratePaths`

Exemplos

Visualize a configuração do acelerador OSS de um bucket na região China (Ulanqab).

Exemplo de solicitação

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

Exemplo de resposta

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>

Códigos de erro

Código de erro	Código de status HTTP	Descrição
DataAcceleratorNotFound	404	O bucket atual não possui aceleradores ativados.
NoSuchConfiguration	404	Não há acelerador ativado na zona correspondente para o bucket atual.