Cette opération interroge les configurations d'accélération de transfert d'un bucket.
Notes d'utilisation
Seul le propriétaire d'un bucket ou les utilisateurs RAM disposant de l'autorisation
oss:PutBucketTransferAccelerationpeuvent envoyer des requêtes pour interroger les configurations d'accélération de transfert d'un bucket.Si l'accélération de transfert n'est pas configurée pour le bucket ciblé par la requête GetBucketTransferAcceleration, aucune configuration n'est renvoyée.
Pour plus d'informations sur l'accélération de transfert, consultez la rubrique Accéder à OSS à l'aide de l'accélération de transfert du Guide du développeur.
Structure de la requête
GET /?transferAcceleration HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue
Paramètres de réponse
|
Paramètre |
Type |
Exemple |
Description |
|
TransferAccelerationConfiguration |
Conteneur |
N/A |
Conteneur utilisé pour stocker les configurations d'accélération de transfert. |
|
Enabled |
Chaîne |
true |
État de l'accélération de transfert. Valeurs possibles :
|
Pour plus d'informations sur les autres en-têtes de réponse courants, tels que x-oss-request-id et Date, inclus dans la réponse à une requête GetBucketTransferAcceleration, consultez la rubrique En-têtes de réponse courants.
Exemples
-
Exemples de requêtes
La requête suivante interroge l'état de l'accélération de transfert d'un bucket nommé examplebucket :
GET /?transferAcceleration HTTP/1.1 Date: Thu, 17 Apr 2025 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 -
Exemples de réponses
La réponse suivante indique que l'accélération de transfert est activée pour examplebucket :
HTTP/1.1 200 OK x-oss-request-id: 534B371674E88A4D8906**** Date: Fri , 30 Apr 2021 13:08:38 GMT <TransferAccelerationConfiguration> <Enabled>true</Enabled> </TransferAccelerationConfiguration>
SDK OSS
Utilisez les SDK OSS pour les langages de programmation suivants afin d'appeler GetBucketTransferAcceleration :
ossutil
Pour obtenir des informations sur la commande ossutil correspondant à l'opération GetBucketTransferAcceleration, consultez la rubrique get-bucket-transfer-acceleration.
Codes d'erreur
|
Code d'erreur |
Code d'état HTTP |
Description |
|
NoSuchTransferAccelerationConfiguration |
404 |
L'accélération de transfert n'est pas configurée pour le bucket. |