OSS支持在上传、下载、拷贝文件时进行流量控制，以保证您其他应用的网络带宽。

当您上传数据至OSS或从OSS下载数据时，会占用较多带宽，在一些不容易做流控的客户端上会对其他应用造成影响。为避免这种问题，您可以在PutObject、AppendObject、PostObject、CopyObject、UploadPart、UploadPartCopy、GetObject请求中携带x-oss-traffic-limit参数，并设置限速值，OSS将按照设定的数值控制此次请求的带宽。

使用场景

单链接限速适用于以下场景：
  • 移动端、web端等不易实现客户端限速的场景，可以通过单链接限速的方式实现流量控制，保证其他应用的正常带宽。
  • 当您将您OSS内的数据分享给其他人的时候，可通过在文件URL中携带x-oss-traffic-limit参数，限制其下载速度，以保证您其他业务或其他用户访问时的带宽。例如，将杭州地域名为atest的存储空间（Bucket）根目录内文件（Object）file.zip通过文件URL分享给其他人下载，设置限速为5MB/s，则文件URL需携带x-oss-traffic-limit=41943040参数： 
    https://atest.oss-cn-hangzhou.aliyuncs.com/file.zip?Expires=156273****&OSSAccessKeyId=TMP.hW5bxvoEiX2BkVvrdBYrfdgc******12RLSb888DqdDZtBUbtHNBKgmn9ZtvTEBtBfATe4VJpnnmKd48UJomnp5JtoHRQXL2FuuS8JKR58RhnD5uRnas6h6ZVHg4tf.tmp&Signature=FIH8m%2FQRDhF%2Bc%2FHhucUogRUcr8U%3D&x-oss-traffic-limit=41943040

操作方式

操作方式 说明
Java SDK 丰富、完整的各类语言SDK demo
Python SDK
Go SDK
C++ SDK

注意事项

  • x-oss-traffic-limit可以设置到header中，也可以放在请求参数中，在表单上传接口中则放在表单域中。不管是在header中还是在请求参数中，都会计入待签名字符串中。
  • x-oss-traffic-limit参数的值必须为数字，单位默认为bit/s。
  • 限速值设置范围为819200~838860800，即100KB/s~100MB/s。
    说明 单位换算公式：1MByte=1024KByte=1048576Byte=8388608bit