この操作を呼び出して、バケットの転送アクセラレーションを構成できます。バケットの転送アクセラレーションを有効にすると、世界中のユーザーがオブジェクトにより迅速にアクセスできるようになります。転送アクセラレーション機能は、地理的に長い距離でデータを転送する必要があるシナリオに適用できます。この機能は、ギガバイトまたはテラバイト単位のオブジェクトをダウンロードまたはアップロードする場合にも使用できます。
使用方法
バケットの転送アクセラレーションを有効にすると、デフォルトのエンドポイントに加えて、アクセラレートエンドポイントを使用してバケットにアクセスできます。アクセス速度が向上するのは、アクセラレートエンドポイントを使用する場合のみです。
アクセラレートエンドポイントを使用してバケットにアクセスすると、転送アクセラレーション料金が発生します。詳細については、「転送アクセラレーション料金」をご参照ください。
転送アクセラレーションの詳細については、「転送アクセラレーション」をご参照ください。
権限
デフォルトでは、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 | バケットの転送アクセラレーションを有効にするかどうかを指定します。有効な値:
重要 転送アクセラレーションは、有効になってから 30 分以内に有効になります。 |
Authorization や Content-Length など、PutBucketTransferAcceleration リクエストに含まれる共通のリクエストヘッダーの詳細については、「共通のリクエストヘッダー」をご参照ください。
レスポンスヘッダー
PutBucketTransferAcceleration リクエストへのレスポンスに含まれるすべてのヘッダーは、x-oss-request-id や Date などの共通のレスポンスヘッダーです。共通のレスポンスヘッダーの詳細については、「共通のレスポンスヘッダー」をご参照ください。
例
リクエストの例
次のリクエスト例は、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 以外の値に設定されています。 |