检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
单位为Byte（字节）。 由于OBS桶存量是后台统计，因此存量会有一定的时延，不能实时更新，因此不建议对存量做实时校验。 OBS的桶容量API增加对各个存储类型的容量统计，目前仅支持部分区域，请以实际操作为准。 请求消息样式 1 2 3 4 GET /?storageinfo HTTP/1
说明 约束 x-workflow-execution-type 否 String 工作流实例的执行方式。 只能是如下枚举值： APICALL：要查询以API触发的工作流实例。 TRIGGERCAL：要查询以事件触发的工作流实例列表。 x-workflow-next-marker 否
图1 OBS API调用的签名和验签机制 表1 OBS API调用的签名和验签机制 执行端 序号 步骤 说明 客户端 1 构造HTTP请求 用户根据自身诉求构建HTTP请求消息，一个完整的API调用请求包含请求URI、请求方法、请求消息头、请求消息体（可选），如何构造API请求详见构造请求。
获取桶元数据 功能介绍 对桶拥有读权限的用户可以执行查询桶元数据是否存在的操作。 请求消息样式 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中携带签名示例
该请求的响应消息使用公共消息头，具体请参考表1。 响应消息元素 该请求的响应消息中不带有响应元素。 错误响应消息 除了公共的错误码外，此接口还会返回一些其他的错误码。下表中列出本接口的一些常见错误，以及可能原因。如表3。 表3 配置桶标签错误码列表 错误码 描述 HTTP状态码 InvalidTagError
删除桶标签 功能介绍 OBS使用DELETE操作来删除指定桶的标签。 要正确执行此操作，需要确保执行者有DeleteBucketTagging权限。缺省情况下只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。 请求消息样式 1 2 3 4 DELETE /
获取桶区域位置 功能介绍 对桶拥有读权限的用户可以执行获取桶区域位置信息的操作。 请求消息样式 1 2 3 4 GET /?location HTTP/1.1 Host: bucketname.obs.cn-north-4.myhuaweicloud.com Date: date
获取桶ACL 功能介绍 用户执行获取桶ACL的操作，返回信息包含指定桶的权限控制列表信息。用户必须拥有对指定桶READ_ACP的权限或FULL_CONTROL权限，才能执行获取桶ACL的操作。 请求消息样式 1 2 3 4 GET /?acl HTTP/1.1 Host: bucketname
HTTP-Verb String 必选 参数解释： HTTP方法（也称为操作或动词），对REST接口而言，即为http请求操作的VERB，如："PUT"，"GET"，"DELETE"等字符串，您可根据要调用的API选择。 约束限制： 不涉及 取值范围： GET：请求服务器返回指定资源，如获取桶列表、下载对象等。
设置桶日志管理配置 功能介绍 创建桶时，默认是不生成桶的日志的，如果需要生成桶的日志，该桶需要打开日志配置管理的开关。桶日志功能开启后，桶的每次操作将会产生一条日志，并将多条日志打包成一个日志文件。日志文件存放位置需要在开启桶日志功能时指定，可以存放到开启日志功能的桶中，也可以存
列举桶清单 功能介绍 OBS使用不带清单id的GET操作来获取指定桶的所有清单配置，获取到的清单配置一次性返回，不分页。 要正确执行此操作，需要确保执行者有GetBucketInventoryConfiguration权限。缺省情况下只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。
获取桶的网站配置 功能介绍 获取该桶设置的网站配置信息。 要正确执行此操作，需要确保执行者有GetBucketWebsite执行权限。默认情况下只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。 请求消息样式 1 2 3 4 GET /?website HTTP/1
获取桶的CORS配置 功能介绍 获取指定桶的CORS配置信息。 要正确执行此操作，需要确保执行者有GetBucketCORS权限。默认情况下只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。 请求消息样式 1 2 3 4 GET /?cors HTTP/1
获取镜像回源规则 功能介绍 本接口用于查询指定桶的镜像回源策略。如果策略存在，则返回成功，status code返回值为200。 请求消息样式 GET /?mirrorBackToSource HTTP/1.1 Host: bucketname.obs.cn-north-4.myhuaweicloud
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
