检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
创建桶 功能介绍 创建桶是指按照用户指定的桶名创建一个新桶的操作。 默认情况下，一个用户可以拥有的桶的数量不能超过100个。 用户删除桶后，需要等待30分钟才能创建同名桶和并行文件系统。 OBS支持在创建桶时指定桶的AZ类型，您可以开启或关闭多AZ。关闭多AZ时，桶内数据默认存储
OPTIONS桶 功能介绍 OPTIONS，称为预请求，是客户端发送给服务端的一种请求，通常被用于检测客户端是否具有对服务端进行操作的权限。只有当预请求成功返回，客户端才开始执行后续的请求。 OBS允许在桶内保存静态的网页资源，在正确的使用下，OBS的桶可以成为网站资源。在这种使
查询工作流详情 功能介绍 本接口用于根据工作流名称查询工作流详细信息。 请求消息样式 GET /v2/workflows/{graph_name} HTTP/1.1 Host: obs.cn-north-4.myhuaweicloud.com Authorization: authorization
配置桶触发器 功能介绍 本接口用于在桶上绑定工作流触发器。 请求消息样式 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:
图1 OBS API调用的签名和验签机制 表1 OBS API调用的签名和验签机制 执行端 序号 步骤 说明 客户端 1 构造HTTP请求 用户根据自身诉求构建HTTP请求消息，一个完整的API调用请求包含请求URI、请求方法、请求消息头、请求消息体（可选），如何构造API请求详见构造请求。
该请求的响应消息使用公共消息头，具体请参考表1。 响应消息元素 该请求的响应消息中不带有响应元素。 错误响应消息 除了公共的错误码外，此接口还会返回一些其他的错误码。下表中列出本接口的一些常见错误，以及可能原因。如表3。 表3 配置桶标签错误码列表 错误码 描述 HTTP状态码 InvalidTagError
删除桶标签 功能介绍 OBS使用DELETE操作来删除指定桶的标签。 要正确执行此操作，需要确保执行者有DeleteBucketTagging权限。缺省情况下只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。 请求消息样式 1 2 3 4 DELETE /
HTTP-Verb String 必选 参数解释： HTTP方法（也称为操作或动词），对REST接口而言，即为http请求操作的VERB，如："PUT"，"GET"，"DELETE"等字符串，您可根据要调用的API选择。 约束限制： 不涉及 取值范围： GET：请求服务器返回指定资源，如获取桶列表、下载对象等。
权限的用户可以执行删除桶的操作，要删除的桶必须是空桶。如果桶中有对象或者有多段任务则认为桶不为空，可以使用列举桶内对象和列举出多段上传任务接口来确认桶是否为空。 注： 如果删除桶时，服务端返回5XX错误或超时，系统需要时间进行桶信息一致性处理，在此期间桶的信息会不准确，过一段时间
OPTIONS对象 功能介绍 请参见章节 OPTIONS桶。 与OPTIONS桶的区别 OPTIONS对象需在URL中指定对象名；OPTIONS桶提交的URL为桶域名，无需指定对象名。两者的请求行分别为： OPTIONS /object HTTP/1.1 OPTIONS / HTTP/1
获取对象ACL 功能介绍 用户执行获取对象ACL的操作，返回信息包含指定对象的权限控制列表信息。用户必须拥有对指定对象读ACP(access control policy)的权限，才能执行获取对象ACL的操作。 多版本 默认情况下，获取最新版本的对象ACL。如果最新版本的对象是删
查询桶触发器 功能介绍 本接口用于查询桶上绑定工作流触发器。 请求消息样式 GET /?obsworkflowtriggerpolicy HTTP/1.1 Host: bucket.obs.cn-north-4.myhuaweicloud.com Authorization: authorization
限。 OBS用户在创建桶时可以设置权限控制策略，也可以通过ACL操作API接口对已存在的桶更改或者获取ACL(access control list) 。一个桶的ACL最多支持100条Grant授权。PUT接口为幂等的覆盖写语意，新设置的桶ACL将覆盖原有的桶ACL，如果需要修改
设置桶策略 功能介绍 该接口的实现使用policy子资源创建或者修改一个桶的策略。如果桶已经存在一个策略，那么当前请求中的策略将完全覆盖桶中现存的策略。单个桶的桶策略条数（statement）没有限制，但一个桶中所有桶策略的JSON描述总大小不能超过20KB。 要使用该接口，使用者要求必须
获取桶策略 功能介绍 该接口的实现使用policy子资源来将指定桶的策略返回给客户端。 要使用该接口，使用者要求必须是桶的所有者，或者是桶所有者的子用户且具有获取桶策略的权限。 以下两种场景无法使用此接口获取桶策略，系统将返回“404 NoSuchBucketPolicy”的错误：
类型：String 父元素：Tag Value Tag的值 类型：String 父元素：Tag 错误响应消息 除了公共的错误码外，此接口还会返回一些其他的错误码。下表中列出本接口的一些常见错误，以及可能原因。如表2。 表2 配置桶标签的错误码列表 错误码 描述 HTTP状态码 NoSuchTagSet
由于桶配额的校验依赖于桶存量，而桶存量是后台计算，因此桶配额可能不会及时生效，存在滞后性。可能会出现桶存量超出配额或者删除数据后存量未能及时回落的情况。 桶存量查询接口请参见获取桶存量信息。 桶存量超出配额后再上传对象，会返回HTTP状态码403 Forbidden，错误码InsufficientStor
该请求的响应消息使用公共消息头，具体请参考表1。 响应消息元素 该请求的响应消息中不带有响应元素。 错误响应消息 除了公共的错误码外，此接口还会返回一些其他的错误码。下面列出本接口的一些常见错误，以及可能原因，如表3。 表3 设置桶清单错误码列表 错误码 描述 HTTP状态码 MalformedXML
删除桶清单 功能介绍 OBS使用DELETE操作来删除指定桶的清单配置（通过清单id来指定清单配置）。 要正确执行此操作，需要确保执行者有DeleteBucketInventoryConfiguration权限。缺省情况下只有桶的所有者可以执行此操作，也可以通过设置桶策略或用户策略授权给其他用户。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
