检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
截断对象 功能介绍 截断对象操作是指将指定文件桶内的一个对象截断到指定大小。 目前接口仅在并行文件系统支持,创建并行文件系统的方法详见请求示例:创建并行文件系统。 请求消息样式 PUT /ObjectName?truncate&length=Length HTTP/1.1 Host:
重命名对象 功能介绍 重命名对象操作是指将指定文件桶内的一个对象重命名为其他对象名。 目前接口仅在并行文件系统支持,创建并行文件系统的方法详见请求示例:创建并行文件系统。重命名对象操作为非幂等操作。 请求消息样式 POST /ObjectName?name=Name&rename
多段上传任务创建后,用户可以通过指定多段上传任务号,为特定的任务上传段,了解完整的分段上传流程请参见分段上传。添加段的方式还包括调用段拷贝接口。允许客户将已上传对象的一部分或全部拷贝为段。 该操作支持服务端加密功能。 拷贝段的结果不能仅根据HTTP返回头域中的status_cod
删除工作流 功能介绍 本接口用于标记删除工作流。 请求消息样式 DELETE /v2/workflows/{graph_name} HTTP/1.1 Host: obs.cn-north-4.myhuaweicloud.com Authorization: authorization
删除对象标签 功能介绍 用户可以通过本接口删除对象(Object)的标签信息。 如果请求中不携带版本号(versionId),需要确保执行者有DeleteObjectTagging权限。如果请求中携带版本号(versionId),需要确保执行者有DeleteObjectTaggi
获取桶元数据 功能介绍 对桶拥有读权限的用户可以执行查询桶元数据是否存在的操作。 请求消息样式 1 2 3 4 HEAD / HTTP/1.1 Host: bucketname.obs.cn-north-4.myhuaweicloud.com Date: date Authorization:
取消多段上传任务 功能介绍 如果用户希望取消一个任务,可以调用取消多段上传任务接口取消任务,了解完整的分段上传流程请参见分段上传。合并段或取消任务接口被调用后,用户不能再对任务进行上传段和列举段的操作。 请求消息样式 1 2 3 4 DELETE /ObjectName?uploadId=uplaodID
设置DIS通知策略 功能介绍 本接口用于为指定桶配置DIS通知策略。接口是幂等的,如果桶上已存在相同策略内容,则返回成功,status code返回值为200;否则status code返回值为201。 请求消息样式 PUT /?disPolicy HTTP/1.1 Host: bucketname
获取DIS通知策略 功能介绍 本接口用于查询指定桶的DIS通知策略信息。如果策略存在,则返回成功,status code返回值为200。 请求消息样式 GET /?disPolicy HTTP/1.1 Host: bucketname.obs.cn-north-4.myhuaweicloud
删除DIS通知策略 功能介绍 本接口用于删除指定桶中配置的全部DIS通知策略。删除成功,status code返回值为204。 请求消息样式 DELETE /?disPolicy HTTP/1.1 Host: bucketname.obs.cn-north-4.myhuaweicloud
ORM策略,也无法通过在上传或合并时指定头域来配置对象级WORM保护策略,指定已上传的段作为此接口的目标对象也无法进行配置。如果您需要对多段对象进行保护,您可以在合并多段对象后通过此接口为其配置对象级WORM保护策略。 请求消息样式 PUT /ObjectName?retention
Header中携带签名 功能介绍 OBS的所有API接口都可以通过在header中携带签名方式来进行身份认证,也是最常用的身份认证方式。如图1所示,在Header中携带签名是指将通过HTTP消息中Authorization header头域携带签名信息。 图1 Header中携带签名示例
HTTP-Verb String 必选 参数解释: HTTP方法(也称为操作或动词),对REST接口而言,即为http请求操作的VERB,如:"PUT","GET","DELETE"等字符串,您可根据要调用的API选择。 约束限制: 不涉及 取值范围: GET:请求服务器返回指定资源,如获取桶列表、下载对象等。
换为本次请求中所带的元数据。新建的目标对象不会复制源对象的ACL信息,默认的新建对象的ACL是private,用户可以使用设置ACL的操作接口来重新设定新对象的ACL。 复制对象操作的请求需要通过头域携带拷贝的原桶和对象信息,不能携带消息实体。 该操作支持服务端加密功能。 目标对象大小范围是[0
多为10000次。 如果对象存储类型为COLD(归档存储)或DEEP_ARCHIVE(深度归档存储),则不能调用该接口。 如果桶设置了跨区域复制配置,则不能调用该接口。 并行文件系统不支持追加写对象。 请求消息样式 POST /ObjectName?append&position=Position
修改写对象 功能介绍 修改写对象操作是指将指定文件桶内的一个对象从指定位置起修改为其他内容。 目前接口仅在并行文件系统支持,创建并行文件系统的方法详见请求示例:创建并行文件系统。 请求消息样式 PUT /ObjectName?modify&position=Position HTTP/1
响应消息元素 在此请求返回的响应消息体中包含的配置元素,具体参见表3 对象的标签配置元素。 错误响应消息 除了公共的错误码外,此接口还会返回一些其他的错误码。下表中列出本接口的一些常见错误,以及可能原因。如下表1 获取对象标签的错误码列表。 表1 获取对象标签的错误码列表 错误码 描述 HTTP状态码
权限的用户可以执行删除桶的操作,要删除的桶必须是空桶。如果桶中有对象或者有多段任务则认为桶不为空,可以使用列举桶内对象和列举出多段上传任务接口来确认桶是否为空。 注: 如果删除桶时,服务端返回5XX错误或超时,系统需要时间进行桶信息一致性处理,在此期间桶的信息会不准确,过一段时间
OPTIONS对象 功能介绍 请参见章节 OPTIONS桶。 与OPTIONS桶的区别 OPTIONS对象需在URL中指定对象名;OPTIONS桶提交的URL为桶域名,无需指定对象名。两者的请求行分别为: OPTIONS /object HTTP/1.1 OPTIONS / HTTP/1
获取对象ACL 功能介绍 用户执行获取对象ACL的操作,返回信息包含指定对象的权限控制列表信息。用户必须拥有对指定对象读ACP(access control policy)的权限,才能执行获取对象ACL的操作。 多版本 默认情况下,获取最新版本的对象ACL。如果最新版本的对象是删