PutBucketDataAccelerator - Object Storage Service - Centre de documentation Alibaba Cloud

Remarques d'utilisation

L'API de l'accélérateur OSS ne peut être appelée que depuis un réseau interne situé dans la même région qu'OSS, et vous devez utiliser le nom de domaine de l'accélérateur correspondant. Par exemple, vous pouvez appeler l'API depuis une instance ECS dans la région Ulanqab. Le tableau suivant répertorie les zones prises en charge ainsi que 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 stratégies RAM ou une Bucket Policy.

API

Action

Description

PutBucketDataAccelerator

oss:PutBucketDataAccelerator

Créez un accélérateur de bucket ou modifiez sa configuration.

Syntaxe de la requête

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>

En-têtes de requête

Cette opération utilise des en-têtes de requête courants. Pour plus d'informations, consultez la section En-têtes de requête courants.

Paramètres de requête

Name

Type

Required

Example

Description

dataAccelerator

string

Yes

None

Paramètre d'identifiant pour les opérations API de l'accélérateur OSS. Peut être défini sur n'importe quelle valeur.

Corps de la requête

Name	Type	Required	Example	Description
DataAcceleratorConfiguration	Container	Yes	N/A	Conteneur pour la configuration de l'accélérateur. Nœuds enfants : `AvailableZone` `Quota` `AcceleratePaths` Nœud parent : None
AvailableZone	string	Yes	`cn-wulanchabu-b`	Zone de l'accélérateur. Zones prises en charge : `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	Yes	100	Capacité de l'accélérateur, en Go. La capacité ne peut pas être modifiée à nouveau dans l'heure qui suit la création ou la modification.
AcceleratePaths	Container	Yes	N/A	Conteneur pour la configuration de la politique d'accélération. Nœuds enfants : `DefaultCachePolicy` `Path` Nœud parent : `DataAcceleratorConfiguration`
Path	Container	No	N/A	Conteneur pour la configuration du chemin d'accélération. Nœuds enfants : `Name` `CachePolicy` Nœud parent : `AcceleratePaths`
Name	string	Yes	`test/dir/`	Préfixe du chemin d'accélération. Nœuds enfants : None Nœud parent : `Path`
CachePolicy	string	Yes	`sync-warmup`, `write-back`	Politique d'accélération pour le chemin. Valeurs valides : `sync-warmup` (préchauffage synchrone lors de l'écriture) `write-back` (préchauffage lors de la lecture) Nœuds enfants : None Nœud parent : `Path`
DefaultCachePolicy	string	Yes	`sync-warmup`, `write-back`	Politique d'accélération par défaut pour l'ensemble du bucket. Prend effet uniquement lorsqu'aucun Path n'est configuré. Valeurs valides : `sync-warmup` (préchauffage synchrone lors de l'écriture) `write-back` (préchauffage lors de la lecture) Nœuds enfants : None Nœud parent : `AcceleratePaths`

En-têtes de réponse

Cette opération utilise des en-têtes de réponse courants. Pour plus d'informations, consultez la section En-têtes de réponse courants.

Exemples

Créez un accélérateur OSS

Exemple de requête

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>

Exemple de réponse

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

Codes d'erreur

Error code

HTTP status code

Description

TooManyAccelerationPolicyPaths

400

Le nombre de chemins d'accélération configurés dépasse la limite.

InvalidCachePathPolicy

400

La politique d'accélération spécifiée n'est pas valide.

InvalidQuota

400

La capacité de l'accélérateur spécifiée n'est pas valide.

DataAcceleratorQuotaFrozen

403

La capacité de l'accélérateur est gelée et ne peut pas être modifiée.

DataAcceleratorAvailableZoneNotSupported

400

La zone spécifiée ne prend pas en charge l'accélérateur.