put-bucket-transfer-acceleration

put-bucket-transfer-acceleration命令用于为存储空间（Bucket）配置传输加速。开启传输加速后，可提升全球各地用户对OSS的访问速度，适用于远距离数据传输、GB或TB级大文件上传和下载的场景。

注意事项

只有Bucket拥有者以及被授予oss:PutBucketTransferAcceleration权限的RAM用户才能发起配置传输加速的请求。
开启传输加速后，Bucket会在保留默认Endpoint的基础上新增传输加速域名，但必须使用OSS的传输加速域名才会提升访问速度。
使用传输加速域名访问Bucket时，OSS会收取传输加速费用。详情请参见传输加速费用。

关于传输加速的更多信息，请参见传输加速。

命令格式

ossutil api put-bucket-transfer-acceleration --bucket value --transfer-acceleration-configuration value [flags]

参数	类型	说明
--bucket	string	Bucket名称。
--transfer-acceleration-configuration	string	传输加速配置的容器。

说明

put-bucket-transfer-acceleration命令对应API接口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-configuration "{\"Enabled\":\"true\"}"

注意事项

命令格式

--transfer-acceleration-configuration

使用示例

put-bucket-transfer-acceleration 2025-04-21 17:29

get-bucket-transfer-acceleration 2025-04-21 17:29

目录