Object Storage Service: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 (
		// In this example, the China (Hangzhou) region is used.
		region = "cn-hangzhou"

		// In this example, access credentials are obtained from environment variables.
		provider credentials.CredentialsProvider = credentials.NewEnvironmentVariableCredentialsProvider()
	)

	// Specify the parameters of an OSS client.
	cfg := oss.LoadDefaultConfig().
		WithCredentialsProvider(provider).
		WithRegion(region)

	// Create an OSS client.
	client := oss.NewClient(cfg)
}

cn-hangzhouやcn-shanghaiなど、リクエストを送信するリージョンを指定できます。 サポートされているリージョンの詳細については、「OSSリージョンとエンドポイント」をご参照ください。

OSS SDK for Goにはデフォルトのリージョンはありません。 設定を読み込むときにリージョンを明示的に指定するには、config.WithRegionパラメーターを指定する必要があります。

例：

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

OSSClient インスタンスの設定

ほとんどの場合、デフォルト設定を使用するデフォルトのOSSClientはビジネス要件を満たすことができます。 OSSClientのデフォルト設定を変更したり、カスタムHTTPクライアントを使用して特定の環境のニーズを満たすこともできます。

共通設定

次のサンプルコードに示すように、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 (
		// In this example, the China (Hangzhou) region is used.
		region = "cn-hangzhou"

		// In this example, access credentials are obtained from environment variables.
		provider credentials.CredentialsProvider = credentials.NewEnvironmentVariableCredentialsProvider()
	)

	// Specify common timeout period or other parameters.
	transConfig := transport.Config{
		// Specify the timeout period for a connection. Default value: 5. Unit: seconds.
		ConnectTimeout: oss.Ptr(10 * time.Second),

		// Specify the timeout period for the application to read and write data. Default value: 10. Unit: seconds.
		ReadWriteTimeout: oss.Ptr(20 * time.Second),

		// Specify the timeout period for an idle connection. Default value: 50. Unit: seconds.
		IdleConnectionTimeout: oss.Ptr(40 * time.Second),

		// Specify the retention period of a network connection. Default value: 30. Unit: seconds.
		KeepAliveTimeout: oss.Ptr(40 * time.Second),

		// Specify whether to enable HTTP redirection. By default, HTTP redirection is disabled.
		EnabledRedirect: oss.Ptr(true),
	}

	// Specify http.Transport parameters.
	var transports []func(*http.Transport)

	// Specify the maximum number of connections. Default value: 100.
	transports = append(transports, transport.MaxConnections(200))

	// If a request contains the Expect: 100-Continue header, it indicates the maximum period of time to wait for the first response header returned from the server after request headers are completely written. Default value: 1. Unit: seconds.
	transports = append(transports, transport.ExpectContinueTimeout(2*time.Second))

	// Specify the earliest version of Transport Layer Security (TLS). Default value: TLS 1.2.
	transports = append(transports, transport.TLSMinVersion(tls.VersionTLS13))

	// Specify whether to skip the SSL certificate verification. By default, the SSL certificate is verified.
	transports = append(transports, transport.InsecureSkipVerify(true))
	
	// For more information about configuring the Transport parameter, see https://pkg.go.dev/net/http#Transport
        
        // Create a custom HTTP Client.
	customClient := transport.NewHttpClient(&transConfig, transports...)
        
	cfg := oss.LoadDefaultConfig().
		WithHttpClient(customClient).
		WithCredentialsProvider(provider).
		WithRegion(region)

	// Create an OSS client.
	client := oss.NewClient(cfg)
}

参照

詳細については、「開発者ガイド」をご参照ください。