Object Storage Service：Go配置用戶端

前提條件

初始化OSSClient前，您需要配置訪問憑證。詳情請參見配置訪問憑證。

建立OSSClient

您可以使用以下範例程式碼，通過載入預設配置的方法建立一個OSSClient。

package main

import (
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
)

func main() {
	var (
		// 以華東1（杭州）為例
		region = "cn-hangzhou"

		// 以從環境變數中擷取訪問憑證為例
		provider credentials.CredentialsProvider = credentials.NewEnvironmentVariableCredentialsProvider()
	)

	// 建立OSS用戶端配置
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(provider).
		WithRegion(region)

	// 建立OSS用戶端
	client := oss.NewClient(cfg)
}

其中，指定地區region時，您可以指定向何處發送請求，例如cn-hangzhou或cn-shanghai。有關所支援的地區列表，請參閱OSS地區和訪問網域名稱。

因為Go SDK沒有設定預設區域，所以您需要在載入配置時使用config.WithRegion作為參數顯式設定地區。例如：

cfg := oss.LoadDefaultConfig().WithRegion("cn-hangzhou")

配置OSSClient

在大多數情況下，使用具有預設值的Client能夠滿足業務需求。您也可以更改Client的預設配置，或自訂HTTP Client，以滿足特定環境下的使用需求。

設定OSSClient常用配置

您可以通過config修改常用的配置，樣本如下：

cfg := oss.LoadDefaultConfig().
  WithConnectTimeout(10 * time.Second).
  UploadBandwidthlimit(10*1024)

常用配置參數匯總

自訂OSSClient

當常用配置參數無法滿足情境需求時，您可以使用WithHTTPClient替換預設的HTTP用戶端，樣本如下：

package main

import (
	"crypto/tls"
	"net/http"
	"time"

	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/credentials"
	"github.com/aliyun/alibabacloud-oss-go-sdk-v2/oss/transport"
)

func main() {
	var (
		// 以華東1（杭州）為例
		region = "cn-hangzhou"

		// 以從環境變數中擷取訪問憑證為例
		provider credentials.CredentialsProvider = credentials.NewEnvironmentVariableCredentialsProvider()
	)

	// 常用逾時或其它設定
	transConfig := transport.Config{
		// 連線逾時, 預設值 5秒
		ConnectTimeout: oss.Ptr(10 * time.Second),

		// 應用讀寫資料的逾時時間, 預設值 10秒
		ReadWriteTimeout: oss.Ptr(20 * time.Second),

		// 串連空閑逾時時間, 預設值 50 秒
		IdleConnectionTimeout: oss.Ptr(40 * time.Second),

		// 網路連接的保持期限, 預設值 30 秒
		KeepAliveTimeout: oss.Ptr(40 * time.Second),

		// 是否開啟啟HTTP重新導向，預設不啟用
		EnabledRedirect: oss.Ptr(true),
	}

	// http.Transport 設定
	var transports []func(*http.Transport)

	// 最大串連數，預設值 100
	transports = append(transports, transport.MaxConnections(200))

	// 如果請求有“Expect: 100-Continue”標題，則此設定表示完全寫入請求標題後等待伺服器第一個響應標題的最長時間，預設 1秒
	transports = append(transports, transport.ExpectContinueTimeout(2*time.Second))

	// TLS的最低版本，預設值 TLS 1.2
	transports = append(transports, transport.TLSMinVersion(tls.VersionTLS13))

	// 是否跳過認證檢查，預設不跳過
	transports = append(transports, transport.InsecureSkipVerify(true))
	
	// 更多Transport參數設定，請參考 https://pkg.go.dev/net/http#Transport
        
        // 建立自訂HTTP Client
	customClient := transport.NewHttpClient(&transConfig, transports...)
        
	cfg := oss.LoadDefaultConfig().
		WithHttpClient(customClient).
		WithCredentialsProvider(provider).
		WithRegion(region)

	// 建立OSS用戶端
	client := oss.NewClient(cfg)
}

相關文檔

關於配置用戶端的更多資訊，請參見開發人員指南。