この操作を呼び出して、バケットの転送アクセラレーションを設定できます。 バケットの転送アクセラレーションを有効にすると、世界中のユーザーがオブジェクトにすばやくアクセスできます。 転送アクセラレーション機能は、データを長い地理的距離で転送する必要があるシナリオに適用できます。 この機能は、ギガバイトまたはテラバイトのサイズのオブジェクトをダウンロードまたはアップロードするためにも使用できます。
使用上の注意
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 | バケットの転送アクセラレーションを有効にするかどうかを指定します。 有効な値:
重要 転送アクセラレーションは、有効になってから30分以内に有効になります。 |
PutBucketTransferAccelerationリクエストに含まれる一般的なリクエストヘッダー (AuthorizationやContent-Lengthなど) の詳細については、「一般的なリクエストヘッダー」をご参照ください。
レスポンスヘッダー
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: 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以外の値に設定されます。 |