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.")
}