この操作を呼び出して、バケットの転送アクセラレーション構成をクエリできます。
使用方法
バケットの所有者、または oss:PutBucketTransferAcceleration 権限が付与されている RAM ユーザーのみが、バケットの転送アクセラレーション構成をクエリするリクエストを開始できます。
GetBucketTransferAcceleration リクエストを送信するバケットに対して転送アクセラレーションが構成されていない場合は、構成は返されません。
転送アクセラレーションの詳細については、開発者ガイドの「転送アクセラレーション」をご参照ください。
リクエスト構造
GET /?transferAcceleration HTTP/1.1
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValueレスポンスパラメーター
パラメーター | タイプ | 例 | 説明 |
TransferAccelerationConfiguration | コンテナー | N/A | 転送アクセラレーション構成を格納するために使用されるコンテナー。 |
Enabled | 文字列 | true | 転送アクセラレーションのステータス。有効な値:
|
GetBucketTransferAcceleration リクエストへのレスポンスに含まれる、x-oss-request-id や Date などの他の一般的なレスポンスヘッダーの詳細については、「共通レスポンスヘッダー」をご参照ください。
例
サンプルリクエスト
次のサンプルリクエストは、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サンプルレスポンス
次のレスポンスは、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>
OSS SDK
次のプログラミング言語の OSS SDK を使用して、GetBucketTransferAcceleration を呼び出すことができます。
ossutil
GetBucketTransferAcceleration 操作に対応する ossutil コマンドについては、「get-bucket-transfer-acceleration」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
NoSuchTransferAccelerationConfiguration | 404 | バケットに対して転送アクセラレーションが構成されていないために返されるエラーメッセージ。 |