本文介绍基于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。