PutBucketDataAccelerator - Object Storage Service - Centro de documentación de Alibaba Cloud

Crea un acelerador de OSS o modifica su configuración.

Notas de uso

La API del acelerador de OSS solo se puede invocar desde una red interna en la misma región que OSS, y debe utilizar el nombre de dominio del acelerador correspondiente. Por ejemplo, puede llamar a la API desde una instancia ECS en la región Ulanqab. A continuación se muestran las zonas compatibles y los nombres de dominio del acelerador de OSS para cada región.

Región	Zona	Nombre de dominio del acelerador de 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`

Permisos

De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos completos. Los usuarios RAM o roles RAM bajo una cuenta de Alibaba Cloud no tienen ningún permiso por defecto. La cuenta de Alibaba Cloud o el administrador de la cuenta deben otorgar los permisos de operación mediante RAM policies o Bucket Policy.

API	Action	Descripción
PutBucketDataAccelerator	`oss:PutBucketDataAccelerator`	Crea un acelerador de bucket o modifica su configuración.

Sintaxis de la solicitud

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>

Encabezados de la solicitud

Esta operación utiliza encabezados de solicitud comunes. Para obtener más información, consulte Common Request Headers.

Parámetros de la solicitud

Nombre	Tipo	Obligatorio	Ejemplo	Descripción
dataAccelerator	string	Sí	Ninguna	Parámetro identificador para las operaciones de la API del acelerador de OSS. Se puede establecer en cualquier valor.

Cuerpo de la solicitud

Nombre	Tipo	Obligatorio	Ejemplo	Descripción
DataAcceleratorConfiguration	Container	Sí	N/A	Contenedor para la configuración del acelerador. Nodos secundarios: `AvailableZone` `Quota` `AcceleratePaths` Nodo principal: Ninguna
AvailableZone	string	Sí	`cn-wulanchabu-b`	Zona del acelerador. Zonas compatibles: `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	Positive integer	Sí	100	Capacidad del acelerador, en GB. La capacidad no se puede modificar nuevamente dentro de una hora después de su creación o modificación.
AcceleratePaths	Container	Sí	N/A	Contenedor para la configuración de la directiva de aceleración. Nodos secundarios: `DefaultCachePolicy` `Path` Nodo principal: `DataAcceleratorConfiguration`
Path	Container	No	N/A	Contenedor para la configuración de la ruta de aceleración. Nodos secundarios: `Name` `CachePolicy` Nodo principal: `AcceleratePaths`
Name	string	Sí	`test/dir/`	Prefijo de la ruta de aceleración. Nodos secundarios: Ninguna Nodo principal: `Path`
CachePolicy	string	Sí	`sync-warmup`, `write-back`	Directiva de aceleración para la ruta. Valores válidos: `sync-warmup` (precarga síncrona al escribir) `write-back` (precarga al leer) Nodos secundarios: Ninguna Nodo principal: `Path`
DefaultCachePolicy	string	Sí	`sync-warmup`, `write-back`	Directiva de aceleración predeterminada para todo el bucket. Solo surte efecto cuando no se configura ninguna ruta (Path). Valores válidos: `sync-warmup` (precarga síncrona al escribir) `write-back` (precarga al leer) Nodos secundarios: Ninguna Nodo principal: `AcceleratePaths`

Encabezados de la respuesta

Esta operación utiliza encabezados de respuesta comunes. Para obtener más información, consulte Common Response Headers.

Ejemplos

Crear un acelerador de OSS

Ejemplo de solicitud

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>

Ejemplo de respuesta

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 error

Código de error	Código de estado HTTP	Descripción
TooManyAccelerationPolicyPaths	400	El número de rutas de aceleración configuradas supera el límite.
InvalidCachePathPolicy	400	La directiva de aceleración especificada no es válida.
InvalidQuota	400	La capacidad del acelerador especificada no es válida.
DataAcceleratorQuotaFrozen	403	La capacidad del acelerador está congelada y no se puede modificar.
DataAcceleratorAvailableZoneNotSupported	400	La zona especificada no admite el acelerador.