阿里云对象存储OSS传输加速-云淘科技

使用OSS控制台

1. 登录OSS管理控制台。

2. 单击Bucket 列表，然后单击目标Bucket名称。

3. 在左侧导航栏，选择Bucket 配置>传输加速。

4. 在传输加速页面，打开开启传输加速开关，然后在弹出的对话框单击确定。

使用阿里云SDK

以下仅列举常见SDK开启传输加速的代码示例。关于其他SDK的开启传输加速的代码示例，请参见SDK简介。

Java

import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;

public class Demo {

    public static void main(String[] args) throws Exception {
        // Endpoint以华东1（杭州）为例，其它Region请按实际情况填写。
        String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
        // 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
        EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        // 填写Bucket名称，例如examplebucket。
        String bucketName = "examplebucket";

        // 创建OSSClient实例。
        OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);

        try {
            // 设置Bucket的传输加速状态。
            // 当设置enabled为true时，表示开启传输加速；当设置enabled为false时，表示关闭传输加速。
            boolean enabled = true;
            ossClient.setBucketTransferAcceleration(bucketName, enabled);

        } catch (OSSException oe) {
            System.out.println("Caught an OSSException, which means your request made it to OSS, "
                    + "but was rejected with an error response for some reason.");
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Caught an ClientException, which means the client encountered "
                    + "a serious internal problem while trying to communicate with OSS, "
                    + "such as not being able to access the network.");
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) {
                ossClient.shutdown();
            }
        }
    }
}

Python

import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider

# 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
# 填写Bucket名称。
bucket = oss2.Bucket(auth, 'https://oss-cn-hangzhou.aliyuncs.com', 'examplebucket')

# 设置Bucket的传输加速状态。
# 当设置enabled为true时，表示开启传输加速；当设置enabled为false时，表示关闭传输加速。
enabled = 'true'
bucket.put_bucket_transfer_acceleration(enabled)

Go

package main

import (
	"fmt"
	"os"

	"github.com/aliyun/aliyun-oss-go-sdk/oss"
)

func HandleError(err error) {
	fmt.Println("Error:", err)
	os.Exit(-1)
}

func main() {
	// 从环境变量中获取访问凭证。运行本代码示例之前，请确保已设置环境变量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
	provider, err := oss.NewEnvironmentVariableCredentialsProvider()
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	// 创建OSSClient实例。
	// yourEndpoint填写Bucket对应的Endpoint，以华东1（杭州）为例，填写为https://oss-cn-hangzhou.aliyuncs.com。其它Region请按实际情况填写。
	client, err := oss.New("yourEndpoint", "", "", oss.SetCredentialsProvider(&provider))
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}

	// 填写Bucket名称。
	bucketName := "examplebucket"

	// 开启Bucket的传输加速状态。
	// Enabled表示传输加速的开关，取值为true表示开启传输加速，取值为false表示关闭传输加速。
	accConfig := oss.TransferAccConfiguration{}
	accConfig.Enabled = true

	err = client.SetBucketTransferAcc(bucketName, accConfig)
	if err != nil {
		HandleError(err)
	}
	fmt.Printf("set bucket transfer accelerate success
")
}

使用REST API

如果您的程序自定义要求较高，您可以直接发起REST API请求。直接发起REST API请求需要手动编写代码计算签名。更多信息，请参见PutBucketTransferAcceleration。

使用浏览器

通过浏览器访问OSS时，将文件URL的Endpoint字段替换为传输加速Endpoint，例如https://test.oss-cn-shenzhen.aliyuncs.com/myphoto.jpg需改为https://test.oss-accelerate.aliyuncs.com/myphoto.jpg。如果文件访问权限为私有，则还需要加上签名信息。

使用命令行工具ossutil

• 替换配置文件的Endpoint为传输加速Endpoint

  通过ossutil访问时，您可以将配置文件内的Endpoint替换为传输加速Endpoint。具体操作，请参见ossutil。

• 在命令示例中增加-e oss-accelerate.aliyuncs.com

  在使用ossutil相关命令时，在命令示例中增加-e oss-accelerate.aliyuncs.com。下图表示在cp命令上传场景中使用了传输加速Endpoint。

  

使用图形化管理工具ossbrowser

重要

通过ossbrowser访问OSS时，除了要填写AccessKey（AK）信息以外，还必须指定预设OSS路径。

各配置项说明如下：

配置示例如下：

使用阿里云SDK

通过各语言SDK访问OSS时，将Endpoint设置为传输加速Endpoint。此处以Java SDK的简单上传和简单下载为例介绍。

• 简单上传

  import com.aliyun.oss.ClientException;
  import com.aliyun.oss.OSS;
  import com.aliyun.oss.common.auth.*;
  import com.aliyun.oss.OSSClientBuilder;
  import com.aliyun.oss.OSSException;
  import com.aliyun.oss.model.PutObjectRequest;
  import java.io.File;
  
  public class Demo {
  
      public static void main(String[] args) throws Exception {
          // 填写传输加速Endpoint。以全球加速Endpoint为例。
          String endpoint = "https://oss-accelerate.aliyuncs.com";
          // 强烈建议不要把访问凭证保存到工程代码里，否则可能导致访问凭证泄露，威胁您账号下所有资源的安全。本代码示例以从环境变量中获取访问凭证为例。运行本代码示例之前，请先配置环境变量。
          EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
          // 填写Bucket名称，例如examplebucket。
          String bucketName = "examplebucket";
          // 填写Object完整路径，例如exampledir/exampleobject.txt。Object完整路径中不能包含Bucket名称。
          String objectName = "exampledir/exampleobject.txt";
          // 填写本地文件的完整路径，例如D:\localpath\examplefile.txt。
          // 如果未指定本地路径，则默认从示例程序所属项目对应本地路径中上传文件。
          String filePath= "D:\localpath\examplefile.txt";
  
          // 创建OSSClient实例。
          OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);
  
          try {
              // 创建PutObjectRequest对象。            
              PutObjectRequest putObjectRequest = new PutObjectRequest(bucketName, objectName, filePath);
              // 如果需要上传时设置存储类型和访问权限，请参考以下示例代码。
              // ObjectMetadata metadata = new ObjectMetadata();
              // metadata.setHeader(OSSHeaders.OSS_STORAGE_CLASS, StorageClass.Standard.toString());
              // metadata.setObjectAcl(CannedAccessControlList.Private);
              // putObjectRequest.setMetadata(metadata);
  
              // 上传文件。
              ossClient.putObject(putObjectRequest);
          } catch (OSSException oe) {
              System.out.println("Caught an OSSException, which means your request made it to OSS, "
                      + "but was rejected with an error response for some reason.");
              System.out.println("Error Message:" + oe.getErrorMessage());
              System.out.println("Error Code:" + oe.getErrorCode());
              System.out.println("Request ID:" + oe.getRequestId());
              System.out.println("Host ID:" + oe.getHostId());
          } catch (ClientException ce) {
              System.out.println("Caught an ClientException, which means the client encountered "
                      + "a serious internal problem while trying to communicate with OSS, "
                      + "such as not being able to access the network.");
              System.out.println("Error Message:" + ce.getMessage());
          } finally {
              if (ossClient != null) {
                  ossClient.shutdown();
              }
          }
      }
  }            

• 简单下载

  import com.aliyun.oss.ClientException;
  import com.aliyun.oss.OSS;
  import com.aliyun.oss.common.auth.*;
  import com.aliyun.oss.OSSClientBuilder;
  import com.aliyun.oss.OSSException;
  import com.aliyun.oss.model.GetObjectRequest;
  import java.io.File;
  
  public class Demo {
  
      public static void main(String[] args) throws Exception {
          // 填写传输加速Endpoint。以全球加速Endpoint为例。
          String endpoint = "https://oss-accelerate.aliyuncs.com";
          // 强烈建议不要把访问凭证保存到工程代码里，否则可能导致访问凭证泄露，威胁您账号下所有资源的安全。本代码示例以从环境变量中获取访问凭证为例。运行本代码示例之前，请先配置环境变量。
          EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
          // 填写Bucket名称，例如examplebucket。
          String bucketName = "examplebucket";
          // 填写不包含Bucket名称在内的Object完整路径，例如testfolder/exampleobject.txt。
          String objectName = "testfolder/exampleobject.txt";
          String filePath = "D:\localpath\examplefile.txt";
  
          // 创建OSSClient实例。
          OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);
  
          try {
              // 下载Object到本地文件，并保存到指定的本地路径中。如果指定的本地文件存在会覆盖，不存在则新建。
              // 如果未指定本地路径，则下载后的文件默认保存到示例程序所属项目对应本地路径中。
              ossClient.getObject(new GetObjectRequest(bucketName, objectName), new File(filePath));
          } catch (OSSException oe) {
              System.out.println("Caught an OSSException, which means your request made it to OSS, "
                      + "but was rejected with an error response for some reason.");
              System.out.println("Error Message:" + oe.getErrorMessage());
              System.out.println("Error Code:" + oe.getErrorCode());
              System.out.println("Request ID:" + oe.getRequestId());
              System.out.println("Host ID:" + oe.getHostId());
          } catch (ClientException ce) {
              System.out.println("Caught an ClientException, which means the client encountered "
                      + "a serious internal problem while trying to communicate with OSS, "
                      + "such as not being able to access the network.");
              System.out.println("Error Message:" + ce.getMessage());
          } finally {
              if (ossClient != null) {
                  ossClient.shutdown();
              }
          }
      }
  }

使用命令行工具ossutil

通过在ossutil命令示例中测试未开启传输加速前（即使用-e oss-us-west-1.aliyuncs.com）以及开启传输加速后（即使用-e oss-accelerate.aliyuncs.com）上传文件所需时间的差异。

使用在线工具

您可以通过OSS互联网连通与测速工具测试您本地访问全球各地数据中心时，开启传输加速与未开启传输加速的访问速度。