对象存储服务 OBS-追加上传(Java SDK):接口约束
时间：2025-05-08 15:06:13
下载对象存储服务 OBS用户手册完整版
复制链接到剪贴板
分享文章到微博
分享文章到朋友圈
接口约束
- 您必须是桶拥有者或拥有上传对象的权限，才能上传对象。建议使用 IAM 或桶策略进行授权，如果使用IAM则需授予obs:object:PutObject权限，如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述，配置方式详见使用IAM自定义策略、配置对象策略。
- OBS支持的region以及region与endPoint的对应关系，详细信息请参见地区与终端节点。
- 每次追加上传的长度不能超过单次上传长度上限5G的限制。
- 每个Appendable对象追加写次数最多为10000次，如果对象追加写次数超过10000次，OBS返回409 Conflict，错误码为ObjectNotAppendable。
- 如果对象存储类别为COLD（归档存储）或深度归档存储，则不能调用该接口。
- 如果桶设置了跨区域复制配置，则不能调用该接口。
- 并行文件系统不支持追加写对象。
- ObsClient.putObject上传的对象可覆盖ObsClient.appendObject上传的对象，覆盖后对象变为普通对象，不可再进行追加上传。
- 对已有对象进行追加上传，要求对象必须为可追加上传的对象，否则将抛出异常（HTTP状态码为409）。判断对象是否可追加上传可通过获取对象元数据查询。
support.huaweicloud.com/sdk-java-devg-obs/obs_21_0609.html
