全部产品
云市场

OSS文件上传

更新时间:2019-01-17 15:01:35

概述

获取视频或图片的 上传地址和凭证 后,进行 Base64解析 得到OSS上传的STS Token和地址,通过以下API进行文件上传。

为方便使用,建议采用 上传SDK 进行文件上传。

简单上传接口

注意:支持的最大单个文件为5GB,不支持断点续传。

API 描述
PutObject 使用简单方式上传Object。
PostObject 使用表单方式上传Object。
AppendObject 使用追加写方式上传Object。

分片上传接口

注意:支持的最大单个文件为48.8TB,支持断点续传。

API 描述
InitiateMultipartUpload 初始化MultipartUpload事件。
UploadPart 分块上传文件。
CompleteMultipartUpload 完成整个文件的MultipartUpload上传。
AbortMultipartUpload 取消MultipartUpload事件。
ListMultipartUploads 罗列出所有执行中的MultipartUpload事件。
ListParts 罗列出指定Upload ID所属的所有已经上传成功Part。

上传校验接口

注意:获取Meta信息里的 crc64 值,可对文件完整性进行校验。

API 描述
GetObjectMeta 获取Object的Meta信息。
HeadObject 获取Object的Meta信息,同GetObjectMeta。

使用说明

使用接口前,确保已完成 上传地址和凭证 的获取和解析。接口参数和解析到的上传信息有如下对应关系:

  • 参数 ObjectName 对应解析到的 FileName

  • 参数 Host 对应 Bucket.Endpoint

    注意:需要将 Endpointhttp(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