检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
Java SDK接口概览(Java SDK) 桶相关接口 桶相关接口如下表所示。 表1 桶相关接口概览 接口名 方法 功能描述 示例代码源代码 创建桶 obsClient.createBucket(CreateBucketRequest request) 在当前账号按照用户指定的
跨区域复制 当前，OBS支持一个源桶到一个目标桶配置一条复制所有对象的跨区域复制规则，或多条按前缀匹配的跨区域复制规则。 跨区域复制不保证时效性，配置跨区域复制规则后，可能会出现对象不会立即进行复制的情况，请耐心等待。 开启WORM保留策略的桶暂不支持跨区域复制能力。 使用场景
回调 功能介绍 用户可以在上传对象请求中设置回调参数，OBS在对象上传成功之后，将上传结果回调特定服务器，并将回调结果返回给用户。 目前只在POST上传对象、PUT上传对象以及多段操作中的合并段API中支持回调功能。 在对象上传成功之后才会回调特定服务器，如果对象上传失败则不会回调。
下载对象 使用场景 您可以根据需要将存储在OBS中的对象下载到本地。 OBS支持批量下载对象，详情请参见OBS批量下载文件操作指导。 约束与限制 对于存储类别为归档存储或深度归档存储的对象，需要确认对象的状态为“已恢复”才能对其进行下载。 基于安全合规要求，自2023年12月30
配置双端固定实现VPC粒度的访问控制 操作场景 使用“双端固定”特性，即同时设置VPC终端节点策略与桶策略，可以对OBS的资源提供VPC粒度的权限控制。 一方面，设置VPC终端节点策略可以限制VPC中的服务器（ECS/CCE/BMS）访问OBS中的特定资源；另一方面，设置桶策略可
桶清单 使用场景 桶清单功能可以定期生成桶内对象的相关信息，保存在CSV格式的文件中，并上传到您指定的桶中，方便您管理桶内对象。目标桶和源桶可以是同一个桶。 指定的对象内容包括对象版本、大小、上次修改时间、存储类别、标签、加密状态等。 支持对桶清单加密，加密方式为SSE-KMS方式。
复制对象 使用场景 用户可以根据需要将存储在OBS上的对象复制到其他路径下。复制对象操作将创建需要复制的对象的副本。在单次操作中，您可以创建最大5GB的对象副本。对于复制大于5GB的对象副本，请您使用多段上传API。通过使用copy操作，您可以： 创建对象的其他副本。 通过复制对象并删除原始对象来重命名它们。
设置桶的CORS配置 功能介绍 CORS（Cross Origin Resource Sharing），即跨域资源共享，是W3C标准化组织提出的一种规范机制，允许客户端的跨域请求的配置。在通常的网页请求中，由于安全策略SOP（Same Origin Policy）的存在，一个网站
ACL 访问控制列表（Access Control List，ACL）是一个指定被授权者和所授予权限的授权列表。 OBS桶和对象的ACL是基于账号的访问控制，默认情况下，创建桶和对象时会同步创建ACL，授权拥有者对桶和对象资源的完全控制权限。 OBS的ACL为了实现用户简单实用地授权，包含以下特点：
费用账单 如果您需要查看OBS详细的费用明细，您可以前往费用中心进行查看。费用账单包含所有的按需和资源包费用明细。 账单上报周期 资源包购买完成支付后，会实时上报一条账单到计费系统进行结算。 OBS相关计费项会按照固定周期上报使用量到计费系统进行结算。OBS按小时进行结算，计费资源的扣费时间可能会滞后于结算周期。
POST上传 功能介绍 上传对象操作是指在指定的桶内增加一个对象，执行该操作需要用户拥有桶的写权限。 同一个桶中存储的对象名是唯一的。 在桶未开启多版本的情况下，如果在指定的桶内已经有相同的对象键值的对象，用户上传的新对象会覆盖原来的对象；为了确保数据在传输过程中没有遭到破坏，用
下载对象(Harmony SDK) 功能说明 您可以根据需要将存储在OBS中的对象下载到本地。 接口约束 您必须是桶拥有者或拥有下载对象的权限，才能下载对象。建议使用IAM或桶策略进行授权，如果使用IAM则需授予obs:object:GetObject权限，如果使用桶策略则需授予
基于浏览器上传的表单中携带签名 功能介绍 OBS服务支持基于浏览器的POST上传对象请求，此类请求的签名信息通过表单的方式上传。计算POST表单上传请求的签名，需要先定义一个安全策略（policy），这个安全策略的作用是限制表单上传的内容，例如规定表单上传对象的对象名前缀必须以“
Header中携带签名 功能介绍 OBS的所有API接口都可以通过在header中携带签名方式来进行身份认证，也是最常用的身份认证方式。如图1所示，在Header中携带签名是指将通过HTTP消息中Authorization header头域携带签名信息。 图1 Header中携带签名示例
创建桶 功能介绍 创建桶是指按照用户指定的桶名创建一个新桶的操作。 默认情况下，一个用户可以拥有的桶的数量不能超过100个。 用户删除桶后，需要等待30分钟才能创建同名桶和并行文件系统。 OBS支持在创建桶时指定桶的AZ类型，您可以开启或关闭多AZ。关闭多AZ时，桶内数据默认存储
设置对象元数据(Java SDK) 功能说明 元数据（Metadata）为描述对象属性的信息，是一组名称值对，用作对象管理的一部分。 当前仅支持系统定义的元数据。 系统定义的元数据又分为两种类别：系统控制和用户控制。如Last-Modified日期等数据由系统控制，不可修改；如为
OBS服务端错误码(Harmony SDK) 在向OBS系统发出请求后，如果遇到错误，会在响应中包含响应的错误码描述错误信息。对象存储访问服务的错误码如表1所示。 表1 错误码 状态码 错误码 错误信息 处理措施 301 Moved Permanently PermanentRedirect
创建并配置客户端(Java SDK) 操作场景 本章节指导客户创建并配置客户端，该任务是使用SDK与OBS交互的必备前置任务。如果您已有客户端，请跳过该节，直接参考Java SDK接口概览(Java SDK)获取接口信息。 前提条件 初始化客户端之前，您需要先完成以下几项准备工作：
URL中携带签名 功能介绍 OBS服务支持用户构造一个特定操作的URL，这个URL的Query参数中会包含用户AK、签名、有效期等信息，任何拿到这个URL的人均可执行这个操作，OBS服务收到这个请求后认为该请求就是签发URL用户自己在执行操作。例如构造一个携带签名信息的下载对象的
文件上传(C SDK) 开发过程中，您有任何问题可以在github上提交issue，或者在华为云对象存储服务论坛中发帖求助。 功能说明 您可以将本地文件直接通过Internet上传至OBS指定的桶中。待上传的文件可以是任何类型：文本文件、图片、视频等。 本章节介绍如何使用文本上传对象。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
