この操作を呼び出して、バケットの転送アクセラレーションを設定できます。 バケットの転送アクセラレーションを有効にすると、世界中のユーザーはより迅速にオブジェクトにアクセスできます。 転送アクセラレーション機能は、データを長い地理的距離で転送する必要があるシナリオに適用できます。 この機能は、ギガバイトまたはテラバイトのサイズのオブジェクトをダウンロードまたはアップロードするためにも使用できます。
使用上の注意
- oss:PutBucketTransferAcceleration権限が付与されているバケットまたはRAMユーザーの所有者のみが、バケットの転送アクセラレーションを設定するリクエストを開始できます。
- バケットの転送アクセラレーションを有効にすると、デフォルトのエンドポイントに加えてアクセラレーションエンドポイントを使用してバケットにアクセスできます。 アクセス速度は、アクセラレーションエンドポイントを使用する場合にのみ高速化されます。
- アクセラレーションエンドポイントを使用してバケットにアクセスすると、転送アクセラレーション料金が発生します。 詳細については、「転送アクセラレーション料金」をご参照ください。
転送アクセラレーションの詳細については、「開発者ガイド」の「転送アクセラレーション」をご参照ください。
リクエスト構造
PUT /?transferAcceleration HTTP/1.1
日付: GMT日付
Content-Length: ContentLength
Content-Type: application/xml
ホスト: BucketName.oss.aliyuncs.com
権限付与: SignatureValue
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
---|---|---|---|---|
TransferAccelerationConfiguration | コンテナー | 必須 | N/A | 転送アクセラレーション設定の格納に使用されるコンテナー。 |
有効 | String | 必須 | true | バケットの転送アクセラレーションを有効にするかどうかを指定します。 設定可能な値は以下のとおりです。
重要 転送アクセラレーションは、有効になってから30分以内に有効になります。
|
For more information about the common request headers contained in a PutBucketTransferAcceleration request, such as Authorization and Content-Length, see 共通リクエストヘッダー.
レスポンスヘッダー
PutBucketTransferAccelerationリクエストへのレスポンスに含まれるすべてのディーダは、x-oss-request-idやDateなどの共通のレスポンスヘッダーです。 共通レスポンスヘッダーの詳細については、「共通レスポンスヘッダー」をご参照ください。
例
- リクエストの例
次のサンプルリクエストは、examplebucketという名前のバケットの転送アクセラレーションを有効にするために使用されます。
PUT /?transferAcceleration HTTP/1.1 日付: 4月30日金曜日2021 13:08:38 GMT コンテンツ-長さ: 443 Content-Type: application/xml ホスト: examplebucket.oss.aliyuncs.com 承認: OSS qn6qrrqxo2oawuk53otf ****:PYbzsdWAIWAlMW8luk **** <TransferAccelerationConfiguration> <有効> true</有効> </TransferAccelerationConfiguration>
- レスポンスの例
HTTP/1.1 200 OK x-oss-request-id: 534B371674A4D890 **** 日付: 4月30日金曜日2021 13:08:38 GMT コンテンツ-長さ: 443 接続: キープアライブ サーバー: AliyunOSS
エラーコード
エラーコード | HTTP ステータスコード | 説明 |
---|---|---|
AccessDenied | 404 | PutBucketTransferAcceleration操作を実行する権限がない場合に返されるエラーメッセージ。 oss:PutBucketTransferAcceleration権限が付与されたユーザーのみが、バケットの転送アクセラレーションを設定できます。 |
MalformedXML | 400 | リクエストが有効なXML形式でない場合に返されるエラーメッセージ。 たとえば、リクエストのEnabledフィールドはtrueまたはfalse以外の値に設定されます。 |