GetBucketDataAccelerator - Object Storage Service - Centre de documentation Alibaba Cloud

Notes d'utilisation

Vous ne pouvez appeler l'API de l'accélérateur OSS que depuis un réseau interne situé dans la même région qu'OSS, en utilisant le nom de domaine de l'accélérateur correspondant. Par exemple, appelez l'API depuis une instance ECS dans la région Ulanqab. Le tableau suivant répertorie les zones prises en charge et les noms de domaine de l'accélérateur OSS pour chaque région.

Region

Zone

OSS accelerator domain name

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

Permissions

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via des politiques RAM ou une stratégie de bucket.

API

Action

Description

GetBucketDataAccelerator

oss:GetBucketDataAccelerator

Consultez les informations de l'accélérateur du bucket.

Syntaxe de la requête

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

En-têtes de requête

Cette opération utilise des en-têtes de requête communs. Pour plus d'informations, consultez les en-têtes de requête communs.

Paramètres de requête

Name

Type

Required

Example

Description

dataAccelerator

string

Yes

None

Identifie cette opération comme une API d'accélérateur OSS. Toute valeur est acceptée.

x-oss-datalake-cache-available-zone

string

No

cn-wulanchabu-b

Si spécifié, renvoie les informations de l'accélérateur uniquement pour cette zone.

Si omis, renvoie toutes les informations de l'accélérateur pour le bucket.

verbose

string

No

None

Si spécifié, renvoie toutes les informations du chemin d'accélération en plus des détails de base de l'accélérateur. Si omis, seules les informations de base de l'accélérateur sont renvoyées.

Ce paramètre peut avoir n'importe quelle valeur.

En-têtes de réponse

Cette opération utilise des en-têtes de réponse communs. Pour plus d'informations, consultez les en-têtes de réponse communs.

Éléments de réponse

Name	Type	Example	Description
DataAccelerator	container	None	Contient les informations de l'accélérateur pour le bucket. Nœuds enfants : `Name` `Bucket` `BasicInfomation` Nœuds parents : aucun
Name	string	`mybucket_data-acc`	Le nom de l'accélérateur. Nœuds enfants : aucun Nœuds parents : `DataAccelerator`
BucketName	string	`mybucket`	Le nom du bucket. Nœuds enfants : aucun Nœuds parents : `DataAccelerator`
BasicInfomation	container	None	Contient des informations détaillées sur un accélérateur spécifique. Nœuds enfants : `AvailableZone` `Quota` `AcceleratePaths` `CreationDate` `QuotaFrozenUntil` Nœuds parents : `DataAccelerator`
Quota	positive integer	100	La capacité de l'accélérateur. Nœuds enfants : aucun Nœuds parents : `BasicInfomation`
AvailableZone	string	`cn-wulanchabu-b`	La zone de l'accélérateur. Nœuds enfants : aucun Nœuds parents : `BasicInfomation`
CreationDate	positive integer	`123456789123`	L'horodatage de création de l'accélérateur. Nœuds enfants : aucun Nœuds parents : `BasicInfomation`
QuotaFrozenUntil	positive integer	`123456789123`	L'horodatage auquel le quota de l'accélérateur sera dégelé. Le quota ne peut pas être modifié avant cet horodatage. Nœuds enfants : aucun Nœuds parents : `BasicInfomation`
AcceleratePaths	container	None	Contient les configurations de la politique d'accélération. Nœuds enfants : `DefaultCachePolicy` `Path` Nœuds parents : `BasicInfomation`
Path	container	None	Contient les configurations du chemin d'accélération. Nœuds enfants : `CachePolicy` `Name` Nœuds parents : `AcceleratePaths`
Name	string	`test/dir/`	Le préfixe du chemin d'accélération spécifié. Nœuds enfants : aucun Nœuds parents : `Path`
CachePolicy	string	`sync-warmup`, `write-back`	La politique d'accélération pour le chemin. Doit être l'une des valeurs suivantes, sinon la politique ne prend pas effet. `sync-warmup` (préchauffage synchrone lors de l'écriture) `write-back` (préchauffage lors de la lecture) Nœuds enfants : aucun Nœuds parents : `Path`
DefaultCachePolicy	string	`sync-warmup`, `write-back`	La politique d'accélération pour l'ensemble du bucket. Doit être l'une des valeurs suivantes. `sync-warmup` (préchauffage synchrone lors de l'écriture) `write-back` (préchauffage lors de la lecture) Nœuds enfants : aucun Nœuds parents : `AcceleratePaths`

Exemples

Interrogez la configuration de l'accélérateur OSS pour un bucket dans la région Chine (Ulanqab).

Exemple de requête

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

Exemple de réponse

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>

Codes d'erreur

Error code

HTTP status code

Description

DataAcceleratorNotFound

404

Aucun accélérateur n'est activé pour le bucket actuel.

NoSuchConfiguration

404

Aucun accélérateur n'est activé pour le bucket actuel dans la zone correspondante.