检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SDK) 功能介绍 OBS桶是对象的容器，您上传的文件都将以对象的形式存放在桶中。本文介绍如何使用Harmony SDK创建桶。 调用创建桶接口，将在当前账号按照用户指定的桶名创建一个新桶，接口支持根据用户诉求，在创建桶的同时配置桶的存储类别、区域及桶的访问权限等参数。 接口约束 您
您可以根据需要将存储在OBS中的对象下载到本地。如果只需要下载对象的其中一部分数据，可以使用范围下载，下载指定范围的数据。如果指定的下载范围是0~1000，则返回第0到第1000个字节的数据，包括第1000个，共1001字节的数据，即[0， 1000]。如果指定的范围无效，则返回整个对象的数据。可以
利用obsutil进行断点续传 obsutil在上传、下载和复制大文件时通过分段上传/下载/复制算法，可支持断点续传。您可根据具体的场景设置开启分段任务的阈值以实现上传/下载/复制任务失败或中断后的续传。您可通过两种方式指定开启分段任务的阈值： 方法一 指定配置文件中的配置参数：defaultBigfi
HTTP代理的格式一般为http://[用户名:密码@]代理服务器地址:端口号，其中用户名密码非必选。 如果proxyUrl参数和系统环境变量的优先级规则为：proxyUrl > HTTPS_PROXY > HTTP_PROXY。 用户名和密码里面不能出现“:”和“@”，否则解析用户名密码会出错。
a-”开头的自定义元数据名称，第二个String代表自定义元数据的值。当用户获取此对象或查询此对象元数据时，加入的自定义元数据将会在返回的消息头中出现。 约束限制： 所有自定义元数据大小的总和不超过8K。单个自定义元数据大小的计算方式为：每个键和值的UTF-8 编码中的字节总数。
算待上传对象的加密前sha256值与加密后的sha256值，并存至对象自定义元数据，同时也会在发送请求时将加密后的文件的sha256值置于请求头，服务端收到请求后会计算收到对象的sha256，如果sha256不一致会返回错误信息。 false：不计算校验加密后数据的sha256。
中携带鉴权信息的URL，可将该URL提供给其他用户进行临时访问。在生成URL时，您需要指定URL的有效期来限制访客用户的访问时长。 如果您想授予其他用户对桶或对象临时进行其他操作的权限（例如上传或下载对象），则需要生成带对应请求的URL后（例如使用生成PUT请求的URL上传对象），将该URL提供给其他用户。
安全性要求较高的场景。 加解密时不需要与KMS交互，访问时延更低，性能较SSE-KMS更好，适用于仅需要基础的加密能力的场景，以及批量加密的场景。 适用于需要用户保存和管理密钥的场景。 密钥管理 KMS服务生成和保管密钥，OBS使用密钥加密对象。 OBS服务生成和保管密钥，并使用密钥加密对象。
安全性要求较高的场景。 加解密时不需要与KMS交互，访问时延更低，性能较SSE-KMS更好，适用于仅需要基础的加密能力的场景，以及批量加密的场景。 适用于需要用户保存和管理密钥的场景。 密钥管理 KMS服务生成和保管密钥，OBS使用密钥加密对象。 OBS服务生成和保管密钥，并使用密钥加密对象。
安全性要求较高的场景。 加解密时不需要与KMS交互，访问时延更低，性能较SSE-KMS更好，适用于仅需要基础的加密能力的场景，以及批量加密的场景。 适用于需要用户保存和管理密钥的场景。 密钥管理 KMS服务生成和保管密钥，OBS使用密钥加密对象。 OBS服务生成和保管密钥，并使用密钥加密对象。
obs:object:PutObject √ √ 获取对象内容和对象元数据 下载对象 获取对象元数据 obs:object:GetObject √ √ 获取指定版本对象内容和对象元数据 下载对象 获取对象元数据 obs:object:GetObjectVersion √ √ 单个删除和批量删除对象 删除对象 批量删除对象
995%，远高于传统架构。 一般的企业自建存储服务器不会投入巨额的成本来同时保证介质、服务器、机柜、数据中心、区域级别的可靠性，一旦出现故障或灾难，很容易导致数据出现不可逆的丢失，给企业造成严重损失。 成本 即开即用，免去了自建存储服务器前期的资金、时间以及人力成本的投入，后期设备的维护交由OBS处理。
实际业务场景下，您可能有不通过恢复而直接获取归档数据的诉求。如有时间要求，需要急速读取归档数据；或者在OBS与其他系统对接的情况下，因接口兼容问题，需要直接读取归档数据。 桶开启归档数据直读后，存储类别为归档存储的对象可以直接访问，无需提前恢复。开启直读后，下载和拷贝归档存储对象均会产生归档数据直读的数据读取流量费用，收费详情请参见产品价格详情。
个文件并发写入的情况。 桶级的桶策略和IAM策略对obsfs挂载方式生效，目录级的桶策略和IAM策略对obsfs挂载方式访问不生效。 适用的操作系统 obsfs适用于Linux操作系统，具体说明和操作指导如表1所示。 表1 获取obsfs的方式 方式 说明 适用的Linux发行版
文件接口方式的数据共享访问：由于 AI 架构需要使用到大规模的计算集群（GPU/NPU服务器），集群中的服务器访问的数据来自一个统一的数据源，即一个共享的存储空间。这种共享访问的数据有诸多好处，它可以保证不同服务器上访问数据的一致性，减少不同服务器上分别保留数据带来的数据冗余等。另外以 AI
obsutil支持上传文件/文件夹时上传软链接指向的真实路径。您可通过在运行上传/增量同步上传时指定命令级参数：link，来实现上传软链接的功能。 obsutil支持识别文件夹软链接，如果软链接指向的真实路径是一个文件夹则会递归扫描该文件夹中的内容。 文件夹软链接不能形成环，否则上传会以panic的形式退出；如果不
上传对象或者初始化分段上传任务时，您可以使用Expires参数直接指定对象的过期时间。此方式仅支持设置以天为单位的对象过期时间，过期后的对象会被OBS服务端自动清理，其优先级高于桶生命周期规则。 代码示例一：上传对象 上传对象时，您可以直接指定对象的过期时间。代码示例如下： // 引入obs库 // 使用npm安装
设置桶和对象的存储类别 操作场景 本章节指导用户在创建桶和上传对象时，初次设置桶和对象的存储类别。如果桶和对象已有存储类别，而您想要修改其存储类别，请查看转换桶和对象的存储类别。 桶存储类别和对象存储类别 创建桶时支持设置桶存储类别，也可在桶创建完成后修改桶存储类别。 上传对象时
越来越广泛的应用。Android和iOS应用使用OBS服务时，不能直接存储访问密钥（AK/SK），这样可能会导致访问密钥（AK/SK）被黑客软件破解获取，进而可能导致存放在云存储中的文件数据被窃取，甚至被篡改。 为了更好地保护应用数据，避免被攻击后数据泄露以及越权访问的风险，为您推荐以下两种方法。
SDK日志（记录工具调用OBS服务端接口期间产生的日志信息）：配置sdkLogPath、sdkLogBackups、sdkLogLevel、sdkMaxLogSize； 详细的配置参数说明请参考配置参数说明。 utilLogPath和sdkLogPath是指日志文件的全路径，而非保存日志的文件夹。 如果未指定
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
