上传回调

使用场景

您可以通过回调，获取对象上传后的相关信息，例如获取对象是否上传成功，获取对象Etag、上传后大小、上传后对象所在桶等信息。OBS支持通过回调获取对象的系统参数和自定义参数，参数详情可参考API参考的回调章节。

图1 上传回调流程图

上传回调的详细流程如图1所示，主要分为以下几个阶段：

1. 客户端发出上传对象请求，请求中携带回调参数。
2. OBS接受到客户端的上传请求，执行上传对象操作。对象上传成功后，OBS封装回调请求。
3. OBS调用回调接口，向回调服务器发起回调请求。
4. 回调服务器得到上传对象完成的通知，完成数据更新，处理回调请求。
5. 回调服务器将回调响应数据返回给OBS。
6. OBS将上传对象请求的响应结果返回给客户端，响应结果中携带回调数据。

约束与限制

• 目前只在POST上传对象、PUT上传对象以及多段操作中的合并段API中支持回调功能。
• 在对象上传成功之后才会回调特定服务器，如果对象上传失败则不会回调。
• 如果上传的图片大小超过25M，则无法通过imageInfo相关魔法变量获取图片基本信息，会导致回调失败。

使用方式

OBS支持通过REST API和SDK方式使用上传回调。