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

Consulta la información del acelerador de OSS para un bucket, lo que incluye las configuraciones de capacidad, zona y rutas de aceleración.

Notas de uso

La API del acelerador de OSS solo se puede invocar desde una red interna ubicada en la misma región que OSS. Además, debe utilizar el nombre de dominio del acelerador correspondiente. Por ejemplo, puede invocar la API desde una instancia ECS en la región Ulanqab. A continuación se muestra una tabla con 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 o roles de RAM asociados a una cuenta de Alibaba Cloud no cuentan con ningún permiso de manera predeterminada. La cuenta de Alibaba Cloud o su administrador deben otorgar los permisos de operación mediante RAM policies o Bucket Policy.

API	Acción	Descripción
GetBucketDataAccelerator	`oss:GetBucketDataAccelerator`	Consulte la información del acelerador del bucket.

Sintaxis de la solicitud

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

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	Identifica esta llamada como una operación de la API del acelerador de OSS. Se acepta cualquier valor.
x-oss-datalake-cache-available-zone	string	No	`cn-wulanchabu-b`	Si se especifica, devuelve únicamente la información del acelerador para esa zona. Si se omite, devuelve toda la información del acelerador del bucket.
verbose	string	No	Ninguna	Si se especifica, devuelve toda la información de las rutas de aceleración además de los detalles básicos del acelerador. Si se omite, solo se devuelve la información básica del acelerador. Este parámetro acepta cualquier valor.

Encabezados de la respuesta

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

Elementos de la respuesta

Nombre	Tipo	Ejemplo	Descripción
DataAccelerator	container	Ninguna	Contiene la información del acelerador del bucket. Nodos secundarios: `Name` `Bucket` `BasicInfomation` Nodos primarios: ninguno
Name	string	`mybucket_data-acc`	El nombre del acelerador. Nodos secundarios: ninguno Nodos primarios: `DataAccelerator`
BucketName	string	`mybucket`	El nombre del bucket. Nodos secundarios: ninguno Nodos primarios: `DataAccelerator`
BasicInfomation	container	Ninguna	Contiene la información detallada de un acelerador específico. Nodos secundarios: `AvailableZone` `Quota` `AcceleratePaths` `CreationDate` `QuotaFrozenUntil` Nodos primarios: `DataAccelerator`
Quota	positive integer	100	La capacidad del acelerador. Nodos secundarios: ninguno Nodos primarios: `BasicInfomation`
AvailableZone	string	`cn-wulanchabu-b`	La zona del acelerador. Nodos secundarios: ninguno Nodos primarios: `BasicInfomation`
CreationDate	positive integer	`123456789123`	La marca de tiempo en la que se creó el acelerador. Nodos secundarios: ninguno Nodos primarios: `BasicInfomation`
QuotaFrozenUntil	positive integer	`123456789123`	La marca de tiempo en la que se liberará la cuota del acelerador. Antes de este momento, no es posible modificar la cuota. Nodos secundarios: ninguno Nodos primarios: `BasicInfomation`
AcceleratePaths	container	Ninguna	Contiene las configuraciones de las políticas de aceleración. Nodos secundarios: `DefaultCachePolicy` `Path` Nodos primarios: `BasicInfomation`
Path	container	Ninguna	Contiene las configuraciones de las rutas de aceleración. Nodos secundarios: `CachePolicy` `Name` Nodos primarios: `AcceleratePaths`
Name	string	`test/dir/`	El prefijo especificado para la ruta de aceleración. Nodos secundarios: ninguno Nodos primarios: `Path`
CachePolicy	string	`sync-warmup`, `write-back`	La política de aceleración para la ruta. Debe ser uno de los siguientes valores; de lo contrario, la política no surtirá efecto. `sync-warmup` (precalentamiento síncrono durante la escritura) `write-back` (precalentamiento durante la lectura) Nodos secundarios: ninguno Nodos primarios: `Path`
DefaultCachePolicy	string	`sync-warmup`, `write-back`	La política de aceleración para todo el bucket. Debe ser uno de los siguientes valores. `sync-warmup` (precalentamiento síncrono durante la escritura) `write-back` (precalentamiento durante la lectura) Nodos secundarios: ninguno Nodos primarios: `AcceleratePaths`

Ejemplos

Consulta la configuración del acelerador de OSS para un bucket en la región China (Ulanqab).

Ejemplo de solicitud

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

Ejemplo de respuesta

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 error

Código de error	Código de estado HTTP	Descripción
DataAcceleratorNotFound	404	El bucket actual no tiene ningún acelerador habilitado.
NoSuchConfiguration	404	El bucket actual no tiene un acelerador habilitado en la zona correspondiente.