この操作を呼び出して、バケットの転送アクセラレーションを構成できます。バケットの転送アクセラレーションを有効にすると、世界中のユーザーがオブジェクトにより迅速にアクセスできるようになります。転送アクセラレーション機能は、地理的に長い距離でデータを転送する必要があるシナリオに適用できます。この機能は、ギガバイトまたはテラバイト単位のオブジェクトをダウンロードまたはアップロードする場合にも使用できます。
使用方法
バケットの所有者、または oss:PutBucketTransferAcceleration 権限が付与された RAM ユーザーのみが、バケットの転送アクセラレーションを構成するリクエストを開始できます。
バケットの転送アクセラレーションを有効にすると、デフォルトのエンドポイントに加えて、アクセラレートエンドポイントを使用してバケットにアクセスできます。アクセス速度が向上するのは、アクセラレートエンドポイントを使用する場合のみです。
アクセラレートエンドポイントを使用してバケットにアクセスすると、転送アクセラレーション料金が発生します。詳細については、「転送アクセラレーション料金」をご参照ください。
転送アクセラレーションの詳細については、「転送アクセラレーション」をご参照ください。
リクエスト構造
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: 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 を呼び出すことができます。
ossutil
PutBucketTransferAcceleration 操作に対応する ossutil コマンドについては、「put-bucket-transfer-acceleration」をご参照ください。
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
AccessDenied | 404 | PutBucketTransferAcceleration 操作を実行する権限がないために返されるエラーメッセージ。oss:PutBucketTransferAcceleration 権限が付与されているユーザーのみが、バケットの転送アクセラレーションを構成できます。 |
MalformedXML | 400 | リクエストが有効な XML 形式ではないために返されるエラーメッセージ。たとえば、リクエストの Enabled フィールドが true または false 以外の値に設定されています。 |