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

Object Storage Service:PutBucketTransferAcceleration

最終更新日:Jul 09, 2025

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

使用方法

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

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

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

権限

デフォルトでは、Alibaba Cloud アカウントはすべての権限を持っています。Alibaba Cloud アカウントの RAM ユーザーまたは RAM ロールは、デフォルトでは権限を持っていません。Alibaba Cloud アカウントまたはアカウント管理者は、RAM ポリシーまたは バケットポリシーを通じて操作権限を付与する必要があります。

API

アクション

定義

PutBucketTransferAcceleration

oss:PutBucketTransferAcceleration

バケットの転送アクセラレーションを構成します。

リクエスト構造

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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
    <TransferAccelerationConfiguration>
      <Enabled>true</Enabled>
    </TransferAccelerationConfiguration>
  • レスポンスの例

    HTTP/1.1 200 OK
    x-oss-request-id: 534B371674A4D890****
    Date: Thu, 17 Apr 2025 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 以外の値に設定されています。