すべてのプロダクト
Search
ドキュメントセンター

Object Storage Service:GetBucketTransferAcceleration

最終更新日:Jul 29, 2025

この操作を呼び出して、バケットの転送アクセラレーション構成をクエリできます。

使用方法

  • バケットの所有者、または 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

転送アクセラレーションのステータス。有効な値:

  • true: バケットに対して転送アクセラレーションが有効になっていることを示します。

  • false: バケットに対して転送アクセラレーションが無効になっていることを示します。

GetBucketTransferAcceleration リクエストへのレスポンスに含まれる、x-oss-request-idDate などの他の一般的なレスポンスヘッダーの詳細については、「共通レスポンスヘッダー」をご参照ください。

  • サンプルリクエスト

    次のサンプルリクエストは、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

バケットに対して転送アクセラレーションが構成されていないために返されるエラーメッセージ。