Configurez l'accélération de transfert pour un bucket. Une fois activée, cette fonctionnalité permet aux utilisateurs du monde entier d'accéder plus rapidement aux objets. Elle convient aux scénarios impliquant des transferts de données sur de longues distances, ainsi qu'au chargement ou au téléchargement d'objets volumineux (de l'ordre du gigaoctet ou du téraoctet).
Remarques d'utilisation
Lorsque vous activez l'accélération de transfert pour un bucket, un endpoint d'accélération s'ajoute à l'endpoint par défaut. L'accès n'est accéléré que si vous utilisez cet endpoint d'accélération.
Des frais d'accélération de transfert s'appliquent lorsque vous accédez à un bucket via l'endpoint d'accélération. Pour plus d'informations, consultez la rubrique Frais d'accélération de transfert.
Pour en savoir plus sur l'accélération de transfert, consultez la rubrique Accéder à OSS via l'accélération de transfert.
Autorisations
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 nécessaires via des politiques RAM ou une Bucket Policy.
|
API |
Action |
Description |
|
PutBucketTransferAcceleration |
oss:PutBucketTransferAcceleration |
Configure l'accélération de transfert pour un bucket. |
Structure de la requête
PUT /?transferAcceleration HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValueParamètres de la requête
|
Paramètre |
Type |
Obligatoire |
Exemple |
Description |
|
TransferAccelerationConfiguration |
Container |
Oui |
N/A |
Conteneur qui stocke la configuration de l'accélération de transfert. |
|
Enabled |
String |
Oui |
true |
Indique si l'accélération de transfert est activée pour le bucket. Valeurs possibles :
Important
L'accélération de transfert prend effet dans les 30 minutes suivant son activation. |
Pour plus d'informations sur les en-têtes de requête communs dans les requêtes PutBucketTransferAcceleration, tels que Authorization et Content-Length, consultez la rubrique En-têtes de requête communs.
En-têtes de réponse
La réponse contient uniquement des en-têtes de réponse communs, tels que x-oss-request-id et Date. Pour plus d'informations, consultez la rubrique En-têtes de réponse communs.
Exemples
-
Exemple de requête
La requête suivante active l'accélération de transfert pour un bucket nommé examplebucket :
PUT /?transferAcceleration HTTP/1.1 Date: Fri, 30 Apr 2021 13:08:38 GMT Content-Length: 443 Content-Type: application/xml Host: examplebucket.oss.aliyuncs.com Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e <TransferAccelerationConfiguration> <Enabled>true</Enabled> </TransferAccelerationConfiguration> -
Exemple de réponse
HTTP/1.1 200 OK x-oss-request-id: 534B371674A4D890**** Date: Thu, 17 Apr 2025 13:08:38 GMT Content-Length: 443 Connection: keep-alive Server: AliyunOSS
SDK OSS
Utilisez les SDK OSS pour les langages de programmation suivants afin d'appeler cette opération :
ossutil
Pour obtenir des informations sur la commande ossutil correspondant à l'opération PutBucketTransferAcceleration, consultez la rubrique put-bucket-transfer-acceleration.
Codes d'erreur
|
Code d'erreur |
Code d'état HTTP |
Description |
|
AccessDenied |
404 |
Vous n'êtes pas autorisé à effectuer cette opération. Seuls les utilisateurs disposant de l'autorisation oss:PutBucketTransferAcceleration peuvent configurer l'accélération de transfert pour le bucket. |
|
MalformedXML |
400 |
Le corps de la requête n'est pas un XML valide. Par exemple, le champ Enabled est défini sur une valeur autre que true ou false. |