バケットの転送アクセラレーションを設定します。 転送の高速化により、世界中のユーザーによるOSSアクセスの速度が向上し、長距離のデータ転送や大きなオブジェクトのアップロードとダウンロードに適しています。
使用上の注意
oss:PutBucketTransferAcceleration権限が付与されているバケットまたはRAMユーザーの所有者のみが、バケットの転送アクセラレーションを設定するリクエストを開始できます。
バケットの転送アクセラレーションを有効にすると、デフォルトのエンドポイントに加えてアクセラレーションエンドポイントを使用してバケットにアクセスできます。 アクセス速度は、アクセラレーションエンドポイントを使用する場合にのみ高速化されます。
アクセラレーションエンドポイントを使用してバケットにアクセスすると、転送アクセラレーション料金が発生します。 詳細については、「転送アクセラレーション料金」をご参照ください。
転送アクセラレーションの詳細については、「転送アクセラレーション」をご参照ください。
コマンド構文
ossutil api put-bucket-transfer-acceleration --bucket value --transfer-acceleration-configuration value [flags]
パラメーター | データ型 | 説明 |
-- bucket | String | バケットの名前です。 |
-- transfer-acceleration-configuration | String | 転送アクセラレーション設定を格納するコンテナー。 |
put-bucket-transfer-accelerationコマンドは、PutBucketTransferAcceleration操作に相当します。 API操作の詳細については、「PutBucketTransferAcceleration」をご参照ください。
-- transfer-acceleration-configuration
-- transfer-acceleration-configurationオプションは、XMLおよびJSON形式をサポートします。
XML 形式:
<TransferAccelerationConfiguration> <Enabled>boolean</Enabled> </TransferAccelerationConfiguration>
JSON 形式:
{ "Enabled": boolean }
詳細については、「コマンドラインオプション」をご参照ください。
例
examplebucketという名前のバケットの転送アクセラレーションを設定します。
XML構成ファイルの使用 (この例ではtransfer-acceleration-configuration.xml)
<?xml version="1.0" encoding="UTF-8"?> <TransferAccelerationConfiguration> <Enabled>true</Enabled> </TransferAccelerationConfiguration>
ossutil api put-bucket-transfer-acceleration -- bucket examplebucket -- transfer-acceleration-configuration file:// transfer-acceleration-configuration.xml
JSON設定ファイルの使用 (この例のtransfer-acceleration-configuration.json)
{ "Enabled": "true" }
ossutil api put-bucket-transfer-acceleration -- bucket examplebucket -- transfer-acceleration-configuration file:// transfer-acceleration-configuration.json
コマンドラインでJSONパラメーターを使用する
ossutil api put-bucket-transfer-acceleration -- bucket examplebucket -- transfer-acceleration "{\" Enabled\":\" true\"}"