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

使用上の注意

  • oss:PutBucketTransferAcceleration権限が付与されているバケットまたはRAMユーザーの所有者のみが、バケットの転送アクセラレーションを設定するリクエストを開始できます。
  • バケットの転送アクセラレーションを有効にすると、デフォルトのエンドポイントに加えてアクセラレーションエンドポイントを使用してバケットにアクセスできます。 アクセス速度は、アクセラレーションエンドポイントを使用する場合にのみ高速化されます。
  • アクセラレーションエンドポイントを使用してバケットにアクセスすると、転送アクセラレーション料金が発生します。 詳細については、「転送アクセラレーション料金」をご参照ください。

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

リクエスト構造

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

リクエストパラメーター

パラメーター データ型 必須/任意 説明
TransferAccelerationConfiguration コンテナー 必須 N/A 転送アクセラレーション設定の格納に使用されるコンテナー。
有効 String 必須 true バケットの転送アクセラレーションを有効にするかどうかを指定します。 設定可能な値は以下のとおりです。
  • true: バケットの転送アクセラレーションを有効にするためにリクエストが送信されることを示します。
  • false: バケットの転送アクセラレーションを無効にするリクエストが送信されたことを示します。
重要 転送アクセラレーションは、有効になってから30分以内に有効になります。

For more information about the common request headers contained in a PutBucketTransferAcceleration request, such as Authorization and Content-Length, see 共通リクエストヘッダー.

レスポンスヘッダー

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

  • リクエストの例

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

    PUT /?transferAcceleration HTTP/1.1
    日付: 4月30日金曜日2021 13:08:38 GMT
    コンテンツ-長さ: 443
    Content-Type: application/xml
    ホスト: examplebucket.oss.aliyuncs.com
    承認: OSS qn6qrrqxo2oawuk53otf ****:PYbzsdWAIWAlMW8luk ****
    <TransferAccelerationConfiguration>
      <有効> true</有効>
    </TransferAccelerationConfiguration>
  • レスポンスの例
    HTTP/1.1 200 OK
    x-oss-request-id: 534B371674A4D890 ****
    日付: 4月30日金曜日2021 13:08:38 GMT
    コンテンツ-長さ: 443
    接続: キープアライブ
    サーバー: AliyunOSS

エラーコード

エラーコード HTTP ステータスコード 説明
AccessDenied 404 PutBucketTransferAcceleration操作を実行する権限がない場合に返されるエラーメッセージ。 oss:PutBucketTransferAcceleration権限が付与されたユーザーのみが、バケットの転送アクセラレーションを設定できます。
MalformedXML 400 リクエストが有効なXML形式でない場合に返されるエラーメッセージ。 たとえば、リクエストのEnabledフィールドはtrueまたはfalse以外の値に設定されます。