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

Object Storage Service:PutBucketTransferAcceleration

最終更新日:Jan 22, 2025

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

使用上の注意

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

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

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

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

リクエストの構造

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

リクエストパラメーター

パラメーター

必須 / 任意

説明

TransferAccelerationConfiguration

コンテナー

対象

非該当

転送アクセラレーション設定の格納に使用されるコンテナー。

有効

String

対象

true

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

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

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

重要

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

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

レスポンスヘッダー

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を呼び出すことができます。

エラーコード

エラーコード

HTTPステータスコード

説明

AccessDenied

404

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

MalformedXML

400

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