检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
列举桶中已初始化多段任务 功能介绍 用户可以通过本接口查询一个桶中所有的初始化后还未合并以及未取消的多段上传任务，了解完整的分段上传流程请参见分段上传。 请求消息样式 GET /?uploads&max-uploads=max HTTP/1.1 Host: bucketname
修改对象元数据 功能介绍 用户可以通过本接口添加、修改或删除桶中已经上传的对象的元数据。 请求消息样式 1 2 3 4 5 6 7 8 PUT /ObjectName?metadata HTTP/1.1 Host: bucketname.obs.cn-north-4.myhuaweicloud
OPTIONS桶 功能介绍 OPTIONS，称为预请求，是客户端发送给服务端的一种请求，通常被用于检测客户端是否具有对服务端进行操作的权限。只有当预请求成功返回，客户端才开始执行后续的请求。 OBS允许在桶内保存静态的网页资源，在正确的使用下，OBS的桶可以成为网站资源。在这种使
配置桶触发器 功能介绍 本接口用于在桶上绑定工作流触发器。 请求消息样式 PUT /?obsworkflowtriggerpolicy HTTP/1.1 Host: bucket.obs.cn-north-4.myhuaweicloud.com Authorization: authorization
删除桶触发器 功能介绍 本接口用于删除在桶上绑定工作流触发器。 请求消息样式 DELETE /?obsworkflowtriggerpolicy HTTP/1.1 Host: bucket.obs.cn-north-4.myhuaweicloud.com Authorization:
修改写对象 功能介绍 修改写对象操作是指将指定文件桶内的一个对象从指定位置起修改为其他内容。 目前接口仅在并行文件系统支持，创建并行文件系统的方法详见请求示例：创建并行文件系统。 请求消息样式 PUT /ObjectName?modify&position=Position HTTP/1
响应消息元素 在此请求返回的响应消息体中包含的配置元素，具体参见表3 对象的标签配置元素。 错误响应消息 除了公共的错误码外，此接口还会返回一些其他的错误码。下表中列出本接口的一些常见错误，以及可能原因。如下表1 获取对象标签的错误码列表。 表1 获取对象标签的错误码列表 错误码 描述 HTTP状态码
权限。SSE-KMS方式加密的对象即使设置了ACL，跨租户也不生效。 OBS用户在上传对象时可以设置权限控制策略，也可以通过ACL操作API接口对已存在的对象更改或者获取ACL(access control list) 。一个对象的ACL最多支持100条Grant授权。 本节将介
列举已上传未合并的段 功能介绍 用户可以通过本接口查询一个未合并任务所属的所有段信息，了解完整的分段上传流程请参见分段上传。此接口列举的各个段大小和分段上传的各个段大小一致。 请求消息样式 GET /ObjectName?uploadId=uploadid&max-parts=m
重命名对象 功能介绍 重命名对象操作是指将指定文件桶内的一个对象重命名为其他对象名。 目前接口仅在并行文件系统支持，创建并行文件系统的方法详见请求示例：创建并行文件系统。重命名对象操作为非幂等操作。 请求消息样式 POST /ObjectName?name=Name&rename
删除工作流 功能介绍 本接口用于标记删除工作流。 请求消息样式 DELETE /v2/workflows/{graph_name} HTTP/1.1 Host: obs.cn-north-4.myhuaweicloud.com Authorization: authorization
删除对象标签 功能介绍 用户可以通过本接口删除对象（Object）的标签信息。 如果请求中不携带版本号（versionId），需要确保执行者有DeleteObjectTagging权限。如果请求中携带版本号（versionId），需要确保执行者有DeleteObjectTaggi
设置桶策略 功能介绍 该接口的实现使用policy子资源创建或者修改一个桶的策略。如果桶已经存在一个策略，那么当前请求中的策略将完全覆盖桶中现存的策略。单个桶的桶策略条数（statement）没有限制，但一个桶中所有桶策略的JSON描述总大小不能超过20KB。 要使用该接口，使用者要求必须
类型：String 父元素：Tag Value Tag的值 类型：String 父元素：Tag 错误响应消息 除了公共的错误码外，此接口还会返回一些其他的错误码。下表中列出本接口的一些常见错误，以及可能原因。如表2。 表2 配置桶标签的错误码列表 错误码 描述 HTTP状态码 NoSuchTagSet
该请求的响应消息使用公共消息头，具体请参考表1。 响应消息元素 该请求的响应消息中不带有响应元素。 错误响应消息 除了公共的错误码外，此接口还会返回一些其他的错误码。下面列出本接口的一些常见错误，以及可能原因，如表3。 表3 设置桶清单错误码列表 错误码 描述 HTTP状态码 MalformedXML
删除桶清单 功能介绍 OBS使用DELETE操作来删除指定桶的清单配置（通过清单id来指定清单配置）。 要正确执行此操作，需要确保执行者有DeleteBucketInventoryConfiguration权限。缺省情况下只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。
更新工作流 功能介绍 本接口用于更新工作流参数值。 请求消息样式 PUT /v2/workflows/{graph_name} HTTP/1.1 Host: obs.cn-north-4.myhuaweicloud.com Authorization: authorization
设置镜像回源规则 功能介绍 本接口用于为指定桶配置镜像回源策略。接口是幂等的，如果桶上已存在相同策略内容，则返回成功，status code返回值为200；否则status code返回值为201。 请求消息样式 PUT /?mirrorBackToSource HTTP/1.1
ID，获取方法参见获取账号、IAM用户、项目、用户组、区域、委托的名称和ID； key_id是从数据加密服务创建的密钥ID，获取方法请参见查看密钥。 父元素：ApplyServerSideEncryptionByDefault 否 ProjectID SSE-KMS加密方式下KM
图1 OBS API调用的签名和验签机制 表1 OBS API调用的签名和验签机制 执行端 序号 步骤 说明 客户端 1 构造HTTP请求 用户根据自身诉求构建HTTP请求消息，一个完整的API调用请求包含请求URI、请求方法、请求消息头、请求消息体（可选），如何构造API请求详见构造请求。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
