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

Notas de uso

A API do acelerador do OSS aceita chamadas apenas de uma rede interna na mesma região do OSS. Além disso, é necessário usar o nome de domínio do acelerador correspondente. Por exemplo, você pode chamar a API a partir de uma instância ECS na região China (Ulanqab). A tabela a seguir lista as zonas suportadas e os nomes de domínio do acelerador do OSS para cada região.

Região	Zona	Nome de domínio do acelerador do 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 tem permissões totais. Usuários RAM ou funções RAM sob uma conta Alibaba Cloud não têm permissões por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder permissões de operação por meio de RAM policies 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 usa cabeçalhos de solicitação comuns. Para mais informações, consulte Common Request Headers.

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 do OSS. Qualquer valor é aceito.
x-oss-datalake-cache-available-zone	string	Não	`cn-wulanchabu-b`	Quando especificado, retorna as informações do acelerador apenas para essa zona. Quando omitido, retorna todas as informações do acelerador para o bucket.
verbose	string	Não	Nenhum	Quando especificado, retorna todas as informações do caminho de aceleração além dos detalhes básicos do acelerador. Quando omitido, retorna apenas as informações básicas do acelerador. Este parâmetro pode ter qualquer valor.

Cabeçalhos da resposta

Esta operação usa cabeçalhos de resposta comuns. Para mais informações, consulte Common Response Headers.

Elementos da resposta

Nome	Tipo	Exemplo	Descrição
DataAccelerator	contêiner	Nenhum	Contém as informações do acelerador para o bucket. Nós filhos: `Name` `Bucket` `BasicInfomation` Nós pais: nenhum
Name	string	`mybucket_data-acc`	O nome do acelerador. Nós filhos: nenhum Nós pais: `DataAccelerator`
BucketName	string	`mybucket`	O nome do bucket. Nós filhos: nenhum Nós pais: `DataAccelerator`
BasicInfomation	contêiner	Nenhum	Contém informações detalhadas sobre um acelerador específico. Nós filhos: `AvailableZone` `Quota` `AcceleratePaths` `CreationDate` `QuotaFrozenUntil` Nós pais: `DataAccelerator`
Quota	inteiro positivo	100	A capacidade do acelerador. Nós filhos: nenhum Nós pais: `BasicInfomation`
AvailableZone	string	`cn-wulanchabu-b`	A zona do acelerador. Nós filhos: nenhum Nós pais: `BasicInfomation`
CreationDate	inteiro positivo	`123456789123`	O timestamp de quando o acelerador foi criado. Nós filhos: nenhum Nós pais: `BasicInfomation`
QuotaFrozenUntil	inteiro positivo	`123456789123`	O timestamp em que a cota do acelerador será descongelada. A cota não pode ser modificada antes deste timestamp. Nós filhos: nenhum Nós pais: `BasicInfomation`
AcceleratePaths	contêiner	Nenhum	Contém as configurações da política de aceleração. Nós filhos: `DefaultCachePolicy` `Path` Nós pais: `BasicInfomation`
Path	contêiner	Nenhum	Contém as configurações do caminho de aceleração. Nós filhos: `CachePolicy` `Name` Nós pais: `AcceleratePaths`
Name	string	`test/dir/`	O prefixo do caminho de aceleração especificado. Nós filhos: nenhum Nós pais: `Path`
CachePolicy	string	`sync-warmup`, `write-back`	A política de aceleração para o caminho. Deve ser um dos seguintes valores, caso contrário, a política não entra em vigor. `sync-warmup` (aquecimento síncrono durante a gravação) `write-back` (aquecimento durante a leitura) Nós filhos: nenhum Nós pais: `Path`
DefaultCachePolicy	string	`sync-warmup`, `write-back`	A política de aceleração para todo o bucket. Deve ser um dos seguintes valores. `sync-warmup` (aquecimento síncrono durante a gravação) `write-back` (aquecimento durante a leitura) Nós filhos: nenhum Nós pais: `AcceleratePaths`

Exemplos

Consulta a configuração do acelerador do OSS para 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 tem nenhum acelerador ativado.
NoSuchConfiguration	404	O bucket atual não tem um acelerador ativado na zona correspondente.