この操作では、バケットの転送アクセラレーション設定を照会します。

使用上の注意

  • oss:PutBucketTransferAcceleration権限が付与されたバケットまたはRAMユーザーの所有者のみが、バケットの転送アクセラレーション設定を照会するリクエストを開始できます。
  • If transfer acceleration is not configured for the bucket to which you send the GetBucketTransferAcceleration request, no configurations are returned.

For more information about transfer acceleration, see 転送アクセラレーション in the Developer Guide.

リクエスト構造

GET /?transferAcceleration HTTP/1.1
日付: GMT日付
Content-Length: ContentLength
Content-Type: application/xml
ホスト: BucketName.oss.aliyuncs.com
権限付与: SignatureValue

レスポンスパラメーター

パラメーター データ型 説明
TransferAccelerationConfiguration コンテナー N/A 転送アクセラレーション設定の格納に使用されるコンテナー。
有効 String true 転送アクセラレーションのステータス有効な値:
  • true: バケットの転送アクセラレーションが有効になっていることを示します。
  • false: バケットの転送アクセラレーションが無効になっていることを示します。

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

  • リクエストの例

    次のサンプルリクエストは、examplebucketという名前のバケットの転送アクセラレーションのステータスを照会するために使用されます。

    GET /?transferAcceleration HTTP/1.1
    日付: 4月30日金曜日2021 13:08:38 GMT
    コンテンツ-長さ: 443
    Content-Type: application/xml
    ホスト: examplebucket.oss.aliyuncs.com
    承認: OSS qn6qrrqxo2oawuk53otf ****:PYbzsdWAIWAlMW8luk ****
  • レスポンスの例

    次のレスポンスは、examplebucketで転送アクセラレーションが有効になっていることを示します。

    HTTP/1.1 200 OK
    x-oss-request-id: 534B371674E88A4D8906 ****
    日付: 4月30日金曜日2021 13:08:38 GMT
    <TransferAccelerationConfiguration>
     <有効> true</有効>
    </TransferAccelerationConfiguration>

エラーコード

エラーコード HTTP ステータスコード 説明
NoSuchTransferAccelerationConfiguration 404 The error message returned because transfer acceleration is not configured for the bucket.