全部產品
Search
文件中心

Object Storage Service:使用Go SDK進行上傳回調的程式碼範例

更新時間:Oct 26, 2024

OSS在完成簡單上傳(PutObject和PutObjectFromFile)以及分區上傳(UploadFile)時可以提供回調(Callback)給應用伺服器。您只需要在發送給OSS的請求中攜帶相應的Callback參數,即可實現回調。

注意事項

  • 本文以華東1(杭州)外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS,請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係,請參見OSS訪問網域名稱、資料中心、開放連接埠

  • 本文以從環境變數讀取存取憑證為例。如何配置訪問憑證,請參見配置訪問憑證

  • 本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient,請參見初始化

範例程式碼

在上傳字串時使用上傳回調(callback),目標儲存空間為examplebucket,上傳的目標檔案為examplefiles檔案夾下的exampleobject.txt檔案,具體代碼如下。

package main

import (
	"encoding/base64"
	"encoding/json"
	"fmt"
	"os"
	"strings"

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

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請按實際情況填寫。
	// yourRegion填寫Bucket所在地區,以華東1(杭州)為例,填寫為cn-hangzhou。其它Region請按實際情況填寫。
	clientOptions := []oss.ClientOption{oss.SetCredentialsProvider(&provider)}
	clientOptions = append(clientOptions, oss.Region("yourRegion"))
	// 設定簽名版本
	clientOptions = append(clientOptions, oss.AuthVersion(oss.AuthV4))
	client, err := oss.New("yourEndpoint", "", "", clientOptions...)
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}

	// 填寫儲存空間名稱,例如examplebucket。
	bucket, err := client.Bucket("examplebucket")
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}

	// 定義回調參數。
	callbackUrl := "http://your.callback.server.address" // 設定回調伺服器的URL。
	callbackMap := map[string]string{
		"callbackUrl":      callbackUrl,                         // 設定回調伺服器的URL。
		"callbackBody":     "bucket=${bucket}&object=${object}", // 設定回調請求體。
		"callbackBodyType": "application/x-www-form-urlencoded", // 設定回調請求體類型。
	}

	// 將回調參數轉換為JSON並進行Base64編碼。
	callbackStr, err := json.Marshal(callbackMap)
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}
	callbackBase64 := base64.StdEncoding.EncodeToString(callbackStr)

	// 設定上傳回調參數。
	options := []oss.Option{
		oss.Callback(callbackBase64),
	}

	// 構建一個由1024*1024個 'a' 字元組成的字串。
	content := strings.Repeat("a", 1024*1024)

	// 上傳字串。確保objectPath不包含Bucket名稱。
	objectPath := "examplefiles/exampleobject.txt"
	err = bucket.PutObject(objectPath, strings.NewReader(content), options...)
	if err != nil {
		fmt.Println("Error:", err)
		os.Exit(-1)
	}

	// 輸出上傳成功訊息。
	fmt.Println("Object uploaded with callback successfully.")
}

相關文檔

  • 關於上傳回調的完整範例程式碼,請參見Github

  • 關於上傳回調的API介面說明,請參見Callback