本文介紹基於OSS服務端API上傳相關介面的使用。
概述
擷取視頻或圖片的上傳地址和憑證後，進行Base64解析得到OSS上傳的STS Token和地址，通過以下API進行檔案上傳。為方便使用，建議採用上傳SDK進行檔案上傳。
簡單上傳介面
支援的最大單個檔案為5 GB，不支援斷點續傳。
API | 描述 |
|---|---|
使用簡單方式上傳Object。 | |
使用表單方式上傳Object。 | |
使用追加寫方式上傳Object。 |
分區上傳介面
支援的最大單個檔案為48.8 TB，支援斷點續傳。
API | 描述 |
|---|---|
初始化MultipartUpload事件。 | |
分塊上傳檔案。 | |
完成整個檔案的MultipartUpload上傳。 | |
取消MultipartUpload事件。 | |
羅列出所有執行中的MultipartUpload事件。 | |
羅列出指定Upload ID所屬的所有已經上傳成功Part。 |
上傳校正介面
擷取Meta資訊裡的crc64值，可對檔案完整性進行校正。
API | 描述 |
|---|---|
擷取Object的Meta資訊。 | |
擷取Object的Meta資訊，同GetObjectMeta。 |
使用說明
使用介面前，確保已完成上傳地址和憑證的擷取和解析。介面參數和解析到的上傳資訊有如下對應關係：
參數
ObjectName對應解析到的FileName。參數
Host對應Bucket.Endpoint。重要需要將
Endpoint的http(s):放置到最前面。計算參數
Authorization時：使用的簽名密鑰為解析得到的AccessKeyId和AccessKeySecret，不要使用自己帳號的AccessKey資訊。
需將解析得到的SecurityToken攜帶在請求header中，或以請求參數的形式放入URL中。兩種形式只能選擇其一，如果都選，OSS會返回InvalidArgument錯誤。
在 header 中包含頭部
x-oss-security-token：SecurityToken。計算簽名CanonicalizedOSSHeaders時，將x-oss-security-token計算在內。在URL中攜帶參數
security-token=SecurityToken。計算簽名CanonicalizedResource時 ，將security-token當做一個sub-resource計算在內。
重要計算Authorization簽名的方式參考在Header中包含簽名和在URL中包含簽名。
使用OSS的API需自行計算簽名，過程較複雜，推薦使用OSS的上傳SDK。