PutBucketDataAccelerator - 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. É obrigatório usar o nome de domínio do acelerador correspondente. Por exemplo, chame a API de uma instância ECS na região de Ulanqab. A tabela a seguir lista as zonas compatíveis 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 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 do RAM ou Bucket Policy.

API	Action	Descrição
PutBucketDataAccelerator	`oss:PutBucketDataAccelerator`	Crie um acelerador de bucket ou defina sua configuração.

Sintaxe da solicitação

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>

Cabeçalhos da solicitação

Esta operação usa 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	Parâmetro identificador para operações da API do acelerador do OSS. Aceita qualquer valor.

Corpo da solicitação

Nome	Tipo	Obrigatório	Exemplo	Descrição
DataAcceleratorConfiguration	Container	Sim	N/A	Container da configuração do acelerador. Nós filhos: `AvailableZone` `Quota` `AcceleratePaths` Nó pai: Nenhum
AvailableZone	string	Sim	`cn-wulanchabu-b`	Zona do acelerador. Zonas compatíveis: `cn-beijing-h` (Beijing) `cn-shanghai-g` (Shanghai) `cn-shenzhen-c` (Shenzhen) `cn-hangzhou-j` (Hangzhou) `cn-wulanchabu-b` (Ulanqab) `ap-southeast-1c` (Singapore)
Quota	Inteiro positivo	Sim	100	Capacidade do acelerador, em GB. Não é possível modificar a capacidade novamente dentro de uma hora após a criação ou modificação.
AcceleratePaths	Container	Sim	N/A	Container da configuração da política de aceleração. Nós filhos: `DefaultCachePolicy` `Path` Nó pai: `DataAcceleratorConfiguration`
Path	Container	Não	N/A	Container da configuração do caminho de aceleração. Nós filhos: `Name` `CachePolicy` Nó pai: `AcceleratePaths`
Name	string	Sim	`test/dir/`	Prefixo do caminho de aceleração. Nós filhos: Nenhum Nó pai: `Path`
CachePolicy	string	Sim	`sync-warmup`, `write-back`	Política de aceleração do caminho. Valores válidos: `sync-warmup` (aquecimento síncrono durante escrita) `write-back` (aquecimento durante leitura) Nós filhos: Nenhum Nó pai: `Path`
DefaultCachePolicy	string	Sim	`sync-warmup`, `write-back`	Política de aceleração padrão para todo o bucket. Aplica-se apenas quando nenhum Path está configurado. Valores válidos: `sync-warmup` (aquecimento síncrono durante escrita) `write-back` (aquecimento durante leitura) Nós filhos: Nenhum Nó pai: `AcceleratePaths`

Cabeçalhos da resposta

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

Exemplos

Crie um acelerador do OSS

Exemplo de solicitação

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>

Exemplo de resposta

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

Códigos de erro

Código de erro	Código de status HTTP	Descrição
TooManyAccelerationPolicyPaths	400	O número de caminhos de aceleração configurados excede o limite.
InvalidCachePathPolicy	400	A política de aceleração especificada é inválida.
InvalidQuota	400	A capacidade do acelerador especificada é inválida.
DataAcceleratorQuotaFrozen	403	A capacidade do acelerador está congelada e não pode ser modificada.
DataAcceleratorAvailableZoneNotSupported	400	A zona especificada não oferece suporte ao acelerador.