检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
多段相关接口说明(Node.js SDK) 对于较大文件上传,可以切分成段上传。用户可以在如下的应用场景内(但不仅限于此),使用分段上传的模式: 上传超过100MB大小的文件。 网络条件较差,和OBS服务端之间的链接经常断开。 上传前无法确定将要上传文件的大小。 分段上传分为如下3个步骤:
文件下载 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。 以下代码展示了如何进行文件下载: // 创建ObsClient实例 var obsClient = new ObsClient({
3.3-表 公共响应消息头。 响应消息元素 该请求的响应消息中不带有响应元素。 错误响应消息 除了公共的错误码外,此接口还会返回一些其他的错误码。下表中列出本接口的一些常见错误,以及可能原因。如下表4 配置对象标签错误码列表。 表4 配置对象标签错误码列表 错误码 描述 HTTP状态码
SDK提供了丰富的对象下载接口,可以通过以下方式下载对象: 流式下载 范围下载 限定条件下载 断点续传下载 下载对象-流式下载(Go SDK) 下载对象-范围下载(Go SDK) 下载对象-限定条件下载(Go SDK) 下载对象-断点续传下载(Go SDK) 父主题: 对象相关接口(Go SDK)
必须是合法的JSONPath格式。 说明: END State没有payload_filter_in属性。 payload_filter_out 否 string 过滤state的输出结果,默认值是"$",表示不过滤。 必须是合法的JSONPath格式。 说明: END Stat
下载对象 功能介绍 GET操作从对象存储下载对象。使用GET接口前,请确认必须拥有对象的READ权限。如果对象Owner向匿名用户授予READ访问权限,则可以在不使用鉴权头域的情况下访问该对象。 服务端加密 如果客户端的对象上传时,使用了客户提供的加密密钥进行服务端加密,当下载对象时,同样也必须在消息中提供密钥。
获取桶策略 功能介绍 该接口的实现使用policy子资源来将指定桶的策略返回给客户端。 要使用该接口,使用者要求必须是桶的所有者,或者是桶所有者的子用户且具有获取桶策略的权限。 以下两种场景无法使用此接口获取桶策略,系统将返回“404 NoSuchBucketPolicy”的错误:
文件上传 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。 文件上传使用本地文件作为对象的数据源。 本示例用于上传本地“localfile”文件到桶名为“bucketname”里,名称为“objectname”的对象。
带签名。 是否支持设置Expires 否 是 是否支持设置Date 是 否 常用API 所有API接口 GET、PUT 时间格式 通过Date头域表示请求生成时间,Date必须为RFC 1123格式的GMT时间。 如果Date与当前服务器的时间相差超过15分钟时,则服务端返回403,认为请求已失效。
x-forward-status: 0x40020000000001 x-dae-api-type: REST.POST.OBJECT 相关参考 针对此接口,与之对应的各类语言SDK文档如下,包含SDK接口说明和示例代码: Java Python C不支持 Go不支持 BrowserJS
该请求的响应消息中不带有响应元素。 错误响应消息 除了公共的错误码外,此接口还会返回一些其他的错误码。下面列出本接口的一些常见错误,以及可能原因,如表3。 表3 设置桶清单错误码列表 错误码 描述 HTTP状态码 MalformedXML 清单的XML配置格式错误。 400 Bad Request InvalidArgument
格式转换与渐进显示 格式转换 此功能在控制台图形界面模式和代码编辑模式使用,也支持通过接口调用模式使用。可以将原图转换为支持的图片格式,具体说明如表1所示。 支持的原图格式:jpg、jpeg、png、bmp、webp、gif、tiff。 支持输出的目标图格式:jpg、png、bmp、webp。
服务器发生错误,用户将无法判断发出的请求是否成功。 注:请使用符合https://www.ietf.org/rfc/rfc2616.txt规定的HTTP/HTTPS请求格式发送API请求。 父主题: 附录
说明: 为了节省内存开销,SDK 采用了流式计算的方法,这也就意味着,普通上传时需要读取并加密文件两次;在另外由于断点续传上传接口为分段上传接口的封装,在断点续传下,则需要读取并加密文件三次。 取值范围: true:设置need_sha256为true时,SDK会自动计算待上
参数解释: 指定对象被下载时的内容编码格式。 约束限制: 无 取值范围: 参见HTTP标准头域Content-Encoding的取值。 默认取值: 无 Content-Language String 否 参数解释: 指定对象被下载时的内容语言格式。 约束限制: 无 取值范围: 参见
该请求的响应消息使用公共消息头,具体请参考表1。 响应消息元素 该请求的响应消息中不带有响应元素。 错误响应消息 除了公共的错误码外,此接口还会返回一些其他的错误码。下表中列出本接口的一些常见错误,以及可能原因。如表3。 表3 配置桶标签错误码列表 错误码 描述 HTTP状态码 InvalidTagError
的段数据,且同时释放容量配额。 合并完成的多段上传数据可以通过已有的下载对象接口,下载整个多段上传对象或者指定Range下载整个多段上传对象的某部分数据。 合并完成的多段上传数据可以通过已有的删除对象接口,删除整个多段上传对象的所有分段数据,删除后不可恢复。 合并完成的多段上传数
source-if-match一起使用,但不能与其它条件复制参数一起使用。 类型:String 格式:符合http://www.ietf.org/rfc/rfc2616.txt规定格式的HTTP时间字符串。 EEE, dd MMM yyyy HH:mm:ss z EEEE, dd-MMM-yy
request-id Content-Length: length ETag: etag 在合并段API中,不使用回调功能时,响应消息body体中为合并段的结果(XML格式),参考合并段,当使用回调功能时,响应消息body体中为回调服务器返回的响应消息body体的内容,例如{"status":"success"}
ORM策略,也无法通过在上传或合并时指定头域来配置对象级WORM保护策略,指定已上传的段作为此接口的目标对象也无法进行配置。如果您需要对多段对象进行保护,您可以在合并多段对象后通过此接口为其配置对象级WORM保护策略。 请求消息样式 PUT /ObjectName?retention