文档中心

上传回调处理(Upload CallBack Processing)

描述

上传回调处理(Upload CallBack Processing,ucp)通过在调用Put Object,Complete Multipart Upload时,代替客户端执行Commit提交操作。 客户端可以将一些上传信息包含在请求头中传递给KS3,从而可以在上传成功后一并返回给用户服务器端。用户服务端正确处理回调后返回{"result":true},如果回调处理错误返回{"result":false},默认的超时时间设置为3秒,重试两次。 KS3会通过POST方法向用户的回调地址POST一段json数据。

请求

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

请求参数

该接口不使用请求参数。

请求头部

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

魔法变量

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

响应

响应内容

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

特殊错误