检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
快速入门(Harmony SDK) OBS SDK对OBS服务提供的REST API进行封装,以简化用户的开发工作。您直接调用OBS SDK提供的接口函数即可使用OBS管理数据。 本章节介绍了OBS Harmony SDK的快速入门,帮助您快速上手OBS的基础功能,包括创建桶、上传对象、下载对象、列举对象。
如果用户上传完所有的段,就可以调用合并段接口,系统将在服务端将用户指定的段合并成一个完整的对象。在执行“合并段”操作以前,用户不能下载已经上传的数据。在合并段时需要将多段上传任务初始化时记录的附加消息头信息拷贝到对象元数据中,其处理过程和普通上传对象带这些消息头的处理过程相同。在并发合并段的情况下,仍然遵循Last
Map<String, Object> 参数解释: 响应消息头列表,由多个元组构成。元组中String代表响应消息头的名称,Object代表响应消息头的值。 默认取值: 无 uploadId String 参数解释: OBS服务端创建的全局唯一标识(Upload ID),用于标识本次分段上传任务
Authorization: authorization string 请求消息参数 该请求消息中不使用消息参数。 请求消息头 该请求使用公共消息头,具体参见表3。 请求消息元素 此请求消息中不使用消息元素。 响应消息样式 1 2 3 4 5 6 7 8 9 10 11
对象数据的MD5值(经过Base64编码),提供给OBS服务端,校验数据完整性。OBS服务端会将该MD5值与对象数据计算出的MD5值进行对比,如果不匹配则上传失败,返回HTTP 400错误。 约束限制: 对象数据的MD5值必须经过Base64编码。 如果不设置对象的MD5值,OBS服务端会忽略对对象数据的MD5值校验。
</Tagging> 请求消息参数 该请求消息中不使用消息参数。 请求消息头 该请求使用的消息头如下表1所示。 表1 请求消息头 消息头名称 描述 是否必选 Content-MD5 参数解释: 按照RFC 1864标准计算出消息体的MD5摘要字符串,即消息体128-bit MD5值
string 参数解释: OBS服务端返回的错误描述。 HostId string 参数解释: OBS服务端返回的请求服务端ID。 RequestId string 参数解释: OBS服务端返回的请求ID。 Id2 string 参数解释: OBS服务端返回的请求ID2。 Indicator
0天前上传的对象,不能设置小于10的值。 如果请求携带了此头域,那么响应的消息中应该包含此消息头。 取值范围: 大于0的整数值。 默认取值: 无 响应消息元素 该请求的响应消息中不带消息元素。 错误响应消息 无特殊错误;所有错误已经包含在表2中。 请求示例:添加对象元数据 给对象
ARCHIVE(受限公测) 是 响应消息样式 1 2 HTTP/1.1 status_code Date: date 响应消息头 该请求的响应消息使用公共消息头,具体请参考表1。 响应消息元素 该请求的响应消息中不带消息元素。 错误响应消息 无特殊错误,错误已经包含在表2中。
默认取值: 无 请求消息元素 该请求消息中不使用消息元素。 响应消息样式 1 2 3 4 HTTP/1.1 status_code Date: date ETag: etag Content-Length: length 响应消息头 该请求的响应消息使用公共消息头,具体请参考表1。
application/xml Content-Length: length 请求消息参数 该请求消息中不使用消息参数。 请求消息头 该请求使用公共消息头,具体参见表3。 请求消息元素 该请求消息中不使用消息元素。 响应消息样式 HTTP/1.1 status_code Date: date Content-Type:
</CORSRule> </CORSConfiguration> 请求消息参数 该请求消息中不使用消息参数。 请求消息头 该请求使用公共消息头外加CORS请求消息头,具体参见表3和表1。 表1 CORS请求消息头 消息头名称 消息头类型 是否必选 描述 Content-MD5 String
是 响应消息样式 1 2 3 4 HTTP/1.1 status_code Date: date Content-Length: length 响应消息头 该请求的响应消息使用公共消息头,具体请参考表1。 响应消息元素 该请求的响应消息中不带消息元素。 错误响应消息 无特殊错误,所有错误已经包含在表2中。
Last-Modified: time <Object Content> 响应消息头 该请求的响应消息使用公共消息头,具体请参考表1。 除公共响应消息头之外,还可能使用如下表3中的消息头。 表3 附加响应消息头 消息头名称 消息头类型 描述 x-obs-expiration String 参数解释:
--9431149156168-- 请求消息参数 该请求消息中不使用参数。 请求消息头 该请求使用公共的消息头,具体请参见表3。 如果想要获取CORS配置信息,则需要使用的消息头如下表1所示。 表1 获取CORS配置的请求消息头 消息头名称 消息头类型 是否必选 描述 Origin String
ation> 请求消息参数 该请求消息中不使用消息参数。 请求消息头 该请求使用公共消息头,具体参见表3。 请求消息元素 在此请求中,需要在请求的消息体中配置桶的加密配置。桶加密的配置信息以XML格式上传。具体的配置元素如表1。 表1 桶的加密配置元素 消息头名称 描述 是否必选
Date: date 请求消息参数 该请求消息中不使用消息参数。 请求消息头 该消息可以带附加的消息头指定复制的信息,具体如表3所示。 表1 请求消息头 消息头名称 消息头类型 是否必选 描述 x-obs-acl String 否 参数解释: 复制对象时,可以加上此消息头设置对象的权限控制策略,使用的策略为预定义的常用策略。
4 工具优势 obsutil具有四大优势: 简单、易用; 无需安装,轻便小巧,即下即用; 同时支持Windows/Linux/macOS三大平台; 配置多元化,性能优良。 使用场景 自动化备份归档等场景,比如定时上传本地数据至OBS。 支持通过OBS Browser+等其他工具不能
默认取值: Standard 响应消息样式 1 2 HTTP/1.1 status_code Date: date 响应消息头 该请求的响应消息使用公共消息头,具体请参考表1。 响应消息元素 该请求的响应消息中不带有响应元素。 错误响应消息 表2 对象存储访问服务错误码列表 错误码 描述
描述 contentType String 可选 参数解释: 对象的文件类型(MIME类型)。contentType(MIME)用于标识发送或接收数据的类型,浏览器根据该参数来决定数据的打开方式。 取值范围: 常见的contentType(MIME)列表参见如何理解Content-Type(MIME)?(Java