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