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

Object Storage Service:PutBucketTransferAcceleration

最終更新日:Feb 19, 2025

この操作を呼び出して、バケットの転送アクセラレーションを構成できます。バケットの転送アクセラレーションを有効にすると、世界中のユーザーがオブジェクトにより迅速にアクセスできるようになります。転送アクセラレーション機能は、地理的に長い距離でデータを転送する必要があるシナリオに適用できます。この機能は、ギガバイトまたはテラバイト単位のオブジェクトをダウンロードまたはアップロードする場合にも使用できます。

使用方法

  • バケットの所有者、または oss:PutBucketTransferAcceleration 権限が付与された RAM ユーザーのみが、バケットの転送アクセラレーションを構成するリクエストを開始できます。

  • バケットの転送アクセラレーションを有効にすると、デフォルトのエンドポイントに加えて、アクセラレートエンドポイントを使用してバケットにアクセスできます。アクセス速度が向上するのは、アクセラレートエンドポイントを使用する場合のみです。

  • アクセラレートエンドポイントを使用してバケットにアクセスすると、転送アクセラレーション料金が発生します。詳細については、「転送アクセラレーション料金」をご参照ください。

転送アクセラレーションの詳細については、「転送アクセラレーション」をご参照ください。

リクエスト構造

PUT /?transferAcceleration HTTP/1.1
Date: GMT 日付
Content-Length: ContentLength
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: SignatureValue

リクエストパラメーター

パラメーター

タイプ

必須

説明

TransferAccelerationConfiguration

コンテナー

はい

該当なし

転送アクセラレーション構成を格納するために使用されるコンテナー。

Enabled

文字列

はい

true

バケットの転送アクセラレーションを有効にするかどうかを指定します。有効な値:

  • true: バケットの転送アクセラレーションを有効にするリクエストが送信されたことを示します。

  • false: バケットの転送アクセラレーションを無効にするリクエストが送信されたことを示します。

重要

転送アクセラレーションは、有効になってから 30 分以内に有効になります。

AuthorizationContent-Length など、PutBucketTransferAcceleration リクエストに含まれる共通のリクエストヘッダーの詳細については、「共通のリクエストヘッダー」をご参照ください。

レスポンスヘッダー

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

  • リクエストの例

    次のリクエスト例は、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: OSS qn6q**************:77Dv****************
    <TransferAccelerationConfiguration>
      <Enabled>true</Enabled>
    </TransferAccelerationConfiguration>
  • レスポンスの例

    HTTP/1.1 200 OK
    x-oss-request-id: 534B371674A4D890****
    Date: Fri, 30 Apr 2021 13:08:38 GMT
    Content-Length: 443
    Connection: keep-alive
    Server: AliyunOSS

OSS SDK

次のプログラミング言語の OSS SDK を使用して、PutBucketTransferAcceleration を呼び出すことができます。

ossutil

PutBucketTransferAcceleration 操作に対応する ossutil コマンドについては、「put-bucket-transfer-acceleration」をご参照ください。

エラーコード

エラーコード

HTTP ステータスコード

説明

AccessDenied

404

PutBucketTransferAcceleration 操作を実行する権限がないために返されるエラーメッセージ。oss:PutBucketTransferAcceleration 権限が付与されているユーザーのみが、バケットの転送アクセラレーションを構成できます。

MalformedXML

400

リクエストが有効な XML 形式ではないために返されるエラーメッセージ。たとえば、リクエストの Enabled フィールドが true または false 以外の値に設定されています。