UploadCallBackProcessing

最近更新时间:2019-05-17 17:09:02

上传回调处理(Upload CallBack Processing)

描述

在调用Put Object,Complete Multipart Upload接口时,可携带相关的Callback参数,实现上传回调处理(Upload CallBack Processing,ucp)。

客户端将文件及相关Callback请求头上传到KS3后,KS3会通过POST方法向用户的回调地址POST一段json数据,此json数据为客户端传入的x-kss-callbackbody请求头填充变量后转化得来。用户服务端正确处理回调后返回{"result":true},如果回调处理错误返回{"result":false},默认的超时时间设置为3秒,重试两次。只有在KS3服务端收到{"result":true}时,上传的文件才真正上传成功

请求

上传回调请求保持原有接口不变,参考Put ObjectComplete Multipart Upload

请求参数

该接口不使用请求参数。

请求头部

名称 描述 必需
x-kss-callbackurl 支持http
x-kss-callbackbody 回调参数支持自定义参数返回、常量和魔法变量,自定义变量通过Head传回,例如objectKey=${key}&etag=${etag}&location=${kss-location} &uid=123
回调参数的value值不能包含“=”和“&”
kss-location 自定义头以kss-开始 自定义

魔法变量

参数 说明 备注
bucket 文件上传的Bucket Utf-8编码
key 文件的名称 Utf-8编码
etag 文件Md5值经过base64处理
objectSize 文件大小 以字节标识
mimeType 文件类型
createTime 文件创建时间 Unix时间戳表示,1420629372,精确到秒

响应

响应内容

上传触发处理与原有Put Object,Complete_Multipart_Upload返回兼容。

特殊错误

金山云,开启您的云计算之旅

注册有礼