# 对象存储服务 OBS > 稳定、安全、高效、易用的云存储服务 ## 服务公告 - [最新公告](https://support.huaweicloud.com/bulletin-obs/obs_bulletin_0000.md): 以下为OBS发布的最新公告,请您关注。 - [华为云新创建OBS桶默认禁止设置公开桶策略与公开ACL功能通知](https://support.huaweicloud.com/bulletin-obs/obs_bulletin_0001.md): 尊敬的华为云客户:自2025年2月26日起,OBS将逐步开启“阻止桶公开访问”特性。基于数据安全考虑,开启后,OBS新创建桶时默认禁止为桶配置公开桶策略或公开ACL,创桶后禁止向桶内上传公开访问的对象。如果您需要配置公开访问相关权限,可以在创桶时关闭该功能,也可创桶后关闭该功能。特性支持范围请以控制台实际展示为准,具体操作请参考用户指南, - [华为云OBS桶合规风险及治理建议](https://support.huaweicloud.com/bulletin-obs/obs_bulletin_0002.md): 近期,我们关注到有非法人员利用客户的OBS桶,将涉黄、涉赌、涉诈等违规内容上传到OBS桶,并在社交媒体等互联网中进行传播,造成受影响客户相关的OBS桶资源因涉嫌参与诈骗等违法违规链条,而面临封禁风险,拥有者也可能存在管理不当、连带面临监管处罚和承担相关法律责任的风险。客户需要加强内容安全审核,避免违规,可以使用内容审核服务进行上传文件的内 ## 产品介绍 - [图解对象存储服务](https://support.huaweicloud.com/productdesc-obs/obs_03_0370.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [什么是对象存储服务](https://support.huaweicloud.com/productdesc-obs/zh-cn_topic_0045829060.md): 对象存储服务(Object Storage Service,OBS)是一个基于对象的海量存储服务,为客户提供海量、安全、高可靠、低成本的数据存储能力。OBS系统和单个桶都没有总数据容量和对象/文件数量的限制,为用户提供了超大存储容量的能力,适合存放任意类型的文件,适合普通用户、网站、企业和开发者使用。OBS是一项面向Internet访问的 - [产品优势](https://support.huaweicloud.com/productdesc-obs/obs_03_0201.md): 在信息时代,企业数据直线增长,自建存储服务器存在诸多劣势,已无法满足企业日益强烈的存储需求。表1向您详细展示了OBS与自建存储服务器的优劣势对比。数据稳定,业务可靠:OBS支撑手机云相册,数亿用户访问,稳定可靠。通过跨区域复制、AZ之间数据容灾、AZ内设备和数据冗余、存储介质的慢盘/坏道检测等技术方案,保障数据持久性高达99.999999 - [应用场景](https://support.huaweicloud.com/productdesc-obs/obs_03_0202.md): 场景描述OBS提供的大数据解决方案主要面向海量数据存储分析、历史数据明细查询、海量行为日志分析和公共事务分析统计等场景,向用户提供低成本、高性能、不断业务、无须扩容的解决方案。海量数据存储分析的典型场景:PB级的数据存储,批量数据分析,毫秒级的数据详单查询等历史数据明细查询的典型场景:流水审计,设备历史能耗分析,轨迹回放,车辆驾驶行为分析 - [产品功能](https://support.huaweicloud.com/productdesc-obs/obs_03_0151.md): 本页面介绍了OBS支持的常用功能特性。关于各功能支持的地域(Region)信息,可通过控制台查询详情。在使用对象存储服务OBS之前,建议您先了解对象存储服务OBS的基本概念,以便更好地理解对象存储服务OBS提供的各项功能。OBS提供OBS Browser+、obsutil、obsfs等多种实用工具,满足不同场景下数据迁移和数据管理需求。您 - [基于IAM进行权限管理](https://support.huaweicloud.com/productdesc-obs/obs_03_0045.md): 如果您需要对华为云上购买的OBS资源,为企业中的员工设置不同的访问权限,以达到不同员工之间的权限隔离,您可以使用统一身份认证服务(Identity and Access Management,简称IAM)进行精细的权限管理。该服务提供用户身份认证、权限分配、访问控制等功能,可以帮助您安全的控制华为云资源的访问。如果华为云账号已经能满足您的 - [OBS服务的访问控制](https://support.huaweicloud.com/productdesc-obs/obs_03_0391.md): 用户访问OBS的方式有多种,包括OBS管理控制台、OBS客户端(OBS Browser+)、OBS命令行工具(obsutil)、API、SDK,无论访问方式封装成何种形式,其本质都是通过OBS提供的REST风格的API接口进行请求。OBS的接口既支持认证请求,也支持匿名请求。匿名请求通常仅用于需要公开访问的场景,例如静态网站托管。除此之外 - [数据保护技术](https://support.huaweicloud.com/productdesc-obs/obs_03_0375.md): OBS通过多种数据保护手段和特性,保障存储在OBS中的数据安全可靠。 - [审计与日志](https://support.huaweicloud.com/productdesc-obs/obs_03_0376.md): 云审计服务(Cloud Trace Service,CTS),是华为云安全解决方案中专业的日志审计服务,提供对各种云资源操作记录的收集、存储和查询功能,可用于支撑安全分析、合规审计、资源跟踪和问题定位等常见应用场景。用户开通云审计服务并创建和配置追踪器后,CTS可记录OBS的管理事件和数据事件用于审计。CTS的详细介绍和开通配置方法,请参 - [服务韧性](https://support.huaweicloud.com/productdesc-obs/obs_03_0377.md): OBS提供五级可靠性架构,通过跨区域复制、AZ之间数据容灾、AZ内设备和数据冗余、存储介质的慢盘/坏道检测等技术方案,保障数据的持久性和可用性。OBS的数据持久性高达99.9999999999%(12个9),可用性高达99.995%,远高于传统架构。 - [监控安全风险](https://support.huaweicloud.com/productdesc-obs/obs_03_0378.md): OBS提供基于云监控服务CES的资源和操作监控能力,帮助用户监控账号下的OBS桶,执行自动实时监控、告警和通知操作。用户可以实时掌握桶中所产生的各类请求、流量、带宽、错误响应和存储用量等信息。关于OBS支持的监控指标,以及如何创建监控告警规则等内容,请参见监控。同时,OBS管理控制台支持监控账号下的资源总用量,以及单桶的用量统计,详情请参 - [认证证书](https://support.huaweicloud.com/productdesc-obs/obs_03_0379.md): 华为云服务及平台通过了多项国内外权威机构(ISO/SOC/PCI等)的安全合规认证,用户可自行申请下载合规资质证书。合规证书下载华为云还提供以下资源来帮助用户满足合规性要求,具体请查看资源中心。华为云安全服务提供了网络安全专用产品安全检测证书、软件著作权等证书,供用户下载和参考。具体请查看合规资质证书。合规资质证书 - [约束与限制](https://support.huaweicloud.com/productdesc-obs/obs_03_0360.md): 本章介绍OBS的性能指标和使用限制。超过QPS或带宽阈值会触发流控。当请求被流控时,请求响应中会携带头域x-obs-qos-delay-time,该头域为请求被流控的时长,单位为ms。上传类请求(PUT上传、上传段等)会返回精确的被流控时长,下载类请求(下载对象等)会返回根据流控程度和文件大小估算出的被流控时长。 - [与其他服务的关系](https://support.huaweicloud.com/productdesc-obs/obs_03_0204.md): 对象存储服务OBS与周边服务的依赖关系如图1所示。OBS可以作为其他云服务的存储资源池,例如关系型数据库(Relational Database Service,RDS),镜像服务(Image Management Service,IMS),云审计服务(Cloud Trace Service,CTS)等。OBS可以作为其他云服务的数据分析 - [对象](https://support.huaweicloud.com/productdesc-obs/obs_03_0206.md): 对象(Object)是OBS中数据存储的基本单位,一个对象实际是一个文件的数据与其相关属性信息(元数据)的集合体。用户上传至OBS的数据都以对象的形式保存在桶中。对象将数据及其属性封装在一起,通过扁平化的架构和基于HTTP/HTTPS协议的访问方式,解决了传统存储的扩展性难题。这种方式不仅降低了海量数据的存储成本,还通过丰富的自定义元数据 - [桶](https://support.huaweicloud.com/productdesc-obs/obs_03_0207.md): 桶(Bucket)是OBS中存储对象的容器。对象存储提供了基于桶和对象的扁平化存储方式,桶中的所有对象都处于同一逻辑层级,去除了文件系统中的多层级树形目录结构。在企业数字化转型过程中,图片、视频、日志等非结构化数据呈现爆炸式增长。传统的文件系统采用树状目录层级结构,当文件数量达到千万甚至十亿级别时,目录树的遍历与寻址会引发性能瓶颈,且硬件 - [并行文件系统](https://support.huaweicloud.com/productdesc-obs/obs_03_0150.md): 并行文件系统(Parallel File System)是对象存储服务(Object Storage Service,OBS)提供的一种经过优化的高性能文件语义系统,旨在为基于对象存储服务作为统一数据湖存储的大数据场景提供解决方案。OBS服务支持对象存储桶(对象语义)和并行文件系统(POSIX文件语义),在大数据场景下建议选择并行文件系统 - [专属对象存储](https://support.huaweicloud.com/productdesc-obs/obs_03_0085.md): 专属云(Dedicated Cloud)是面向企业、政府、金融等客户,提供计算、存储资源池以及网络、管控多级隔离的综合解决方案。租户独享专属资源池,与公共租户资源物理隔离,满足特定性能、应用及安全合规等要求,为客户提供可靠、便捷的云上“头等舱”。专属对象存储(Dedicated OBS)是专属云资源下的对象存储服务。对象存储服务可以申请独 - [访问密钥(AK/SK)](https://support.huaweicloud.com/productdesc-obs/obs_03_0208.md): OBS支持通过访问密钥认证方式进行认证鉴权,即使用AK/SK加密的方法来验证某个请求发送者身份。访问密钥(AK/SK,Access Key ID/Secret Access Key)包含访问密钥ID(AK)和秘密访问密钥(SK)两部分,是您的长期身份凭证,您可以通过访问密钥对API的请求进行签名。华为云通过AK识别访问用户的身份,通过SK - [终端节点(Endpoint)和访问域名](https://support.huaweicloud.com/productdesc-obs/obs_03_0152.md): 终端节点(Endpoint):OBS为每个区域提供一个终端节点,终端节点可以理解为OBS在不同区域的区域域名,用于处理各自区域的访问请求。各区域的终端节点详情请参见地区和终端节点。访问域名:OBS会为每一个桶分配默认的访问域名。访问域名是桶在互联网中的域名地址,可应用于直接通过域名访问桶的场景,比如:云应用开发、数据分享等。OBS桶访问域 - [区域和可用区](https://support.huaweicloud.com/productdesc-obs/obs_03_0148.md): 我们用区域和可用区来描述数据中心的位置,您可以在特定的区域、可用区创建资源。区域(Region):从地理位置和网络时延维度划分,同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region,通用Region指面向公共租户提供通用云服务的Region;专属R ## 计费说明 - [计费概述](https://support.huaweicloud.com/price-obs/obs_42_0001.md): 本章节主要介绍对象存储的计费说明,包括计费项、计费模式等。关于并行文件系统和专属对象存储的计费说明,请参考产品价格详情。OBS计费项由存储费用、请求费用、流量费用、数据恢复费用和数据处理费用组成,如图1所示。OBS提供按需计费和资源包两种计费模式,您可以根据实际需求选择资源的计费模式。按需计费OBS服务默认为按需计费模式,即按实际使用的时 - [存储费用](https://support.huaweicloud.com/price-obs/obs_42_0003.md): 在使用对象存储服务时,按实际使用的存储容量、存储类型和时长收费。在使用不同存储类别的桶存储不同存储类别的对象文件时,收取的计费项有所不同。具体计费说明如表1所示。不同规格的存储类别详细介绍请参考存储类别。最低存储时间:当对象存储类型不变时,按照实际存储时间计费。当存储类型发生变化或者对象被删除时,需要考虑最低存储时间。例如,低频访问存储的 - [请求费用](https://support.huaweicloud.com/price-obs/obs_42_0004.md): 通过控制台、API、工具、SDK等任意方式对OBS进行操作,实际上都是对OBS API的调用,每调用一次API都计算一次请求次数。对象存储服务OBS会根据调用API的请求次数进行费用收取。除了服务端返回的状态码为5XX或403错误的请求外,其余的请求均会计入请求次数。OBS的请求主要分为四大类:读操作(GET类请求):GET/HEAD/L - [流量费用](https://support.huaweicloud.com/price-obs/obs_42_0005.md): 流量是在使用和访问对象存储服务OBS时,产生的数据流量累计值。流量包括内/公网流入流量、内网流出流量、公网流出流量、跨区域复制流量、回源流量等。OBS会根据您实际使用时产生的流量进行费用收取。详细的服务资费费率标准请参见产品价格详情中“对象存储服务”的内容。 - [数据恢复费用](https://support.huaweicloud.com/price-obs/obs_42_0006.md): 访问低频访问存储类别、归档存储类别和深度归档存储类别的对象时,会根据恢复方式和对象大小等产生额外的数据恢复费用。此项费用不管通过内、外网访问均会产生;如果恢复后使用公网访问对象,则还会同时收取公网流出流量费用。一个完整的恢复过程,会涉及下表所示收费项:详细的服务资费费率标准请参见产品价格详情中“对象存储服务”的内容。以下示例中出现的费用价 - [数据处理费用](https://support.huaweicloud.com/price-obs/obs_42_0007.md): 当您使用图片处理功能时,对象存储服务OBS会收取相应的费用。详细的服务资费费率标准请参见产品价格详情中“对象存储服务”的内容。以下示例中出现的费用价格仅供参考,实际价格请参见产品价格详情中“对象存储服务”的内容。假设某用户于2023年7月1日对15TB数据做图片处理。由于数据处理费用无适用的资源包,则按照按需计费方式分析如下。0~10TB - [计费模式概述](https://support.huaweicloud.com/price-obs/obs_42_0020.md): 对象存储OBS提供按需计费和资源包两种计费模式,以满足不同场景下的用户需求。资源包:一种预付费模式,资源包是预先购买的资源使用量配额。在按需资源使用过程中,优先扣减匹配的资源包使用量。资源包购买周期越长,购买使用量越多,享受的折扣越大。一般适用于数据存储需求量长期稳定的成熟业务。资源包用完或者过期后,将按照按需计费标准进行费用结算。按需计 - [按需计费](https://support.huaweicloud.com/price-obs/obs_42_0009.md): 按需计费适用于具有不能中断的短期、突增或不可预测的场景,例如请求、数据读取、图片处理等。以下计费项支持按需计费。最低存储时间:当对象存储类型不变时,按照实际存储时间计费。当存储类型发生变化或者对象被删除时,需要考虑最低存储时间。例如,低频访问存储的最低存储时间是30天,如果没有改变对象的存储类别和删除对象,那么按照实际存储天数收费。如果早 - [资源包概述](https://support.huaweicloud.com/price-obs/obs_42_0011.md): 您也可以通过资源包的方式,提前购买使用额度和时长,获取更多的优惠。超出资源包的部分自动转按需计费。如何购买资源包?对象存储服务资源包仅支持抵扣资源包购买后产生的费用,不支持抵扣资源包购买前产生的费用。例如,某用户有500GB文件存储在华北-北京四的OBS桶中,存储类别为单AZ标准存储。该用户于2023年6月30日购买了华北-北京四的单AZ - [资源包购买](https://support.huaweicloud.com/price-obs/obs_42_0012.md): 对象存储服务同时提供资源包计费模式,您可以购买资源包用以抵扣计费项。资源包包括标准存储单AZ存储包、标准存储多AZ存储包、归档存储包、公网流出流量包、跨区域复制流量包、医疗影像单AZ存储包和回源流量包。OBS各类资源包的详细介绍,请参见OBS计费说明。如果您在购买资源包时选择定向企业项目使用,请根据桶所属企业项目确定资源包定向使用的企业项 - [资源包叠加购买](https://support.huaweicloud.com/price-obs/obs_42_0013.md): 当资源包即将到期、容量不足或有更大容量的资源包需求时,可以通过叠加购买实现资源包的容量扩大。在购买一个资源包后,可继续购买除特价体验资源包外的任意规格资源包。40GB存储包和50GB公网流出流量包为特价体验套餐包,每个用户在同一时间只能分别购买一次,套餐包过期后,才可重复购买,其余规格可任意叠加购买。叠加购买资源包后,会优先使用原购买资源 - [资源包有效期及重置](https://support.huaweicloud.com/price-obs/obs_42_0035.md): 资源包有效期:指资源包的开始生效与到期之间的一段时间。在有效期内,用户可以使用资源包所包含的资源额度来抵扣相应的费用。资源包到期后,未使用完的资源额度会失效,如果没有新购买的资源包,或没有对资源包进行续费,那么系统将按需计算后续的费用。如果资源包是当月最后一天生效,则到期日为目标月最后一天。如果资源包生效当日天数大于到期月总天数,则到期日 - [资源包升配](https://support.huaweicloud.com/price-obs/obs_42_0021.md): 如果您在使用OBS的过程中需要更高规格的资源包,可以对当前资源包进行升配操作。因为数据是持续增长的,资源包需要具备动态升配的能力,可以让用户轻松管理资源包。对于标准存储单AZ存储包、标准存储多AZ存储包、归档存储包,用户可以对其升配,但无法降配。以下情况暂不支持资源包升配:资源包类型为医疗影像单AZ存储包资源包规格已经是最高级别资源包正在 - [资源包续费](https://support.huaweicloud.com/price-obs/obs_42_0014.md): 资源包到期会转为按需计费。如果您想继续使用,可以在资源包到期前为资源包续费,否则桶及桶内资源的相关操作会转为按需计费。转为按需计费后如果账户余额不足导致欠费,经过宽限期和保留期后,桶及桶内资源会自动释放,数据丢失且不可恢复。OBS资源包支持自动续费和手动续费,如表1所示。续费更多相关详情请参见续费管理。只有通过实名认证的客户,才可以执行续 - [资源包退订](https://support.huaweicloud.com/price-obs/obs_42_0015.md): 资源包支持未使用全额退订,新购超过五天或已产生使用量,属于非全额退订,详见退订规则。您还可以在OBS控制台进行自主退订,具体操作请参考自行退订操作步骤。购买医疗影像单AZ存储包时,购买时长选择“15年”,购买成功后会拆分为3个5年时长的医疗影像单AZ存储包,因此退订时建议选择拆分的3个资源包一起退订。以下步骤为退订非医疗影像单AZ存储包的 - [查看资源包详情](https://support.huaweicloud.com/price-obs/obs_42_0017.md): 如果您已购买资源包,您可以在OBS管理控制台上查看已购买资源包的使用详情。包括资源包规格、所属区域、状态、剩余容量、起止时间、订单号和使用明细。OBS提供按需付费和资源包两种计费模式。在按需付费的场景下,用多少付多少,不存在资源包剩余量的概念。如果用户购买了资源包,则可以通过以下方式查看资源包剩余量的情况。 - [Flexus OBS资源包](https://support.huaweicloud.com/price-obs/obs_42_0034.md): Flexus OBS资源包是针对标准存储单AZ存储容量提供的优化套餐,适用于网站、备份、办公OA、医疗影像等场景。支持对象桶和并行文件系统抵扣。您可以通过包年方式提前购买使用额度和时长,资源包购买后立即生效。仅支持抵扣标准存储单AZ容量,且只能用于资源包所属区域。资源包适用于所有企业项目。资源包仅支持抵扣资源包购买后产生的费用。资源包到期 - [计费样例](https://support.huaweicloud.com/price-obs/obs_42_0031.md): 以下示例中出现的费用价格仅供参考,实际价格请参见产品价格详情中“对象存储服务”的内容。计费场景某企业基于弹性云服务器(Elastic Cloud Server,ECS)构建好基础的业务后,随着数据增长,硬盘已无法满足大量的图片、视频等数据存取需求。了解到华为云提供有海量、弹性的云存储服务OBS后,决定将OBS作为数据存储资源池,以减轻服务 - [特殊场景计费](https://support.huaweicloud.com/price-obs/obs_42_0016.md): 如果您配置了生命周期规则,在生命周期规则执行过程中以及执行完成后,可能产生如下费用:各项费用的详细说明,请参见OBS计费项说明。以下示例中出现的费用价格仅供参考,实际价格请参见产品价格详情中“对象存储服务”的内容。生命周期计费示例:低频访问存储>归档存储>过期删除用户拥有100GB数据(包含1000个对象),区域是华北-北京四,2025年 - [变更计费模式](https://support.huaweicloud.com/price-obs/obs_42_0022.md): OBS支持按需和资源包两种计费模式,两种计费模式的转换逻辑如下:按需转资源包:在使用OBS的过程中,如果发现按需计费模式无法满足业务需求,您可以通过购买对应资源包的方式,变更计费模式为资源包,支持资源包抵扣的计费项可参见资源包概述。购买资源包后,扣费时会先检查有无与计费项匹配的资源包,如果有对应资源包会优先走资源包抵扣。资源包转按需:在资 - [费用账单](https://support.huaweicloud.com/price-obs/obs_42_0027.md): 如果您需要查看OBS详细的费用明细,您可以前往费用中心进行查看。费用账单包含所有的按需和资源包费用明细。资源包购买完成支付后,会实时上报一条账单到计费系统进行结算。OBS相关计费项会按照固定周期上报使用量到计费系统进行结算。OBS按小时进行结算,计费资源的扣费时间可能会滞后于结算周期。可以单击列表右侧的导出详细账单进行查看。目前费用中心对 - [欠费说明](https://support.huaweicloud.com/price-obs/obs_42_0018.md): 用户在使用云服务时,账户的可用额度小于待结算的账单,即被判定为账户欠费。欠费后,可能会影响云服务资源的正常运行,请及时充值。已购买资源包,但使用量超出资源包额度或资源包属性与桶属性不匹配,进而产生按需费用,同时账户中的余额不足以抵扣产生的按需费用。请参考已购买资源包,为什么仍然产生按需计费识别产生按需计费的原因,并重新选择正确的资源包或保 - [停止计费](https://support.huaweicloud.com/price-obs/obs_42_0029.md): 本章节展示针对单个桶资源,通过账单查找OBS资源并停止计费的操作步骤,解决“资源删除不彻底”这一用户高频问题。针对资源包的消费使用,涉及所有对应单AZ/多AZ、区域的桶资源,不建议通过账单查找OBS资源并停止计费。对于按需计费模式的桶资源,例如按需计费的低频存储桶,如果不再使用该资源且需停止计费,请删除相应资源。针对单个桶资源的消费使用, - [计费FAQ](https://support.huaweicloud.com/price-obs/obs_42_0019.md): 如何购买专属对象存储?配置CDN回源,并购买回源流量包,计费未走回源流量包已购买资源包,为什么仍然产生按需计费?购买了回源流量包是否还需要购买公网流出流量包?资源包是否必须购买?是否能指定给具体的桶使用?资源包是否支持退订或修改?并行文件系统是否支持资源包?哪些资源包会按月更新额度,哪些不会?当月未用完的资源包用量是否会结转到下个月?资源 ## 快速入门 - [通过控制台快速使用OBS](https://support.huaweicloud.com/qs-obs/obs_qs_0001.md): 控制台是网页形式的操作平台,提供更直观的界面操作,简单易上手。本章节以上传对象至“test-example-bucket”桶为例,帮助您通过控制台快速使用OBS的基础功能,包括创建桶、上传对象、下载对象、分享对象。使用OBS之前,您需要拥有一个华为账号并实名认证,然后为账号充值。如果您已有华为账号,请忽略此步骤。如果您还没有华为账号,请执 - [通过OBS Browser+图形化工具快速使用OBS](https://support.huaweicloud.com/qs-obs/obs_qs_0002.md): OBS Browser+是一款图形化工具,适用于Windows10,Windows Server2016以及Mac平台,可以非常方便地让用户在本地对OBS的数据进行管理。本章节以上传一个文件至“test-example-bucket”桶为例,帮助您快速通过OBS Browser+使用OBS的基础功能,包括创建桶、上传对象、下载对象、分享对 - [通过obsutil命令行工具快速使用OBS](https://support.huaweicloud.com/qs-obs/obs_qs_0012.md): obsutil是一款命令行工具,对于熟悉命令行的用户,obsutil能在执行批量处理、自动化任务的场景中为您带来更优体验。本章节以Linux操作系统为例,以上传一个文件至“bucket-test”桶为例,帮助您快速通过obsutil使用OBS的基础功能,包括创建桶、上传对象、下载对象、分享对象。使用obsutil命令行工具之前,您需要拥有 - [通过OBS SDK快速使用OBS](https://support.huaweicloud.com/qs-obs/obs_qs_0013.md): OBS SDK对OBS服务提供的REST API进行封装,以简化用户的开发工作。您直接调用OBS SDK提供的接口函数即可使用OBS管理数据。本章节以Java、Python、Go三种SDK为例,帮助您快速上手OBS的基础功能,包括创建桶、上传对象、下载对象、列举对象。使用Java SDK之前,您需要拥有一个华为账号并实名认证、为账号充值, - [入门实践](https://support.huaweicloud.com/qs-obs/obs_qs_0011.md): 当您完成了创建桶、上传对象和下载对象等基本操作后,可以根据自身的业务需求使用OBS提供的一系列常用实践。 ## 用户指南 - [OBS访问规则](https://support.huaweicloud.com/usermanual-obs/obs_41_0003.md): 华为云OBS桶访问域名通过DNS解析的IP地址是会发生变化的,不推荐直接使用IP地址访问OBS。在了解OBS访问规则前,建议您先了解以下OBS访问相关的概念:OBS提供多种访问方案,根据您的访问需求,推荐访问相关的功能配置,帮助您构建高效、稳定、安全的OBS访问架构,如表2所示。以下列举OBS常见的区域、终端节点、双栈域名终端节点、内网I - [存储类别概述](https://support.huaweicloud.com/usermanual-obs/obs_41_0080.md): 伴随着互联网的高速发展,数据存储场景越来越多样化,单一的存储类别已无法满足多样化的存储场景和成本管理诉求。OBS设计了多种存储类别,支持的存储类别有标准存储、低频访问存储、归档存储、深度归档存储,您可以结合自身业务合理选择。不同规格的存储类别计费参见存储费用。OBS支持以下存储类别:适用场景:标准存储访问时延低和吞吐量高,因而适用于有大量 - [设置桶和对象的存储类别](https://support.huaweicloud.com/usermanual-obs/obs_41_0081.md): 本章节指导用户在创建桶和上传对象时,初次设置桶和对象的存储类别。如果桶和对象已有存储类别,而您想要修改其存储类别,请查看转换桶和对象的存储类别。创建桶时支持设置桶存储类别,也可在桶创建完成后修改桶存储类别。上传对象时,对象的存储类别默认继承桶的存储类别,您也可以重新指定对象的存储类别,同时也支持在对象上传完成后修改对象的存储类别。修改桶的 - [转换桶和对象的存储类别](https://support.huaweicloud.com/usermanual-obs/obs_41_0082.md): 本章节指导用户如何修改桶和对象的存储类别。桶存储类别仅支持手动修改。对象存储类别支持手动修改和使用生命周期自动转换。转换存储类别时数据冗余策略保持不变。如果桶或对象是多AZ,那么只能转换成支持多AZ的存储类型(标准存储、低频访问存储支持多AZ)。例如,对象A是多AZ标准存储,那么对象A可以转为低频访问存储,但不能转换为归档存储,因为归档存 - [桶概述](https://support.huaweicloud.com/usermanual-obs/obs_41_0008.md): 桶(Bucket)是OBS中存储对象的容器。对象存储提供了基于桶和对象的扁平化存储方式,桶中的所有对象都处于同一逻辑层级,去除了文件系统中的多层级树形目录结构。每个桶都有自己的存储类别、访问权限、所属区域等属性,用户可以在不同区域创建不同存储类别和访问权限的桶,并配置更多高级属性来满足不同场景的存储诉求。对象存储服务设置有四类桶存储类别, - [创建桶](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829088.md): 您可以通过OBS管理控制台、API、SDK、OBS Browser+、obsutil方式创建桶。桶是OBS中存储对象的容器。您需要先创建一个桶,然后才能在OBS中存储数据。华为云OBS管理控制台支持在创建桶时选择源桶,同步桶配置。选择后可复制源桶的以下配置信息:区域 / 数据冗余策略 / 存储类别 / 桶策略 / 服务端加密 / 归档数据 - [快速为新桶复制已有桶的配置](https://support.huaweicloud.com/usermanual-obs/obs_41_0052.md): OBS提供了桶配置信息复制功能,方便您在创建新桶之后,快速将已有桶的配置信息复制到新桶中。支持复制的桶配置信息包括:桶策略CORS规则生命周期规则数据回源规则图片处理样式在线解压规则Data+事件触发器从源桶复制配置信息的操作为增量复制,不会删除当前桶已存在的配置信息,与已存在的配置信息冲突的规则不会复制。源桶和目标桶的桶版本号都必须是3 - [列举桶](https://support.huaweicloud.com/usermanual-obs/obs_41_0010.md): 当账户下桶的数量比较多时,人工管理桶不仅效率低下,且容易发生操作失误。用户可以通过列举桶功能,获取账户下的桶列表,从而方便进行桶清点、批量操作、权限审计等操作,从而提升管理桶的效率与准确性。列举桶请求默认发生在华北-北京一,所以在统计请求费用时,ListAllMyBucketsOperation请求的费用会被划归到华北-北京一区域。同时列 - [查看桶信息](https://support.huaweicloud.com/usermanual-obs/obs_03_0312.md): 创建桶之后,您可以通过OBS管理控制台直接查看某个桶的详情,包括用量分析、监控告警、域名信息、基本信息、基础配置、常见问题和了解更多模块。也可以将桶列表导出,在本地Excel查看账号下所有桶的基本信息。OBS支持通过管理控制台、API、SDK、OBS Browser+、obsutil查看桶基本信息。以上统计数据非实时数据,大约存在一个小时 - [管理桶配额](https://support.huaweicloud.com/usermanual-obs/obs_41_0012.md): 默认情况下,OBS系统和单个桶都没有总数据容量和对象数量的限制。您可以通过为桶设置配额限制来控制桶内允许上传的对象总容量,超过设置的对象容量后,上传对象会失败(返回HTTP状态码403 Forbidden,错误码InsufficientStorageSpace)。此时如果想要继续上传对象,请扩大配额,或取消配额限制(设置为0),或删除不需 - [桶用量统计](https://support.huaweicloud.com/usermanual-obs/obs_03_0446.md): OBS支持在对象存储管理控制台上查看所有桶或单个桶的存储、流量和请求的情况。此功能需要在区域级项目配置云监控的权限策略ces:metricData:list,才能看到用量统计。配置方法请参见Cloud Eye自定义策略。OBS为您提供了如表1所示的几种统计分析项,帮助您了解如下信息:“用量统计”非实时刷新,“存储”数据约有1小时左右的时延 - [桶标签](https://support.huaweicloud.com/usermanual-obs/obs_03_0331.md): 您可以在创建桶时,配置其标签,详见创建桶。您也可以在桶创建后,再配置其标签。本章节介绍桶创建后标签的配置方法。标签用于标识云资源,当您拥有相同类型的许多云资源时,可以使用标签按多种维度(如用途、所有者或环境)对云资源进行分类,从而帮助您对资源进行使用量分析或成本核算等。对于OBS,标签用于标识桶,对OBS中的桶进行分类,从而帮助您对OBS - [删除桶](https://support.huaweicloud.com/usermanual-obs/obs_03_0314.md): 如果桶为空或您不再需要一个桶,可以通过OBS管理控制台、API、SDK、OBS Browser+、obsutil方式将其删除,以免占用桶数量配额,同时可以降低存储成本。删桶后桶名会释放,释放完成后才能创建同名桶。调用删桶API一般耗时约30分钟释放,如遇特殊情况(例如欠费、销户触发删桶,删桶前需要先进行资源清理)耗时会更长,OBS无法保证 - [对象概述](https://support.huaweicloud.com/usermanual-obs/obs_41_0015.md): 对象(Object)是OBS中数据存储的基本单位,一个对象实际是一个文件的数据与其相关属性信息(元数据)的集合体。用户上传至OBS的数据都以对象的形式保存在桶中。对象包括了Key,Metadata,Data三部分:Key:键值,即对象的名称,为经过UTF-8编码的长度大于0且不超过1024的字符序列。一个桶里的每个对象必须拥有唯一的对象键 - [上传概述](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829661.md): 您可以根据需要上传文件或者文件夹至已有的OBS桶。待上传的文件可以是任何类型,包括但不限于文本文件、图片、视频等。上传文件时,如果您需要将文件归类处理,可以先新建文件夹,然后将相关的文件上传到文件夹中。新建文件夹的详情请参见创建和删除文件夹。虽然OBS服务支持您将对象上传到指定区域的桶里,但是华为云并不感知您对象的具体内容。如果您对象上传 - [简单上传(PUT上传)](https://support.huaweicloud.com/usermanual-obs/obs_03_1002.md): 如果待上传的文本文件、图片、视频等资源小于5GB,您可以选择简单上传,即PUT操作的方式将对象上传到桶中。PUT上传中参数通过请求头域传递,上传需在URL中指定对象名,请求行为如下所示:虽然OBS服务支持您将对象上传到指定region的桶里,但是华为云并不感知您对象的具体内容。如果您对象上传行为涉及跨境传输,请您确保使用本服务符合所适用的 - [表单上传(POST上传)](https://support.huaweicloud.com/usermanual-obs/obs_03_1003.md): 表单上传(POST上传)是指通过HTML表单以POST请求方式,将小于5GB的文件直接从浏览器上传到OBS桶中。它一般普遍适用于WEB应用程序,其应用场景包括但不限于以下几方面:用户交互与内容生成:包括社交账号头像与封面设置、富媒体内容发布、社交动态发布、用户反馈与工单等。业务单据和数据交换:包括后台管理系统批量数据导入、官方证件与材料提 - [多段上传](https://support.huaweicloud.com/usermanual-obs/obs_41_0021.md): 分段上传将单个对象拆分为多个分片分别上传,当对象的所有分片都上传后,OBS将这些段合并起来,然后创建对象。一般而言,如果您的对象大小达到了100MB,应考虑使用多段上传,而不是使用简单上传。使用分段上传具有以下优势:提高吞吐量:多个分片并行上传可以提高上传速度,最大限度地利用您的带宽。更好地适应网络波动:如果某一个分片因为网络原因上传失败 - [断点续传](https://support.huaweicloud.com/usermanual-obs/obs_03_1005.md): 当上传大文件时,经常出现因网络不稳定或程序崩溃导致上传失败的情况。失败后再次重新上传不仅浪费资源,而且当网络不稳定时仍然有上传失败的风险。断点续传上传接口能有效地解决此类问题引起的上传失败,其原理是将待上传的文件分成若干个分段分别上传,不仅能在失败重传时节省资源提高效率,还因其对分段进行并发上传的机制能加快上传速度。您必须是桶拥有者或拥有 - [追加写对象](https://support.huaweicloud.com/usermanual-obs/obs_03_1006.md): 简单上传、表单上传、多段上传在上传结束之后内容是固定的,只能读取,不能修改。如果对象内容发生了改变,只能重新上传同名的对象来覆盖之前的内容。对于上传日志、视频监控和视频直播等领域生成的实时视频流,使用以上上传方式,会存在软件架构复杂、客户端发送请求频繁造成服务器压力大、数据延时等问题。为了解决以上问题,可以使用追加写的方式上传对象,就是在 - [授权第三方上传](https://support.huaweicloud.com/usermanual-obs/obs_03_1007.md): 当第三方用户没有上传权限的时候,可以临时授权给第三方用户临时访问OBS服务,在授权有效期内实现对象上传。例如,部分企业拥有自己的用户管理系统,用户管理系统中的用户包括终端APP用户、企业本地用户等,这部分用户并不具有IAM用户的权限,通过授予其临时访问密钥来访问OBS。授权方式有以下两种:通过临时访问密钥授权上传通过临时URL授权上传OB - [查看上传进度](https://support.huaweicloud.com/usermanual-obs/obs_03_1008.md): 您可以利用OBS SDK提供的进度监听功能实现一个进度条,来获取指定对象的上传进度,从而预估剩余时间。OBS支持通过SDK获取上传进度。 - [使用上传回调获取对象信息](https://support.huaweicloud.com/usermanual-obs/obs_41_0079.md): 您可以通过回调,获取对象上传后的相关信息,例如获取对象是否上传成功,获取对象Etag、上传后大小、上传后对象所在桶等信息。OBS支持通过回调获取对象的系统参数和自定义参数,参数详情可参考API参考的回调章节。上传回调的详细流程如图1所示,主要分为以下几个阶段:目前只在POST上传对象、PUT上传对象以及合并段API中支持回调功能。在对象上 - [下载对象](https://support.huaweicloud.com/usermanual-obs/obs_03_0317.md): 您可以根据需要将存储在OBS中的对象下载到本地。OBS支持批量下载对象,详情请参见OBS批量下载文件操作指导。对于存储类别为归档存储或深度归档存储的对象,需要确认对象的状态为“已恢复”才能对其进行下载。基于安全合规要求,自2023年12月30日后创建的桶,都禁止使用桶默认域名通过公网访问后缀为.apk或者.ipa的对象。通过自定义域名访问 - [使用单链接限速限制下载流量](https://support.huaweicloud.com/usermanual-obs/obs_03_0318.md): 为了避免因为客户端下载对象时占用较大的带宽,而影响其他应用的网络带宽。您可以使用OBS单链接限速功能,通过限制下载的流量,保证其他应用的网络带宽。本章将介绍以下限速方式通过SDK请求限速通过对象URL限速通过签名URL限速通过Header头域携带限速通过SDK发起请求时,目前仅支持单链接限速下载对象进行限速,详情参见单链接限速。 - [在线预览对象](https://support.huaweicloud.com/usermanual-obs/obs_03_0342.md): 基于安全合规要求,对象存储服务OBS禁止通过OBS的默认域名(桶访问域名或静态网站访问域名)在线预览桶内对象,即使用上述域名从浏览器访问桶内对象(如视频、图片、网页等)时,不会显示对象内容,而是以附件形式下载。为了解决以上问题,OBS默认域名强制下载后,推荐用户使用自有域名实现在线预览。方案一:使用OBS自定义域名访问(不开启CDN加速) - [列举对象](https://support.huaweicloud.com/usermanual-obs/obs_03_0723.md): OBS管理控制台单击桶名称进入对象列表页,默认对象名按照字典序排序来列举对象。您也可以根据实际场景需求,按照“大小”和“最后修改时间”进行排序列举对象。在OBS列举桶内对象中,各参数(参数名以API为准)通过以下逻辑协同工作,以实现精准、可控的数据读取:prefix用于界定检索范围,系统仅返回以该值开头的对象名,起到“划定选区”的作用。如 - [复制对象](https://support.huaweicloud.com/usermanual-obs/obs_41_0020.md): 用户可以根据需要将存储在OBS上的对象复制到其他路径下。复制对象操作将创建需要复制的对象的副本。在单次操作中,您可以创建最大5GB的对象副本。对于复制大于5GB的对象副本,请您使用多段上传API。通过使用copy操作,您可以:创建对象的其他副本。通过复制对象并删除原始对象来重命名它们。更改对象元数据。每个OBS对象都带有元数据,它是一组名 - [配置、编辑、查看对象元数据](https://support.huaweicloud.com/usermanual-obs/obs_03_0324.md): 元数据(Metadata)为描述对象属性的信息,是一组名称和值的配对,用作对象管理的一部分。OBS 中有两种元数据:系统定义的对象元数据和自定义元数据。系统定义的元数据包括对象的创建日期、大小和存储类别等元数据;自定义元数据是您可以为对象自行设置的某些具有特殊含义的元数据,用来标识对象的用途或属性等。您可以在上传对象时在OBS中设置对象元 - [分享对象](https://support.huaweicloud.com/usermanual-obs/obs_03_0046.md): 您可以使用对象分享功能,通过对象的临时URL将存放在OBS中的对象分享给所有用户。实际业务场景下,您可能会需要将文件临时分享给其他人或者将文件永久共享给其他人。临时分享:通过文件的临时URL直接将其分享给其他用户。文件分享强调临时性,所有分享的URL都是临时URL,存在有效期。临时URL是由文件的访问域名和临时鉴权信息组成。示例如下:ht - [匿名用户通过URL访问对象](https://support.huaweicloud.com/usermanual-obs/obs_03_0319.md): 将对象权限设置为匿名用户读取权限,通过分享对象URL,匿名用户通过分享的链接地址可访问对象数据。已经设置匿名用户对该对象的读取权限。权限开启方法请参见对所有账号授予指定对象的读权限。不能对已加密的对象进行共享。匿名用户单击该链接地址即可通过浏览器访问该对象。对象链接地址格式为:https://桶名.域名/文件夹目录层级/对象名。如果该对象 - [恢复归档或深度归档存储对象](https://support.huaweicloud.com/usermanual-obs/obs_03_0320.md): 为了节约存储成本,我们通常将很少访问或长期不访问的文件作为归档存储或深度归档存储类别的对象存储在桶中,这些对象无法直接读取,需要先恢复才能下载对象、分享对象、修改对象存储类别、通过对象URL访问对象等。以下从对象恢复的流程及恢复有效期叠加规则来介绍对象恢复的工作原理。归档存储或深度归档存储类别的对象恢复后,会产生一个标准存储类别的对象副本 - [归档数据直读](https://support.huaweicloud.com/usermanual-obs/obs_03_0143.md): 实际业务场景下,您可能有不通过恢复而直接获取归档数据的诉求。如有时间要求,需要急速读取归档数据;或者在OBS与其他系统对接的情况下,因接口兼容问题,需要直接读取归档数据。您可以直接开启“归档数据直读”功能,无需提前恢复归档数据,就能直接下载对象、读取对象、配置对象的ACL权限、修改存储类别、通过对象URL访问对象相关操作。桶开启归档数据直 - [对象标签](https://support.huaweicloud.com/usermanual-obs/obs_41_0054.md): OBS支持为桶内对象设置自定义标签,用于实现数据的精细化分类管理。您可在上传对象时同步添加标签,也可为已有对象追加标签。基于对象标签,既可结合生命周期规则按标签自动转储或清理对象,也可在权限体系中按标签维度控制访问范围,为数据治理、成本优化与安全管控提供统一支撑。OBS支持使用对象标签对桶中的对象进行分类,您可以在上传对象时添加标签,也可 - [软链接](https://support.huaweicloud.com/usermanual-obs/obs_13_0021.md): 类似于Windows的快捷方式,软链接(Symbolic Link)用于提高资源管理灵活性和访问便捷性。创建一个指向目标对象的软链接,打开软链接即可访问目标对象。软链接的使用场景主要有:对象迁移过渡期间的平滑衔接:当对象存储路径进行变更时,希望通过旧的路径继续访问,避免修改客户端代码。软链接可作为过渡方案,确保业务无感知。例如文件从old - [删除OBS桶中的对象](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829108.md): 您可以通过OBS管理控制台、API、SDK、OBS Browser+、obsutil方式删除无用的文件或文件夹,以优化存空间,节约成本。本小节主要介绍如何删除文件或文件夹的方式,具体请参见表1。对于并行文件系统目录,大数据场景下(目录层级深、目录下文件多)的删除,可能会因超时而删除失败,建议使用:hadoop 客户端(嵌套OBS客户端插件 - [清理碎片](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829110.md): 桶中不完整的数据称之为碎片。OBS采用分段上传的模式上传数据,在下列情况下(但不仅限于此)通常会导致数据上传失败而产生碎片。网络条件较差,与OBS的服务器之间的连接经常断开。上传过程中,人为中断上传任务。设备故障。突然断电等特殊情况。上传失败而产生的碎片会存储在OBS中,您可以使用本章提供的方式进行手动清理碎片,也可以根据需要选择通过继续 - [管理文件夹概述](https://support.huaweicloud.com/usermanual-obs/obs_03_10070.md): OBS凭借其底层的扁平化架构,在处理海量数据时具备优良的扩展性。但当桶内存放了大量文件时,所有对象都平铺在同一个界面中,会使您的查找、批量操作变得繁琐,业务数据的归类也会缺乏清晰的逻辑边界。为了解决这一问题,OBS在控制台、OBS Browser+等可视化工具中提供了“文件夹”视图功能。OBS本质上是采用扁平化的存储结构,即数据以对象的形 - [创建和删除文件夹](https://support.huaweicloud.com/usermanual-obs/obs_03_0316.md): 您可以在已创建的桶中新建一个文件夹,从而更方便地对存储在OBS中的数据进行分类管理。由于OBS是一种对象存储服务,并没有文件系统中的文件和文件夹概念。为了使用户更方便进行管理数据,OBS提供了一种方式模拟文件夹。实际上在OBS内部是通过在对象的名称中增加“/”,将该对象在OBS管理控制台或者OBS Browser+上模拟成一个文件夹的形式 - [分享文件夹](https://support.huaweicloud.com/usermanual-obs/obs_03_0104.md): 您可以使用文件夹分享功能,将OBS中的整个文件夹分享给所有用户。分享文件夹包含临时分享和永久共享。临时分享:通过文件夹的临时URL直接将其分享给其他用户。文件夹分享强调临时性,所有分享的URL都是临时URL,存在有效期。临时分享分为两种方式:提取码分享、直接分享。提取码分享分享者需要先设置一个提取码,再创建分享。创建成功后,OBS会自动将 - [统计文件夹中的对象数量和大小](https://support.huaweicloud.com/usermanual-obs/obs_06_1009.md): 如果您需要统计桶中文件夹的大小及其所含对象数量,可以使用文件夹统计功能。统计文件夹大小会收取“列举桶内对象”接口的调用费用,详情请参考计费说明。支持统计对象数量在100万以内的文件夹,对象数量超过100万的文件夹建议使用obsutil工具的列举对象命令进行统计。统计对象数量较多的文件夹时,可能需要一定的时间,请您耐心等待。启用多版本控制功 - [通过IAM角色或策略授予使用OBS的权限](https://support.huaweicloud.com/usermanual-obs/obs_03_0121.md): 如果您需要对所拥有的OBS资源的管理和访问进行权限管控,您可以使用统一身份认证服务(Identity and Access Management,简称IAM)。IAM有两种授权方式,一种是基于角色与策略的授权,一种是基于身份策略的授权,两种方式的区别详见IAM权限和授权项说明。本节讲解基于角色与策略的授权方式。通过IAM基于角色与策略的授 - [通过IAM身份策略授予使用OBS的权限(IAM新版)](https://support.huaweicloud.com/usermanual-obs/obs_03_0154.md): 如果您需要对所拥有的OBS资源的管理和访问进行权限管控,您可以使用统一身份认证服务(Identity and Access Management,简称IAM)。IAM有两种授权方式,一种是基于角色与策略的授权,一种是基于身份策略的授权,两种方式的区别详见IAM权限和授权项说明。本节讲解基于身份策略的授权方式。通过IAM基于身份策略的授权方 - [使用模板创建桶策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0142.md): OBS管理控制台预置了多种常用典型场景的桶策略模板,用户可以使用模板创建桶策略,快速完成桶策略配置。OBS支持通过管理控制台、API、SDK、OBS Browser+、obsutil方式配置桶策略。当被授权用户选择“当前账号”时,需要您的账号具有“iam:users:listUsers”权限才能列举出当前账号下的IAM用户来供您选择。授权 - [自定义创建桶策略(可视化视图)](https://support.huaweicloud.com/usermanual-obs/obs_03_0123.md): 您可以根据实际业务场景的定制化需求,不使用预置桶策略模板,自定义创建桶策略。自定义桶策略由效力、被授权用户、资源、动作和条件5个桶策略基本元素共同决定。详细请参见桶策略参数说明。 - [自定义创建桶策略(JSON视图)](https://support.huaweicloud.com/usermanual-obs/obs_03_0141.md): 熟悉JSON以及OBS桶策略语法结构的用户,可以直接使用JSON视图编辑桶策略。单个桶的桶策略条数(statement)没有限制,但一个桶中所有桶策略的JSON描述总大小不能超过20KB。OBS支持通过管理控制台、API、SDK、OBS Browser+、obsutil方式自定义创建桶策略。以下示例中,“test-obs-policy”为 - [复制桶策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0371.md): 从源桶复制桶策略的操作为增量复制,不会删除当前桶已存在的桶策略。与当前桶中相同名称的桶策略不会复制。源桶和目标桶的桶版本号都必须是3.0。源桶中所有与当前桶不同名的桶策略将在复制列表中展示,您可以按需移除不需要复制的桶策略。 - [查看桶策略解析结果](https://support.huaweicloud.com/usermanual-obs/obs_03_0604.md): OBS在桶列表中提供了桶策略配置结果智能解析的能力,桶策略作用于所配置的OBS桶及桶内对象,列表仅统计桶策略的配置结果,不统计ACL。桶策略的配置结果可能会有时延,具体以实际访问结果为准。 - [配置对象策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0075.md): 对象策略是桶策略针对对象的策略,选中对象后配置该对象的对象策略。对象策略的资源为选中的对象,对应的动作和条件为桶策略中针对对象的动作和条件。支持使用模板创建和自定义创建两种方式,您可以根据需要进行选择。使用模板创建:系统预置了多种常用典型场景的对象策略模板,您可以使用模板快速完成对象策略配置。各模板的详细说明,请参见桶策略参数说明。自定义 - [配置桶ACL](https://support.huaweicloud.com/usermanual-obs/obs_03_0326.md): 配置桶ACL的账号需要是桶的拥有者,或者具备该桶的ACL写权限。OBS支持通过管理控制台、API、SDK、OBS Browser+、obsutil方式配置桶ACL。公共读/公共读写权限切换私有权限,切换后除桶或对象的所有者外,其余用户无访问权限。私有权限切换公共读权限,可以使任何用户在不用身份认证的情况下直接读取桶内的对象,请谨慎操作。私 - [配置对象ACL](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829106.md): 配置对象ACL的账号需要是对象的所有者,或者具备该对象的ACL写权限。对象的所有者是上传对象的账号,而不是对象所属的桶的所有者。例如,如果账号B被授予访问账号A的桶的权限,账号B上传一个文件到桶中,则账号B是对象的所有者,而不是账号A。默认情况下,账号A没有该对象的访问权限,也无法读取和修改该对象的ACL。公共读权限切换私有权限,切换后除 - [服务端加密概述](https://support.huaweicloud.com/usermanual-obs/obs_03_0088.md): 如果您的业务对数据存储的安全性和合规性有较高要求,可使用OBS提供的服务端加密功能,对上传到OBS存储的数据进行加密保护。服务器端加密将对存储在OBS中的静态数据进行加密,即存储介质中存的是数据密文,防止存储介质(如硬盘等)被物理窃取或未授权访问时的数据泄露。在访问对象时,由OBS服务端对文件进行解密,然后返回解密后的数据。OBS支持SS - [SSE-KMS加密(KMS托管密钥)](https://support.huaweicloud.com/usermanual-obs/obs_03_0090.md): SSE-KMS加密方式适用于对合规性、安全性要求较高的场景。SSE-KMS将密钥管理服务KMS和对象存储服务OBS结合起来,KMS为OBS提供密钥,OBS使用密钥加密上传到桶中的数据。该密钥由经过安全认证的第三方硬件安全模块(HSM)产生,对密钥的关键操作都会进行访问控制及日志跟踪,安全性更高。您还可以借助KMS来管理密钥,例如使用KMS - [使用OBS桶密钥降低SSE-KMS成本](https://support.huaweicloud.com/usermanual-obs/obs_03_0091.md): 当您使用SSE-KMS对海量对象进行加密时,每个对象的加密过程都需要OBS调用KMS服务来派生数据加密密钥,这可能会导致大量的请求发送到KMS,从而产生时延和大量的KMS访问流量。通过桶密钥在OBS内部缓存并限时使用的方法可以减少与KMS的交互次数,降低了加解密操作对KMS的流量需求,从而节约成本,提高性能。如图所示,桶密钥原理如下:KM - [SSE-OBS加密(OBS托管密钥)](https://support.huaweicloud.com/usermanual-obs/obs_03_0092.md): 使用SSE-OBS方式加解密时不需要与KMS交互,访问时延更低,性能较SSE-KMS更好,适用于仅需要基础的加密能力的场景,以及批量加密的场景。使用SSE-OBS加密不会产生额外费用,但配置桶或对象使用SSE-OBS加密会产生请求费用。加密后对象的ETag值不是对象明文的MD5值,而是对象密文的MD5值。SSE-OBS支持AES256一种 - [SSE-C加密(用户提供密钥)](https://support.huaweicloud.com/usermanual-obs/obs_03_0093.md): SSE-C是使用客户密钥来进行服务器端加密的方式,适用于需要用户自行保存和管理密钥的场景。使用SSE-C加密不会产生额外费用,但配置对象使用SSE-C加密会产生请求费用。使用SSE-C时,必须严格使用HTTPS协议发送请求,以保证您的密钥安全性,OBS会拒绝非HTTPS的SSE-C相关请求。OBS不会存储您的密钥,如果您丢失了密钥,可能会 - [服务端加密相关接口概览](https://support.huaweicloud.com/usermanual-obs/obs_03_0094.md): OBS支持对已有桶直接设置、获取和删除加密配置,详细API和参数说明参见:设置桶的加密配置、获取桶的加密配置、删除桶的加密配置。同时,OBS还是支持在创桶、上传对象、下载对象、分段上传相关接口、复制对象接口中进行加密设置,下表是相关接口涉及参数的概览: - [多版本控制简介](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829098.md): 对于存储在OBS桶中的文件被误删除或被删除后想找回,以及对于在线协作类产品,文件会被频繁修改而产生大量的临时版本,如果您想找回某个时间点的版本,可以使用多版本控制功能。多版本控制功能会在一个桶中保留多个版本的对象,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。以下介绍多版本控制相关概念及多版本控制的状态。历史版本 - [开启、暂停、查看多版本控制](https://support.huaweicloud.com/usermanual-obs/obs_03_0327.md): 默认情况下,OBS中新创建的桶不会开启多版本功能,向同一个桶上传同名的对象时,新上传的对象将覆盖原有的对象。利用多版本控制,您可以在一个桶中保留多个版本的对象,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据,支持全新开启多版本控制或重新开启已暂停的多版本控制。多版本控制功能开启后不支持关闭,如果您不再使用该功能,可 - [找回已删除对象](https://support.huaweicloud.com/usermanual-obs/obs_03_082103.md): 开启了多版本控制后,如果由于意外操作或应用程序故障导致数据丢失,可以通过以下方法找回丢失的数据:通过复制指定版本的对象,来使得任意历史版本的对象成为当前版本对象。通过彻底删除带删除标记的当前版本,来使得最近一个历史版本对象成为当前版本对象。对象所在桶已开启多版本控制。通过彻底删除带删除标记的对象来找回对象时,要求至少有一个不带删除标记的历 - [清理无历史版本的删除标记以提高性能](https://support.huaweicloud.com/usermanual-obs/obs_03_082104.md): 开启多版本控制后,在对象列表中,未打开“历史版本”开关,单击单个对象右侧操作列的“更多>删除”或选中多个对象并单击上方的“删除”(未指定版本ID删除对象),该删除对象操作并未完全删除对象,OBS将插入一个删除标记,当前版本对象会成为历史版本对象,删除标记成为当前版本,打开对象列表上方的“历史版本”开关即可看到。带删除标记的版本不占用存储空 - [WORM简介](https://support.huaweicloud.com/usermanual-obs/obs_03_0716.md): OBS提供WORM(Write Once Read Many)功能,实现对象在用户指定的时间段内不能被删除和篡改。目前OBS支持桶级和对象级的WORM功能,如果您希望在指定时间内任何用户(包含桶或对象的拥有者)均不能修改和删除OBS桶中的所有对象,您可以配置桶级WORM;如果您希望在指定时间内任何用户(包含桶或对象的拥有者)均不能修改和删 - [配置桶级WORM](https://support.huaweicloud.com/usermanual-obs/obs_03_0718.md): 如果您希望在指定时间内任何用户(包含桶或对象的拥有者)均不能修改和删除OBS桶中的所有对象,您可以配置桶级WORM。本文介绍为桶配置WORM,包含:创建桶时配置WORM、桶创建后配置WORM、取消或修改桶级WORM的默认保留期。桶级WORM开关一旦打开,无法关闭,但可以禁用桶级默认保留期。开启桶级WORM后,无法暂停桶的多版本控制。开启桶 - [配置对象级WORM](https://support.huaweicloud.com/usermanual-obs/obs_03_081703.md): 如果您希望在指定时间内任何用户(包含桶或对象的拥有者)均不能修改和删除OBS桶中的指定对象,您可以配置对象级WORM。本文介绍为对象配置WORM,包含:上传对象时配置WORM、上传对象后配置WORM。桶级WORM策略只对策略生效之后新上传的对象生效,如果要使存量对象也受WORM策略保护,请单独为对象配置对象级WORM。WORM不阻止修改对 - [配置CORS实现跨域访问OBS](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0066036542.md): OBS提供HTML5协议中的CORS设置,帮助用户实现跨域访问。您可以新建CORS规则,也可以从其他桶复制已有CORS规则。在通常的网页请求中,浏览器的同源安全策略(Same Origin Policy,SOP)只允许网页访问相同协议、域名和端口的资源,不同域(协议/域名/端口不同)之间的网站脚本和内容是无法进行交互的,即由于JavaSc - [配置防盗链防止非法流量盗用](https://support.huaweicloud.com/usermanual-obs/obs_03_0341.md): OBS提供同时支持允许白名单访问和阻止黑名单访问的配置,防止盗链。一些不良网站为了不增加成本而扩充自己站点内容,经常盗用其他网站的链接。一方面损害了原网站的合法利益,另一方面又加重了服务器的负担。因此,产生了防盗链技术。在HTTP协议中,通过表头字段referer,网站可以检测目标网页访问的来源网页。有了referer跟踪来源,就可以通过 - [配置双端固定实现VPC粒度的访问控制](https://support.huaweicloud.com/usermanual-obs/obs_03_0602.md): 使用“双端固定”特性,可以对OBS中的资源提供VPC粒度的权限控制,确保云上数据在一个安全的网络环境内传输,降低未授权访问风险。双端固定适用于以下场景:保护重要数据不通过公网传输,只有指定用户可以通过内网访问。例如,医疗行业存储在OBS中的医疗影像、电子病例等敏感信息,由于合规要求不能在公网传输,只能由华为云某个特定VPC中的服务器(EC - [阻止桶公共访问](https://support.huaweicloud.com/usermanual-obs/obs_03_0739.md): 公共访问是指请求者无需拥有特定权限或身份验证即可访问桶和桶内数据,存在数据泄露和恶意访问导致大量外网流量的风险。为了避免这些风险,OBS支持为桶配置阻止公共访问功能(Block Public Access),以确保数据的安全性。借助BPA,桶拥有者可以集中轻松限制资源的公共访问。当前功能仅部分区域支持(例如华东-青岛、拉美-墨西哥城一等) - [使用Https双向证书认证建立安全传输通道](https://support.huaweicloud.com/usermanual-obs/obs_03_100530.md): 通过自定义域名访问OBS时,使用Https双向证书认证的安全机制,可在客户端和OBS服务端之间建立数据安全传输通道,确保只有合法的、获得授权的用户可以查看数据,防止数据泄露和篡改。Https双向证书认证适用于金融、医疗、政府与公共服务、企业数据管理等对数据安全性要求较高的场景。例如存储在OBS中的医院患者的医疗影像信息,双向证书认证可实现 - [限制TLS版本以保护通信安全](https://support.huaweicloud.com/usermanual-obs/obs_13_0038.md): OBS广泛应用于企业数据存储、备份、静态网站托管、视频点播等场景,客户端与OBS之间的数据传输过程依赖TLS协议实现加密防护,保障数据传输安全。OBS支持多个TLS版本(包括TLS 1.0、TLS 1.1、TLS1.2、TLS1.3),同时支持使用桶策略限制访问OBS的TLS版本。在进行TLS相关配置操作前,您可能需要了解TLS及其版本的 - [桶的域名管理概述](https://support.huaweicloud.com/usermanual-obs/obs_41_0060.md): 与OBS桶相关的域名有桶的自定义域名、桶的加速域名、桶默认域名。当您使用桶默认域名访问桶中的文件时,会变为强制下载,无法在线预览。如果您不希望暴露桶的默认域名或希望在浏览器中可以在线预览文件,那么可以为桶绑定自定义域名,通过自定义域名访问桶中的文件;除此之外,如果您还希望通过自定义域名加速访问桶中的文件,您可以为桶绑定CDN加速域名。如果 - [通过自定义域名访问桶](https://support.huaweicloud.com/usermanual-obs/obs_03_0032.md): 当您将文件上传至OBS桶后,OBS会使用桶的默认域名自动生成文件的访问地址,使用浏览器访问该地址时,会强制下载文件。如果您不希望暴露桶的默认域名或希望在浏览器中可以在线预览文件,那么您可以为桶绑定自定义域名,通过自定义域名访问桶中的文件。域名可靠性增强:保护您的业务不受其他域名管控活动的干扰。当华为云基础域名( myhuaweicloud - [通过CDN加速域名访问桶](https://support.huaweicloud.com/usermanual-obs/obs_03_0600.md): 现在越来越多的行业使用OBS存储图片、视频、软件包等静态资源文件,并将OBS作为网站、论坛、APP、游戏等业务的存储源。在需要获取这些静态资源时,用户会通过URL直接从OBS请求数据,但一般情况下文件只存储在一个区域,距离文件存储区域较远的用户访问OBS时,响应速度可能会比较慢。同时,在需要频繁访问的场景下,直接访问OBS来获取相应文件, - [为桶的CDN加速域名配置自动刷新策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0097.md): CDN加速功能将存储在OBS中的数据缓存到终端用户附近的CDN节点上,让身处各地的终端用户都可以快速访问存储在OBS中的数据。当用户需要更新OBS中存储的数据时,CDN中缓存的过时数据也需要进行更新,可以使用CDN自动刷新功能来自动通知CDN去更新数据。因此,通过配置自动刷新策略,可以保证CDN节点上的缓存数据和源站(OBS)的数据一致。 - [证书托管](https://support.huaweicloud.com/usermanual-obs/obs_06_3200.md): 如果您需要通过HTTPS的方式访问桶的自定义域名,那么您需要为自定义域名配置对应的证书。在 HTTPS 协议中,数字证书是确保通信安全、数据完整性和身份验证的核心组件,其重要性主要体现在以下几个方面:身份验证,确保服务器身份可信。可防止中间人攻击,通过证书验证服务器的真实身份,避免用户连接到伪造的钓鱼网站。在某些场景(如企业内部系统)中, - [使用IPv6访问OBS](https://support.huaweicloud.com/usermanual-obs/obs_06_3201.md): OBS除支持IPv4外,还支持使用IPv6访问OBS桶。双栈域名是指一个互联网域名(如 www.example.com)在域名系统(DNS)中同时配置了IPv4和IPv6两种地址记录。用户访问该域名时,DNS会根据访问者自身的网络能力,提供最合适的IP地址:如果用户的网络和设备支持更新的IPv6,则将其解析到IPv6地址(格式如:2001 - [生命周期概述](https://support.huaweicloud.com/usermanual-obs/obs_03_0335.md): 使用OBS“基于最后一次修改时间”的生命周期功能可实现定时转换对象的存储类别和定时删除桶中的对象。“转换”表示在不复制原对象的情况下自动将某些不再频繁访问的对象转换为成本更低的存储类别,以减少您的存储费用。关于生命周期规则的元素组成和语法说明可参考生命周期元素说明配置生命周期规则的具体步骤参见配置生命周期规则更多生命周期规则示例可参考生命 - [使用生命周期删除和转换对象存储类别的规则](https://support.huaweicloud.com/usermanual-obs/obs_41_0072.md): 本节介绍使用生命周期定时转换对象存储类别、删除对象的规则。归档存储和深度归档存储不支持多AZ,因此不支持使用生命周期将多AZ桶中对象的存储类别转化为归档存储或深度归档存储。如图所示,OBS支持通过生命周期实现以下场景的存储类别自动转换:标准存储->低频访问存储、归档存储、深度归档存储低频访问存储->归档存储、深度归档存储归档存储->深度归 - [配置生命周期规则](https://support.huaweicloud.com/usermanual-obs/obs_41_0074.md): 本章节将介绍如何配置生命周期规则。生命周期规则目前仅支持根据前缀和对象标签进行匹配,不支持通配符匹配、后缀匹配以及正则匹配。单个桶的生命周期规则条数没有限制,但单个桶中所有生命周期规则的XML描述总大小不能超过20KB。您最多可以在一个并行文件系统下配置20条生命周期管理规则,超过20条将提示不支持。设置桶的生命周期配置为覆盖语义,修改桶 - [生命周期配置示例](https://support.huaweicloud.com/usermanual-obs/obs_41_0075.md): 如果您的使用方式为API或SDK,请参考以下xml示例。示例1:生命周期将应用于存储桶内的所有对象如果需要适用于桶中的全部对象,需要指定一个空前缀。以下规则适用于桶中的全部对象,在对象创建100天后将其转换为归档存储类型。xml:示例2:基于对象名前缀指定筛选条件筛选条件指定了一个对象名前缀(texta/),以下生命周期规则将应用于对象名 - [生命周期元素说明](https://support.huaweicloud.com/usermanual-obs/obs_41_0073.md): 本章节以一个典型的配置示例为例,说明生命周期规则的元素组成,示例如下:一条完整的生命周期规则由规则元数据、规则的对象筛选条件和规则执行的动作和时间3个关键元素组成:规则元数据说明规则ID以及规则状态:规则的对象筛选条件说明生命周期规则的操作目标是哪些对象:下表参数说明在什么时间点开始执行生命周期规则,以及针对目标对象执行的动作是什么:单条 - [桶清单](https://support.huaweicloud.com/usermanual-obs/obs_03_0084.md): 当您的桶中对象数量多达数百万甚至数百亿时,通过列举桶中对象逐一列举对象效率很低且成本高。OBS提供桶清单功能,以定期生成桶内对象的相关信息(如大小、上次修改时间、存储类别)的清单文件,并将清单文件上传到您指定的桶中,方便您管理桶内海量对象。桶清单功能按照一定周期生成桶内对象的相关信息,保存在CSV格式的文件中,并上传到您指定的桶中。支持对 - [使用EG发送OBS事件通知](https://support.huaweicloud.com/usermanual-obs/obs_06_19_05.md): 在对桶及桶中的对象执行某些操作后,如果您希望能够及时感知,进而触发后续操作流程,那么可以通过EG事件通知来实现。例如:您需要向源桶中上传图片后,自动触发后续流程执行为图片添加水印,并将添加水印后的图片存放至目标桶中,那么可以通过配置EG事件通知来实现。对象存储服务(Object Storage Service,OBS)用于存储文件、图片、 - [使用DIS发送OBS事件通知](https://support.huaweicloud.com/usermanual-obs/obs_03_0147.md): 本节介绍如何在OBS管理控制台配置DIS通知。您可以新建DIS通知规则,也可以从同区域的其他桶复制已有DIS通知规则。OBS提供的DIS通知功能,主要面向大数据场景,要求OBS与数据接入服务(DIS)及其他大数据相关服务结合使用。当OBS桶中触发了对象上传、下载、删除等操作事件时,OBS将事件通知发送给DIS,再通过DIS通道将通知分发给 - [使用镜像回源获取源站数据](https://support.huaweicloud.com/usermanual-obs/obs_03_0006.md): 一般情况下,当客户端访问OBS时(使用GET请求获取OBS资源),如果OBS中没有被访问的数据,将会返回404错误。OBS提供数据回源功能,可以在被请求的数据不存在时,通过回源规则从源站获取对应数据。用户为桶定义镜像回源规则后,如果客户端访问OBS桶中不存在的资源,且该资源符合镜像回源规则,OBS将以镜像回源的方式去数据源站获取资源,将该 - [静态网站托管](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829093.md): OBS服务允许在桶上托管静态网站,支持索引页、错误页展示和页面跳转。您可以将静态网站文件上传至OBS的桶中,并对这些文件赋予匿名用户可读权限,然后将该桶配置成静态网站托管模式,就可以实现在OBS上托管静态网站了。静态网站通常仅包含静态网页,以及可能包含部分可在客户端运行的脚本,如JavaScript、Flash等。相比之下,动态网站则依赖 - [重定向请求](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0066088957.md): 在使用静态网站托管功能时,OBS还支持配置重定向请求,即您可以将特定的请求或所有请求实施重定向。当网站结构调整、网站地址变化或者网站的扩展名发生变化时,用户使用旧的网站地址(比如收藏夹中的地址)访问网站会访问失败,用户只能得到404页面错误信息。此时网站配置了重定向后,让访问这些域名的用户跳转到设定的页面以避免404错误访问。重定向典型的 - [数据复制概述](https://support.huaweicloud.com/usermanual-obs/obs_10_1001.md): 在数据存储过程中,如果出现故障,会严重影响业务,因此灾备能力对数据存储至关重要。可以使用数据复制来满足灾备要求,数据复制能够满足您将数据复制到其他桶(同区域桶或异地区域桶)进行备份的需求,为您提供数据容灾的能力。数据复制分为:同账号跨区域复制、跨账号跨区域复制、同账号同区域复制、跨账号同区域复制。以下数据复制的源桶和目标桶均为华为云OBS - [使用OBS实现同账号跨区域桶之间数据复制](https://support.huaweicloud.com/usermanual-obs/obs_03_0003.md): 同账号跨区域复制是指通过创建跨区域复制规则,将某个账号某个区域下的源桶中的数据自动、接近实时地复制到相同账号下的另一个区域下的目标桶中。复制到目标桶的对象是源桶中对象的精确副本。本节介绍使用OBS控制台、API、obsutil工具实现同账号跨区域桶之间数据复制。支持复制的对象范围:按前缀匹配来复制符合前缀的对象,也可以复制桶中的所有对象, - [使用OMS实现跨账号跨区域桶之间数据复制](https://support.huaweicloud.com/usermanual-obs/obs_10_1003.md): 跨账号跨区域复制是指将某个账号某个区域下的源桶中的数据复制到其他账号其他区域下的目标桶中。本节介绍使用对象存储迁移服务(Object Storage Migration Service,OMS)的控制台和API以及OBS的obsutil工具实现跨账号跨区域桶之间数据复制。支持复制的对象范围:包括文件/文件夹、对象列表、指定对象前缀、指定时 - [使用OMS实现同账号同区域桶之间数据复制](https://support.huaweicloud.com/usermanual-obs/obs_10_1004.md): 同账号同区域复制是指将某个账号某个区域下的源桶中的数据复制到同一账号同一区域下的目标桶中。本节介绍使用对象存储迁移服务(Object Storage Migration Service,OMS)的控制台和API以及OBS的API、SDK、Browser+工具、obsutil工具实现同账号同区域桶之间数据复制。支持复制的对象范围:指定文件/ - [使用OMS实现跨账号同区域桶之间数据复制](https://support.huaweicloud.com/usermanual-obs/obs_10_1005.md): 跨账号同区域复制是指将某个账号某个区域下的源桶中的数据复制到另一账号同区域下的目标桶中。本节介绍使用对象存储迁移服务(Object Storage Migration Service,OMS)的控制台和API以及OBS的API、SDK、obsutil工具实现跨账号同区域桶之间数据复制。支持复制的对象范围:包括文件/文件夹、对象列表、指定对 - [图片处理概述](https://support.huaweicloud.com/usermanual-obs/obs_01_0001.md): 图片处理特性(Image Processing)是对象存储服务(Object Storage Service,OBS)为用户提供稳定、安全、高效、易用、低成本的图片处理服务,包括:图片瘦身、图片剪切、图片缩放、图片水印、格式转换等。图片处理特性提供OBS管理控制台和RESTful API接口的使用方法,使用户可以在任何时间和地点对存储在对 - [图片处理约束限制](https://support.huaweicloud.com/usermanual-obs/obs_01_0140.md): 所有的图片处理操作均不会修改原图。归档存储不支持图片处理。深度归档存储不支持图片处理。使用SSE-KMS服务端加密的OBS桶不能用做图片处理。当前只有桶版本号为3.0的桶支持图片处理。桶版本号可以在对象存储服务管理控制台上,进入桶概览页后,在“基本信息”中查看。当图片允许匿名访问时,图片处理请求无需携带签名即可通过浏览器访问。例如:htt - [图片处理基本概念](https://support.huaweicloud.com/usermanual-obs/obs_01_0150.md): 样式是将图片处理对图片设置的参数或界面操作设置保存成的一个集合。在对多张图片进行重复相同设置时,可以先创建一个图片样式,在不同的图片套用图片样式,就不需要进行重复的命令操作。每个桶最多支持创建100个样式。Exif(Exchangeable Image File)是“可交换图像文件”的缩写,在一些相机或手机拍摄的图片中会含有Exif信息。 - [开始图片处理(控制台)](https://support.huaweicloud.com/usermanual-obs/obs_01_0211.md): 用户可以在OBS管理控制台图片处理界面通过按钮或编辑代码操作创建图片样式,在图片预览区域预览图片使用相应样式模板的效果,通过复制链接按钮获取使用样式后的图片URL进行使用。您可以通过OBS管理控制台、OBS SDK、RESTful API处理图片。本章简要展示使用管理控制台方式访问和使用图片处理的流程,具体如图1所示。在使用图片处理前,您 - [开始图片处理(API接口)](https://support.huaweicloud.com/usermanual-obs/obs_01_0224.md): OBS提供了REST接口。REST从资源的角度来观察整个网络,分布在各处的资源由URI(Uniform Resource Identifier)确定,而客户端的应用通过URL(Unified Resource Locator)来获取资源。URL的一般格式为:https://Endpoint/uri。用户只需在浏览器地址栏中输入符合图片处理 - [获取图片信息](https://support.huaweicloud.com/usermanual-obs/obs_01_0410.md): 此功能仅支持通过接口调用模式使用。通过此操作可以获取到图片的基本信息:长、宽、以及文件的大小和格式。如果图片包含Exif信息,将按照json格式返回完整的Exif信息。操作名称:info关于图片样式的使用,请参见处理图片。查询example.jpg信息。https://e-share.obs.cn-north-1.myhuaweiclou - [获取图片平均色值](https://support.huaweicloud.com/usermanual-obs/obs_01_0490.md): 此功能仅支持通过接口调用模式使用。通过此操作可以获取图片的平均色值,平均色值将以json格式返回一个十六进制值。操作名称:average-hue关于图片样式的使用,请参见处理图片。获取图片example.jpg的平均色值,可在浏览器直接访问以下地址。https://e-share.obs.cn-north-1.myhuaweicloud. - [设置图片效果](https://support.huaweicloud.com/usermanual-obs/obs_01_0420.md): 此功能支持管理控制台图形界面模式和代码编辑模式使用,也支持通过接口调用模式使用。具体的参数说明如表1所示。操作名称:bright关于图片样式的使用,请参见步骤三:创建图片样式和处理图片。将图片样式的亮度设置为50。https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x- - [设置缩略](https://support.huaweicloud.com/usermanual-obs/obs_01_0430.md): 此功能支持管理控制台图形界面模式和代码编辑模式使用,也支持通过接口调用模式使用。通过resize操作能够使图片按照一定规则进行缩放,支持按照指定宽高和比例进行缩放。关于图片样式的使用,请参见步骤三:创建图片样式和处理图片。关于长短边:长边是指原尺寸与目标尺寸的比值大的那条边,短边同理。例如原图为400px*200px,缩放为100px*1 - [旋转图片](https://support.huaweicloud.com/usermanual-obs/obs_01_0440.md): 此功能仅支持通过管理控制台代码编辑模式和接口调用模式使用。关于图片样式的使用,请参见步骤三:创建图片样式和处理图片。对图片进行旋转设置后,图片将会按顺时针方向进行旋转。具体说明如表1所示。操作名称:rotate旋转后的图片可能会比原图尺寸大。将图片宽度设置为100且旋转角度设置为90。https://e-share.obs.cn-nort - [剪切图片](https://support.huaweicloud.com/usermanual-obs/obs_01_0450.md): 此功能仅支持通过管理控制台代码编辑模式和接口调用模式使用。关于图片样式的使用,请参见步骤三:创建图片样式和处理图片。可以设置图片上的任意一点为起始点,根据指定宽高进行图片剪切,剪切后的图片为矩形。具体说明如表1所示。操作说明:crop剪切原点位置九宫格如图1所示。如果从剪切原点开始设置的x和y坐标大于原图,则剪切无法正常执行,将返回错误。 - [设置水印](https://support.huaweicloud.com/usermanual-obs/obs_01_0460.md): 此功能在管理控制台图形界面模式和代码编辑模式使用,也支持通过接口调用模式使用。关于图片样式的使用,请参见步骤三:创建图片样式和处理图片。可以将文字内容或另一张图片设置为原图的水印。添加水印中的文字内容和字体或图片水印路径均需使用用于URL传输的Base64编码。标准的Base64编码并不适合直接放在URL里传输。用于URL传输的Base6 - [格式转换与渐进显示](https://support.huaweicloud.com/usermanual-obs/obs_01_0470.md): 此功能在管理控制台图形界面模式和代码编辑模式使用,也支持通过接口调用模式使用。关于图片样式的使用,请参见步骤三:创建图片样式和处理图片。可以将原图转换为支持的图片格式,具体说明如表1所示。支持的原图格式:jpg、jpeg、png、bmp、webp、gif、tiff。支持输出的目标图格式:jpg、png、bmp、webp。操作名称:form - [质量变换](https://support.huaweicloud.com/usermanual-obs/obs_01_0480.md): 此功能支持在管理控制台代码编辑模式和接口调用模式使用。关于图片样式的使用,请参见步骤三:创建图片样式和处理图片。质量变换仅支持jpg、webp格式。可以对输出格式为jpg的图片进行图片压缩,不使用压缩则可能会使图片占用的空间变大。具体参数说明如表1所示。操作名称:qualityq参数仅对输出格式为jpg的图片有效。如果同时使用了q和Q参数 - [设置图片瘦身](https://support.huaweicloud.com/usermanual-obs/obs_01_0411.md): 图片瘦身支持通过OBS管理控制台代码编辑模式和接口调用模式使用。关于图片样式的使用,请参见步骤三:创建图片样式和处理图片。图片瘦身是对图片压缩功能的简化,操作原理为输出绝对质量为75%的图片。无需配置参数,通过操作命令即可完成图片瘦身。操作名称:imageslim仅支持对jpg格式的图片进行瘦身。建议在其他图片处理操作后再进行图片瘦身。先 - [处理图片持久化](https://support.huaweicloud.com/usermanual-obs/obs_01_0412.md): 图片处理持久化支持将处理后的图片同步存储至指定的OBS桶中,方便下次直接访问处理后的图片,减少图片处理花费的时间,提升用户体验。图片处理持久化目前仅支持通过接口调用模式使用。关于图片样式的使用,请参见处理图片。在图片处理请求接口中,以参数名=参数值的格式,发送图片处理持久化请求,具体参数说明如表1所示。Java示例代码:ObsClient - [去除图片元信息](https://support.huaweicloud.com/usermanual-obs/obs_06_5017.md): 此功能支持在管理控制台代码编辑模式和接口调用模式使用。关于图片样式的使用,请参见步骤三:创建图片样式和处理图片。通过此操作可以去除图片元信息。操作名称:strip去除图片元信息。https://e-share.obs.cn-north-1.myhuaweicloud.com/example.jpg?x-image-process=imag - [忽略错误](https://support.huaweicloud.com/usermanual-obs/obs_06_5018.md): 此功能支持在管理控制台代码编辑模式和接口调用模式使用。关于图片样式的使用,请参见步骤三:创建图片样式和处理图片。通过此操作可以忽略请求参数非法、图片超过处理限制等错误,直接返回原图。操作名称:ignore-error忽略错误参数。https://e-share.obs.cn-north-1.myhuaweicloud.com/exampl - [配置Data+](https://support.huaweicloud.com/usermanual-obs/obs_03_0353.md): 文档已迁移至数据工坊 DWR,请前往查看。当需要使用OBS提供的Data+服务对OBS内存储的数据,自动进行多项复杂任务(如解析、转码、截图等)处理时,可按照本节指导进行配置。您需要先创建工作流,工作流可以自定义任务处理流程。再为工作流创建事件触发器,事件触发器为工作流设置执行条件,指定桶内什么数据在执行某类操作后开始执行工作流。您可以新 - [自定义函数开发规范](https://support.huaweicloud.com/usermanual-obs/obs_03_0354.md): 文档已迁移至数据工坊 DWR,请前往查看。用户在自行开发自定义函数时,函数的输入参数和输出参数需要遵守本节的开发规范。自定义函数的编译方式请参考FunctionGraph的《开发指南》。Data+工作流执行自定义函数时,函数输入参数的JSON格式的结构体和环境变量的定义如下:函数输入的JSON格式体名称是否必选参数类型说明executio - [预置模板参数说明](https://support.huaweicloud.com/usermanual-obs/obs_03_0361.md): 文档已迁移至数据工坊 DWR,请前往查看。本小节提供Data+各类函数模板及自定义函数的参数配置说明。当前支持的函数模板如下:不同区域支持的预置模板数量不同,请以控制台实际支持的模板为准。模板作用:能准确识别自然图片中数百种场景、上千种通用物体及其属性。让智能相册管理等功能更加直观。该模板实际调用的是Image服务的图像标签接口。模板作用 - [视频转码](https://support.huaweicloud.com/usermanual-obs/obs_03_0449.md): 文档已迁移至数据工坊 DWR,请前往查看。针对使用Data+做视频转码的场景,如果需要每个对象转码任务的参数不同,可通过给对象增加对象元数据(例如:x-obs-meta-transcode-commands: base64(commands)),再使用Data+集成自定义函数的方式来实现。具体的Data+工作流视图如图1所示。算子就是具有 - [在线解压](https://support.huaweicloud.com/usermanual-obs/obs_03_0368.md): OBS支持ZIP包上传后自动解压并存放在指定目录。当您需要一次性上传大量的小文件时,可以将所有文件打包成ZIP包,上传之后压缩包可以自动解压,省时省力。OBS批量上传文件时有一些限制,参见OBS批量上传文件。成功创建在线解压策略后,您上传到OBS的ZIP包如果能匹配解压策略,则会自动解压。创建策略前已存在的ZIP包不受影响。您可以新建在线 - [监控对象存储服务](https://support.huaweicloud.com/usermanual-obs/obs_03_0009.md): 您在使用OBS的过程中会不断发送PUT、GET类的请求,产生上传、下载流量,也可能会遇到服务端返回的错误响应。为使用户更好地掌握OBS桶的状态,华为云提供了云监控服务(Cloud Eye)。您可以使用云监控服务(Cloud Eye)监控自己的OBS桶,执行自动实时监控、告警和通知操作,帮助您跟踪访问桶的请求,分析桶的使用情况,了解桶的业务 - [对象存储服务监控指标说明](https://support.huaweicloud.com/usermanual-obs/obs_03_0010.md): 本节定义了对象存储服务OBS上报云监控服务Cloud Eye的监控指标的命名空间,监控指标列表和维度,用户可以通过CES控制台或API接口来检索对象存储服务产生的监控指标和告警信息。云监控服务最大支持4个层级维度,维度编号从0开始,编号3为最深层级。例如:监控指标中的维度信息为“bucket_name,api_name”时,表示对应的监控 - [对象存储服务支持事件监控的事件说明](https://support.huaweicloud.com/usermanual-obs/obs_03_085003.md): 事件监控提供了事件类型数据上报、查询和告警的功能。方便您将业务中的各类重要事件或对云资源的操作事件收集到云监控服务,并在事件发生时进行告警。SYS.OBS - [创建告警规则](https://support.huaweicloud.com/usermanual-obs/obs_03_085004.md): 当您需要监控OBS资源的使用情况或OBS资源的关键操作时,可以创建告警规则。告警规则添加完成后,当监控指标触发设定的阈值或者指定的事件发生时,云监控服务会在第一时间通过告警通知实时告知您云上OBS资源异常,以免因此造成业务损失。当使用消息通知服务(SMN)发送告警通知时,涉及消息通知费用、外网下行流量费用,计费详情请参见计费说明。设置告警 - [查看监控指标](https://support.huaweicloud.com/usermanual-obs/obs_03_085005.md): 云监控服务实时监控OBS的监控指标和事件,您可以在OBS控制台或云监控服务控制台查看各项指标的详细监控数据,也可以使用云监控服务的API查看监控数据。使用云监控服务提供的监控看板查看监控指标时,请先确保您已创建监控大盘或已创建自定义监控看板。您可以通过OBS控制台或云监控服务控制台查看监控指标和事件监控数据。弹窗中默认展示最近1小时的监控 - [OBS支持审计的关键操作](https://support.huaweicloud.com/usermanual-obs/obs_03_120201.md): 云审计服务(Cloud Trace Service,简称CTS),是华为云安全解决方案中专业的日志审计服务,能够为您提供云服务资源的操作记录,记录的信息包括发起操作的用户身份、IP地址、具体的操作内容的信息,以及操作返回的响应信息。根据这些操作记录,您可以很方便地实现安全审计、问题跟踪、资源定位,帮助您更好地规划和利用已有资源、甄别违规或 - [查询OBS审计事件](https://support.huaweicloud.com/usermanual-obs/obs_03_120202.md): 本节介绍如何在云审计服务控制台查看或导出最近7天的操作事件记录,以及查看转储至OBS桶或LTS中的操作事件记录。以下以创建桶(管理类事件)、上传对象(数据类事件)操作为例,介绍分别在CTS、OBS、LTS存储的审计事件文件内容。更多云审计事件样例,请参见事件样例。云审计事件列表仅支持查看OBS管理类事件(如:创建桶),OBS数据类事件(如 - [桶日志概述](https://support.huaweicloud.com/usermanual-obs/zh-cn_topic_0045829095.md): 访问桶的过程中会产生大量的访问日志,默认情况下,OBS不会为您的桶收集访问日志。如果您需要分析访问桶的用户请求性质、类型或趋势,可以为桶开启日志记录功能,OBS会自动将桶的访问日志按照固定的规则命名,并生成日志文件上传至您指定的日志存储桶(当前桶或同一区域的其他桶)。您可以通过云日志服务(Log Tank Service,LTS)、事件网 - [配置桶的日志记录](https://support.huaweicloud.com/usermanual-obs/obs_03_0329.md): 访问桶时,OBS会为您记录跟桶操作相关的各种请求日志,为桶配置日志记录后,产生的桶日志记录会被存储至同账号同区域下的同一个桶或其他桶中,便于您通过检索和分析日志来完成异常事件回溯和定位等工作。本文档提供配置桶日志、验证桶日志配置、关闭桶日志等操作指导。OBS支持通过管理控制台、API、SDK方式配置桶的日志记录,不支持通过OBS Brow - [并行文件系统概述](https://support.huaweicloud.com/usermanual-obs/obs_13_0007.md): 并行文件系统(Parallel File System)是对象存储服务(Object Storage Service,OBS)提供的一种经过优化的高性能文件语义系统,旨在为基于对象存储服务作为统一数据湖存储的大数据场景提供解决方案。并行文件系统提供毫秒级别访问时延、TB/s级别带宽和百万级别的IOPS、高兼容性、高性能、高可扩展性、高可靠 - [并行文件系统支持的特性](https://support.huaweicloud.com/usermanual-obs/obs_13_0012.md): 本节主要介绍并行文件系统和已有的OBS API的兼容情况,并对部分兼容的API进行差异说明。关于OBS各个API接口的详细介绍,请参见《对象存储服务API参考》。并行文件系统的权限配置与对象存储权限配置应用场景与主要功能一致,更多信息可参照权限配置指南。需要精确匹配指定目录时,策略中的资源路径需要以“/”结束。因为并行文件系统做权限检查时 - [并行文件系统约束限制](https://support.huaweicloud.com/usermanual-obs/obs_13_0009.md): 操作限制不支持将已有的OBS桶修改为并行文件系统,创建并行文件系统方法请参见创建并行文件系统。不支持控制台设置并行文件系统的自定义域名,API设置方法参见设置自定义域名。功能限制暂不支持通过图片处理特性对存放在并行文件系统中的图片进行瘦身、缩放、添加水印等操作。暂不支持服务端加密暂不支持跨区域复制暂不支持多版本控制暂不支持配置桶清单暂不支 - [创建并行文件系统](https://support.huaweicloud.com/usermanual-obs/obs_13_0002.md): 用户可以通过控制台创建并行文件系统。单击“选择源并行文件系统”后,可以在并行文件系统列表中选择一个源并行文件系统。确认选择后页面会自动复制源并行文件系统的以下配置信息:区域 / 数据冗余策略 / 策略 / 服务端加密 / 归档数据直读 / 企业项目 / 标签。选择后您仍可以根据业务情况对复制的配置信息进行部分或全部更改。并行文件系统创建成 - [本地可用区OBS和本地可用区PFS](https://support.huaweicloud.com/usermanual-obs/obs_03_0194.md): 本地可用区OBS是部署在智能边缘云(IEC)上的桶,提供了非结构化数据本地存储、本地访问、以及本地处理的能力。通过该种方式将OBS部署到企业现场,您可以在本地可用区OBS中创建存储空间,达到降低访问时延、实现数据本地化留存及本地系统交互、提升业务体验。本地可用区PFS是部署在智能边缘云(IEC)上的并行文件系统,并行文件系统是OBS提供的 - [OBS ON 智能边缘小站简介](https://support.huaweicloud.com/usermanual-obs/obs_03_0709.md): OBS智能边缘小站提供了非结构化数据本地存储、本地访问、以及本地处理的能力。您可以在OBS智能边缘小站中创建存储空间。OBS智能边缘小站在物联网、智能汽车驾驶、客户本地数据处理和智慧园区等场景下有很广泛的用途,是公有云业务形态的重要组成部分。在此类业务场景下,对象存储下沉支撑客户数据本地存储,支撑客户敏感数据本地化诉求、数据就近快速处理诉 - [创建桶](https://support.huaweicloud.com/usermanual-obs/obs_03_0702.md): 您可以通过OBS管理控制台创建桶。桶是OBS中存储对象的容器。您需要先创建一个桶,然后才能在OBS中查看存储数据。您的账号及账号下的所有子用户共可创建的桶+并行文件系统+OBS智能边缘小站文件系统的上限为100个。边缘小站:CloudPond云服务中用于管理线下部署站点的逻辑概念。一个边缘小站关联一个华为云指定的区域和一个用户指定的部署位 - [配置生命周期规则](https://support.huaweicloud.com/usermanual-obs/obs_03_0703.md): 您可以为某个桶或某些对象设置生命周期规则。标准对象可以转换为低频访问、归档对象或深度归档对象。低频访问对象可以转换为归档对象或深度归档对象。归档对象可以转换为深度归档对象。指定对象过期删除。深度归档对象不能通过设置生命周期规则来转换存储类别。您可以新建生命周期规则,也可以从其他桶复制已有生命周期规则。或您可以直接在左侧导航栏单击“基础配置 - [配置跨域资源共享](https://support.huaweicloud.com/usermanual-obs/obs_03_0706.md): OBS提供HTML5协议中的CORS设置,帮助用户实现跨域访问。您可以新建CORS规则,也可以从其他桶复制已有CORS规则。或您可以直接在左侧导航栏单击“访问权限控制>CORS规则”,进入“CORS规则”界面。一个桶最多可设置100条CORS规则。如果该OBS桶同时开启了CDN加速,CDN侧需配置HTTP header,详见HTTP he - [配置防盗链](https://support.huaweicloud.com/usermanual-obs/obs_03_0704.md): OBS提供同时支持允许白名单访问和阻止黑名单访问的配置,防止盗链。Referer规则如下:白名单Referer/黑名单Referer输入的字节数不能超过1024个字符。Referer格式:Referer可以设置多个,多个Referer换行隔开;Referer参数支持通配符(*)和问号(?),通配符可代替0个或多个字符,问号可代替单个字符; - [配置桶标签](https://support.huaweicloud.com/usermanual-obs/obs_03_0705.md): 您可以在创建桶时,配置其标签,详见创建桶。您也可以在桶创建后,再配置其标签。本章节介绍桶创建后标签的配置方法。或您可以直接在左侧导航栏单击“基础配置>标签”,进入“标签”界面。设置桶标签后,大约需要等待3分钟才能生效。您可以单击“编辑”,修改标签的“值”;也可以单击“删除”,删除标签。 - [配置桶的日志记录](https://support.huaweicloud.com/usermanual-obs/obs_03_0715.md): 当一个桶开启了日志记录功能后,OBS自动将该桶的日志按照固定的命名规则,生成一个对象写入用户指定的桶。启用日志记录功能后,生成的日志文件根据如下规则命名:<日志文件前缀>YYYY-mm-DD-HH-MM-SS-<日志文件前缀>为用户指定的日志文件日志存储前缀。YYYY-mm-DD-HH-MM-SS为日志生成的日 - [配置桶ACLs](https://support.huaweicloud.com/usermanual-obs/obs_03_0707.md): 配置桶ACL的账号需要是桶的拥有者,或者具备该桶的ACL写权限。公共读/公共读写权限切换私有权限,切换后除桶或对象的所有者外,其余用户无访问权限。私有权限切换公共读权限,可以使任何用户在不用身份认证的情况下直接读取桶内的对象,请谨慎操作。私有权限切换公共读写权限,可以使任何用户在不用身份认证的情况下直接读/写/删桶内的对象,请谨慎操作。输 - [使用模板创建桶策略](https://support.huaweicloud.com/usermanual-obs/obs_03_0710.md): OBS管理控制台预置了八种常用典型场景的桶策略模板,用户可以使用模板创建桶策略,快速完成桶策略配置。部分桶策略模板需要指定被授权用户或资源范围,请根据界面提示完成桶策略配置。您也可以在原有模板基础上修改策略名称、被授权用户、授权资源、动作以及条件。相关说明请参见桶策略参数说明。 - [自定义创建桶策略(可视化视图)](https://support.huaweicloud.com/usermanual-obs/obs_03_0711.md): 你可以根据实际业务场景的定制化需求,不使用预置桶策略模板,自定义创建桶策略。自定义桶策略由效果、被授权用户、资源、动作和条件5个桶策略基本元素共同决定。详细请参见桶策略参数说明。 - [自定义创建桶策略(JSON视图)](https://support.huaweicloud.com/usermanual-obs/obs_03_0712.md): 熟悉JSON以及OBS桶策略语法结构的用户,可以直接使用JSON视图编辑桶策略。单个桶的桶策略条数(statement)没有限制,但一个桶中所有桶策略的JSON描述总大小不能超过20KB。 ## 权限配置指南 - [OBS不同权限控制方式的区别](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0001.md): 默认情况下,OBS的资源(桶和对象)都是私有的,只有资源拥有者可以访问OBS资源,其他用户在未经授权的情况下均无OBS访问权限。OBS的权限控制是指通过编写访问策略向其他账号或者IAM用户授予资源的控制权限。例如,你拥有一个桶,你可以授权一个其他的IAM用户上传对象到你的桶中;你也可以将桶开放给非公有云用户访问,即桶作为一个公共资源,能被 - [一张图看懂OBS权限控制](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0040.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [IAM权限配置概述](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0053.md): 默认情况下,管理员创建的IAM用户没有任何权限,需要将其加入用户组,并给用户组授予策略和角色,才能使得用户组中的用户获得策略定义的权限,这一过程称为授权。授权后,用户就可以基于被授予的权限对云服务进行操作。对于OBS,IAM权限作用于OBS所有的桶和对象。如果要授予IAM用户操作OBS资源的权限,则需要向IAM用户所属的用户组授予一个或多 - [基于角色与策略的授权](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0054.md): OBS服务支持基于角色与策略授权的授权模型。默认情况下,管理员创建的IAM用户没有任何权限,需要将其加入用户组,并给用户组授予策略或角色,才能使得用户组中的用户获得对应的权限,这一过程称为授权。授权后,用户就可以基于被授予的权限对云服务进行操作。如果您通过IAM授权时,没有指定具体的桶和对象,那么使用IAM授予的权限对所有桶生效。如表1所 - [基于身份策略的授权(IAM新版)](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0055.md): OBS服务支持基于身份策略授权的授权模型。如表1所示,包括了OBS基于身份策略授权中的所有系统策略。身份策略授权的系统策略,和角色与策略授权的系统策略并不互通。例如,如果您使用基于身份策略的授权方式给用户授权,那么配置策略时,策略中的action需要使用基于身份策略的授权项,并使用基于身份策略的条件键和运算符。表2列出了OBS常用操作与系 - [桶策略概述](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0004.md): 桶策略是作用于所配置的OBS桶及桶内对象的。OBS桶拥有者通过桶策略可为IAM用户或其他账号授权桶及桶内对象的操作权限。创建桶和获取桶列表这两个服务级的操作权限,需要通过IAM权限配置。桶策略模板:OBS控制台预置了八种常用典型场景的桶策略模板,用户可以使用模板创建桶策略,快速完成桶策略配置。选择使用模板创建时,部分模板需要指定被授权用户 - [桶策略参数说明](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0041.md): 一个Policy由JSON描述,格式定义为:实例如下所示:{ "Statement" : [{ "Sid": "ExampleStatementID1", "Principal": "*", "Effect": "Allow", "Action": ["ListBucket"], - [示例:使用桶策略限制访问IP](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0056.md): 只允许某些特定IP访问OBS桶,或者拒绝指定IP访问桶,可以防止来自恶意IP地址或IP段的攻击,如网络攻击者的暴力破解、网络扫描、恶意软件传播等,降低系统被入侵和数据泄露的风险。对于存储敏感数据的OBS桶,如商业机密、用户个人信息、银行账户信息等,通过限制IP访问,可以确保只有授权的IP地址能够访问数据,增强数据的保密性和完整性。通过限制 - [ACL](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0005.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。OBS ACL是基于账号级别的读写权限控制,且主要用于授予基本的读/写权限,权限控制细粒度不如桶策略和IAM权限。一般情况下,建议使用IAM权限和桶策略进行访问控制。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶 - [通过永久访问密钥访问OBS](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0007.md): OBS的REST接口既支持认证请求,也支持匿名请求。匿名请求通常仅用于需要公开访问的场景,例如静态网站托管。除此之外,绝大多数场景是需要经过认证的请求才可以访问成功。经过认证的请求总是需要包含一个签名值,该签名值以请求者的访问密钥(AK/SK)作为加密因子、结合请求体携带的特定信息计算而成。计算签名的过程已经包含在SDK中,使用者只需将访 - [通过临时访问密钥访问OBS](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0008.md): OBS可以通过IAM获取临时访问密钥(临时AK,SK和securitytoken)进行临时授权访问。通过使用临时AK,SK和securitytoken,您可以为第三方应用或IAM用户颁发一个自定义时效和权限的访问凭证。您可以通过调用IAM的获取临时AK/SK和securitytoken接口获取临时AK/SK和securitytoken。临 - [通过临时URL访问OBS](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0009.md): 您可以通过临时URL访问OBS,对桶或对象进行创建桶、上传对象和下载对象等操作,详细示例可参考使用URL进行授权访问。本章节主要详细介绍如何通过临时URL分享对象。OBS提供分享功能,将存放在OBS中对象(文件或文件夹)限时分享给所有用户。文件分享文件分享强调临时性,所有分享的URL都是临时URL,存在有效期。临时URL是由文件的访问域名 - [通过IAM委托换取临时访问密钥访问OBS](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0010.md): IAM委托为统一身份认证服务IAM的功能特性,OBS在部分使用场景中(如CDN私有桶回源、跨区域复制),需要使用IAM委托功能,授予其他账号或云服务访问OBS的权限,替委托方管理OBS资源,实现安全高效的代维工作。使用OBS的跨区域复制、桶日志功能,需要使用委托:在创建跨区域复制规则时,需要选择或新建一个委托,授予OBS相关权限,才可以执 - [权限典型场景一览](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0011.md): 我们提供了如下典型的权限场景,帮助您顺利完成OBS权限配置。场景分类的总体思路为:对谁授权:主要分为单个IAM用户、多个IAM用户或用户群组、其他账号、匿名用户对什么资源授权:主要分为所有OBS资源(服务级权限)、指定桶、指定对象等授予什么权限:案例中聚焦一些基础的权限,如读权限、读写权限等,您可以根据实际业务情况扩展您可以根据上述思路, - [对单个IAM用户授予创建桶和列举桶的权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0014.md): 本案例介绍如何为华为云账号下的某个IAM用户授予OBS创建桶和列举桶的权限。拥有本权限的IAM用户可以创建桶,创建的桶仍然属于IAM用户对应的账号。同时该IAM用户也可以看到账号下的所有桶。创建桶和列举桶属于OBS服务级别权限,只能通过IAM权限实现,推荐使用IAM自定义策略。按照IAM文档指导,将前面步骤创建的自定义策略添加到用户组中。 - [对单个IAM用户授予桶的读写权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0015.md): 本案例介绍如何为华为云账号下的某个IAM用户授予OBS桶的读写权限。对单个IAM用户授予资源级别权限,推荐使用桶策略。本案例预置的“桶读写”模板允许指定IAM用户对整个桶及桶内所有对象执行除以下权限以外的所有权限:DeleteBucket:删除桶PutBucketPolicy:设置桶策略PutBucketAcl:设置桶ACL按照本案例配置 - [对单个IAM用户授予桶的指定操作权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0016.md): 本案例介绍如何为华为云账号下的某个IAM用户授予OBS桶的指定操作权限,此处以授予删除桶的权限为例。如果需要配置其他指定的权限,在桶策略的动作名称中选择对应动作即可。OBS支持的动作对单个IAM用户授予资源级别权限,推荐使用桶策略。按照本案例配置后,可以正常通过API或SDK完成桶删除操作,但如果通过控制台或OBS Browser+登录桶 - [对单个IAM用户授予指定对象的读权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0017.md): 本案例介绍如何为华为云账号下的某个IAM用户授予OBS桶中某个对象或某类对象的读权限。对单个IAM用户授予资源级别权限,推荐使用桶策略。本案例预置的“对象只读”模板允许指定IAM用户对桶内指定对象执行以下权限:GetObject:获取对象内容、获取对象元数据GetObjectVersion:获取指定版本对象内容、获取指定版本对象元数据Ge - [对单个IAM用户授予指定对象的指定操作权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0018.md): 本案例介绍如何为华为云账号下的某个IAM用户授予OBS桶中指定对象的指定操作权限,此处以授予下载对象的权限为例。如果需要配置其他指定的权限,在桶策略的动作名称中选择对应动作即可。OBS支持的动作对单个IAM用户授予资源级别权限,推荐使用桶策略。按照本案例配置后,可以正常通过API或SDK完成对象下载操作,但如果通过控制台或OBS Brow - [对IAM用户组授予OBS所有资源的所有操作权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0020.md): 本案例介绍如何为华为云账号下的多个IAM用户或用户群组授予OBS所有资源的所有操作权限。拥有本权限的IAM用户可以执行任何OBS操作。IAM自定义策略按照IAM文档指导,将前面步骤创建的自定义策略添加到用户组中。由于缓存的存在,授予OBS相关的策略后,大概需要等待10~15分钟策略才能生效。 - [对IAM用户组授予OBS所有资源的基本操作权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0021.md): 本案例介绍如何通过IAM预置的与OBS相关的系统角色和策略,为华为云账号下的多个IAM用户或用户群组授予OBS所有资源的基本操作权限。预置的系统角色和策略所支持的权限如下表所示。IAM系统角色/策略按照本案例配置系统角色或策略后,如果通过控制台或OBS Browser+登录,可能会出现无权限的相关提示信息。即使界面出现了权限不足的提示,也 - [对IAM用户组授予OBS所有资源的指定操作权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0022.md): 本案例介绍如何为华为云账号下的多个IAM用户或用户群组授予OBS所有资源的指定操作权限。IAM自定义策略按照本案例配置后,可以正常通过API或SDK完成权限所允许的操作,但如果通过控制台或OBS Browser+登录,可能会出现无权限的相关提示信息。报错原因:通过控制台或者OBS Browser+登录后,加载桶列表时会调用获取桶列表(Li - [对IAM用户组授予OBS指定资源的指定操作权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0023.md): 本案例介绍如何为华为云账号下的多个IAM用户或用户群组授予OBS指定资源的指定操作权限,资源可以具体到某个桶或对象。IAM自定义策略按照本案例配置后,可以正常通过API或SDK完成权限所允许的操作,但如果通过控制台或OBS Browser+登录,可能会出现无权限的相关提示信息。报错原因:通过控制台或者OBS Browser+登录后,加载桶 - [对IAM用户组授予OBS指定文件夹的指定操作权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0044.md): 本案例介绍如何为华为云账号下的多个IAM用户或用户群组授予OBS某个桶下指定文件夹的指定操作权限。IAM自定义策略按照本案例配置后,可以正常通过API或SDK完成权限所允许的操作,但如果通过控制台或OBS Browser+登录,可能会出现无权限的相关提示信息。报错原因:通过控制台或者OBS Browser+登录后,加载桶列表时会调用获取桶 - [对其他账号授予桶的读写权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0025.md): 本案例介绍如何为其他华为云账号授予OBS桶的读写权限。这里的账号指华为云账号本身,不包含账号下的IAM用户,如果要为IAM用户授权,请参见对其他账号下的IAM用户授予桶和桶内资源的访问权限。对其他账号授权,推荐使用桶策略。本案例预置的“桶读写”模板允许其他账号对整个桶及桶内所有对象执行除以下权限以外的所有权限:DeleteBucket:删 - [对其他账号授予桶的指定操作权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0026.md): 本案例介绍如何为其他华为云账号授予OBS桶的指定操作权限。这里的账号指华为云账号本身,不包含账号下的IAM用户,如果要为IAM用户授权,请参见对其他账号下的IAM用户授予桶和桶内资源的访问权限。此处以授予设置桶ACL和获取桶ACL的权限为例。如果需要配置其他指定的权限,在桶策略的动作名称中选择对应动作即可。OBS支持的动作对其他账号授权, - [对其他账号下的IAM用户授予桶和桶内资源的访问权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0027.md): 本案例介绍如何为其他华为云账号下的IAM用户授予OBS桶和桶内资源的访问权限。此处以授予上传和下载桶内对象的权限为例。如果需要配置其他指定的权限,在桶策略和给IAM用户授权中配置对应的权限即可。对其他账号下的IAM用户授予桶和桶内资源的访问权限,需要同时配置桶策略和给IAM用户授权。例如要允许账号A下的IAM用户A访问账号B的桶B:首先, - [对其他账号授予指定对象的读权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0028.md): 本案例介绍如何为其他账号授予OBS桶中某个对象或某类对象的读权限。这里的账号指华为云账号本身,不包含账号下的IAM用户,如果要为IAM用户授权,请参见对其他账号下的IAM用户授予桶和桶内资源的访问权限。对其他账号授权,推荐使用桶策略。本案例预置的“对象只读”模板允许其他账号对桶内指定对象执行以下权限:GetObject:获取对象内容、获取 - [对其他账号授予指定对象的指定操作权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0029.md): 本案例介绍如何为其他账号授予OBS桶中指定对象的指定操作权限,此处以授予下载对象的权限为例。如果需要配置其他指定的权限,在桶策略的动作名称中选择对应动作即可。OBS支持的动作这里的账号指华为云账号本身,不包含账号下的IAM用户,如果要为IAM用户授权,请参见对其他账号下的IAM用户授予桶和桶内资源的访问权限。对其他账号授权,推荐使用桶策略 - [对象owner给桶owner授予对象的完全控制权限(对象owner和桶owner不属于同一个账号)](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0057.md): 本案例介绍当桶中对象来源于其他账号(非桶owner上传)时,桶owner如何获取对象的完全控制权限,即对象owner如何给桶owner授予对象的完全控制权限。例如账号A将对象a上传到账号B的桶b中,如何给账号B授予对象a的完全控制权限。在使用云服务的过程中,您可能会遇到如下场景:跨账号上传对象后,基于业务诉求,桶owner需要访问和分析对 - [对所有账号授予桶的公共读权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0031.md): 当某个桶需要授权所有账号访问权限时,可以通过桶策略和桶ACL配置授予所有账号访问桶的权限。本示例以桶策略为例。本案例预置的“公共读”模板允许所有账号(所有互联网用户)对整个桶及桶内所有对象执行以下权限:HeadBucket:判断桶是否存在、获取桶元数据GetBucketLocation:获取桶位置GetObject:获取对象内容、获取对象 - [对所有账号授予指定目录的读权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0032.md): 当一个文件夹下的对象都需要授权所有账号访问权限时,可以通过桶策略配置授予所有账号访问文件夹内对象的权限。本案例预置的“目录只读”模板允许所有账号(所有互联网用户)对指定目录执行以下权限:GetObject:获取对象内容、获取对象元数据GetObjectVersion:获取指定版本对象内容、获取指定版本对象元数据GetObjectVersi - [对所有账号授予指定对象的读权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0033.md): 某公司A使用OBS存储了大量全球各地的地图数据,这些数据需要对外开放供所有人查阅。在这种情况下,该公司便可以为这部分数据设置所有账号的读取权限,然后将这些数据对应的URL公开在互联网上,所有人就可以使用这个URL访问或下载这些公开数据了。本案例预置的“对象只读”模板允许所有账号(所有互联网用户)对桶内指定对象执行以下权限:GetObjec - [向所有账号临时分享对象](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0034.md): 如果希望将对象限时对外开放供所有人查阅,可以通过对象的分享功能实现。此时,链接信息中的链接就已经生效并开始计时,有效期为默认的5分钟。修改URL有效期,链接会相应变化,新链接的有效期从修改时开始计算。单击“打开URL”,将在新页面打开文件进行预览或者直接下载文件到本地。单击“复制链接”,您可以将该链接分享给所有用户,用户可以在浏览器中通过 - [临时授权访问OBS](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0037.md): 本案例介绍如何使用临时访问密钥(临时AK/SK和securitytoken),通过临时授权的方式访问OBS。假设您希望IAM用户(用户名:APPServer)可以访问桶hi-company的APPClient文件夹,并希望申请到两个不同的临时访问密钥分发给终端APP:APP-1和APP-2,其中APP-1仅能访问APPClient/APP - [让IAM用户只能看到被授权的桶](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0038.md): 本章节介绍如何通过企业项目为华为云账号下的某个IAM用户配置指定桶的权限,使其只能在控制台看到授权的桶并且拥有桶的指定权限,无法看到账号下的其他桶,实现桶资源的隔离。本案例将指定IAM用户test-user只能在控制台看到名为example的桶,并且只拥有上传权限(obs:object:PutObject)、列举桶内权限(obs:buck - [限制指定的IP地址访问桶](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0036.md): 本案例介绍如何限制访问OBS桶的源端IP地址,此处以拒绝来源IP为“114.115.1.0/24”网段的客户端访问OBS桶为例。桶策略如果希望限制网段外的IP地址的客户端访问桶,需要参考对所有账号授权对所有账号授予允许访问的权限。使用114.115.1.0/24网段内的IP地址的客户端访问桶,访问被拒绝。使用114.115.1.0/24网 - [部门公共数据权限管理](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0046.md): 企业日常有大量工作文件需要存档,但并不希望花费大量的人力、物力在存储资源上。因此该企业开通了OBS,用于存储日常工作文件,并希望为不同职能部门的员工设置不同的访问权限,以此达到不同部门人员访问公司数据的权限隔离。对于存储在OBS中的部门公共数据,企业希望管理员用户拥有完全控制权限,普通用户仅拥有只读权限,可以在OBS执行基本的数据读取操作 - [部门/项目之间数据共享](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0047.md): 企业不同部门/项目之间需要共享的数据,本部门/项目允许其他部门/项目用户下载共享数据,禁止写删,以降低共享数据被误删、篡改的风险。本文以部门A共享存储在example-bucket桶中的数据给部门B的用户下载为例,介绍如何以最小权限原则对共享数据进行权限控制。在本场景下两个部门的管理员、用户与共享数据桶之间的逻辑关系如图1所示。在此场景下 - [给业务部门授予独立的资源权限](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0049.md): 通常一个企业可能会分设多个业务部门,各业务部门之间的数据需要独立管理。在此场景下,可以考虑给各业务部门分配各自所需的IAM用户,通过桶策略给每个业务部门下的IAM用户授予独立的资源权限。假设某企业下有A和B两个不同的业务部门,希望各业务部门的数据存放在自己的桶中,且各业务部门的用户分别拥有本部门桶的上传权限。在本场景下两个部门的管理员、用 - [业务部门之间桶资源隔离](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0050.md): 按照给业务部门授予独立的资源权限的场景配置,虽然可以实现不同部门用户只能访问本部门的资源,但是每个用户都可以看到企业账号下的所有桶资源,无法做到只能看到自己部门的桶。本节介绍如何通过OBS Browser+添加外部桶的方式实现业务部门之间桶资源隔离。假设某企业下有A和B两个不同的业务部门,希望各业务部门的数据存放在自己的桶中,各业务部门的 - [常见问题](https://support.huaweicloud.com/perms-cfg-obs/obs_40_0051.md): 如何对OBS进行访问权限控制?IAM权限和桶策略访问控制有什么区别?在IAM配置OBS系统权限后仍然提示拒绝访问,请检查相应权限给IAM用户配置了桶读写权限,登录控制台仍然提示拒绝访问,请检查相应权限已配置OBS权限,仍然无法访问OBS(403 AccessDenied) ## 工具指南 - [OBS工具汇总](https://support.huaweicloud.com/tg-obs/obs_09_0001.md): 对象存储服务(Object Storage Service,OBS)提供如表1所示工具,供用户使用。 - [OBS Browser+简介](https://support.huaweicloud.com/browsertg-obs/obs_03_1000.md): OBS Browser+是一款用于访问和管理对象存储服务(Object Storage Service,OBS)的图形化工具,支持完善的桶管理和对象管理操作。OBS Browser+的图形化界面可以非常方便地让用户在本地对OBS进行管理,例如:创建桶、上传下载文件、浏览文件等。OBS Browser+适用于Windows10,Window - [OBS Browser+功能概述](https://support.huaweicloud.com/browsertg-obs/obs_03_1001.md): OBS Browser+支持的功能如OBS Browser+功能列表所示。 - [下载OBS Browser+](https://support.huaweicloud.com/browsertg-obs/obs_03_1003.md): 针对不同操作系统,OBS Browser+下载地址如表1所示。OBS Browser+最新版本将不支持Windows 7, Windows 8 和 Windows 8.1等旧版本的Windows,旧版Windows请使用OBSBrowserPlus_3.22.11-win64版本或OBSBrowserPlus_3.22.11-win32版 - [安装OBS Browser+](https://support.huaweicloud.com/browsertg-obs/obs_03_1005.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [登录OBS Browser+](https://support.huaweicloud.com/browsertg-obs/obs_03_1004.md): 您可以登录OBS Browser+访问华为云OBS云服务,完成桶和对象的相关操作。您也可以通过登录OBS Browser+访问与OBS兼容的其他对象存储服务。具体登录方式请参见表1。为账号开启“编程访问”。开启方法请参见查看或修改IAM用户信息。如果您的网络环境需要通过代理访问,请您在登录前,单击“更多 > 设置”设置网络代理。以下是几种 - [创建桶](https://support.huaweicloud.com/browsertg-obs/obs_03_1041.md): 桶是对象存储中存储对象的容器。您需要先创建一个桶,然后才能在对象存储中存储数据。 - [搜索桶](https://support.huaweicloud.com/browsertg-obs/obs_03_1042.md): OBS Browser+支持按桶名所包含的字符串搜索桶。搜索到的桶会显示在桶列表中。如果想重新搜索其他桶,可单击删除已输入的关键字后重新输入需要搜索的桶名,如图2所示。 - [查看桶的基本信息](https://support.huaweicloud.com/browsertg-obs/obs_03_1043.md): 可以通过OBS Browser+查看桶的基本信息,如桶类型、账户ID、区域和存储用量等。 - [碎片管理](https://support.huaweicloud.com/browsertg-obs/obs_03_1044.md): 对象存储服务采用分块上传的模式上传数据,在下列情况下(但不仅限于此)通常会导致数据上传失败而产生垃圾数据,因此需要清理这些碎片数据来释放空间。网络条件较差,与OBS 对象存储的服务器之间的连接经常断开。上传过程中,人为中断上传任务。设备故障。突然断电等特殊情况。碎片管理功能可以清除由于对象上传失败而产生的垃圾数据。碎片删除后无法恢复,请确 - [删除桶](https://support.huaweicloud.com/browsertg-obs/obs_03_1045.md): 用户可根据需要删除已创建的桶。待删除的桶为空。只有桶的所有者才能删除桶。删除桶之前必须确保桶内的对象已全部删除,并且桶内没有未完成的多段上传任务。用户删除桶后,需要等待30分钟才能创建同名桶和并行文件系统。 - [桶ACL权限简介](https://support.huaweicloud.com/browsertg-obs/obs_03_1048.md): 访问控制列表(Access Control List,ACL)是一个指定被授权者和所授予权限的授权列表。OBS桶和对象的ACL是基于账号的访问控制,默认情况下,创建桶和对象时会同步创建ACL,授权拥有者对桶和对象资源的完全控制权限。OBS的ACL为了实现用户简单实用地授权,包含以下特点:ACL对租户和租户下的用户都生效。桶和对象的拥有者相 - [配置桶ACL权限](https://support.huaweicloud.com/browsertg-obs/obs_03_1049.md): OBS Browser+可以配置拥有者、匿名用户、特定用户对应的ACL权限。当用户新创建一个桶时,如果不指定相应的ACL权限,OBS Browser+自动将该桶设置为仅允许桶的所有者访问,其他任何人无法访问该桶及桶内的对象。 - [配置生命周期管理策略](https://support.huaweicloud.com/browsertg-obs/obs_03_1050.md): 您可以为某个桶定义生命周期管理规则,来为该桶的对象定义各种生命周期规则。更多关于生命周期管理的内容请参考生命周期。状态:勾选“启用”,启用本条生命周期规则。规则名称:用于识别不同的生命周期配置,其长度需不超过255字符。策略:可根据对象名前缀进行匹配,满足该前缀的对象将受生命周期规则管理。也可将生命周期规则配置到整个桶,则桶内所有对象都将 - [桶策略简介](https://support.huaweicloud.com/browsertg-obs/obs_03_1054.md): 桶的所有者可以通过编写桶策略,限定桶的访问权限。桶策略可基于各种条件,如动作、被授权用户、资源和请求的其他要素(如IP地址)提供对桶和对象的集中访问控制。如果资源设置为*,则权限适用于该桶内所有对象。例如,账户可以按以下维度制定策略,授予某用户写权限:给予用户特定的桶的写权限。给予特定的网络中的用户写权限。更多信息请参考桶策略 。 - [配置桶策略](https://support.huaweicloud.com/browsertg-obs/obs_03_1055.md): 桶策略定义了OBS中的资源(桶和对象)的访问控制策略。给账户授予权限。下面的示例,允许账户(账户ID为783fc6652cf246c096ea836694f71855)获取桶logging.bucket3的日志管理信息。{ "Statement": [ { "Sid": "testing", - [挂载外部桶简介](https://support.huaweicloud.com/browsertg-obs/obs_03_1057.md): 当您拥有其他用户的桶的相应ACL权限时,通过挂载外部桶功能,可以通过您的个人账户在本地对该桶进行访问。默认情况下,用户A挂载了用户B的桶后,往挂载的桶中上传的对象,用户B不能进行下载。桶的读写权限可以通过桶ACL和桶策略来授权,桶ACL读写权限授权的操作如下:标准桶策略授权的读写操作权限如下:高级桶策略授权权限时,必须开通的权限为Head - [配置挂载外部桶](https://support.huaweicloud.com/browsertg-obs/obs_03_1058.md): OBS Browser+支持挂载外部桶功能。已获得访问其他用户的桶的相应ACL权限。例如:账户A需要挂载账户B下的桶“bucket_share”以便于读取账户B下的桶“bucket_share”中的对象,则账户B需要先获取账户A的“账户ID”并通过OBS管理控制台先为其设置桶“bucket_share”的“读取权限”。账户A可通过单击目标 - [版本管理](https://support.huaweicloud.com/browsertg-obs/obs_03_2003.md): OBS支持多版本控制,您可以在一个桶中保留对象的多个版本,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。更多多版本相关信息请参见多版本控制。设置桶的多版本状态过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。多版本控制相关问题请参见多版本控制相关常见问题。 - [加密配置](https://support.huaweicloud.com/browsertg-obs/obs_03_2004.md): 设置桶的加密配置,以允许在该桶中上传对象时,采用对应加密配置对数据进行加密,数据会在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。当前Browser+只支持默认KMS密钥。设置桶加密配置过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。安全相关常见问题请参见安全相关常见问题。 - [新建文件夹](https://support.huaweicloud.com/browsertg-obs/obs_03_1060.md): 用户可通过OBS Browser+新建文件夹。由于OBS没有文件系统中的文件和文件夹概念。为了使用户更方便进行管理数据,OBS提供了一种方式模拟文件夹。通过在对象的名称中增加“/”,将该对象在管理控制台上模拟成一个文件夹的形式展现。文件夹名称不能包含以下字符 : \:*?'<>|。文件夹名称不能以英文句号(.)或斜杠(/)开头或结尾。文件 - [浏览文件或者文件夹](https://support.huaweicloud.com/browsertg-obs/obs_03_2005.md): 用户可通过OBS Browser+浏览文件或者文件夹,也可浏览文件对应的更多版本。多版本功能可在用户意外覆盖或删除对象的情况下提供一种恢复手段。用户可以使用多版本功能来保存、检索和还原对象的各个版本,这样用户能够从意外操作或应用程序故障中轻松恢复数据。多版本功能还可用于数据保留和存档。默认列举出来的文件或文件夹只有前100个(按照对象名字 - [文件元数据管理](https://support.huaweicloud.com/browsertg-obs/obs_03_2006.md): 用户可通过OBS Browser+查看以及管理文件的元数据信息。由于OBS没有文件系统中的文件和文件夹概念。多版本功能可在用户意外覆盖或删除对象的情况下提供一种恢复手段。用户可以使用多版本功能来保存、检索和还原对象的各个版本,这样用户能够从意外操作或应用程序故障中轻松恢复数据。多版本功能还可用于数据保留和存档。 - [上传文件或文件夹](https://support.huaweicloud.com/browsertg-obs/obs_03_1061.md): 上传文件操作可将本地文件或文件夹存储至OBS,对象的存储类别默认与桶的存储类别一致。OBS Browser+使用分段上传功能上传文件。通过分段上传功能,OBS Browser+支持上传最大为48.8TB的单个文件。文件或文件夹名称长度不能超过1023字节。(如果有上级目录,加上所有上级目录名长度(目录自动增加/),文件名总长度最大为102 - [搜索文件或文件夹](https://support.huaweicloud.com/browsertg-obs/obs_03_1062.md): OBS Browser+支持按前缀搜索文件或文件夹。搜索到的文件或文件夹会显示到对象列表中。如果想重新搜索其他文件或文件夹,可单击输入框中的删除已输入的关键字后重新输入需要搜索的文件或文件夹名。例如,您需要查找桶“mybucket”中前缀为“testobject”的文件或文件夹,则需先进入桶“mybucket”的对象管理页面,在对象管理页 - [下载文件或文件夹](https://support.huaweicloud.com/browsertg-obs/obs_03_1063.md): 用户可根据需要将存储在OBS上的文件或文件夹下载到本地。对于存储类别为归档存储的桶中的文件,需要确认对象的状态为“已恢复”才能对其进行下载。请参见恢复对象查看如何恢复文件。批量下载仅支持下载当前已经列举出来的文件或文件夹,可以通过下拉触底更新已列举出的文件或文件夹数量,每次触底更新100个。对于存储类别为归档存储的桶中的文件,需要确认对象 - [复制文件或文件夹](https://support.huaweicloud.com/browsertg-obs/obs_03_1064.md): 用户可根据需要将存储在OBS上的文件或文件夹复制到其他路径下。不支持复制外部桶中的文件或文件夹。不支持复制归档存储对象的恢复状态。仅支持将文件或文件夹复制到不同路径下。 - [移动文件或文件夹](https://support.huaweicloud.com/browsertg-obs/obs_03_1065.md): 用户可根据需要将存储在OBS上的文件或文件夹移动到其他路径下。不支持移动外部桶中的文件或文件夹。仅支持将文件或文件夹移动到不同路径下。如果任务在过程中被主动取消或因网络等原因意外中断,该任务将无法自动恢复或继续执行。这种情况可能导致源对象(尚未删除)和目标对象(已复制)同时存在。 - [删除文件或文件夹](https://support.huaweicloud.com/browsertg-obs/obs_03_1066.md): 用户可根据需要删除已有文件或文件夹。删除文件夹时,文件夹内的文件也将同时被删除,请务必确认这些文件可以被删除。删除无用的文件或文件夹可节省空间和成本。用户上传到OBS的某些文件,可能需要定期删除,对于这类删除文件的场景,可通过OBS的生命周期管理功能实现,也可通过OBS的生命周期管理功能一次性清空桶里面所有文件或文件夹。详情请参见配置生命 - [分享文件或文件夹](https://support.huaweicloud.com/browsertg-obs/obs_03_1067.md): 对象URL(对象共享)功能,可实现匿名用户通过对象共享链接地址,直接访问对象数据。已通过OBS管理控制台设置匿名用户读取该指定对象的权限。对象ACL权限设置请参考ACL章节。对于存储类别为归档存储的桶中的对象,如果要让匿名用户通过URL访问,则需要先确认对象的状态是否为“已恢复”。基于安全合规要求,华为云对象存储服务OBS禁止通过OBS的 - [恢复文件或文件夹](https://support.huaweicloud.com/browsertg-obs/obs_03_1068.md): 针对存储类别为归档存储的桶中的对象,用户需要先恢复才能下载。重复恢复归档存储数据时在延长恢复有效期的同时,也将会对恢复时产生的恢复费用进行重复收取。产生的标准存储类别的对象副本有效期将会延长,并且收取延长时间段产生的标准存储副本费用。归档存储是一种很少访问(平均一年访问一次)、但安全、持久且成本极低的存储服务,适用于数据归档和长期备份。客 - [预览文件](https://support.huaweicloud.com/browsertg-obs/obs_03_2007.md): 用户可以预览文件,包括不限于.mp4、.png、.txt等文件。预览时可通过单击左下方按钮进行下载、分享、查看对象元数据、查看/修改对象ACL操作,还可通过右下角按钮切换上一个/下一个对象。 - [管理运行队列](https://support.huaweicloud.com/browsertg-obs/obs_03_1070.md): 任务列表中存在正在运行的任务。 - [管理已暂停队列](https://support.huaweicloud.com/browsertg-obs/obs_03_1071.md): 任务列表中存在正在暂停的任务。 - [管理已完成队列](https://support.huaweicloud.com/browsertg-obs/obs_03_1072.md): 任务列表中存在已完成的任务。建议定期清空“已完成任务”列表,请参考为什么我运行了百万级别的任务后,感觉任务执行较慢?。 - [管理恢复中队列](https://support.huaweicloud.com/browsertg-obs/obs_03_1073.md): 任务列表中存在恢复中的任务。归档存储的对象正在恢复的过程中,不允许暂停或删除恢复任务。对象状态为恢复中的对象不能再次恢复。工具中的“删除”功能只是删除本地任务数据。 - [管理失败队列](https://support.huaweicloud.com/browsertg-obs/obs_03_1074.md): 任务列表中存在失败的任务。失败的任务会自动重试三次。通过查看失败原因可以初步定位问题,如果仍有疑问,可联系华为云智能客服。 - [拖拽上传](https://support.huaweicloud.com/browsertg-obs/obs_03_1075.md): OBS Browser+提供强大的拖拽上传功能,您可以将本地的一个或多个文件或者文件夹拖拽到对象存储的对象列表或者并行文件系统的对象列表中;同时您也可以将文件或文件夹拖拽到指定的目录上,这样可以上传到指定的目录中。拖拽上传可以轻松便捷地帮您把本地文件上传到OBS中。 - [目录分享](https://support.huaweicloud.com/browsertg-obs/obs_03_1076.md): 如果您想将一个文件夹分享给其他人,同时希望能够指定有效期,OBS Browser+提供文件夹分享和授权码登录的功能,轻松为您完成数据分享。首先,您登录OBS Browser+后,选择您要分享的目录右键或者单击操作栏的分享按钮。然后,选择分享链接的有效期,并输入提取码,然后创建分享即可以生成分享链接及二维码。最后,您可以将生成的分享链接信息 - [后台运行](https://support.huaweicloud.com/browsertg-obs/obs_03_1077.md): 后台运行适用场景如果您有大量任务在OBS Browser+中运行,同时希望能够关闭OBS Browser+的UI界面,以方便进行其他操作,同时希望所有的任务能够后台运行。如何进入和结束后台运行您可以单击关闭OBS Browser+工具,并选择后台运行,这时候您的所有任务将进入后台运行模式。当您在系统托盘中双击OBS Browser+的图标 - [定时上传](https://support.huaweicloud.com/browsertg-obs/obs_03_1078.md): OBS Browser+ 提供定时上传功能,您可以将本地磁盘或目录中的一个或多个文件周期性地上传到目标桶的对应路径下。首先进入定时上传页面,单击“立即上传”,进入到“创建定时上传”页面。然后选择目标桶类型、桶路径、本地上传对象,您还可以打开自动上传开关,设置上传周期策略。单击“确定”后,OBS Browser+会在设定的周期开始时自动上传 - [上传/下载性能优化](https://support.huaweicloud.com/browsertg-obs/obs_03_1079.md): OBS Browser+对大于50MB的文件/对象默认采用分段方式进行上传/下载,与分段任务相关的参数都在“系统设置”->“基础设置”中。通常情况下使用分段任务不仅能提高传输效率,还能实现失败任务的断点续传。默认情况下,分段任务的段大小可以勾选“自动调整段大小”自动调整。但在实际操作中,为了进一步提升上传下载性能,可根据文件大小、网络情况 - [代理配置](https://support.huaweicloud.com/browsertg-obs/obs_03_1080.md): 配置代理服务器后让Browser+通过一个专用的服务端进行网络访问,而不是直接连接到网络,它可以帮助您更安全、更高效地访问网络资源。通常,电脑是直接访问网站或服务器的。而当电脑设置了代理后,它会先把所有网络请求都发送给这个“代理服务器”,再由它代为转发给目标网站,最后将结果返回给电脑。这样做通常有两个主要目的:提高安全性与隐私性:目标网站 - [在哪里可以获取AK和SK?](https://support.huaweicloud.com/browsertg-obs/obs_03_1007.md): IAM用户如果希望使用AK/SK访问OBS,必须要账号为其开启“编程访问”。开启方法请参见查看或修改IAM用户信息。在使用Browser+访问OBS时,需要使用AK/SK进行签名验证。AK/SK获取步骤如下:如果已开启操作保护,则需进行此验证。为防止访问密钥泄露,建议您将其保存到安全的位置。 - [如何获取子用户IAM的用户ID?](https://support.huaweicloud.com/browsertg-obs/obs_03_1014.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [是否可以同时装两个不同站点的OBS Browser+工具?](https://support.huaweicloud.com/browsertg-obs/obs_03_1008.md): 不可以。一个系统中只允许安装一个版本的OBS Browser+工具。不同局点提供的OBS Browser+工具可能支持的功能不一致。因此,如果您想使用某一个局点的OBS请下载相应局点的OBS Browser+工具。 - [OBS Browser+与OBS Browser的不同之处?](https://support.huaweicloud.com/browsertg-obs/obs_03_1009.md): OBS Browser+是OBS Browser的升级版,提供全新的UI界面,提供多种登录登出方式,全新的用户体验;OBS Browser+比OBS Browser性能更优,效率更高,体验更佳。 - [OBS Browser+支持迁移OBS Browser保存的账号信息和任务信息吗?](https://support.huaweicloud.com/browsertg-obs/obs_03_1010.md): OBS Browser+ 只支持将OBS Browser保存的账号信息迁移过来,不支持迁移任务信息;同时,OBS Browser+只支持迁移一次,不支持增量迁移;因此,强烈推荐您后期一直使用OBS Browser+。 - [为什么我运行了百万级别的任务后,感觉任务执行较慢?](https://support.huaweicloud.com/browsertg-obs/obs_03_1011.md): 这是因为:OBS Browser+中任务数量达到了百万级别及以上,系统会处于海量查找的状态中,对您机器的性能要求比较高。建议您:为了提升您的体验,建议清理历史任务数据。清理方法是在任务管理窗口,选中已完成任务然后删除,如图1所示。 - [为什么OBS Browser+上显示的桶中对象数量和桶内存储用量与实际的不一致?](https://support.huaweicloud.com/browsertg-obs/obs_03_1012.md): 可能原因如下:数值统计不是实时统计,有一定的延迟。数值统计为估算数值,可能与实际数值存在误差。因此,OBS提供的桶内对象数量和桶存储用量的统计,建议您只作为参考。 - [为什么通过OBS Browser+设置桶ACL后,旧配置中的deliver属性会被覆盖为false?](https://support.huaweicloud.com/browsertg-obs/obs_03_1013.md): OBS Browser+目前不支持设置桶权限的继承关系,如果要使用继承这个特性,请直接使用OBS SDK操作。 - [使用账号登录时,界面提示“没有权限登录”](https://support.huaweicloud.com/browsertg-obs/obs_03_1029.md): 在使用OBS Browser+过程中,如果使用账号登录时提示“没有权限登录”,原因是统一身份认证服务平台认证失败。可按照以下步骤排查解决问题: - [使用账号登录时,界面提示“获取用户的Token失败”](https://support.huaweicloud.com/browsertg-obs/obs_03_1030.md): 在使用OBS Browser+过程中,如果使用账号登录时提示“获取用户的Token失败”,原因是Nodejs限制Http头大小。可尝试设置系统环境变量解决。以Windows 10 64位系统为例,步骤如下:使用该解决方案,会对一些软件使用存在冲突。 - [使用账号登录时,界面提示“账号或者密码错误”](https://support.huaweicloud.com/browsertg-obs/obs_03_1031.md): 在使用OBS Browser+过程中,如果使用账号登录时提示“登录认证失败,账号或者密码错误”,可能原因如下:账号密码输入错误,请检查您的账号密码是否输入正确。如果确认输入的账号密码无误,则可能的原因是您使用的账号为华为账号而非华为云账号,当前由于IAM不支持通过华为账号获取账号Token,因此无法通过华为账号直接登录OBS Browse - [定时上传是否采用增量](https://support.huaweicloud.com/browsertg-obs/obs_03_1033.md): OBS Browser+的定时上传任务默认情况下采用的是增量上传。当周期开始时,OBS Browser+会扫描本地文件与桶中对应路径的对象进行对比。仅在对象不存在,或者对象大小与文件大小不一致,或者对象的最后修改时间早于文件的最后修改时间时才会进行上传。需要注意的是,当修改已有任务的定时上传设置后,会重新创建任务,并覆盖掉原有任务,因此修 - [如何永久分享文件或文件夹](https://support.huaweicloud.com/browsertg-obs/obs_03_1035.md): 通过OBS Browser+工具可以实现分享文件或分享文件夹,通过该方式生成的分享链接中都包含链接的有效时间,超过有效期后即无法通过该链接继续访问。永久分享文件:可通过将对象权限设置为匿名用户读取权限,通过获取对象URL,匿名用户通过该URL地址访问对象数据。永久分享文件夹:可通过配置桶策略指定以目录为前缀的对象权限为公共读权限,即可实现 - [如何访问指定桶或指定目录](https://support.huaweicloud.com/browsertg-obs/obs_03_1036.md): 背景:使用Browser+的过程中,在某些业务场景下,您登录的AK,SK仅有访问某个桶或者某个桶内指定路径的权限,在这种情况下如果直接使用AK、SK登录,由于缺乏获取桶列表等操作的权限,会导致登录时提示权限不足。解决办法:针对以上场景,Browser+工具支持您在登录时指定访问路径,访问路径的格式为:obs://bucketName/fo - [目录分享是否支持分享后取消分享](https://support.huaweicloud.com/browsertg-obs/obs_03_1037.md): 不支持。当前通过OBS Browser+分享的对象或目录均有有效期,在有效期内的链接无法通过Browser+取消分享。因此请您在使用过程中一定要谨慎选择分享链接的有效期,同时注意分享对象或目录的正确性。 - [是否支持统计文件夹内的文件数目及大小](https://support.huaweicloud.com/browsertg-obs/obs_03_1038.md): OBS Browser+不支持统计文件夹内的文件数目及大小,可以使用obsutil列举对象命令,指定前缀为需要查看的文件夹进行列举。以Linux操作系统为例,运行./obsutil ls obs://bucket-test/test/ -du -limit=0命令,查询桶bucket-test下test文件夹的大小。./obsutil l - [如何解决DNS解析失败](https://support.huaweicloud.com/browsertg-obs/obs_03_1039.md): 该问题属于网络问题,需要借助日志详情文件帮助定位。打开日志文件obssdk.log文件,查看最近日志,可看到关键报错信息如下所示:可按照以下步骤排查解决问题:在 "控制面板" 中,查看方式选择“类别”,依次单击"网络和Internet"、“网络和共享中心”和“更改适配器设置”。右键单击要配置的连接,然后单击"属性 "。单击 "Intern - [是否支持列举特殊字符对象](https://support.huaweicloud.com/browsertg-obs/obs_03_1082.md): 不支持。建议您使用OBS SDK来列举特殊字符对象。使用SDK列举特殊字符对象,具体请参见OBS对应SDK文档中的“列举对象”章节。 - [恢复对象任务状态一直是恢复中](https://support.huaweicloud.com/browsertg-obs/obs_03_1084.md): 当OBS Browser+中任务数量达到了百万级别及以上时,系统会处于海量查找的状态中,因批量恢复的对象数量较多,browser+在这种数量级的恢复请求下,获取真实的恢复状态会很慢,实际恢复请求已经成功。建议通过服务端或者其他途径进行查询对象的实际状态,browser+上的恢复任务,后续会自动同步到已完成列表。 - [新创建的桶执行上传任务时,报错临时重定向](https://support.huaweicloud.com/browsertg-obs/obs_03_1085.md): 报错信息:临时重定向,当dns更新时,请求将被重定向到桶。报错原因:该桶为新创建的桶,新创建的桶如果使用browser+前5-10分钟内可能会出现重定向问题,因为新创建的桶服务端DNS解析还未完善,browser+使用全局域名访问桶时服务端无法把请求转到正确的DNS上。解决方案1:新创建的桶需要等待10分钟再使用browser+操作。解决 - [卸载OBS Browser+](https://support.huaweicloud.com/browsertg-obs/obs_03_1025.md): 卸载OBS Browser+的操作步骤如下: - [obsutil简介](https://support.huaweicloud.com/utiltg-obs/obs_11_0001.md): obsutil是一款用于访问管理华为云对象存储服务(Object Storage Service,OBS)的命令行工具,您可以使用该工具对OBS进行常用的配置管理操作,如创建桶、上传文件/文件夹、下载文件/文件夹、删除文件/文件夹等。对于熟悉命令行程序的用户,obsutil能在执行批量处理、自动化任务场景能为您带来更优体验。obsutil - [下载和安装obsutil](https://support.huaweicloud.com/utiltg-obs/obs_11_0003.md): 针对不同操作系统,obsutil的下载地址如表1所示。在不同操作系统,下载obsutil的方式也有所不同,下载后无需安装,即可开始使用。执行以下命令前要求云服务器已连接到互联网,否则安装obsutil客户端失败。Windows操作系统Linux操作系统Linux AMD 64位(Linux x86 64位):Linux ARM 64位:w - [准备环境](https://support.huaweicloud.com/utiltg-obs/obs_11_0004.md): 使用obsutil前您需要执行注册云服务账号、开通OBS服务以及获取访问密钥(AK和SK)等环境准备操作。使用OBS之前必须要有一个云服务账号。打开浏览器。登录公有云网站。在页面右上角单击“注册”。按需填写注册信息并单击“同意协议并注册”。使用OBS服务之前必须先充值,才能正常使用OBS服务。登录管理控制台。单击页面右上角的“费用和成本” - [初始化配置](https://support.huaweicloud.com/utiltg-obs/obs_11_0005.md): 使用obsutil之前,您需要配置obsutil与OBS的对接信息,包括OBS终端节点地址(Endpoint)和访问密钥(AK和SK)。获得OBS的认证后,才能使用obsutil执行OBS桶和对象的相关操作。已下载obsutil软件包,具体请参见下载和安装obsutil。已获取OBS当前开通的区域和终端节点地址,您可以从这里查看。例如,访 - [快速使用](https://support.huaweicloud.com/utiltg-obs/obs_11_0006.md): 本章节以Linux操作系统为例,介绍如何通过obsutil在OBS上完成基本的数据存取操作,具体操作流程如图1所示。已获取到obsutil工具,并完成了初始化配置。已进入obsutil工具所在目录。以上命令中location参数定义了桶将会被创建在哪个区域,如果初始化配置时配置的终端节点(Endpoint)归属于默认区域华北-北京一(cn - [创建桶](https://support.huaweicloud.com/utiltg-obs/obs_11_0008.md): 按照用户指定的桶名创建一个新桶。新创建桶的桶名在OBS中必须是唯一的。一个用户可以拥有的桶的数量不能超过100个。如果是同一个用户在同一区域的重复创建同名桶不会报错,返回HTTP状态码200,创建的桶属性以第一次请求为准。除此以外的其他场景重复创建同名桶返回HTTP状态码409,表明桶已存在。如果您当前配置的endpoint是全局域名(o - [列举桶](https://support.huaweicloud.com/utiltg-obs/obs_11_0009.md): 获取存储桶列表,返回的结果将按存储桶名称的字典序进行排列。Windows操作系统obsutil ls [-s] [-fs] [-sc] [-du] [-fs] [-j=1] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]macOS - [查询桶属性](https://support.huaweicloud.com/utiltg-obs/obs_11_0010.md): 查询单个桶的基本属性,包括桶的默认存储类型、桶的区域、桶的版本号、桶是否支持文件接口、桶的可用区、桶中对象数量、桶的存储用量以及桶的配额。Windows操作系统obsutil stat obs://bucket [-acl] [-bf=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xx - [设置桶属性](https://support.huaweicloud.com/utiltg-obs/obs_11_0040.md): 设置桶的存储类型、访问策略等属性。Windows操作系统obsutil chattri obs://bucket [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]macOS/Linux操作系统./obsutil chat - [删除桶](https://support.huaweicloud.com/utiltg-obs/obs_11_0011.md): 删除桶,待删除的桶必须为空(不包含对象、历史版本对象或分段上传碎片)。如果要删除非空桶,请先使用删除分段上传任务命令和删除对象命令,将桶清空后再执行删除桶命令。Windows操作系统obsutil rm obs://bucket [-f] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]m - [设置桶策略](https://support.huaweicloud.com/utiltg-obs/obs_11_0406.md): 设置桶策略。Windows操作系统obsutil bucketpolicy obs://bucket -method=put -localfile=xxx [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]macOS/Linux操作系统./obsutil bucketpolicy obs:/ - [获取桶策略](https://support.huaweicloud.com/utiltg-obs/obs_11_0407.md): 获取桶策略。Windows操作系统obsutil bucketpolicy obs://bucket -method=get [-localfile=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]macOS/Linux操作系统./obsutil bucketpolicy obs - [删除桶策略](https://support.huaweicloud.com/utiltg-obs/obs_11_0408.md): 删除桶策略。Windows操作系统obsutil bucketpolicy obs://bucket -method=delete [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]macOS/Linux操作系统./obsutil bucketpolicy obs://bucket -met - [设置桶的生命周期配置](https://support.huaweicloud.com/utiltg-obs/obs_11_0092.md): 设置桶生命周期规则。Windows操作系统obsutil lifecycle obs://bucket -method=put -localfile=xxx [-config=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-e=xxx]macOS/Linux操作系统./obsutil lifecycle obs://b - [获取桶的生命周期配置](https://support.huaweicloud.com/utiltg-obs/obs_11_0093.md): 获取桶生命周期规则。Windows操作系统obsutil lifecycle obs://bucket -method=get [-localfile=xxx] [-config=xxx] [-i=xxx] [-k=xxx] [-t=xxx] [-e=xxx]macOS/Linux操作系统./obsutil lifecycle obs: - [删除桶的生命周期配置](https://support.huaweicloud.com/utiltg-obs/obs_11_0094.md): 删除桶生命周期规则。Windows操作系统obsutil lifecycle obs://bucket -method=delete [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]macOS/Linux操作系统./obsutil lifecycle obs://bucket -metho - [设置镜像回源规则](https://support.huaweicloud.com/utiltg-obs/obs_11_1002.md): 设置桶的回源镜像规则。Windows操作系统obsutil mirror-back-to-source obs://bucket -method=put -localfile=xxx [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]macOS/Linux操作系统./obsutil mirr - [获取镜像回源规则](https://support.huaweicloud.com/utiltg-obs/obs_11_1003.md): 获取桶的回源镜像规则。Windows操作系统obsutil mirror-back-to-source obs://bucket -method=get [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]macOS/Linux操作系统./obsutil mirror-back-to-sour - [删除镜像回源规则](https://support.huaweicloud.com/utiltg-obs/obs_11_1004.md): 删除桶的回源镜像规则。Windows操作系统obsutil mirror-back-to-source obs://bucket -method=delete [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]macOS/Linux操作系统./obsutil mirror-back-to-s - [设置桶的自定义域名](https://support.huaweicloud.com/utiltg-obs/obs_11_1005.md): 设置桶的自定义域名。您必须是桶拥有者或拥有设置桶的自定义域名配置的权限,才能设置桶的自定义域名配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:SetBucketCustomDomainConfiguration权限,如果使用桶策略则需授予SetBucketCustomDomainConfiguration - [获取桶的自定义域名](https://support.huaweicloud.com/utiltg-obs/obs_11_1006.md): 获取桶的自定义域名。您必须是桶拥有者或拥有获取桶的自定义域名配置的权限,才能获取桶的自定义域名配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketCustomDomainConfiguration权限,如果使用桶策略则需授予GetBucketCustomDomainConfiguration - [删除桶的自定义域名](https://support.huaweicloud.com/utiltg-obs/obs_11_1007.md): 删除桶的自定义域名。您必须是桶拥有者或拥有删除桶的自定义域名的权限,才能删除桶的自定义域名。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketCustomDomainConfiguration权限,如果使用桶策略则需授予DeleteBucketCustomDomainConfigurati - [设置桶标签](https://support.huaweicloud.com/utiltg-obs/obs_11_1008.md): 设置桶标签。您必须是桶拥有者或拥有设置桶标签的权限,才能设置桶标签。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutBucketTagging权限,如果使用桶策略则需授予PutBucketTagging权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、自定义创建桶策略。Wi - [获取桶标签](https://support.huaweicloud.com/utiltg-obs/obs_11_1009.md): 获取桶标签。您必须是桶拥有者或拥有获取桶标签的权限,才能获取桶标签。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketTagging权限,如果使用桶策略则需授予GetBucketTagging权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、自定义创建桶策略。Wi - [删除桶标签](https://support.huaweicloud.com/utiltg-obs/obs_11_1010.md): 删除桶标签。您必须是桶拥有者或拥有删除桶标签的权限,才能删除桶标签。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketTagging权限,如果使用桶策略则需授予DeleteBucketTagging权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、自定义创建 - [设置桶的加密配置](https://support.huaweicloud.com/utiltg-obs/obs_11_1011.md): 本章节指导用户如何设置桶的加密配置。您必须是桶拥有者或拥有设置桶的加密配置权限,才能设置桶的加密配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:SetEncryptionConfiguration权限,如果使用桶策略则需授予SetEncryptionConfiguration权限。相关授权方式介绍可参见O - [获取桶的加密配置](https://support.huaweicloud.com/utiltg-obs/obs_11_1012.md): 获取桶的加密配置。您必须是桶拥有者或拥有获取桶加密配置的权限,才能获取桶加密配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetEncryptionConfiguration权限,如果使用桶策略则需授予GetEncryptionConfiguration权限。相关授权方式介绍可参见OBS权限控制概述,配 - [删除桶的加密配置](https://support.huaweicloud.com/utiltg-obs/obs_11_1013.md): 删除桶的加密配置。您必须是桶拥有者或拥有删除桶加密配置的权限,才能删除桶加密配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutEncryptionConfiguration权限,如果使用桶策略则需授予PutEncryptionConfiguration权限。相关授权方式介绍可参见OBS权限控制概述,配 - [设置桶的网站配置](https://support.huaweicloud.com/utiltg-obs/obs_11_2020.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用设置桶的网站配置接口,您可以为指定桶设置网站配 - [获取桶的网站配置](https://support.huaweicloud.com/utiltg-obs/obs_11_2021.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用获取桶的网站配置接口,您可以获取指定桶的网站配 - [删除桶的网站配置](https://support.huaweicloud.com/utiltg-obs/obs_11_2022.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用删除桶的网站配置接口,您可以删除指定桶的网站配 - [设置桶的CORS配置](https://support.huaweicloud.com/utiltg-obs/obs_11_1017.md): 设置桶的CORS配置,以允许客户端浏览器进行跨域请求。您必须是桶拥有者或拥有设置桶的CORS配置的权限,才能设置桶的CORS规则。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutBucketCORS权限,如果使用桶策略则需授予PutBucketCORS权限。相关授权方式介绍可参见OBS权限控制概述,配置方 - [获取桶的CORS配置](https://support.huaweicloud.com/utiltg-obs/obs_11_1018.md): 获取桶的CORS配置。您必须是桶拥有者或拥有获取桶的CORS配置的权限,才能获取桶的CORS配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketCORS权限,如果使用桶策略则需授予GetBucketCORS权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、自定 - [删除桶的CORS配置](https://support.huaweicloud.com/utiltg-obs/obs_11_1019.md): 删除桶的CORS配置。您必须是桶拥有者或拥有删除桶的CORS配置的权限,才能删除桶的CORS配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketCORS权限,如果使用桶策略则需授予DeleteBucketCORS权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定 - [创建文件夹](https://support.huaweicloud.com/utiltg-obs/obs_11_0050.md): 在指定桶内或本地文件系统中创建文件夹。创建重名文件夹,不会报错,且文件夹内已存在的内容不发生变化。Windows操作系统在指定桶内创建文件夹obsutil mkdir obs://bucket/folder[/subfolder1/subfolder2] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [ - [上传对象](https://support.huaweicloud.com/utiltg-obs/obs_11_0013.md): 上传单个或多个本地文件或文件夹至OBS指定路径。待上传的文件可以是任何类型:文本文件、图片、视频等等。上传本地文件或文件夹时,请确保本地文件或文件夹在上传过程不发生变化,否则可能产生上传失败或者数据不一致的问题。obsutil对上传的文件或文件夹有大小限制,最小可以上传0Byte的空文件或文件夹,最大可以上传5GB(未采用分段上传)或48 - [查询对象属性](https://support.huaweicloud.com/utiltg-obs/obs_11_0015.md): 查询对象的基本属性。Windows操作系统obsutil stat obs://bucket/key [-acl][-bf=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]macOS/Linux操作系统./obsutil stat obs://bucket/key [-acl][ - [设置对象属性](https://support.huaweicloud.com/utiltg-obs/obs_11_0041.md): 设置对象的属性或按对象名前缀批量设置对象的属性。只有3.0版本的桶支持设置对象存储类型。Windows操作系统设置单个对象属性obsutil chattri obs://bucket/key [-meta=aaa:bbb#ccc:ddd] [-sc=xxx] [-acl=xxx] [-aclXml=xxx] [-versionId=xxx - [列举对象](https://support.huaweicloud.com/utiltg-obs/obs_11_0014.md): 查询桶内对象或多版本对象,返回对象列表将按照对象名和版本号以字典序排列。Windows操作系统obsutil ls obs://bucket[/prefix] [-s] [-fs] [-d] [-v] [-du] [-marker=xxx] [-versionIdMarker=xxx] [-encoding-type=url] [-bf= - [复制对象](https://support.huaweicloud.com/utiltg-obs/obs_11_0017.md): 复制对象或按对象名前缀批量复制对象。复制对象或批量复制时,请确保OBS桶中的源对象不发生变化,否则可能产生复制失败或者数据不一致的问题。如果被复制对象的存储类型为cold,必须首先恢复被复制对象,否则无法复制成功。复制时需要有被复制对象的读权限和目标桶的写权限。如果没有开启客户端跨区域复制模式,复制的源桶和目标桶必须在同一个区域(Regi - [移动对象](https://support.huaweicloud.com/utiltg-obs/obs_11_0053.md): 移动对象或按对象名前缀批量移动对象。移动对象时,请确保OBS桶中的源对象不发生变化,否则可能产生移动失败或者数据不一致的问题。如果被移动对象的存储类型为cold,必须首先恢复被移动对象,否则无法移动成功。移动对象或批量移动成功后,源端对象会被删除。当使用 OBS Util 执行对象移动(mv)操作时,如果该任务被主动取消或遭遇意外中断,工 - [下载对象](https://support.huaweicloud.com/utiltg-obs/obs_11_0018.md): 下载对象或按对象名前缀批量下载对象到本地。下载对象或批量下载时,请确保OBS桶中的源对象不发生变化,否则可能产生下载失败或者数据不一致的问题。如果待下载对象的存储类型为低频访问存储,必须首先恢复待下载对象,否则无法下载成功。Windows操作系统下载单个对象obsutil cp obs://bucket/key file_or_folde - [生成对象的下载链接](https://support.huaweicloud.com/utiltg-obs/obs_11_0051.md): 生成指定桶内对象的下载链接,或按对象名前缀批量生成桶内对象的下载链接。Windows操作系统生成单个对象的下载链接obsutil sign obs://bucket/key [-e=300] [-config=xxx] [-endpoint=xxx] [-i=xxx] [-k=xxx] [-t=xxx]按对象名前缀批量生成对象的下载链接o - [删除对象](https://support.huaweicloud.com/utiltg-obs/obs_11_0021.md): 删除指定的对象。按指定的对象名前缀批量删除对象。删除对象后无法恢复,请谨慎使用。删除对象后无法恢复,请谨慎使用。对于并行文件系统目录,大数据场景下(目录层级深、目录下文件多)的删除,可能会因超时而删除失败,建议使用:hadoop 客户端(嵌套OBS客户端插件OBSA)删除目录:hadoop fs - rmr obs://{并行文件系统名} - [增量同步上传对象](https://support.huaweicloud.com/utiltg-obs/obs_11_0042.md): 将本地源路径下的所有内容同步到OBS指定目标桶,使两边内容保持一致。此处的增量同步有两层含义:增量,依次比较源文件和目标对象,只上传存在变化的源文件。同步,命令执行完成后,保证本地源路径是OBS指定目标桶的子集,即本地源路径下的所有文件均能在OBS指定目标桶中找到对应对象。同步上传时,请确保本地文件或文件夹在同步过程不发生变化,否则可能产 - [增量同步复制对象](https://support.huaweicloud.com/utiltg-obs/obs_11_0044.md): 将源桶指定路径下的所有对象同步到目标桶指定路径,使两边内容保持一致。这里的增量同步有两层含义:增量,依次比较源对象和目标对象,只复制存在变化的源对象;同步,命令执行完成后,保证源桶指定路径是目标桶指定路径的子集,即源桶指定路径下的所有对象均能在目标桶中找到对应对象。同步复制对象时,请确保OBS桶中的源对象不发生变化,否则可能产生同步失败或 - [增量同步下载对象](https://support.huaweicloud.com/utiltg-obs/obs_11_0043.md): 将OBS源桶指定路径下的所有对象同步到本地目标路径,使两边内容保持一致。这里的增量同步有两层含义:增量,依次比较源对象和目标文件,只下载存在变化的源对象;同步,命令执行完成后,保证OBS指定源桶指定路径是本地目标路径的子集,即OBS源桶指定路径下的所有对象均能在本地目标路径下找到对应文件。同步下载时,请确保OBS桶中的源对象不发生变化,否 - [恢复归档存储深度归档存储对象](https://support.huaweicloud.com/utiltg-obs/obs_11_0016.md): 恢复指定的存储类型为cold的对象或按指定的对象名前缀批量恢复存储类型为cold的对象。恢复过程中无法读取对象内容。恢复存储对象后,其实际转换为可下载状态的完成时间依赖于OBS服务端。当前obsutil暂不支持查询恢复状态,您可以通过OBSBrowser+工具或者调用获取对象元数据接口查询恢复状态。obsutil 无法识别并跳过已恢复对象 - [恢复失败的上传任务](https://support.huaweicloud.com/utiltg-obs/obs_11_0036.md): 根据任务号(TaskId)恢复失败的上传任务。Windows操作系统obsutil cp -recover=xxx [-arcDir=xxx] [-dryRun] [-f] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [- - [恢复失败的复制任务](https://support.huaweicloud.com/utiltg-obs/obs_11_0037.md): 根据任务号(TaskId)恢复失败的复制任务。Windows操作系统obsutil cp -recover=xxx [-dryRun] [-f] [-u] [-crr] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-acl=xxx] [-sc=xxx] [-meta=aa - [恢复失败的下载任务](https://support.huaweicloud.com/utiltg-obs/obs_11_0038.md): 根据任务号(TaskId)恢复失败的下载任务。Windows操作系统obsutil cp -recover=xxx [-dryRun] [-tempFileDir=xxx] [-f] [-u] [-vlength] [-vmd5] [-j=1] [-p=1] [-threshold=52428800] [-ps=auto] [-inclu - [列举分段上传任务](https://support.huaweicloud.com/utiltg-obs/obs_11_0019.md): 查询桶内分段上传任务。Windows操作系统obsutil ls obs://bucket[/prefix] [-s] [-d] -m [-a] [-uploadIdMarker=xxx] [-marker=xxx] [-limit=1] [-format=default] [-config=xxx] [-e=xxx] [-i=xxx] - [删除分段上传任务](https://support.huaweicloud.com/utiltg-obs/obs_11_0020.md): 通过分段上传任务的ID,删除指定桶中的分段上传任务。按指定的对象名前缀批量删除分段上传任务。Windows操作系统删除单个分段上传任务obsutil abort obs://bucket/key -u=xxx [-f] [-fr] [-o=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t= - [创建目录分享的授权码](https://support.huaweicloud.com/utiltg-obs/obs_11_0062.md): 指定桶名、对象名前缀和提取码,创建目录分享的授权码。Windows操作系统obsutil create-share obs://bucket[/prefix] [-ac=xxx] [-vp=xxx] [-dst=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]macOS/Linu - [授权码列举对象](https://support.huaweicloud.com/utiltg-obs/obs_11_0063.md): 使用授权码查询桶内对象,返回对象列表将按照对象名以字典序排列。Windows操作系统直接输入授权码obsutil share-ls authorization_code [-ac=xxx] [-prefix=xxx] [-s] [-d] [-marker=xxx] [-bf=xxx] [-limit=1] [-format=default - [授权码下载对象](https://support.huaweicloud.com/utiltg-obs/obs_11_0064.md): 使用授权码下载对象或按对象名前缀批量下载对象到本地。下载对象或批量下载时,请确保OBS桶中的源对象不发生变化,否则可能产生下载失败或者数据不一致的问题。Windows操作系统直接输入授权码下载单个对象obsutil share-cp authorization_code file_or_folder_url -key=xxx [-ac=x - [设置对象标签](https://support.huaweicloud.com/utiltg-obs/obs_11_1014.md): 设置对象标签。您必须是对象拥有者或拥有设置对象标签的权限,才能设置对象标签。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutObjectTagging权限,如果使用桶策略则需授予PutObjectTagging权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、自定义创建桶策 - [获取对象标签](https://support.huaweicloud.com/utiltg-obs/obs_11_1015.md): 获取对象标签。您必须是对象拥有者或拥有获取对象标签的权限,才能获取对象标签。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetObjectTagging权限,如果使用桶策略则需授予GetObjectTagging权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、自定义创建桶策 - [删除对象标签](https://support.huaweicloud.com/utiltg-obs/obs_11_1016.md): 删除对象标签。您必须是对象拥有者或拥有删除对象标签的权限,才能删除对象标签。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteObjectTagging权限,如果使用桶策略则需授予DeleteObjectTagging权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、自 - [更新配置文件](https://support.huaweicloud.com/utiltg-obs/obs_11_0023.md): 更新配置文件(.obsutilconfig)中的部分配置信息,可更新的配置包括:endpoint、ak、sk、token。关于配置文件(.obsutilconfig)中参数的详细说明,请参见配置参数说明。Windows操作系统交互模式更新配置obsutil config [-interactive] [-crr] [-config=xxx - [删除断点记录文件](https://support.huaweicloud.com/utiltg-obs/obs_11_0024.md): 删除指定文件夹下的断点记录文件。Windows操作系统obsutil clear [checkpoint_dir] [-u] [-d] [-c] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]macOS/Linux操作系统./obsutil clear [checkpoint_dir] - [查看命令帮助](https://support.huaweicloud.com/utiltg-obs/obs_11_0025.md): 查看工具支持的命令,或查看某个具体命令的帮助文档。Windows操作系统obsutil help [command]macOS/Linux操作系统./obsutil help [command]以Windows操作系统为例,运行obsutil help mb,查看创建桶命令的帮助文档。obsutil help mb Summary: - [查看版本号](https://support.huaweicloud.com/utiltg-obs/obs_11_0026.md): 查看工具当前的版本号。Windows操作系统obsutil versionmacOS/Linux操作系统./obsutil version以Windows操作系统为例。运行示例如下: - [归档日志文件](https://support.huaweicloud.com/utiltg-obs/obs_11_0045.md): 将日志文件归档到本地,或归档到指定的桶。Windows操作系统归档到本地obsutil archive [file_or_folder_url] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]归档到指定的桶obsutil archive obs://bucket[/key] [-conf - [列举失败结果清单文件](https://support.huaweicloud.com/utiltg-obs/obs_11_0072.md): 按最后修改时间列举指定文件夹中cp命令及sync命令生成的失败结果清单文件。Windows操作系统obsutil ls -failed [-limit=1000] [-o=xxx]macOS/Linux操作系统./obsutil ls -failed [-limit=1000] [-o=xxx]以Windows操作系统为例。运行示例如下: - [上传示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0028.md): 本章节案例中的所有命令均以Linux操作系统为例,提供上传操作指导。假设本地文件夹的格式如下:基于以上文件夹格式,不同上传场景的命令示例如下:上传本地src1文件夹下的test3.txt文件至bucket-test桶的根目录,命令如下:./obsutil cp /src1/test3.txt obs://bucket-test成功上传后 - [同步上传示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0046.md): 本章节案例中的所有命令均以Linux操作系统为例,提供同步上传操作指导。假设本地文件夹的格式如下:假设bucket-test桶内包含如下对象:基于以上本地文件夹和桶内对象的格式,不同场景下同步上传的示例如下:同步本地src1文件夹下的test3.txt文件至bucket-test桶的根目录,同步命令如下:./obsutil sync /s - [下载示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0029.md): 本章节案例中的所有命令均以Linux操作系统为例,提供下载操作指导。假设bucket-test桶内包含如下对象:基于以上桶内对象格式,不同下载场景下的命令示例如下:下载bucket-test桶中的test1.txt文件至本地的src1文件夹中,下载命令如下:./obsutil cp obs://bucket-test/test1.txt - [同步下载示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0047.md): 本章节案例中的所有命令均以Linux操作系统为例,提供同步下载操作指导。假设bucket-test桶内包含如下对象:假设本地文件夹的格式如下:基于以上桶内对象和本地文件夹的格式,不同场景下同步下载的示例如下:同步bucket-test的src1文件夹中的所有文件和文件夹至本地已存在的src1文件夹中,同步命令如下:./obsutil sy - [复制示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0030.md): 本章节案例中的所有命令均以Linux操作系统为例,提供复制操作指导。假设bucket-src桶内包含如下对象:基于以上对象格式,不同复制场景下的命令示例如下:复制bucket-src桶中的test1.txt文件至bucket-dest桶中,复制命令如下:./obsutil cp obs://bucket-src/test1.txt ob - [同步复制示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0048.md): 本章节案例中的所有命令均以Linux操作系统为例,提供同步复制操作指导。假设源桶bucket-src内包含如下对象:假设目标桶bucket-dest内包含如下对象:基于以上对象格式,不同场景下同步复制的命令示例如下:同步bucket-src桶中src1文件夹下的文件和文件夹至bucket-dest桶的src1文件夹中,同步复制命令如下:. - [列举示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0031.md): 本章节案例中的所有命令均以Linux操作系统为例,提供列举操作指导。假设bucket-test桶内包含如下对象:基于以上对象格式,不同场景下列举对象的命令示例如下:只列举bucket-test桶中的3个对象,列举命令如下:./obsutil ls obs://bucket-test -limit=3返回结果按照对象名和版本号以字典序排列后 - [列举分段上传任务示例](https://support.huaweicloud.com/utiltg-obs/obs_11_0032.md): 本章节案例中的所有命令均以Linux操作系统为例,提供列举上传任务操作指导。假设bucket-test桶内包含如下分段上传任务:只列举3个bucket-test桶内的分段上传任务示例,列举命令如下:./obsutil ls obs://bucket-test -m -limit=3返回结果按照对象名字典序排列后,结果如下:obs://bu - [删除桶内全部分段上传任务](https://support.huaweicloud.com/utiltg-obs/obs_11_0065.md): 本章节案例中的所有命令均以Linux操作系统为例,提供删除桶内全部分段上传操作指导。假设bucket-test桶内包含如下分段上传任务:可以使用如下命令一次性删除桶内全部分段上传任务的碎片: - [问题定位简介](https://support.huaweicloud.com/utiltg-obs/obs_11_0055.md): obsutil提供多种方式帮助用户自助进行日常问题分析和定位,具体方式及其说明如表1所示。您通常需要结合多种方式以准确定位问题。 - [日志文件](https://support.huaweicloud.com/utiltg-obs/obs_11_0056.md): obsutil的日志文件分为工具日志和SDK日志,可通过在.obsutilconfig配置文件中加入如下参数开启这两种日志:工具日志(记录工具在运行期间产生的日志信息):配置utilLogPath、utilLogBackups、utilLogLevel、utilMaxLogSize。SDK日志(记录工具调用OBS服务端接口期间产生的日志信 - [结果清单](https://support.huaweicloud.com/utiltg-obs/obs_11_0057.md): 批量任务执行完成后,会生成结果清单文件,默认情况下结果清单文件保存在运行obsutil命令的用户目录的子文件夹.obsutil_output下,用户可以通过在运行命令时指定-o附加参数来指定保存结果清单文件的文件夹。结果清单文件包含三种类型,成功结果清单、失败结果清单和警告结果清单,命名规则为:操作_{succeed | failed - [返回码](https://support.huaweicloud.com/utiltg-obs/obs_11_0058.md): 通过进程等方式调用obsutil时,无法实时查看回显信息。obsutil支持在进程运行结束后,根据不同的运行结果生成不同的返回码,具体的返回码及其含义如表1所示。您可以通过以下方式获取最近一次运行结果的返回码,然后根据返回码分析并处理问题。macOS/Linux操作系统,执行以下命令获取最近一次运行结果的返回码:echo $?Window - [利用obsutil帮助命令查找工具功能](https://support.huaweicloud.com/utiltg-obs/obs_11_0066.md): obsutil提供了帮助命令(help命令)用于查看各命令的帮助文档。以查询创建桶命令的帮助文档为例,详细的步骤如下:更多关于帮助命令的介绍请参考查看命令帮助。您可以通过配置文件中的helpLanguage参数配置帮助命令的语言类型。例如,配置helpLanguage=Chinese代表配置帮助命令的语言类型为中文。当前支持的语种类型包括 - [利用crontab配置定时任务](https://support.huaweicloud.com/utiltg-obs/obs_11_0034.md): 示例场景:每天21:30进入/root目录下,执行增量上传/src/src1文件夹到obs://bucket-test桶内。必须在Linux操作系统下,并且正常开启了crond(定时任务计划)服务。如果是windows用户请参考配置windows定时任务。运行service crond status命令可查看是否开启该服务。假设obsut - [将obsutil设为系统内置命令](https://support.huaweicloud.com/utiltg-obs/obs_11_0049.md): 作为外部软件,obsutil命令需要进入obsutil工具所在目录后方可运行,易用性较差。操作系统提供内置命令,在系统启动时就将依赖的目录调入内存,这样在任意目录下都可以运行命令,提高工具易用性。本章根据不同操作系统,分别介绍如何将obsutil设置为系统内置命令。方式一:使用脚本自动配置(推荐)如果使用脚本自动配置完成后,执行命令obs - [为obsutil配置自动获取访问密钥](https://support.huaweicloud.com/utiltg-obs/obs_11_0067.md): 除了从配置文件.obsutilconfig中获取访问密钥(AK/SK)外,obsutil还提供链式自动获取访问密钥功能,可以从系统环境变量获取访问密钥,或者通过ECS接口获取临时访问密钥。启用链式获取访问密钥功能后,obsutil会依次从.obsutilconfig配置文件 -> 系统环境变量 -> ECS弹性云服务器中尝试获取可用的访问 - [obsutil性能调优最佳实践](https://support.huaweicloud.com/utiltg-obs/obs_11_0052.md): obsutil对大于50MB的文件/对象默认采用分段方式进行上传、下载和复制,与分段任务相关的参数在.obsutilconfig配置文件中,如表1所示。通常情况下使用分段任务不仅能提高传输效率,还能实现失败任务的断点续传。默认情况下,分段任务的段大小可以使用auto模式让obsutil自动调整。但在实际操作中,为了进一步提升上传下载性能, - [利用obsutil进行断点续传](https://support.huaweicloud.com/utiltg-obs/obs_11_0059.md): obsutil在上传、下载和复制大文件时通过分段上传/下载/复制算法,可支持断点续传。您可根据具体的场景设置开启分段任务的阈值以实现上传/下载/复制任务失败或中断后的续传。您可通过两种方式指定开启分段任务的阈值:指定配置文件中的配置参数:defaultBigfileThreshold,详情请参见配置参数说明。在运行上传、下载、复制、增量同 - [利用obsutil上传软链接](https://support.huaweicloud.com/utiltg-obs/obs_11_0060.md): obsutil支持上传文件/文件夹时上传软链接指向的真实路径。您可通过在运行上传对象和增量同步上传对象时指定命令级参数:link,来实现上传软链接的功能。obsutil支持识别文件夹软链接,如果软链接指向的真实路径是一个文件夹则会递归扫描该文件夹中的内容。文件夹软链接不能形成环,否则上传会以panic的形式退出;如果不希望产生panic, - [为obsutil配置HTTP代理](https://support.huaweicloud.com/utiltg-obs/obs_11_0068.md): 您可以通过如下三种方式配置HTTP代理。方式一,通过配置文件.obsutilconfig中的proxyUrl参数,示例:proxyUrl=http://username:password@your-proxy:8080;方式二,通过系统环境变量HTTPS_PROXY或HTTP_PROXY,示例:HTTPS_PROXY=http://use - [使用obsutil实现目录分享](https://support.huaweicloud.com/utiltg-obs/obs_11_0069.md): 目录分享允许桶的拥有者将桶的目录或者整个桶以授权码+提取码的形式分享给其他用户。获取到授权码和提取码的用户,可以在授权码的有效期内通过OBS提供的工具(OBS Browser、obsutil),或者直接在浏览器上输入授权码进行对象的列举和下载。obsutil提供了三个命令用于实现目录分享的功能,具体步骤如下:建议创建授权码时,待分享的目录 - [使用obsutil实现客户端跨区域复制](https://support.huaweicloud.com/utiltg-obs/obs_11_0039.md): obsutil支持使用客户端跨区域复制模式进行复制,即通过数据流的方式从源桶直接复制数据到目标桶,且两个桶可以是任意两个OBS服务的桶;借助客户端跨区域复制模式即可实现相同账户下不同区域桶或不同账户间桶内对象的复制;跨账号复制对象具体步骤如下:Windows操作系统obsutil config -i=src_ak -k=src_sk -e - [指定obsutil上传下载时进行限速](https://support.huaweicloud.com/utiltg-obs/obs_11_0073.md): obsutil支持通过在配置文件.obsutilconfig中配置rateLimitThreshold参数实现对上传/下载操作进行限速。参数具体描述可参考配置参数说明,默认不指定即不进行限速,此时具体的上传/下载速度取决于用户侧的实际网络带宽及上传/下载任务的并发配置,具体调优方案可以参考obsutil性能调优最佳实践。需要注意的是,ra - [在obsutil中配置自定义域名访问OBS](https://support.huaweicloud.com/utiltg-obs/obs_11_0085.md): obsutil 支持配置自定义域名访问OBS,目前仅支持列举、上传、下载对象。具体配置步骤如下:根据命令回显结果,检查配置结果:如果返回结果中包含“Object number :”,表明配置正确。如果返回结果中包含“Http status [403]”,表明域名配置有误。该功能仅限5.5.3及以上版本支持。配置文件(.obsutilcon - [使用自定义域名访问桶和对象](https://support.huaweicloud.com/utiltg-obs/obs_11_2030.md): obsutil 现在支持配置文件和命令参数两种方式指定自定义域名。通过配置文件指定自定义域名访问桶和对象请参考在obsutil中配置自定义域名访问OBS。关于命令参数,需要在原有命令基础上增加 -bucket-cname=example.com,代表含义是指定桶绑定的自定义域名。常见的 Linux 命令示例如下:功能命令列举桶内对象obs - [是否支持同步删除文件](https://support.huaweicloud.com/utiltg-obs/obs_11_0075.md): 不支持。当前obsutil工具支持同步上传本地目录到OBS桶中,同步成功后,如果用户删除了本地目录下的部分文件,再次进行增量同步上传时,工具将只会检查本地存在的文件是否需要增量进行上传,无法感知已删除文件是否需要在目标桶内进行删除。需要注意的是,如果在上传过程中,本地目录中的文件有新增则无法保证工具最终上传的对象数目和本地目录内文件数目的 - [列举接口是否支持保存结果到本地文件](https://support.huaweicloud.com/utiltg-obs/obs_11_0076.md): obsutil工具本身的列举相关操作不支持直接将结果保存在本地文件,但是可以通过操作系统提供的重定向操作实现将列举结果从屏显的标准输出重定向到指定的本地结果文件中;以列举桶内对象为例:Windows操作系统(在命令行cmd下执行该重定向操作)obsutil ls obs://bucketName -format=default -limi - [列举桶内对象返回的大小与控制台桶内对象大小不一致](https://support.huaweicloud.com/utiltg-obs/obs_11_0077.md): 通过obsutil列举桶内全量对象时最终输出结果中还会包含对象的总的大小,如果通过列举操作返回的对象大小与通过控制台、OBSBrowser+工具查询的桶使用情况不一致时可以从如下两点进行排查:OBSBrowser+和控制台均通过调用获取桶存量信息接口查询当前桶内对象个数及对象占用空间,对应obsutil中调用stat命令返回的结果;由于O - [批量任务执行失败如何确认错误信息](https://support.huaweicloud.com/utiltg-obs/obs_11_0078.md): 用户执行批量上传/下载/复制等批量操作时,最终输出结果中会显示批量任务执行成功的个数及失败的任务个数。为确认失败任务的具体错误原因,可以通过查看对应任务的失败结果清单文件及obsutil的日志文件进行确认。批量任务执行完成后会输出taskID信息,根据taskID信息即可在.obsutil_output目录下查询到对应失败任务清单文件,失 - [i/o timeout、EOF错误原因定位及解决](https://support.huaweicloud.com/utiltg-obs/obs_11_0079.md): i/o timeout、EOF报错是两种常见的因为网络原因导致请求失败的场景,通常是由于网络波动等原因导致;常见的定位思路包括:通过ping桶域名(bucketName.endpoint)判断本地到指定访问的桶域名之间的网络是否不通;如果不通优先排查本地网络问题。如果问题出现概率较大,且域名可以ping通的情况下,可以通过修改endpoi - [批量任务进度条中出现问号的原因](https://support.huaweicloud.com/utiltg-obs/obs_11_0080.md): 问题原因:在执行批量上传/下载任务时,如果目标目录包含大量的对象,由于要遍历所有对象才能统计该任务涉及的整体对象数目、大小等信息,因此在获取这些信息的过程中,进度条会以 ? 问号的形式进行展示。解决办法:待获取任务的整体信息后即会在进度条中展示相应任务信息。 - [是否支持多个config文件在同一个目录下](https://support.huaweicloud.com/utiltg-obs/obs_11_0081.md): 不支持。当前OBSUtil工具支持配置多个不同的config文件,但是需要注意的是由于config文件的加密需要,因此不能在同一个目录下配置多个config文件,否则会造成冲突。如果需要配置多个config文件,则需要将不同的config配置文件初始化在不同的目录下。 - [是否支持列举特殊字符对象](https://support.huaweicloud.com/utiltg-obs/obs_11_0082.md): 5.5.12版本及以上支持,需要指定参数 -encoding-type=url;低版本需要使用OBS SDK 或者API 实现该功能。 - [Windows操作系统下,下载对象时发现本地和云上对象数量不一致](https://support.huaweicloud.com/utiltg-obs/obs_11_0083.md): 如果发现下载后本地文件和文件夹数量之和小于云上对象数量(OBS不区分文件或文件夹,统称为对象),并且当前操作系统是Windows,这个是因为Windows文件系统将文件和目录名称视为不区分大小写,FOO.txt和foo.txt将被视为相同文件;但是在OBS中是区分大小写的,FOO.txt和foo.txt将被视为不同文件。比如桶中存在以下对 - [是否支持修改对象名称(重命名)](https://support.huaweicloud.com/utiltg-obs/obs_11_0084.md): 支持。可以使用mv移动命令,示例如下:以Windows操作系统为例,运行obsutil mv obs://bucket-test/key obs://bucket-test/key2 ,将对象key重命名为key2。obsutil mv obs://bucket-test/key obs://bucket-test/key2 Paral - [是否支持判断对象是否存在](https://support.huaweicloud.com/utiltg-obs/obs_11_2040.md): 支持。您可以使用 stat 命令判断对象是否存在。如果对象存在:返回对象的属性(LastModified、Size、StorageClass、ETag 等)。如果对象不存在:返回 404 错误。如果对象存在,但是命令返回403,可能是权限不足导致的,请优先解决权限问题。 - [配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.md): 通过配置文件.obsutilconfig,您可以设置obsutil中的各项配置参数。配置文件格式:各参数的详细描述如表1所示。建议值为N/A的表示需要根据实际情况进行设置;建议指定sdkLogPath和utilLogPath开启SDK日志和obsutil日志;defaultBigfileThreshold、defaultPartSize、 - [obsfs简介](https://support.huaweicloud.com/fstg-obs/obs_12_0001.md): obsfs是对象存储服务 (Object Storage Service,OBS)提供的一款基于FUSE的文件系统工具,用于将OBS桶或者并行文件系统挂载至Linux系统,让用户能够在本地像操作文件系统一样直接使用OBS海量的存储空间。对于原本使用本地文件系统存储数据的用户,如果希望把数据存储在OBS上但不改变数据的访问方式,可以使用ob - [资源准备](https://support.huaweicloud.com/fstg-obs/obs_12_0003.md): 使用obsfs之前,您需要完成如表1所示的资源准备。在使用obsfs之前,您需要拥有一个华为账号并且成功开通OBS。OBS提供按需和资源包两种计费方式,充值或购买资源包即开通OBS服务。成功开通OBS后即可进行访问和使用。如果您已有账号且账号已开通OBS服务,可以略过此部分内容。使用OBS前需注册一个华为账号。如果您已有账号,请从3开始。 - [方式一:下载并安装obsfs](https://support.huaweicloud.com/fstg-obs/obs_12_0004.md): 针对常见的Linux系统发行版,obsfs提供了部分操作系统版本的软件包供用户直接下载使用。通过下载方式获取obsfs工具后,在对应的Linux操作系统上配置好运行环境就可运行挂载命令,直接挂载并行文件系统或者OBS桶。obsfs的下载地址如表1所示。obsfs仅支持对应的Linux发行版本,下载时请提前确认操作系统版本。表1的SHA25 - [方式二:通过编译生成obsfs](https://support.huaweicloud.com/fstg-obs/obs_12_0005.md): obsfs工具已在GitHub上开源,如果您的操作系统版本不是Ubuntu 16、CentOS 7等上述发行版,或者您想通过编译源码生成obsfs工具,可以从GitHub上获取obsfs工具的源码自行编译生成。通过编译源码生成obsfs工具,需要配置好编译环境,执行编译脚本生成obsfs工具。obsfs源码下载地址:请单击此处。在Linu - [初始化obsfs](https://support.huaweicloud.com/fstg-obs/obs_12_0006.md): 在使用obsfs之前,需要将访问密钥(AK和SK)信息写入密钥文件,方便在使用并行文件系统时对使用者的身份进行验证。本章节以将访问密钥信息写入“/etc/passwd-obsfs”文件为例,介绍具体的操作步骤。已获取访问密钥(AK和SK),具体操作请参见资源准备。2023年2月25日以后(不含该日期)提供的官网软件包与2026年5月28日 - [挂载并行文件系统](https://support.huaweicloud.com/fstg-obs/obs_12_0008.md): 通过obsfs使用OBS服务,需要将OBS的并行文件系统挂载至您本地的文件系统上。挂载完成后,可以像操作本地目录一样操作OBS并行文件系统,比如保存某个文件至挂载目录,即上传对象至OBS。obsfs通过公网挂载到华为云服务器ECS上时占用OBS流量,不占用华为云服务器ECS的流量。obsfs挂载OBS并行文件系统后,不支持作为ftp目录使 - [取消挂载并行文件系统](https://support.huaweicloud.com/fstg-obs/obs_12_0009.md): 如果不再需要通过挂载方式访问OBS并行文件系统,或者需要对已挂载并行文件系统进行参数新增、修改或删除时,可以取消挂载并行文件系统。取消挂载并行文件系统不会影响已保存至并行文件系统中的数据。待取消挂载的并行文件系统目前处于挂载状态。是,需退出挂载目录,退出后再执行步骤3。否,执行步骤3。 - [挂载对象存储桶](https://support.huaweicloud.com/fstg-obs/obs_12_0018.md): 通过obsfs使用OBS服务,需要将OBS桶挂载至您本地的文件系统上。挂载完成后,可以采用操作本地目录类似的方式操作OBS桶,比如保存某个文件至挂载目录,即上传对象至OBS。obsfs通过公网挂载到华为云服务器ECS上时占用OBS流量,不占用华为云服务器ECS的流量。如果obsfs的版本早于2025年,则不支持挂载OBS桶。挂载目录中的文 - [取消挂载对象存储桶](https://support.huaweicloud.com/fstg-obs/obs_12_0019.md): 如果不再需要通过挂载方式访问OBS桶,或者需要对已挂载OBS桶进行参数新增、修改或删除时,可以取消挂载OBS桶。取消挂载OBS桶不会影响已保存至OBS桶中的数据。待取消挂载的OBS桶目前处于挂载状态。是,需退出挂载目录,退出后再执行步骤3。否,执行步骤3。 - [卸载obsfs](https://support.huaweicloud.com/fstg-obs/obs_12_0017.md): 不需要使用obsfs时,用户可以根据本章节说明将obsfs从操作系统中移除。已经卸载掉所有已挂载的并行文件系统和对象存储桶。具体卸载方法请参考取消挂载并行文件系统和取消挂载对象存储桶。提示以下信息为成功:Uninstall obsfs success. - [常见问题](https://support.huaweicloud.com/fstg-obs/obs_12_0010.md): 可以。可以,且每一个挂载进程都是独立的。通过多次调用挂载的命令实现多进程挂载。obsfs挂载到华为云服务器ECS上访问OBS时,会占用OBS流量和ECS弹性网卡流量,如果访问OBS过程中产生公网访问OBS,会额外占用ECS绑定的EIP流量。占用ECS弹性网卡流量不收费。OBS收费规则请详见OBS计费概述。EIP收费规则请详见EIP计费模式 - [挂载OBS失败](https://support.huaweicloud.com/fstg-obs/obs_12_0014.md): 用户在挂载OBS时可能会遇到的不同现象,本章节总结了常见挂载OBS失败的可能原因及解决办法。问题定位:需要挂载并行文件系统或OBS桶不存在。解决办法:并行文件系统名称或OBS桶名称有误,请确认输入名称是否正确。创建一个并行文件系统或OBS桶后再重新挂载。创建的方法参见创建并行文件系统、创建桶。问题定位:挂载的桶不是并行文件系统。解决办法: - [取消挂载OBS失败](https://support.huaweicloud.com/fstg-obs/obs_12_0011.md): 本文根据在取消挂载并行文件系统时遇到的不同现象,总结了常见取消挂载并行文件系统失败的可能原因及解决办法。问题定位:取消挂载时,命令行终端停留在挂载目录或其子目录。解决办法:退出挂载目录后,重新执行取消挂载命令。具体请参考取消挂载并行文件系统和取消挂载对象存储桶。 - [libfuse安装指导](https://support.huaweicloud.com/fstg-obs/obs_12_0016.md): 本章节以安装libfuse 2.9.7为例,介绍其在CentOS 7、SUSE 12以及Ubuntu 16系统上的安装操作。安装编译工具及依赖(需要root权限)。CentOS 7Ubuntu 16下载并解压 libfuse 源码编译生成libfuse.so.2.9.7 (需要root权限)。CentOS 7默认安装的是libfuse.s ## 最佳实践 - [OBS最佳实践汇总](https://support.huaweicloud.com/bestpractice-obs/obs_05_1000.md): 本文汇总了基于对象存储服务(OBS,Object Storage Service)常见应用场景的操作实践,为每个实践提供详细的方案描述和操作指导,帮助用户轻松构建基于OBS的存储业务。为帮助企业高效上云,华为云Solution as Code萃取丰富上云成功实践,提供一系列基于华为云可快速部署的解决方案,帮助用户降低上云门槛。同时开放完整 - [将WordPress远程附件存储到OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1600.md): WordPress是一个基于PHP语言和MySQL数据库开发的博客平台,并逐步演化成一款内容管理系统软件,具有广泛的应用场景。本文介绍如何通过插件,将WordPress远程附件存储到华为云OBS。OBS提供海量、稳定、安全的云存储能力,无需事先规划存储容量,存储资源可线性无限扩展。插件支持的功能如下:支持自定义附件在桶的存储位置。支持OB - [Web端通过PostObject接口直传OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1800.md): 常见的Web端上传方法是用户通过浏览器上传文件至应用服务器,再由应用服务器上传至OBS,数据需要在应用服务器中转,传输效率较低,且多任务同时上传时应用服务器压力大。本文介绍一种在Web端利用PostObject接口直传文件至OBS的方法,即使用表单上传方式上传文件至OBS。如图1所示,该方案省去了应用服务器这一步骤,提高了传输效率,不会对 - [Web端直传OBS并设置上传回调](https://support.huaweicloud.com/bestpractice-obs/obs_05_2317.md): 常见的Web端上传方式是用户通过浏览器上传文件至应用服务器,再由应用服务器上传至OBS,如图1所示,数据需要在应用服务器中转,传输效率较低,且多任务同时上传时应用服务器压力很大。本文介绍一种在Web端利用PostObject接口直传文件至OBS并设置上传回调的方法,即使用表单上传方式上传文件至OBS,上传成功后会回调指定的地址。如方案架构 - [移动应用直传方案概述](https://support.huaweicloud.com/bestpractice-obs/obs_05_1201.md): 在互联网中,使用OBS作为存储在移动APP(手机Android、iOS应用)中获得了越来越广泛的应用。Android和iOS应用使用OBS服务时,不能直接存储访问密钥(AK/SK),这样可能会导致访问密钥(AK/SK)被黑客软件破解获取,进而可能导致存放在云存储中的文件数据被窃取,甚至被篡改。为了更好地保护应用数据,避免被攻击后数据泄露以 - [使用临时安全凭证直传OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1202.md): 使用的方式,可以将应用客户端的数据直传至OBS,或者将存储在OBS里的数据进行下载。具体流程如图1。OBS支持使用临时安全凭证(临时AK/SK和securitytoken)进行授权访问,同时支持为临时安全凭证配置权限策略来指定使用该临时安全凭证时允许执行的操作。什么是临时安全凭证?移动应用客户端可以使用指定了权限策略的临时安全凭证来访问O - [使用临时安全凭证直传OBS并设置上传回调](https://support.huaweicloud.com/bestpractice-obs/obs_05_2316.md): OBS支持使用临时安全凭证(临时AK/SK和securitytoken)进行授权访问,同时支持为临时安全凭证配置权限策略来指定使用该临时安全凭证时允许执行的操作。临时安全凭证的含义请参见什么是临时安全凭证?移动应用客户端可以使用指定了权限策略的临时安全凭证来访问OBS,实现数据直传并设置上传回调,如图1所示。整个过程不会暴露用户的永久AK - [使用预签名URL直传OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1203.md): 应用客户端每个请求都将向应用服务器申请预签名URL,该预签名URL有效期由应用服务器管理。具体流程如图1。角色分析如下:应用客户端:即最终用户手机上的APP,负责向应用服务器申请包含预签名的URL,以及访问OBS完成数据上传或下载。应用服务器:即提供该Android/iOS应用的开发者开发的APP后台服务,用于管理凭证信息以及发放预签名U - [使用预签名URL直传OBS(鸿蒙版)](https://support.huaweicloud.com/bestpractice-obs/obs_05_2318.md): 应用客户端每个请求都将向应用服务器申请预签名URL,该预签名URL有效期由应用服务器管理。具体流程如图1。角色分析如下:应用客户端:即最终用户手机上的APP,负责向应用服务器申请包含预签名的URL,以及访问OBS完成数据上传或下载。应用服务器:即提供该Android/iOS/Harmony应用的开发者开发的APP后台服务,用于管理凭证信息 - [小程序直传OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_2000.md): 微信小程序作为当下流行的移动应用,具有广泛的应用场景。如何通过微信小程序上传文件至对象存储服务OBS成为了一个热点问题,本文将通过一个示例程序进行演示。客户端计算签名时依赖引用“crypto-js”及“js-base64”两个开源组件,因此需要在微信小程序项目中设置使用NPM模块。在微信小程序中进行编译时,如果在引入“crypto-js” - [搬迁本地数据至OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_0110.md): 传统的自建存储服务器已不能满足大量的数据存储需求,主要原因可以归类为以下三点:数据存储量受限于搭建服务器时使用的硬件设备,如果存储量不够,需要重新购买存储硬盘,进行人工扩容。前期安装难、设备成本高、初始投资大、自建周期长、无法匹配快速变更的企业业务。需承担网络信息安全、技术漏洞、误操作等各方面的数据安全风险。OBS提供海量、稳定、安全的云 - [使用备份软件实现本地数据备份至OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_0310.md): 传统的备份与恢复方案需要将备份数据写入磁带等存储设备,然后再运输至数据中心。在此过程中数据的安全及完整性依赖很多因素,比如硬件、人员等等。无论是从前期搭建数据中心还是后期的维护,都使得传统的备份与恢复方案面临着管理复杂、投入成本高的难题。云存储定位于简单、安全、高效且低成本,使其成为磁带等传统存储设备的非常有吸引力的替代品。OBS即一种云 - [迁移第三方云厂商数据至OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_0210.md): 有大量数据在第三方云厂商对象存储上的用户,需要先将第三方云厂商上的对象数据下载到本地,再通过OBS控制台、客户端等工具上传到OBS,整个过程耗时又耗力,容易存在漏传、误传等问题。针对迁移第三方云厂商的对象数据至OBS的场景,华为云提供OMS服务。通过迁移服务,用户只需在控制台配置简单的连接参数以及迁移任务,即可把数据从第三方云厂商轻松、平 - [OBS之间数据迁移](https://support.huaweicloud.com/bestpractice-obs/obs_05_1900.md): 本教程介绍如何通过对象存储迁移服务OMS实现对象存储服务OBS之间跨账号、跨区域、以及同区域内的数据迁移。跨账号迁移:不同的华为云账号之间桶数据迁移。跨区域迁移:不同区域之间的桶数据迁移。同区域迁移:同区域内的桶数据迁移。对象存储迁移服务(Object Storage Migration Service,OMS)是一种线上数据迁移服务,可 - [在ECS上通过内网访问OBS方案概述](https://support.huaweicloud.com/bestpractice-obs/obs_05_0410.md): 某企业基于弹性云服务器(Elastic Cloud Server,ECS)构建好基础的业务后,随着数据增长,硬盘已无法满足大量的图片、视频等数据存取需求。了解到华为云提供有海量、弹性的云存储服务OBS后,决定将OBS作为数据存储资源池,以减轻服务器负担。在ECS上可以通过公网和华为云内网两种网络访问OBS。当有存取对象数据的需求时,公网方 - [在Windows ECS上使用OBS Browser+通过内网访问OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_0420.md): OBS Browser+是一款用于访问和管理对象存储服务的图形化工具,支持通过配置内网DNS服务器地址的方式,使在华为云上的Windows ECS通过内网直接访问OBS,下面将介绍具体操作流程和操作步骤。OBS Browser+需通过公网下载,或者从其他可以访问公网的云服务器下载后传到当前云服务器安装。在登录ECS云服务器之前,请确保您已 - [在Linux ECS上使用obsutil通过内网访问OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_0430.md): obsutil是适用于Windows、macOS和Linux操作系统的命令行工具,支持通过配置内网DNS服务器地址的方式,使在华为云上的Linux ECS通过内网直接访问OBS,下面将介绍其具体操作流程和操作步骤。obsutil需通过公网下载,或者从其他可以访问公网的云服务器下载后传到当前云服务器安装。在登录ECS云服务器之前,请确保您已 - [通过Nginx反向代理访问OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1400.md): 一般情况下,用户会通过OBS提供的桶访问域名(例如https://bucketname.obs.cn-north-4.myhuaweicloud.com)或者绑定的自定义域名来访问OBS。但在某些场景下,用户需要通过固定的IP地址访问OBS,例如:某些企业出于安全考虑,对于可访问的外部地址需要设置黑白名单,而这个时候对于OBS的访问则需要 - [通过云连接CC实现内网跨区域访问OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_2205.md): 为了降低访问延迟、满足当地的数据合规性等需求,您的业务数据可能存储在各区域的OBS桶中,与此同时,您可能需要集中访问、处理和分析各区域OBS桶中的数据。例如,您的ECS云服务器部署在华东-上海一,存储数据的OBS桶可能部署在华北-北京四等其他区域,此时ECS云服务器需要跨区域访问OBS桶。在使用云连接(Cloud Connect,以下简称 - [使用云专线访问OBS概述](https://support.huaweicloud.com/bestpractice-obs/obs_05_2202.md): 使用云专线可以建立企业本地数据中心IDC(Internet Data Center,以下简称IDC)与华为云间的高速、低时延、稳定安全的专属连接通道。帮助您在充分利用华为云服务优势的同时,继续使用现有的线下IT设施,实现灵活一体,可伸缩的混合云计算环境,了解更多请参见云专线使用云专线访问OBS有以下优势:稳定高效的性能体验:云专线提供高带 - [通过专线域名访问OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_2203.md): 如果在IDC和各云厂商多云互联场景下,各云厂商内网IP网段冲突,可以使用专线域名避免冲突问题,访问OBS专门为IDC场景预留的专线IP网段。如图1所示,IDC数据中心访问OBS的原理如下:IDC数据中心使用公网访问OBS提供的专线域名(BucketName.obs-private.RegionID.myhuaweicloud.com)。D - [通过ELB代理访问OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_2204.md): 如果您的IDC机房由于IP规划或其他原因,不能在本地机房配置OBS内网IP、专线IP网段的路由,只能使用虚拟私用云VPC的私有IP网段,可以参考本方案使用ELB代理实现IDC通过VPC私网IP访问云上OBS资源。如图1所示,使用ELB代理实现IDC通过云专线访问OBS的原理如下:IDC数据中心访问VPC私有IP。IDC侧网关将对VPC私有 - [通过CDN加速访问OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_0510.md): 现在越来越多的行业使用OBS存储图片、视频、软件包等静态资源文件,并将OBS作为网站、论坛、APP、游戏等业务的存储源。在需要获取这些静态资源时,用户通过URL直接从OBS请求数据,数据请求过程如图1所示。OBS能够很好地解决本地存储不够用的难题,但一般情况下文件只存储在一个区域,不同区域的用户访问OBS的响应速度存在差异。在需要频繁访问 - [使用自定义域名托管静态网站](https://support.huaweicloud.com/bestpractice-obs/obs_05_0610.md): 当企业有大量静态网站需要提供给用户访问,却不想搭建网站服务器时,可以将静态网站托管在OBS桶中,用户可以直接通过OBS桶绑定的自定义域名访问托管的静态网站。企业将静态网站托管至OBS桶中,并为OBS桶绑定对外的自定义域名。用户访问自定义域名时,即可直接访问到存储在OBS桶中的静态网站。在此之前,您可能需要了解一些关于OBS静态网站托管的基 - [基于crc64或MD5的OBS数据完整性校验](https://support.huaweicloud.com/bestpractice-obs/obs_05_0801.md): 对象数据在上传下载过程中,有可能会因为网络劫持、数据缓存等原因,存在数据不一致的问题。OBS提供通过计算MD5、crc64对上传下载的数据进行完整性校验。默认情况下,OBS不会进行完整性校验,您可以在上传下载时主动启用校验,具体使用方式参见表1。crc64、MD5的完整性校验结果不互通,例如如果您使用crc64方式在上传时通过了完整性校验 - [OBS安全配置建议](https://support.huaweicloud.com/bestpractice-obs/obs_05_2100.md): 安全性是华为云与您的共同责任。华为云负责云服务自身的安全,提供安全的云;作为租户,您需要合理使用云服务提供的安全能力对数据进行保护,安全地使用云。详情请参见责任共担。本文提供了OBS使用过程中的安全最佳实践,旨在为提高整体安全能力提供可操作的规范性指导。根据该指导文档您可以持续评估OBS资源的安全状态,更好的组合使用OBS提供的多种安全能 - [减少因误操作导致的数据丢失风险](https://support.huaweicloud.com/bestpractice-obs/obs_05_2120.md): 华为云无法恢复您主动删除、覆盖、配置规则自动删除或服务协议到期自动删除的OBS数据。为了避免误删操作导致业务无法正常运行,本文提供了几种规避方式,您可结合自身业务选择合适的方案。以下建议并不等同完整的安全解决方案,可能不适合您的环境或不满足您的环境要求,仅作为参考。请务必在日常使用中提高数据安全意识并时刻做好内容安全防范措施。通过控制台、 - [降低因恶意访问导致资金或资源包损失的风险](https://support.huaweicloud.com/bestpractice-obs/obs_05_2321.md): 由于场景和业务存在差异性,以下建议可能无法完全适配您的实际环境或满足特定要求,并不等同完整的安全解决方案,仅作为参考。如果您的OBS桶或并行文件系统遭受恶意攻击或流量盗刷,会引发信息泄露和流量激增,造成资源包耗尽、高额账单等较大的资金损失,且一旦账户余额耗尽进入欠费状态可能会影响业务正常运行:账单风险一旦桶遭受恶意攻击或流量被盗刷,会引发 - [降低因账号密码泄露带来的未授权访问风险](https://support.huaweicloud.com/bestpractice-obs/obs_05_2322.md): 在云服务环境中,账号和密码作为最基本的认证机制,是保护用户资源的第一道防线。一旦这些凭证遭到泄露,攻击者可能获得未经授权的访问权限,进而对存储在云端的对象(如文件、数据库等)执行非法操作,包括但不限于读取、修改或删除数据。这种行为不仅会直接导致数据丢失或损坏,还可能造成财务损失、声誉损害以及法律纠纷。为了确保资源的安全性,建议您不要将所有 - [强制桶加密](https://support.huaweicloud.com/bestpractice-obs/obs_05_2200.md): 如果您的业务场景对安全性、合规性要求较高,可使用Organizations云服务提供的SCP策略,强制要求绑定策略的成员账号在创建桶时必须开启服务端加密,且现有桶不允许执行关闭桶加密操作。在使用华为云的过程中,您可能不仅仅只拥有一个华为账号,而是同时拥有多个华为账号,例如企业A有下属子公司B、C、D,企业A总部有账号a,下属子公司分别有账 - [OBS性能优化建议](https://support.huaweicloud.com/bestpractice-obs/obs_05_1100.md): OBS按照对象名的UTF-8编码范围来进行分区管理,对系统进行水平扩展与动态负载均衡。如果用户在对象命名规则上使用了顺序前缀(如时间戳或字母顺序),可能导致大量对象的请求访问集中于某个特定分区,造成访问热点。热点分区上的请求速率受限,访问时延上升。推荐使用随机前缀对象名,这样请求就会均匀分布在多个分区,达到水平扩展的效果。示例:比如典型的 - [大数据场景下使用OBS实现存算分离方案概述](https://support.huaweicloud.com/bestpractice-obs/obs_05_1501.md): 随着大数据技术的飞速发展,对数据价值的认识逐渐加深,大数据已经融入到了各行各业。根据相关调查报告数据显示,超过39.6%的企业正在应用大数据并从中获益;超过89.6%的企业已经成立或计划成立相关的大数据分析部门;超过六成的企业在扩大大数据的投入力度。对各行业来讲,大数据的使用能力成为未来取得竞争优势的关键能力之一。在大数据场景下,数据已成 - [操作流程](https://support.huaweicloud.com/bestpractice-obs/obs_05_1530.md): 大数据场景下使用OBS实现存算分离的操作流程如图1所示。配置的核心是完成大数据平台与OBS对接,实现OBS作为大数据的统一数据湖存储。本文档提供三种主流大数据平台的对接指导,详情请参见支持的大数据平台简介。(可选)OBS除了可以与主流大数据平台对接外,还可以直接与开源的大数据组件对接。当您使用开源的大数据组件时,可参考支持的大数据组件简介 - [支持的大数据平台简介](https://support.huaweicloud.com/bestpractice-obs/obs_05_1527.md): 华为云大数据存算分离方案中,OBS支持与多种大数据平台对接,包括华为云MapReduce服务(MRS)、Cloudera CDH和Hortonworks HDP,满足用户业务的灵活诉求。华为云MapReduce服务(MRS)是华为云提供的大数据服务,可以在华为云上部署和管理Hadoop系统,一键即可部署Hadoop集群。MRS提供用户完全 - [华为云MRS对接OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1503.md): 详细操作,请参见使用委托方式配置存算分离集群。详细操作,请参见使用存算分离集群。 - [Cloudera CDH对接OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1504.md): 安装版本硬件:1Master+3Core(配置:8U32G,操作系统:CentOS 7.5)软件:CDH 6.0.1部署视图并将OBSA-HDFS工具jar包(如hadoop-huaweicloud-3.1.1-hw-53.8.jar)上传到CDH各节点/opt/obsa-hdfs目录中。hadoop-huaweicloud-x.x.x- - [Hortonworks HDP对接OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1505.md): 安装版本硬件:1master+3core(配置:8U32G,操作系统:CentOS 7.5)软件:Ambari:2.7.1.0,HDP:3.0.1.0部署视图下载OBSA-HDFS工具的jar包(如hadoop-huaweicloud-3.1.1-hw-53.8.jar)到/mnt/obsjar目录。hadoop-huaweicloud- - [支持的大数据组件简介](https://support.huaweicloud.com/bestpractice-obs/obs_05_1528.md): 在华为云大数据存算分离方案中,OBS除了可以与大数据平台对接外,还可以直接与开源的大数据组件对接。当前支持的大数据组件如下:HadoopHiveSparkFlumeDataXDruidFlinklogstash - [Hadoop对接OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1507.md): Hadoop系统提供了分布式存储、计算和资源调度引擎,用于大规模数据处理和分析。OBS服务实现了Hadoop的HDFS协议,在大数据场景中可以替代Hadoop系统中的HDFS服务,实现Spark、MapReduce、Hive等大数据生态与OBS服务的对接,为大数据计算提供“数据湖”存储。HDFS协议:Hadoop中定义了HDFS协议(通过 - [Hive对接OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1508.md): Hive是一个数据仓库工具,可以对存储在分布式存储中的大规模数据进行数据提取、转化和加载,它提供了丰富的SQL查询方式来进行数据分析。已安装Hadoop,具体请参见Hadoop对接OBS。以Hive 2.3.3为例。重命名/opt/hive-2.3.3/conf/hive-env.sh.template为hive-env.sh。重命名/o - [Spark对接OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1509.md): Apache Spark是专为大规模数据处理而设计的快速通用的计算引擎。已安装Hadoop,具体请参见Hadoop对接OBS。为了减少日志输出,在/opt/spark-2.3.3/conf/log4j.properties文件中增加配置:以Spark2.3.3为例。重命名/opt/spark-2.3.3/conf/spark-env.sh - [Presto对接OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1511.md): Presto分为prestoSql(现更名为Trino)和PrestoDB两大分支或是发行版。Presto on OBS仅支持prestoSql/Trino发行版,下述对接步骤以prestoSql-333版本为例(从prestoSql-332版本开始Presto服务端必须使用JDK 11)。本章节中的Presto指prestoSql/Tr - [Flume对接OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1512.md): Flume是一个分布式的、可靠的和高可用的服务,用于收集、聚合以及移动大量日志数据,具体请参见Apache Flume。OBS在大数据场景中可以替代Hadoop系统中的HDFS服务。多sink写同一文件OBS和HDFS在一致性保证上是有差别的:HDFS租约机制可以保证并发写同一个文件时不会产生一致性问题,但是OBS实现的HDFS协议不支持 - [DataX对接OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1513.md): DataX是一个数据同步框架,实现了包括MySQL、SQL Server、Oracle、PostgreSQL、HDFS、Hive、HBase、OTS、ODPS等各种异构数据源之间高效的数据同步功能。OBS在大数据场景中可以替代Hadoop系统中的HDFS服务,本文介绍DataX如何对接OBS。升级hdfsreader和hdfswriter - [Druid对接OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1514.md): Druid专为需要快速数据查询与摄入的工作流程而设计,在即时数据可见性、即席查询、运营分析以及高并发等方面表现非常出色。通过HDFS接口对接OBS,使用OBS提供的OBSA-HDFS工具,无需重新编译druid,将OBS配置为deep storage。修改配置:conf/druid/single-server/micro-quicksta - [Flink对接OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1516.md): Flink是一个分布式的数据处理引擎,用于处理有界和无界流式数据。Flink定义了文件系统抽象,OBS服务实现了Flink的文件系统抽象,使得OBS可以作为flink StateBackend和数据读写的载体。flink-obs-fs-hadoop目前仅支持OBS并行文件系统。为了减少日志输出,在/opt/flink-1.12.1/con - [Logstash对接OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1517.md): Logstash能够从多个来源采集数据、转换数据并将数据发送到存储系统中,具体请参见Logstash。本文用于描述Logstash如何对接使用OBS。请使用较新版本的logstash,例如≥7.10.2的版本,避免使用较老版本的logstash。以logstash-7.10.2为例。示例:以file为源端,以OBS为目的端。创建配置文件f - [Spark on iceberg最佳实践](https://support.huaweicloud.com/bestpractice-obs/obs_05_2323.md): Iceberg是一种开放的数据湖表格式。您可以借助Iceberg快速地在HDFS或者华为云OBS上构建自己的数据湖存储服务,并借助开源大数据生态的Spark、Flink、Hive和Trino等计算引擎来实现数据湖的分析。完成Hadoop部署和对接OBS,详情参考Hadoop对接OBS。完成Spark部署。如果数据目录Catalog选择Hi - [Trino on iceberg最佳实践](https://support.huaweicloud.com/bestpractice-obs/obs_05_2329.md): Iceberg是一种开放的数据湖表格式。您可以借助Iceberg快速地在HDFS或者华为云OBS上构建自己的数据湖存储服务,并借助开源大数据生态的Spark、Flink、Hive和Trino等计算引擎来实现数据湖的分析。其中,Trino是针对OLAP设计的用于高效的分布式查询大量数据的分析引擎。主要具备下列优点:屏蔽底层数据源,提供统一查 - [Spark on Paimon最佳实践](https://support.huaweicloud.com/bestpractice-obs/obs_05_2325.md): Apache Paimon是一个流式数据湖存储技术,它提供高吞吐、低延迟的数据摄入、流式订阅和实时查询。采用开放的ORC、Parquet、Avro文件格式,与Flink、Spark等计算引擎兼容。完成Hadoop部署并对接OBS,详情参考Hadoop对接OBS。完成Spark部署。如果数据目录Catalog选择Hive,Spark请使用预 - [Flink on Paimon最佳实践](https://support.huaweicloud.com/bestpractice-obs/obs_05_2326.md): Apache Paimon是一个流式数据湖存储技术,它提供高吞吐、低延迟的数据摄入、流式订阅和实时查询。采用开放的ORC、Parquet、Avro文件格式,与Flink、Spark等计算引擎兼容。完成Hadoop部署并对接OBS,详情参考Hadoop对接OBS。已部署Flink,并集成Paimon到Flink中,详情参考Flink官方文档 - [Flink使用Hive connector对接OBS指导](https://support.huaweicloud.com/bestpractice-obs/obs_05_2327.md): 通过使用Hive Catalog,Apache Flink可以对Apache Hive表做统一的批处理和流处理。这意味着Flink可以成为Hive批处理引擎的一个性能更好的选择,或者连续读写Hive表中的数据以支持实时数据仓库应用。参考Flink对接OBS完成Flink对接OBS。参考Flink官网文档完成Flink的Hive conne - [StarRocks访问Apache Hive+OBS存算分离指导](https://support.huaweicloud.com/bestpractice-obs/obs_05_2328.md): StarRocks 是一款高性能分析型数据仓库,使用向量化、MPP 架构、CBO、智能物化视图、可实时更新的列式存储引擎等技术实现多维、实时、高并发的数据分析。StarRocks既支持从各类实时和离线的数据源高效导入数据,也支持直接分析数据湖上各种格式的数据。StarRocks 兼容MySQL协议,可使用MySQL客户端和常用BI工具对接 - [迁移HDFS数据至OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_1522.md): 在华为云大数据存算分离方案中,对象存储服务OBS作为统一数据湖存储数据。如果用户数据仍存储在本地HDFS中,则需要先将HDFS的数据迁移至OBS。用户可以使用以下迁移方案中的任意一种完成数据迁移,包括:Distcp方式迁移、CDM方式迁移和OMS方式迁移(OMS仅支持其他云服务厂商对象存储数据迁移至华为云OBS)。Hadoop Distc - [面向AI场景使用OBS+SFS Turbo的存储加速方案概述](https://support.huaweicloud.com/bestpractice-obs/obs_05_2301.md): 近年来,AI快速发展并应用到很多领域中,AI新产品掀起一波又一波热潮,AI应用场景越来越多,有自动驾驶、大模型、AIGC、科学AI等不同行业。AI人工智能的实现需要大量的基础设施资源,包括高性能算力,高速存储和网络带宽等基础设施,即“大算力、大存力、大运力”的AI基础大设施底座,让算力发展不要偏斜。从过去的经典AI,到今天人人谈论的大模型 - [资源和成本规划](https://support.huaweicloud.com/bestpractice-obs/obs_05_2302.md): 本节介绍最佳实践中资源规划情况,包含以下内容:如果您想了解更多本方案相关信息,或在方案使用过程中存在疑问,可通过方案咨询渠道,寻求专业人员支持。 - [操作流程](https://support.huaweicloud.com/bestpractice-obs/obs_05_2303.md): 本文档介绍面向AI场景如何使用OBS+SFS Turbo的存储加速,流程如图1所示。如果您想了解更多本方案相关信息,或在方案使用过程中存在疑问,可通过方案咨询渠道,寻求专业人员支持。 - [创建资源](https://support.huaweicloud.com/bestpractice-obs/obs_05_2305.md): 本最佳实践方案需要使用到VPC、SFS Turbo HPC型文件系统、OBS桶、ModelArts资源池资源。为了提供最佳加速性能,建议SFS Turbo HPC文件系统和ModelArts资源池就近选择在同一个Region的同一个可用区(AZ)。虚拟私有云可以为您构建隔离的、用户自主配置和管理的虚拟网络环境,操作指导请参考创建虚拟私有云 - [配置ModelArts和SFS Turbo间网络直通](https://support.huaweicloud.com/bestpractice-obs/obs_05_2307.md): 选择“允许”。选择云服务,勾选“弹性文件服务(SFSTurbo)”。选择“操作”,勾选只读操作“sfsturbo:shares:showShareNic”、“sfsturbo:shares:listShareNics”,勾选写操作“sfsturbo:shares:addShareNic”、“sfsturbo:shares:deleteSh - [配置SFS Turbo和OBS联动](https://support.huaweicloud.com/bestpractice-obs/obs_05_2308.md): SFS Turbo HPC型文件系统支持无缝访问存储在对象存储OBS存储桶中的对象,您可以指定SFS Turbo内的文件目录与OBS对象存储桶进行关联。更多内容请参考管理SFS Turbo文件系统与OBS桶的存储联动。ModelArts平台默认使用ma-user用户来访问SFS Turbo,建议把“导入的文件权限”和“导入的目录权限”设置 - [配置SFS Turbo数据自动导出到OBS桶](https://support.huaweicloud.com/bestpractice-obs/obs_05_2309.md): 配置自动导出后,训练过程中周期性写入SFS Turbo文件系统的Checkpoint模型文件会自动以异步方式导出到关联的OBS桶中进行长期保存,无需手工导出,异步导出方式不会占用上层训练任务时间。文件导出速度受OBS服务的写入带宽上限影响,默认是16Gbit/s,如果大模型训练生成的Checkpoint文件过大、导出速度过慢,可提交工单申 - [配置SFS Turbo数据淘汰策略](https://support.huaweicloud.com/bestpractice-obs/obs_05_2310.md): SFS Turbo HPC型文件系统绑定OBS后端之后,建议配置缓存数据淘汰功能。SFS Turbo会自动释放设定时间内没有访问过的文件数据内容,仅保留文件元数据,数据内容释放后不占用SFS Turbo文件系统上的存储空间,再次访问该文件时,将重新从OBS中加载文件数据内容。只有已经导出到OBS且满足淘汰时间的数据才会被淘汰。更多内容请参 - [上传数据至OBS并预热到SFS Turbo中](https://support.huaweicloud.com/bestpractice-obs/obs_05_2312.md): 下载ImageNet21K数据集,并上传ImageNet21K数据集至OBS,详细操作指导请参考上传数据至OBS。OBS针对不同场景提供了多种数据上云方案,您可根据数据量、耗时、费用等需求选择适合的方案上传数据至OBS,更多内容请参考数据上云方案。SFS Turbo HPC型文件系统绑定OBS桶后,可以使用数据预热功能,以减少后续训练首次 - [创建训练任务](https://support.huaweicloud.com/bestpractice-obs/obs_05_2313.md): 基于SFS Turbo共享文件存储创建ModelArts训练任务。资源池:专属资源池,选择创建资源中创建的ModelArts资源池。SFS Turbo:增加挂载配置,选择创建资源中创建的SFS Turbo HPC型文件系统。训练作业创建完成后,后台将自动完成容器镜像下载、代码目录下载、执行启动命令等动作。训练作业一般需要运行一段时间,根据 - [例行维护](https://support.huaweicloud.com/bestpractice-obs/obs_05_2314.md): 如果SFS Turbo HPC型文件系统存储空间被写满,会影响业务运行,您可以在CES云监控服务上监控SFS Turbo文件系统的容量使用情况,并创建告警规则,当容量使用率超过一定阈值,可以发送邮件、短信等告警到运维人员。当收到容量监控告警时,您需要及时清理SFS Turbo存储空间、或缩短冷数据淘汰时间加速冷数据淘汰、或对SFS Tur - [常见问题](https://support.huaweicloud.com/bestpractice-obs/obs_05_2315.md): 可以只使用SFS Turbo HPC型文件系统支撑AI训练吗?当数据规模较小,不存在冷热数据分级降本诉求,又希望能方便快捷的构建AI训练系统时,可以选择只使用SFS Turbo高性能文件存储支撑AI训练。当数据规模较小,不存在冷热数据分级降本诉求,又希望能方便快捷的构建AI训练系统时,可以选择只使用SFS Turbo高性能文件存储支撑AI - [结合EG事件通知自动处理OBS桶中的图片](https://support.huaweicloud.com/bestpractice-obs/obs_05_2217.md): 根据业务需求,您在OBS桶中执行上传、删除对象等操作后,希望能够自动触发执行后续操作流程,提升效率。本实践将提供全流程方案,即向源桶中上传图片后,通过EG事件通知功能自动通知下游服务函数工作流FunctionGraph,触发函数为图片添加水印,并将处理后的图片上传至目标桶中。结合EG通知自动处理OBS桶中图片的方案如下:向源桶中上传图片, - [基于全站加速WSA的OBS传输加速最佳实践](https://support.huaweicloud.com/bestpractice-obs/obs_05_2218.md): 远距离数据传输:如果客户端所在区域与数据存储区域相距较远,那么当客户端访问数据时,可能会因为传输距离远引发访问延时长、不稳定等问题,例如全球性的论坛网站、在线协同办公平台等,远距离传输造成的长时延会影响客户上传下载数据的体验。基于全站加速(Whole Site Acceleration,WSA)的传输加速方案可以让全球各地的客户极大地提升 - [使用LTS解析桶日志](https://support.huaweicloud.com/bestpractice-obs/obs_05_2400.md): 开启桶日志记录功能后,OBS会自动对桶的访问请求记录日志,并生成日志文件写入您指定的桶(日志存储桶)中,而后通过对生成的日志文件进行深入分析来进行问题定位或了解访问该桶的用户请求性质、类型、趋势等。本文为您详细介绍通过云日志服务(Log Tank Service,LTS)、事件网格(EventGrid,EG)和函数工作流(Function ## API参考 - [概述](https://support.huaweicloud.com/api-obs/zh-cn_topic_0031051947.md): 欢迎使用对象存储服务OBS(Object Storage Service)。对象存储服务提供海量、安全、高可靠、低成本的数据存储能力,可供用户存储任意类型和大小的数据。适合企业备份/归档、视频点播、视频监控等多种数据存储场景。您可以使用本文档提供的API对OBS进行相关操作,如创建、修改、删除桶,上传、下载、删除对象等。支持的全部操作请参 - [基本概念](https://support.huaweicloud.com/api-obs/obs_04_0004.md): 账号用户注册时的账号,账号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于账号是付费主体,为了确保账号安全,建议您不要直接使用账号进行日常管理工作,而是创建用户并使用他们进行日常管理工作。用户注册时的账号,账号对其所拥有的资源及云服务具有完全的访问权限,可以重置用户密码、分配用户权限等。由于账号是付费主体 - [API概览](https://support.huaweicloud.com/api-obs/obs_04_0005.md): Data+相关API已上线,详情请参见DWR API参考。 - [构造请求](https://support.huaweicloud.com/api-obs/obs_04_0007.md): 本节介绍REST API请求的组成。您还可以通过这个视频教程了解如何构造请求调用API:https://bbs.huaweicloud.com/videos/101580OBS根据桶和对象及携带的资源参数来确定具体的URI,当需要进行资源操作时,可以使用这个URI地址。URI的一般格式为(方括号内为可选项):protocol://[buc - [OBS签名机制概述](https://support.huaweicloud.com/api-obs/obs_04_0009.md): 客户端每次调用OBS API时,都需要在HTTP调用请求中携带签名信息,服务端会对收到的签名信息进行验证。签名验证的目的是:对请求者进行身份验证,防止未授权用户访问。请求携带的签名包含用户相关信息,华为云会对请求者身份进行验证,只有已授权用户的密钥才能通过签名检查,成功调用API。防止传输数据被篡改。对数据签名并检验,保障传输内容完整性。 - [Header中携带签名](https://support.huaweicloud.com/api-obs/obs_04_0010.md): OBS的所有API接口都可以通过在header中携带签名方式来进行身份认证,也是最常用的身份认证方式。如图1所示,在Header中携带签名是指将通过HTTP消息中Authorization header头域携带签名信息。Authorization header头域的格式为:Authorization头域的值,由字符串“OBS”、用户访问密 - [URL中携带签名](https://support.huaweicloud.com/api-obs/obs_04_0011.md): OBS服务支持用户构造一个特定操作的URL,这个URL的Query参数中会包含用户AK、签名、有效期等信息,任何拿到这个URL的人均可执行这个操作,OBS服务收到这个请求后认为该请求就是签发URL用户自己在执行操作。例如构造一个携带签名信息的下载对象的URL,拿到相应URL的人都能下载这个对象,但该URL只在Expires指定的失效时间内 - [基于浏览器上传的表单中携带签名](https://support.huaweicloud.com/api-obs/obs_04_0012.md): OBS服务支持基于浏览器的POST上传对象请求,此类请求的签名信息通过表单的方式上传。计算POST表单上传请求的签名,需要先定义一个安全策略(policy),这个安全策略的作用是限制表单上传的内容,例如规定表单上传对象的对象名前缀必须以“prefix01”开头,使用policy能够帮助您更好的管控桶中的文件。POST上传对象的流程是:下面 - [签名计算工具](https://support.huaweicloud.com/api-obs/obs_04_0171.md): OBS提供可视化签名计算工具,帮助您轻松完成签名计算。本节介绍如何使用工具计算签名如果调用OBS API报如下错误:状态码:403 Forbidden错误码:SignatureDoesNotMatch错误信息:The request signature we calculated does not match the signature - [返回结果](https://support.huaweicloud.com/api-obs/obs_04_0013.md): 请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。状态码是一组从2xx(成功)到4xx或5xx(错误)的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码。对应请求头,响应同样也有响应头,如“Content-Length”。详细的公共响应头字段请参见表1。公共响应头消息头名称描述Content-Length响应消 - [创建桶](https://support.huaweicloud.com/api-obs/obs_04_0015.md): 桶是OBS中存储对象的容器。您需要先创建一个桶,然后才能在OBS中存储数据。下面介绍如何调用创建桶API在指定的区域创建一个桶,API的调用方法请参见如何调用API。已获取AK和SK,获取方法参见获取访问密钥(AK/SK)。您需要规划桶所在的区域信息,并根据区域确定调用API的Endpoint,详细信息请参见地区和终端节点。区域一旦确定, - [获取桶列表](https://support.huaweicloud.com/api-obs/obs_04_0016.md): 如果用户想要查看自己创建的所有桶信息,可以使用获取桶列表接口查看。下面介绍如何调用获取桶列表API,API的调用方法请参见如何调用API。已获取AK和SK,获取方法参见获取访问密钥(AK/SK)。您需要选择一个区域的Endpoint来调用API,详细信息请参见地区和终端节点。示例中使用Apache HttpClient。其中Date头域D - [上传对象](https://support.huaweicloud.com/api-obs/obs_04_0017.md): 您可以根据需要,将任何类型的文件上传到OBS桶中进行存储。下面介绍如何调用PUT上传API在指定的桶中上传对象,API的调用方法请参见如何调用API。已获取AK和SK,获取方法参见获取访问密钥(AK/SK)。已创建了至少一个可用的桶。已准备好了待上传的文件,并了解文件所在的本地完整路径。您需要知道待上传桶所在的区域信息,并根据区域确定调用 - [获取桶列表-ListBuckets](https://support.huaweicloud.com/api-obs/obs_04_0020.md): OBS用户可以通过本接口查询自己创建的所有区域的桶列表。了解更多获取桶列表相关信息,请参见列举桶。终端节点(Endpoint)不会限制查询结果,无论哪一个区域的Endpoint,查询结果都是所有区域的桶列表。创建桶时,请勿并发列举桶。账号根用户具备所有API的调用权限,账号的其他IAM用户需拥有列举桶的权限才能调用当前API,建议使用IA - [创建桶-CreateBucket](https://support.huaweicloud.com/api-obs/obs_04_0021.md): 创建桶是指按照用户指定的桶名创建一个新桶的操作,新桶的桶名在OBS中必须是唯一的。了解更多创建桶的相关信息,请参见创建桶。桶创建成功后,不能修改名称和所属区域。创建时,请设置合适的桶名和区域。一个账号及账号下的所有IAM用户一共可创建100个桶。建议结合OBS细粒度权限控制能力,合理进行桶规划和使用。例如,建议在桶内根据对象前缀划分不同的 - [列举桶内对象-ListObjects](https://support.huaweicloud.com/api-obs/obs_04_0022.md): 调用本接口可以获取桶内对象列表。如果用户在请求中只指定了桶名,则返回信息中会包含桶内部分或所有对象的描述信息(一次最多返回1000个对象信息);如果用户还指定了prefix、marker、max-keys、delimiter参数中的一个或多个,则返回的对象列表将按照如表 URI参数所示规定的语义返回指定的对象。了解更多列举桶内对象相关信息 - [获取桶元数据-GetBucketMetadata](https://support.huaweicloud.com/api-obs/obs_04_0023.md): 可通过本接口获取桶元数据相关信息。了解更多元数据相关介绍,请参见配置、编辑、查看对象元数据。您必须是桶拥有者或拥有获取桶元数据的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种,并配置 - [获取桶区域位置-GetBucketLocation](https://support.huaweicloud.com/api-obs/obs_04_0024.md): 调用该接口可以获取指定桶的区域位置信息。建议使用获取桶元数据-GetBucketMetadata接口来获取桶区域位置。您必须是桶拥有者或拥有获取桶区域位置的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IA - [删除桶-DeleteBucket](https://support.huaweicloud.com/api-obs/obs_04_0025.md): 删除桶操作用于删除用户指定的桶。只有桶的所有者或者拥有桶的删桶policy权限的用户可以执行删除桶的操作,了解更多删除桶相关信息,请参见删除桶。删除桶时,如果服务端返回5XX错误或超时,可能是系统需要时间进行桶信息一致性处理,在此期间桶的信息会不准确,您可以过一段时间再查看桶是否删除成功。如果删除未成功,即还是可以查询到桶,那么需要再次调 - [设置桶默认存储类型-PutBucketStoragePolicy](https://support.huaweicloud.com/api-obs/obs_04_0044.md): OBS支持设置桶的默认存储类型。设置后如果上传对象、复制对象和初始化多段上传任务时未指定对象的存储类型,则该对象的存类型默认取桶的存储类型。了解更多有关存储类型的信息,请参见设置桶和对象的存储类别。归档存储和深度归档存储不支持多AZ。修改桶的默认存储类别不会影响已有对象的存储类别,仅对新上传的对象生效。您必须是桶拥有者或拥有设置桶默认存储 - [获取桶默认存储类型-GetBucketStoragePolicy](https://support.huaweicloud.com/api-obs/obs_04_0045.md): 可通过该接口获取桶默认存储类型相关信息。了解更多有关存储类型的信息,请参见设置桶和对象的存储类别。您必须是桶拥有者或拥有获取桶默认存储类型的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择 - [设置桶归档存储对象直读策略-SetDirectcoldaccess](https://support.huaweicloud.com/api-obs/obs_04_0065.md): 对象直读是指用户可以不用恢复归档存储对象,便能直接对其进行操作。了解更多归档存储数据直读相关信息,请参见归档数据直读。您必须是桶拥有者或拥有设置桶归档存储对象直读策略的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授 - [获取桶归档存储对象直读策略-GetDirectcoldaccess](https://support.huaweicloud.com/api-obs/obs_04_0066.md): 当桶设置了归档存储对象直读状态,可以通过本接口获取指定桶的归档存储对象直读状态信息。了解更多归档存储数据直读相关信息,请参见归档数据直读。您必须是桶拥有者或拥有获取桶归档存储对象直读策略的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略 - [删除桶归档存储对象直读策略-DeleteDirectcoldaccess](https://support.huaweicloud.com/api-obs/obs_04_0067.md): 对于设置了归档存储对象直读状态的桶,可以删除指定桶的归档存储对象直读状态,删除后桶内的归档存储对象不能直接读取。了解更多归档存储数据直读相关信息,请参见归档数据直读。您必须是桶拥有者或拥有删除桶归档存储对象直读策略的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IA - [设置桶配额-SetBucketQuota](https://support.huaweicloud.com/api-obs/obs_04_0052.md): 默认情况下,OBS系统和单个桶都没有总数据容量和对象数量的限制。您可以通过为桶设置配额限制来控制桶内允许上传的对象总容量,超过设置的对象容量后,上传对象会失败(返回HTTP状态码403 Forbidden,错误码InsufficientStorageSpace)。此时如果想要继续上传对象,请扩大配额,或取消配额限制(设置为0),或删除不需 - [获取桶配额-GetBucketQuota](https://support.huaweicloud.com/api-obs/obs_04_0053.md): 调用本接口可以获取桶配置信息,桶配额值的单位为Byte(字节),0代表不设上限。了解更多桶配额相关信息,请参见管理桶配额。您必须是桶拥有者或拥有获取桶配额的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IA - [获取桶存量信息-GetBucketStorageInfo](https://support.huaweicloud.com/api-obs/obs_04_0054.md): 查询桶对象个数及对象占用空间,对象占用空间大小值为Long类型的非负值,单位为Byte(字节)。由于OBS桶存量是后台统计,存量会有一定的时延,不能实时更新,因此不建议对存量做实时校验。OBS的桶容量API增加对各个存储类型的容量统计,目前仅支持部分区域,请以实际操作为准。您必须是桶拥有者或拥有获取桶存量信息的权限,才能调用本接口,建议使 - [设置桶标签-SetBucketTagging](https://support.huaweicloud.com/api-obs/obs_04_0049.md): 标签用于标识OBS中的桶或对象,帮助您对桶或对象进行分类。可以在创建桶时配置桶标签,也可以在创建桶后再配置标签,调用本接口可为一个已经存在的桶添加标签。了解更多桶标签相关信息,请参见桶标签。为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往 - [获取桶标签-GetBucketTagging](https://support.huaweicloud.com/api-obs/obs_04_0050.md): 标签用于标识OBS中的桶或对象,帮助您对桶或对象进行分类。调用本接口可以获取指定桶的标签。了解更多桶标签相关信息,请参见桶标签。您必须是桶拥有者或拥有获取桶标签的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两 - [删除桶标签-DeleteBucketTagging](https://support.huaweicloud.com/api-obs/obs_04_0051.md): 标签用于标识OBS中的桶或对象,帮助您对桶或对象进行分类。调用本接口可以删除指定桶的标签。了解更多桶标签相关信息,请参见桶标签。您必须是桶拥有者或拥有删除桶标签的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两 - [设置桶清单-SetBucketInventory](https://support.huaweicloud.com/api-obs/obs_04_0055.md): 桶清单功能可以定期生成桶内对象的元数据信息,通过查看这些信息,可以帮助您更好地了解桶内对象的状态,调用本接口可以配置桶清单功能。有关更多桶清单的介绍和使用限制,请参见桶清单。您必须是桶拥有者或拥有设置桶清单的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权, - [获取桶清单-GetBucketInventory](https://support.huaweicloud.com/api-obs/obs_04_0056.md): 桶清单功能可以定期生成桶内对象的元数据信息,通过查看这些信息,可以帮助您更好地了解桶内对象的状态,可通过本接口获取桶清单。有关更多桶清单的介绍和使用限制,请参见桶清单。您必须是桶拥有者或拥有获取桶清单的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请 - [列举桶清单-ListBucketInventory](https://support.huaweicloud.com/api-obs/obs_04_0057.md): 桶清单功能可以定期生成桶内对象的元数据信息,通过查看这些信息,可以帮助您更好地了解桶内对象的状态。调用本接口可以获取桶的所有清单配置,获取到的清单配置一次性返回,不分页。有关更多桶清单的介绍和使用限制,请参见桶清单。您必须是桶拥有者或拥有列举桶清单的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不 - [删除桶清单-DeleteBucketInventory](https://support.huaweicloud.com/api-obs/obs_04_0058.md): 调用本接口删除指定桶的清单配置(通过清单id来指定清单配置)。有关更多桶清单的介绍和使用限制,请参见桶清单。您必须是桶拥有者或拥有删除桶清单的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选 - [设置桶日志管理配置-SetBucketLogging](https://support.huaweicloud.com/api-obs/obs_04_0032.md): 用户在创建或访问桶时,默认是不生成桶日志的。用户可通过打开日志配置管理开关,开启桶日志功能。OBS会为您记录跟桶操作相关的各种请求日志,产生的桶日志记录会被存储至同账号同区域下的同一个桶或其他桶中,便于您通过检索和分析日志来完成异常事件回溯和定位等工作。了解更多有关桶日志信息,请参见配置桶的日志记录。日志可以存储在产生日志的源桶,也可以存 - [获取桶日志管理配置-GetBucketLogging](https://support.huaweicloud.com/api-obs/obs_04_0033.md): 开启了桶日志记录功能后,可以通过本接口查询当前桶的日志管理配置情况。了解更多有关桶日志信息,请参见配置桶的日志记录。日志可以存储在产生日志的源桶,也可以存储在其他桶,但日志存储桶和源桶必须属于同一账号下的相同区域。将源桶产生的日志文件存储至日志存储桶,该操作本身也会生成新的日志,此时如果源桶和日志存储桶是同一个,则存储日志操作生成的日志会 - [设置桶策略-SetBucketPolicy](https://support.huaweicloud.com/api-obs/obs_04_0027.md): 使用本接口可以修改或者新建指定桶的桶策略。了解更多桶策略相关信息,请参见配置桶策略。使用桶策略进行权限控制请参考《对象存储服务权限配置指南》的OBS权限控制概述章节。如果桶已经存在一个策略,那么当前请求中的策略将完全覆盖桶中现存的策略。单个桶的桶策略条数(statement)没有限制,但一个桶中所有桶策略的JSON描述总大小不能超过20K - [获取桶策略-GetBucketPolicy](https://support.huaweicloud.com/api-obs/obs_04_0028.md): 如果一个桶设置了桶策略,可通过本接口获取桶策略相关信息。了解更多桶策略相关信息,请参见配置桶策略。跨账号场景,不允许调用本接口。例如,账号A和账号B是两个华为账号,账号A不能设置/获取/删除账号B桶的桶策略。同账号场景,您必须是桶拥有者或拥有获取桶策略的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OB - [删除桶策略-DeleteBucketPolicy](https://support.huaweicloud.com/api-obs/obs_04_0029.md): 可通过本接口删除指定桶上的桶策略。了解更多桶策略相关信息,请参见配置桶策略。无论桶的策略本身是否存在,删除成功后系统都直接返回“204 No Content”的结果。跨账号场景,不允许调用本接口。例如,账号A和账号B是两个华为账号,账号A不能设置/获取/删除账号B桶的桶策略。同账号场景,您必须是桶拥有者或拥有删除桶策略的权限,才能调用本接 - [设置桶ACL-SetBucketAcl](https://support.huaweicloud.com/api-obs/obs_04_0030.md): 可在创建桶时可以设置ACL,也可以创桶后通过本接口设置桶ACL。了解更多有关设置桶ACL相关信息,请参见配置桶ACL。使用桶ACL进行权限控制请参考《对象存储服务权限配置指南》的OBS权限控制概述章节。一个桶的ACL最多支持100条Grant授权。设置桶ACL为幂等的覆盖写语义,新设置的桶ACL将覆盖原有的桶ACL,如果需要修改或者删除某 - [获取桶ACL-GetBucketAcl](https://support.huaweicloud.com/api-obs/obs_04_0031.md): 调用本接口,可获取指定桶的ACL信息。了解更多桶ACL相关信息,请参见配置桶ACL。您必须是桶拥有者或拥有获取桶ACL的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种,并配置相应权限 - [设置桶级阻止公共访问配置-SetBucketPublicAccessBlock](https://support.huaweicloud.com/api-obs/obs_04_0174.md): 公共访问是指请求者无需拥有特定权限或身份验证即可访问桶和桶内数据,此操作存在数据泄露和恶意访问导致大量外网流量的风险。OBS支持为桶配置阻止公共访问功能,可通过本接口设置桶级BPA,从而确保桶内数据的安全性。了解更多设置桶级阻止公共访问配置相关信息,请参见阻止桶公共访问。如果开启阻止公共访问,且开启任一BPA配置项(BlockPublic - [获取桶级阻止公共访问配置-GetBucketPublicAccessBlock](https://support.huaweicloud.com/api-obs/obs_04_0175.md): 可通过本接口获取桶级BPA配置的相关信息。了解更多桶级阻止公共访问配置相关信息,请参见阻止桶公共访问。您必须是桶拥有者或拥有获取桶级阻止公共访问配置的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权 - [删除桶级阻止公共访问配置-DeleteBucketPublicAccessBlock](https://support.huaweicloud.com/api-obs/obs_04_0176.md): 可通过本接口删除桶级BPA配置。了解更多桶级阻止公共访问配置相关信息,请参见阻止桶公共访问。您必须是桶拥有者或拥有删除桶级阻止公共访问配置的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择 - [获取桶公共状态-GetBucketPublicStatus](https://support.huaweicloud.com/api-obs/obs_04_0177.md): 获取OBS桶的公共状态。了解更多桶级阻止公共访问配置相关信息,请参见阻止桶公共访问。您必须是桶拥有者或拥有获取桶公共状态的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种,并配置相应权 - [获取桶策略公共状态-GetBucketPolicyPublicStatus](https://support.huaweicloud.com/api-obs/obs_04_0178.md): 获取OBS桶策略的公共状态。了解更多桶级阻止公共访问配置相关信息,请参见阻止桶公共访问。您必须是桶拥有者或拥有获取桶策略公共状态的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种,并配 - [设置桶的加密配置-SetBucketEncryption](https://support.huaweicloud.com/api-obs/obs_04_0062.md): OBS支持为桶创建或更新默认服务端加密配置信息。设置桶加密配置后,在该桶中上传对象时,会默认采用桶的加密配置对数据进行加密。目前支持配置的服务端加密方式有:KMS托管密钥的服务端加密(SSE-KMS)、OBS托管密钥的服务端加密(SSE-OBS)。了解更多桶加密配置相关信息,请参见服务端加密。一个对象每次上传,只支持一种服务端加密方式。对 - [获取桶的加密配置-GetBucketEncryption](https://support.huaweicloud.com/api-obs/obs_04_0063.md): 当存储桶设置了加密配置,可通过本接口获取桶的加密配置信息。了解更多桶加密配置相关信息,请参见服务端加密。您必须是桶拥有者或拥有获取桶的加密配置的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中 - [删除桶的加密配置-DeleteBucketEncryption](https://support.huaweicloud.com/api-obs/obs_04_0064.md): 当存储桶设置了加密配置,可通过该接口删除桶的加密配置。了解更多桶加密配置相关信息,请参见服务端加密。您必须是桶拥有者或拥有删除桶的加密配置的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择 - [服务端加密](https://support.huaweicloud.com/api-obs/obs_04_0188.md): OBS支持SSE-KMS、SSE-OBS、SSE-C三种加密方式,了解更多服务端加密相关内容请参考服务端加密。OBS支持对已有桶直接设置、获取和删除加密配置,详细API和参数说明参见:设置桶的加密配置、获取桶的加密配置、删除桶的加密配置。同时,OBS还是支持在创桶、上传对象、下载对象、分段上传相关接口、复制对象接口中进行加密设置,下表是相 - [设置桶的CORS配置-SetBucketCors](https://support.huaweicloud.com/api-obs/obs_04_0074.md): CORS(Cross Origin Resource Sharing),即跨域资源共享,是W3C标准化组织提出的一种规范机制,允许客户端的跨域请求的配置。通过本接口可设置桶的CORS配置,托管在OBS中的网站就可以响应另一个网站的跨域请求。了解更多有关跨域资源共享信息,请参见配置跨域资源共享。您必须是桶拥有者或拥有设置桶的CORS配置的权 - [获取桶的CORS配置-GetBucketCors](https://support.huaweicloud.com/api-obs/obs_04_0075.md): 可通过本接口获取桶的CORS配置信息。了解更多有关跨域资源共享信息,请参见配置跨域资源共享。您必须是桶拥有者或拥有获取桶的CORS配置的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种 - [删除桶的CORS配置-DeleteBucketCors](https://support.huaweicloud.com/api-obs/obs_04_0076.md): 可通过本接口删除桶的CORS配置信息,删除后桶以及桶中的对象将不能再被其他网址发送的请求访问。了解更多有关跨域资源共享信息,请参见配置跨域资源共享。您必须是桶拥有者或拥有删除桶的CORS配置的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与 - [配置桶级默认WORM策略-SetBucketObjectLock](https://support.huaweicloud.com/api-obs/obs_04_0167.md): OBS提供合规模式的WORM功能,当桶设置了WORM策略后,如果新上传的对象没有设置保护策略和保护期限,则其会自动应用桶级WORM策略。可通过本接口为指定桶配置默认保护策略和保护期限。了解更多配置桶级默认WORM策略相关信息,请参见配置对象锁定(WORM)防止对象被更改或删除。当您在桶内配置了桶级默认WORM策略以后,如果您在上传对象时没 - [获取桶级默认WORM策略-GetBucketObjectLock](https://support.huaweicloud.com/api-obs/obs_04_0168.md): 当桶设置了桶级默认WORM策略,可以通过本接口获取该桶的桶级默认WORM策略。了解更多桶级默认WORM策略相关信息,请参见配置对象锁定(WORM)防止对象被更改或删除。如果您打开了桶级WORM开关,但从未配置过桶级默认WORM策略,您依然可以使用此接口查看开关的打开情况。开启桶级WORM开关的桶暂不支持跨区域复制能力。在客户销户、欠费超期 - [设置桶的自定义域名-SetBucketCustomdomain](https://support.huaweicloud.com/api-obs/obs_04_0059.md): 调用本接口可为桶设置自定义域名,设置成功之后,用户访问桶的自定义域名就能访问到桶。请确保自定义域名通过DNS能够正确解析到OBS服务。了解更多桶自定义域名相关信息,请参见通过自定义域名访问桶。跨账号场景,不允许调用本接口。例如,账号A和账号B是两个华为账号,账号A不能设置/获取/删除账号B桶的自定义域名。同账号场景,您必须是桶拥有者或拥有 - [获取桶的自定义域名-GetBucketCustomdomain](https://support.huaweicloud.com/api-obs/obs_04_0060.md): 为桶设置了自定义域名后,可以通过本接口获取桶的自定义域名。了解更多桶自定义域名相关信息,请参见通过自定义域名访问桶。跨账号场景,不允许调用本接口。例如,账号A和账号B是两个华为账号,账号A不能设置/获取/删除账号B桶的自定义域名。同账号场景,您必须是桶拥有者或拥有获取桶的自定义域名的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了 - [删除桶的自定义域名-DeleteBucketCustomdomain](https://support.huaweicloud.com/api-obs/obs_04_0061.md): 桶设置了自定义域名后,可以通过本接口删除桶的自定义域名。了解更多桶自定义域名相关信息,请参见通过自定义域名访问桶。跨账号场景,不允许调用本接口。例如,账号A和账号B是两个华为账号,账号A不能设置/获取/删除账号B桶的自定义域名。同账号场景,您必须是桶拥有者或拥有删除桶的自定义域名的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解 - [设置桶的多版本状态-SetBucketVersioning](https://support.huaweicloud.com/api-obs/obs_04_0037.md): 多版本功能可在用户意外覆盖或删除对象的情况下提供一种恢复手段。用户可以使用多版本功能来保存、检索和还原对象的各个版本,这样用户能够从意外操作或应用程序故障中轻松恢复数据。多版本功能还可用于数据保留和存档。可通过本接口设置桶的多版本状态,用来开启或暂停桶的多版本功能。了解更多多版本状态相关信息,请参见多版本控制。多版本控制一旦启动,不可关闭 - [获取桶的多版本状态-GetBucketVersioning](https://support.huaweicloud.com/api-obs/obs_04_0038.md): 可通过本接口获取桶的多版本状态,如果从未设置桶的多版本状态,则此操作不会返回桶的多版本状态,而是返回空响应体。了解更多多版本控制相关信息,请参见多版本控制。多版本控制一旦启动,不可关闭,只能暂停使用。开启了桶级WORM开关,需要先开启多版本控制。使用控制台配置WORM时,控制台会自动开启多版本,并且不允许暂停多版本。使用API配置WORM - [设置桶的生命周期配置-SetBucketLifecycle](https://support.huaweicloud.com/api-obs/obs_04_0034.md): 您可以通过设置生命周期规则来管理对象的生命周期,例如定期将桶中的对象删除或者转换对象的存储类别。生命周期规则详情请参见生命周期。生命周期规则目前仅支持根据前缀和对象标签进行匹配,不支持通配符匹配、后缀匹配以及正则匹配。单个桶的生命周期规则条数没有限制,但单个桶中所有生命周期规则的XML描述总大小不能超过20KB。您最多可以在一个并行文件系 - [获取桶的生命周期配置-GetBucketLifecycle](https://support.huaweicloud.com/api-obs/obs_04_0035.md): 当桶设置了生命周期规则时,可以通过本接口获取桶的生命周期配置信息。了解更多生命周期规则相关信息,请参见生命周期。生命周期规则目前仅支持根据前缀和对象标签进行匹配,不支持通配符匹配、后缀匹配以及正则匹配。单个桶的生命周期规则条数没有限制,但单个桶中所有生命周期规则的XML描述总大小不能超过20KB。您必须是桶拥有者或拥有获取桶的生命周期配置 - [删除桶的生命周期配置-DeleteBucketLifecycle](https://support.huaweicloud.com/api-obs/obs_04_0036.md): 当桶设置了生命周期规则后,可以通过本接口删除指定桶的生命周期配置信息。删除后桶中的对象不会过期,OBS不会自动删除桶中对象。了解更多生命周期规则相关信息,请参见生命周期。您必须是桶拥有者或拥有删除桶的生命周期配置的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM - [设置DIS通知策略-PutDisPolicy](https://support.huaweicloud.com/api-obs/obs_04_0139.md): 可以通过本接口为指定桶配置DIS通知策略。了解更多设置DIS通知策略的相关信息,请参见使用DIS发送OBS事件通知。需要使用IAM的角色与策略授权功能,增加Tenant Administrator权限后才能设置、获取、删除DIS通知策略。使用DIS消息通知需要使用IAM的角色与策略授权功能,创建对OBS云服务的委托,委托赋予的权限需为数据 - [获取DIS通知策略-GetDisPolicy](https://support.huaweicloud.com/api-obs/obs_04_0140.md): 本接口用于查询指定桶的DIS通知策略信息。如果策略存在,则返回成功,status code返回值为200。了解更多设置DIS通知策略的相关信息,请参见使用DIS发送OBS事件通知。您必须是桶拥有者或者拥有Tenant Administrator权限,才能调用本接口。配置Tenant Administrator权限,需要使用角色与策略授权( - [删除DIS通知策略-DeleteDisPolicy](https://support.huaweicloud.com/api-obs/obs_04_0141.md): 本接口用于删除指定桶中配置的全部DIS通知策略。删除成功,status code返回值为204。了解更多设置DIS通知策略的相关信息,请参见使用DIS发送OBS事件通知。您必须是桶拥有者或者拥有Tenant Administrator权限,才能调用本接口。配置Tenant Administrator权限,需要使用角色与策略授权(旧版IAM - [设置桶的跨区域复制配置-SetBucketReplication](https://support.huaweicloud.com/api-obs/obs_04_0046.md): 跨区域复制是指同账号下跨不同区域中的桶自动、异步地复制对象。通过激活跨区域复制,OBS可将新创建的对象及修改的对象从一个源桶复制到不同区域中的目标桶。桶拥有者或拥有设置桶的跨区域复制配置的用户,可以通过本接口设置桶的跨区域复制配置。了解更多跨区域复制相关信息,请参见使用OBS实现同账号跨区域桶之间数据复制。配置跨区域复制需要选择IAM委托 - [获取桶的跨区域复制配置-GetBucketReplication](https://support.huaweicloud.com/api-obs/obs_04_0047.md): 可通过本接口获取指定桶的跨区域复制配置信息。了解更多跨区域复制相关信息,请参见使用OBS实现同账号跨区域桶之间数据复制。您必须是桶拥有者或拥有获取桶的跨区域复制配置的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权 - [删除桶的跨区域复制配置-DeleteBucketReplication](https://support.huaweicloud.com/api-obs/obs_04_0048.md): 用户可通过该接口删除桶的跨区域复制配置信息。了解更多跨区域复制相关信息,请参见使用OBS实现同账号跨区域桶之间数据复制。您必须是桶拥有者或拥有删除桶的跨区域复制配置的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权 - [设置镜像回源规则-PutMirrorBackToSource](https://support.huaweicloud.com/api-obs/obs_04_0119.md): OBS提供数据回源功能,可以在被请求的数据不存在时,通过回源规则从源站获取对应数据。可通过本接口为指定桶设置镜像回源规则。了解更多镜像回源相关信息,请参见使用镜像回源获取源站数据。您必须是桶拥有者或者拥有Tenant Administrator权限,才能调用本接口。配置Tenant Administrator权限,需要使用角色与策略授权( - [获取镜像回源规则-GetMirrorBackToSource](https://support.huaweicloud.com/api-obs/obs_04_0120.md): 当桶设置了镜像回源规则,可以使用本接口查询指定桶的镜像回源策略。如果策略存在,则返回成功,status code返回值为200。了解更多镜像回源相关信息,请参见使用镜像回源获取源站数据。您必须是桶拥有者或者拥有Tenant Administrator权限,才能调用本接口。配置Tenant Administrator权限,需要使用角色与策略 - [删除镜像回源规则-DeleteMirrorBackToSource](https://support.huaweicloud.com/api-obs/obs_04_0121.md): 当桶设置了镜像回源规则,可以使用本接口删除指定桶的镜像回源策略。删除成功,status code返回值为204。了解更多镜像回源相关信息,请参见使用镜像回源获取源站数据。您必须是桶拥有者或者拥有Tenant Administrator权限,才能调用本接口。配置Tenant Administrator权限,需要使用角色与策略授权(旧版IAM - [设置在线解压策略-PutDecompressPolicy](https://support.huaweicloud.com/api-obs/obs_04_0148.md): OBS支持ZIP包上传后自动解压并存放在指定目录。桶设置了在线解压策略后,上传到该桶内的ZIP包如果匹配解压策略,ZIP包将会自动解压到指定目录里。本接口用于为指定桶配置ZIP文件解压策略。了解更多在线解压相关信息,请参见在线解压 。URI 参数 obscompresspolicy 是 OBS 侧定义的子资源名称,是对"压缩/解压缩"功能 - [获取在线解压策略-GetDecompressPolicy](https://support.huaweicloud.com/api-obs/obs_04_0149.md): 可通过本接口查询指定桶的文件解压策略。如果策略存在,则返回成功,status code返回值为200。了解更多在线解压相关信息,请参见在线解压。URI 参数 obscompresspolicy 是 OBS 侧定义的子资源名称,是对"压缩/解压缩"功能的统称;接口名使用 DecompressPolicy 是对该策略实际业务语义(解压缩)的精 - [删除在线解压策略-DeleteDecompressPolicy](https://support.huaweicloud.com/api-obs/obs_04_0150.md): 可通过本接口删除指定桶中配置的文件解压策略,删除成功status code返回值为204。了解更多在线解压相关信息,请参见在线解压。URI 参数 obscompresspolicy 是 OBS 侧定义的子资源名称,是对"压缩/解压缩"功能的统称;接口名使用 DecompressPolicy 是对该策略实际业务语义(解压缩)的精确表达。DE - [设置桶的网站配置-SetBucketWebsite](https://support.huaweicloud.com/api-obs/obs_04_0071.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。可以通过本接口为桶创建或更新网站配置信息。了解更多有关静态网站信息,请参见静态网站托管。基于安全合规要求,华为云对象存储服务OBS禁止通过O - [获取桶的网站配置-GetBucketWebsite](https://support.huaweicloud.com/api-obs/obs_04_0072.md): 可以使用本接口获取指定桶的网站配置信息。了解更多有关静态网站信息,请参见静态网站托管。您必须是桶拥有者或拥有获取桶的网站配置的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种,并配置相 - [删除桶的网站配置-DeleteBucketWebsite](https://support.huaweicloud.com/api-obs/obs_04_0073.md): 可以使用本接口删除指定桶的网站配置信息。了解更多有关静态网站信息,请参见静态网站托管。您必须是桶拥有者或拥有删除桶的网站配置的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种,并配置相 - [OPTIONS桶-OptionsBucket](https://support.huaweicloud.com/api-obs/obs_04_0077.md): OPTIONS称为预检请求(Preflight Request),是浏览器在发送跨域请求前自动发出的检测请求,通常被用于检测客户端是否具有对服务端进行操作的权限。只有当预请求成功返回,客户端才开始执行后续的请求。OBS允许在桶内保存静态的网页资源,在正确的使用下,OBS的桶可以成为网站资源。在这种使用场景下,OBS中的桶作为服务端,需要处 - [PUT上传-PutObject](https://support.huaweicloud.com/api-obs/obs_04_0080.md): 用户在OBS系统中创建了桶之后,可以使用本接口将对象上传到桶中。了解更多上传方式相关介绍,请参见简单上传(PUT上传)。OBS没有文件夹的概念。为了使用户更方便进行管理数据,OBS提供了一种方式模拟文件夹:通过在对象的名称中增加“/”,例如“test/123.jpg”。此时,“test”就被模拟成了一个文件夹,“123.jpg”则模拟成“ - [POST上传-PostObject](https://support.huaweicloud.com/api-obs/obs_04_0081.md): 上传对象操作是指在指定的桶内增加一个对象,执行该操作需要用户拥有对桶的写权限。了解更多上传方式相关介绍,请参见表单上传(POST上传)。PUT上传中参数通过请求头域传递;POST上传则作为消息体中的表单域传递。关于PUT上传的更多详细信息,请参考PUT上传。PUT上传需在URL中指定对象名;POST上传提交的URL为桶域名,无需指定对象名 - [复制对象-CopyObject](https://support.huaweicloud.com/api-obs/obs_04_0082.md): 本接口为已经存在的对象创建一个副本。当进行复制对象操作时,目标对象默认复制源对象的元数据,用户也可以将目标对象的元数据替换为本次请求中所带的元数据。了解更多复制对象相关信息,请参见复制对象。注意,新建的目标对象不会复制源对象的ACL信息,默认的新建对象的ACL是private,用户可以使用设置ACL的操作接口来重新设定新对象的ACL。默认 - [下载对象-GetObject](https://support.huaweicloud.com/api-obs/obs_04_0083.md): 可通过本接口将存储在OBS中的对象下载到本地。了解更多信息请参见下载对象。如果客户端的对象上传时,使用了客户提供的加密密钥进行服务端加密,当下载对象时,同样也必须在消息中提供密钥。默认情况下,获取的是最新版本的对象。如果最新版本的对象是删除标记,则返回对象不存在。如果要获取指定版本的对象,请求可携带versionId消息参数。如果要下载的 - [修改对象元数据-SetObjectMetadata](https://support.huaweicloud.com/api-obs/obs_04_0091.md): 元数据(Metadata)为描述对象属性的信息,是一组名称和值的配对,用作对象管理的一部分。可通过本接口添加、修改或删除桶中已经上传的对象的元数据。了解更多对象元数据相关知识,请参见配置、编辑、查看对象元数据。当桶开启多版本控制时,最新版本的对象支持设置元数据,历史版本的对象不支持设置元数据。对于存储类别为归档存储或深度归档存储的对象,不 - [获取对象元数据-HeadObject](https://support.huaweicloud.com/api-obs/obs_04_0084.md): 拥有对象读权限的用户可以执行HEAD操作命令获取对象元数据,返回信息包含对象的元数据信息。获取采用SSE-C加密的对象的元数据时,需要携带SSE-C相关头域,详见表2。默认情况下,获取的是最新版本的对象元数据。如果最新版本的对象是删除标记,则返回404。如果要获取指定版本的对象元数据,请求可携带versionId消息参数。您必须是对象拥有 - [修改写对象-UploadModifyObject](https://support.huaweicloud.com/api-obs/obs_04_0092.md): 修改写对象操作是指将指定文件桶内的一个对象从指定位置起修改为其他内容。目前接口仅在并行文件系统支持,创建并行文件系统的方法详见请求示例:创建并行文件系统。您必须是对象拥有者或拥有修改写对象的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策 - [删除对象-DeleteObject](https://support.huaweicloud.com/api-obs/obs_04_0085.md): 当对象不再使用或无需保存时,可及时删除,以减少存储空间占用及存储成本。了解更多删除对象相关介绍,请参见删除对象。如果要删除的对象不存在,则仍然返回成功信息。当桶的多版本状态是开启时,不指定版本删除对象将产生一个带唯一版本号的删除标记,并不删除对象;当桶的多版本状态是Suspended时,不指定版本删除将删除版本号为null的对象,并将产生 - [批量删除对象-DeleteObjects](https://support.huaweicloud.com/api-obs/obs_04_0086.md): 批量删除对象特性用于将一个桶内的多个对象一次性删除,删除后不可恢复。批量删除对象支持两种响应方式:quiet模式(Quiet参数设置为True):quiet模式是指在返回响应时,只返回删除失败的对象结果,没有返回的认为删除成功。非quiet模式(系统默认,或Quiet参数设置为False):非quiet模式是指在返回响应时,不管对象是否删 - [恢复归档存储或深度归档存储对象-RestoreObject](https://support.huaweicloud.com/api-obs/obs_04_0087.md): 如果要获取归档存储或深度归档存储对象的内容,需要先将对象恢复,然后再执行下载数据的操作。对象恢复后,会产生一个标准存储类型的对象副本,也就是说会同时存在标准存储类型的对象副本和归档存储或深度归档存储类型的对象,在恢复对象的保存时间到期后标准存储类型的对象副本会自动删除。了解更多恢复归档存储或深度归档存储对象相关信息,请参见恢复归档或深度归 - [追加写对象-AppendObject](https://support.huaweicloud.com/api-obs/obs_04_0088.md): 追加写对象操作是指在指定桶内的一个对象尾追加上传数据,不存在相同对象名的对象则创建新对象。了解更多追加写对象相关信息,请参见追加写对象。通过Append Object操作创建的Object类型为Appendable Object,而通过Put Object上传的Object是Normal Object。为了确保数据在传输过程中没有遭到破坏 - [截断对象-TruncateObject](https://support.huaweicloud.com/api-obs/obs_04_0093.md): 截断对象操作是指将指定文件桶内的一个已有对象截断到指定大小。目前接口仅在并行文件系统支持,创建并行文件系统的方法详见请求示例:创建并行文件系统。您必须是对象拥有者或拥有截断对象的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“ - [重命名对象-RenameObject](https://support.huaweicloud.com/api-obs/obs_04_0094.md): 重命名对象操作是指将指定文件桶内的一个对象重命名为其他对象名。目前接口仅在并行文件系统支持,创建并行文件系统的方法详见请求示例:创建并行文件系统。重命名对象操作为非幂等操作。您必须是对象拥有者或拥有重命名对象的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权 - [列举桶中已初始化多段任务-ListMultipartUploads](https://support.huaweicloud.com/api-obs/obs_04_0097.md): 用户可以通过本接口查询一个桶中所有的初始化后还未合并以及未取消的多段上传任务。了解更多多段上传相关信息,请参见多段上传。文件夹不支持多段上传。一个请求只能上传一个段,可以同时发起多个请求。分段相关限制:分段相关限制项目限制对象大小最大48.8TB每次上传的段的数量最大10000段编号1到10000(含)段大小100KB到5GB,最后一个段 - [初始化上传段任务-InitiateMultipartUpload](https://support.huaweicloud.com/api-obs/obs_04_0098.md): 使用多段上传特性时,须先调用初始化上传段任务接口创建任务,系统会给用户返回一个全局唯一的多段上传任务号,作为任务标识。后续可以根据这个标识发起相关的请求,如:上传段、合并段、列举段等,了解完整的多段上传流程请参见多段上传。创建多段上传任务不影响已有的同名对象;同一个对象可以同时存在多个多段上传任务;每个多段上传任务在初始化时可以附加消息头 - [上传段-UploadPart](https://support.huaweicloud.com/api-obs/obs_04_0099.md): 多段上传任务创建后,用户可以通过指定多段上传任务号,通过上传段接口为特定的任务上传段,从客户端上传新数据,了解完整的多段上传流程请参见多段上传。同一个对象的同一个多段上传任务在上传段时,上传的顺序对后续的合并操作没有影响,也即支持多个段并发上传。请确保段大小范围是[100KB,5GB],最后一个段的大小范围为[0,5GB],否则在进行合并 - [拷贝段-CopyPart](https://support.huaweicloud.com/api-obs/obs_04_0100.md): 添加段的方式还包括调用段拷贝接口,允许用户将已上传对象的一部分或全部拷贝为段。了解完整的多段上传流程请参见多段上传。将源对象(例如:object)拷贝为一个段(例如:part1),如果在拷贝操作之前part1已经存在,拷贝操作执行之后老段数据part1会被新拷贝的段数据覆盖。拷贝成功后,只能列举到最新的段part1,老段数据将会被删除。因 - [列举已上传未合并的段-ListParts](https://support.huaweicloud.com/api-obs/obs_04_0101.md): 用户可以通过本接口查询一个未合并任务所属的所有段信息,了解完整的多段上传流程请参见多段上传。此接口列举的各个段大小和分段上传的各个段大小一致。您必须是桶拥有者或拥有列举已上传未合并的段的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授 - [合并段-CompleteMultipartUpload](https://support.huaweicloud.com/api-obs/obs_04_0102.md): 如果用户上传完所有的段,就可以调用合并段接口,系统将在服务端将用户指定的段合并成一个完整的对象,了解完整的多段上传流程请参见多段上传。在执行“合并段”操作以前,用户不能下载已经上传的数据。在合并段时需要将多段上传任务初始化时记录的附加消息头信息拷贝到对象元数据中,其处理过程和普通上传对象带这些消息头的处理过程相同。在并发合并段的情况下,仍 - [取消多段上传任务-AbortMultipartUpload](https://support.huaweicloud.com/api-obs/obs_04_0103.md): 如果用户希望取消一个任务,可以调用取消多段上传任务接口取消任务,了解完整的duo 段上传流程请参见多段上传。合并段或取消任务接口被调用后,用户不能再对任务进行上传段和列举段的操作。您必须是桶拥有者或拥有取消多段上传任务的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用 - [设置对象ACL-SetObjectAcl](https://support.huaweicloud.com/api-obs/obs_04_0089.md): SSE-KMS方式加密的对象即使设置了ACL,跨租户也不生效。默认情况下,只有对象的创建者才有该对象的读写权限。用户也可以通过本接口设置已有对象的ACL,比如对一个对象可以设置公共访问策略,允许所有人对其都有读权限。了解更多设置对象ACL相关信息,请参见配置对象ACL。默认情况下,更改的是最新版本的对象ACL。要设置指定版本的对象ACL, - [获取对象ACL-GetObjectAcl](https://support.huaweicloud.com/api-obs/obs_04_0090.md): 调用本接口可获取对象ACL配置信息。了解更多对象ACL相关信息,请参见配置对象ACL。默认情况下,获取最新版本的对象ACL。如果最新版本的对象是删除标记,则返回404 Not Found,错误码为NoSuchKey。如果要获取指定版本的对象ACL,请求可携带versionId消息参数。您必须是对象拥有者或拥有获取对象ACL的权限,才能调用 - [回调-Callback](https://support.huaweicloud.com/api-obs/obs_04_0095.md): 用户可以在上传对象请求中设置回调参数,OBS在对象上传成功之后,将上传结果回调特定服务器,并将回调结果返回给用户。了解更多回调相关信息请参考使用上传回调获取对象信息。目前只在POST上传对象、PUT上传对象以及合并段API中支持回调功能。在对象上传成功之后才会回调特定服务器,如果对象上传失败则不会回调。如果上传的图片大小超过25M,则无法 - [设置对象标签-PutObjectTagging](https://support.huaweicloud.com/api-obs/obs_04_0172.md): OBS支持使用对象标签对桶中的对象进行分类,调用本接口可为已有对象添加或更新标签。了解更多对象标签相关信息,请参考对象标签。对象标签功能目前在公测阶段,免费使用;公测结束后,将收取费用。用户读写对象标签必须拥有对应标签操作权限,当前可通过设置桶策略授权给其他用户。默认情况下只有对象的所有者可以执行此操作。并行文件系统不支持给文件添加标签。 - [获取对象标签-GetObjectTagging](https://support.huaweicloud.com/api-obs/obs_04_0164.md): 可通过本接口获取对象的标签信息。了解更多对象标签相关信息,请参考对象标签。您必须是对象拥有者或拥有获取对象标签的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种,并配置相应权限:如果使 - [删除对象标签-DeleteObjectTagging](https://support.huaweicloud.com/api-obs/obs_04_0165.md): 可通过本接口删除对象的标签信息。了解更多对象标签相关信息,请参考对象标签。您必须是对象拥有者或拥有删除对象标签的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。如果使用IAM授权,那么请在“角色与策略授权”、“身份策略授权”两种IAM授权方式中选择一种,并配置相应权限:如果使 - [创建软链接-PutSymlink](https://support.huaweicloud.com/api-obs/obs_04_0186.md): 调用本接口可以为指定对象创建软链接,您可以通过该软链接访问目标对象。未开启多版本,创建软链接时,如果同一路径下存在同名软链接,则旧链接会被新链接覆盖。开启多版本时,旧链接会变为历史版本,新上传的软链接成为当前版本。未开启多版本,创建软链接时,如果同一路径下存在同名对象(非链接),则对象会被软链接覆盖。开启多版本时,旧对象会变为历史版本,新 - [获取软链接-GetSymlink](https://support.huaweicloud.com/api-obs/obs_04_0187.md): 调用此接口获取软链接,您可以获取软链接对象本身的信息,以及软链接对象指向目标对象的对象名。默认获取软链接当前版本指向的目标对象。允许通过指定versionId来获取指定版本。如果软链接的当前版本为删除标记,且不指定versionId,OBS会返回404,在响应头中返回x-obs-delete-marker为true以及版本ID(x-obs - [配置对象级WORM保护策略-SetObjectLock](https://support.huaweicloud.com/api-obs/obs_04_0166.md): 开启了WORM开关的桶,WORM保护策略在API中通过retention(保留策略)参数进行配置,上传的对象支持配置或修改对象保护期限。如果上传对象时没有配置保护期限或自动应用桶级默认保护策略,您可以通过本接口配置对象保护期限。如果上传对象时配置了保护期限或自动应用了默认保护期限,允许用户通过本接口延长保护期限(不允许缩短)。对象保护期限 - [OPTIONS对象-OptionsObject](https://support.huaweicloud.com/api-obs/obs_04_0078.md): OPTIONS对象是CORS预检请求,用于检测实际跨域请求是否会被OBS允许。使用OPTIONS对象前,需要先为桶配置CORS规则,关于CORS的使用说明,请参见章节设置桶的CORS配置-SetBucketCors。OPTIONS对象需在URL中指定对象名,它是检查针对特定对象的跨域访问权限;OPTIONS桶提交的URL为桶域名,无需指定 - [Data+ API](https://support.huaweicloud.com/api-obs/obs_04_0138.md): Data+ API相关文档已迁移至DWR。您可以单击DWR API参考进行查看,并使用API对DWR进行相关操作,如创建、修改、删除算子与工作流,配置触发器等。 - [错误码概述](https://support.huaweicloud.com/api-obs/obs_04_0115.md): 调用接口出错后,系统会返回错误码和相关报错信息。您可以根据报错信息来定位报错原因或寻求技术帮助。如下为报错响应消息样式,由状态码、响应头、响应体三部分组成:以上样式是接口报错会返回的公共响应头和响应体,除此之外许多接口的错误响应还包含其他更丰富的错误信息, 建议将所有错误信息记入日志,方便错误定位和解决。StatusCode:HTTP状态 - [AccessDenied](https://support.huaweicloud.com/api-obs/obs_errorcode_0003.md): 没有权限执行操作。权限不足通常与您配置的IAM策略、桶策略、ACL或其他策略有关,常见的权限不足原因有如下。原因1:未正确配置IAM策略、桶策略或ACL权限。原因2:跨账号访问资源时,仅配置了IAM策略、桶策略、ACL中的一种,权限不足。原因3:被已配置的IAM策略、桶策略、VPCEP策略、所属组织的服务控制策略拒绝访问。原因4:配置了防 - [AccessForbidden](https://support.huaweicloud.com/api-obs/obs_errorcode_0004.md): 报错描述该存储桶未启用CORS。报错原因跨域访问时,桶未配置CORS规则,CORS规则列表为空,导致跨域访问被拒绝。处理建议通过OBS控制台或API配置桶的CORS规则,详情参见配置CORS实现跨域访问OBS。报错描述桶CORS规则无法匹配。报错原因跨域访问时,请求的Origin、请求方法(request method / Access- - [DeregisterUserId](https://support.huaweicloud.com/api-obs/obs_errorcode_0006.md): 报错描述桶归属的华为账号已被注销,或资源已被释放。报错原因账号注销导致报错:如果桶是由账号或账号下的IAM子用户创建的,那么这个桶归属于该账号。如果桶归属的账号已被注销,那么账号资源将会被释放,释放过程中对桶和桶内所有对象的请求会返回报错。账号欠费导致资源释放:如果账号欠费后在保留期内仍旧没有支付欠款,那么账号资源将会被释放,释放过程中对 - [InArrearOrInsufficientBalance](https://support.huaweicloud.com/api-obs/obs_errorcode_0007.md): 报错描述欠款或余额不足。报错原因账号欠费后,账号进入宽限期,您需要在宽限期内支付欠费金额。如果宽限期截止前未支付,那么资源会进入保留期,资源状态变为“已冻结”。如果请求方账号处于欠费保留期,则资源被冻结无法访问。如果被访问的资源归属的账号处于欠费保留期,则资源被冻结无法访问。处理建议如果请求方账号欠费,请给请求方账号充值。如果被访问资源归 - [InsufficientStorageSpace](https://support.huaweicloud.com/api-obs/obs_errorcode_0008.md): 报错描述桶配额不足。报错原因桶中所有对象大小的总和,已经超过了预置的桶配额。处理建议调整桶配额或者清理桶内优先级低的数据。相关文档获取桶内存储对象的大小,可参考获取桶存量。您可以结合使用生命周期功能高效管理和删除数据。设置桶配额API参见设置桶配额-SetBucketQuota,获取桶配额API参见获取桶配额-GetBucketQuota - [InvalidAccessKeyId](https://support.huaweicloud.com/api-obs/obs_errorcode_0009.md): 报错描述Security Token无效。相关知识:临时AK/SK和SecurityToken,共同组成了用户的临时安全凭证。临时安全凭证存在有效期,有效期内可以使用凭证访问云服务,超出有效期凭证作废。报错原因原因1:请求使用的Security Token格式错误,可能已损坏或不完整。原因2:请求使用的Security Token已过期。 - [InvalidObjectState](https://support.huaweicloud.com/api-obs/obs_errorcode_0010.md): 报错描述操作对于对象的存储类别无效。报错原因对象的存储类型是归档存储或深度归档存储,需要先完成恢复才能访问(包括读取、下载、通过对象URL访问对象、修改对象存储类别等)。如果访问时对象未恢复,或者正在恢复中,会返回本错误。处理建议参考恢复归档或深度归档存储对象,对对象进行恢复操作。如果已恢复,请等待恢复完成后再复制,如何查看恢复进度请参见 - [NotSignedUp](https://support.huaweicloud.com/api-obs/obs_errorcode_0011.md): 报错描述账号未开通OBS服务。报错原因用户账号未注册OBS服务。处理建议请提交工单联系技术人员开通OBS服务。 - [RequestTimeTooSkewed](https://support.huaweicloud.com/api-obs/obs_errorcode_0012.md): 报错描述请求尚未生效报错原因请求头域中携带签名情况下,客户端指定的请求生成时间晚于服务器当前时间超过15分钟。处理建议确保客户端时间与服务端时间(GMT时间)同步。在生成请求时使用系统当前时间作为请求时间戳,不要手动设置或修改请求时间戳。报错描述请求已失效报错原因请求头域中携带签名情况下,客户端指定的请求生成的时间早于服务器当前时间超过1 - [SignatureDoesNotMatch](https://support.huaweicloud.com/api-obs/obs_errorcode_0013.md): 请求签名在服务端的计算结果与您提供的结果不匹配。服务端计算的请求签名与您提供的签名不匹配。基于签名计算原理,签名不匹配通常为以下原因:1. 服务端构造的StringToSign与客户端构造的不同。2. 服务端使用的访问密钥AK/SK与客户端使用的不同。获取服务端StringToSign:以下为签名校验失败时的响应消息示例,其中返回的Str - [VirtualHostDomainRequired](https://support.huaweicloud.com/api-obs/obs_errorcode_0014.md): 报错描述访问特定桶时需要使用虚拟主机域名。报错原因使用路径访问方式(path请求方式)访问特定桶,但当前配置要求必须使用虚拟主机访问方式,不可以使用path请求方式。处理建议path请求方式:桶名不在访问域名中,而在URL参数中的访问请求,即https://obs.regionID.myhuaweicloud.com/${bucketna - [Unauthorized](https://support.huaweicloud.com/api-obs/obs_errorcode_0015.md): 报错描述用户未实名认证报错原因中国站用户未实名认证,访问任意Region,拒绝访问。中国站用户未实名认证,使用全局域名(obs.myhuaweicloud.com)列举桶,拒绝访问处理建议参考个人账号如何完成实名认证或企业账号如何完成实名认证,完成个人或企业账号实名认证。 - [RequestPayerDenied](https://support.huaweicloud.com/api-obs/obs_errorcode_0016.md): 报错描述桶为请求者付费桶,访问被拒绝。报错原因原因1:桶是请求者付费桶,但请求者是匿名用户。原因2:桶是请求者付费桶,请求者不是桶的所有者,且请求中未携带“x-obs-request-payer”头域。处理建议针对原因1:使用认证用户身份发起请求,确保请求携带有效的AK/SK或临时凭证。针对原因2:在请求中添加x-obs-request- - [UserRestricted](https://support.huaweicloud.com/api-obs/obs_errorcode_0017.md): 报错描述针对受限用户,该操作被禁止。报错原因中国站未实名认证、余额不足,导致创建桶操作被禁止。处理建议中国站用户请进行实名认证并检查账户余额,如果账号是欠费状态,请尽快进行账户充值。 - [NoSuchLifecycleConfiguration](https://support.huaweicloud.com/api-obs/obs_errorcode_0019.md): The lifecycle configuration does not exist报错描述没有找到生命周期配置。报错原因桶未配置生命周期规则,导致查询规则时报错404。处理建议查询规则前,请先参见配置生命周期规则为桶设置规则。 - [NoSuchBucket](https://support.huaweicloud.com/api-obs/obs_errorcode_0020.md): The specified bucket does not exist报错描述没有找到桶报错原因原因1:请求中指定的桶名和实际桶名不一致。原因2:桶未创建,或已经被删除。处理建议针对原因1:检查请求中的桶名字符串是否与实际桶名一致,是否存在多余字符、缺失字符或字符写错的情况。检查请求中的桶名字符串是否与实际桶名一致,是否存在多余字符、缺失 - [NoSuchBucketPolicy](https://support.huaweicloud.com/api-obs/obs_errorcode_0022.md): The bucket policy does not exist报错描述桶策略不存在。报错原因当请求要获取桶策略配置时,如果之前没有配置桶策略,那么会报错桶策略不存在。处理建议如果您需要授权其他用户访问您的桶和对象,可使用桶策略为其配置权限。 - [NoSuchCORSConfiguration](https://support.huaweicloud.com/api-obs/obs_errorcode_0023.md): The CORS Configuration does not exist报错描述CORS配置不存在。报错原因当请求要获取桶的CORS规则时,如果桶之前没有配置CORS规则,那么会报错CORS配置不存在。处理建议如果您想要允许相应的跨域请求,请为桶配置CORS实现跨域访问OBS。 - [NoSuchCustomDomain](https://support.huaweicloud.com/api-obs/obs_errorcode_0024.md): The specified custom domain does not configured.报错描述请求的自定义域名未配置到任何桶。报错原因原因1:请求中指定的自定义域名和实际域名不一致。原因2:自定义域名并没有成功绑定到桶。处理建议针对原因1:检查请求中的自定义域名字符串是否与实际域名一致,是否存在多余字符、缺失字符或字符写错的情况 - [NoSuchKey](https://support.huaweicloud.com/api-obs/obs_errorcode_0025.md): The specified key does not exist报错描述对象不存在。报错原因原因1:请求中指定的对象名和实际对象名不一致。原因2:触发生命周期规则,对象被删除。原因3:对象被其他具有合法权限的用户通过OBS控制台、工具或API等方式删除。原因4:目标桶与其他桶存在跨区域复制关系,其他桶中执行的删除操作被同步到目标桶中,此时 - [NoSuchUpload](https://support.huaweicloud.com/api-obs/obs_errorcode_0026.md): The specified upload does not exist. The upload ID may be invalid, or the upload may have been aborted or completed报错描述在上传段、拷贝段、列举段、合并段时,指定的多段上传任务不存在。上传ID可能无效,或者该上传任务可能已被 - [NoSuchVersion](https://support.huaweicloud.com/api-obs/obs_errorcode_0027.md): The specified version does not exist报错描述指定的对象版本不存在。报错原因当桶开启多版本控制后,单个对象可能会对应多个对象版本。访问对象时,您可以通过携带版本ID的方式,访问指定版本。当指定版本不存在时,报404 NoSuchVersion错误。不存在的原因如下:原因1:版本ID错误,与实际版本ID不一 - [NoSuchWebsiteConfiguration](https://support.huaweicloud.com/api-obs/obs_errorcode_0028.md): The specified bucket does not have a website configuration报错描述指定桶没有网站配置。报错原因当获取桶的网站配置时,目标桶未配置静态网站托管。处理建议请在获取网站配置前,先为目标桶配置静态网站托管,详情请参见静态网站托管 。 - [SymlinkTargetNotExist](https://support.huaweicloud.com/api-obs/obs_errorcode_0029.md): The symlink target object does not exist报错描述软链接指向的目标对象不存在。报错原因通过下载对象或者获取对象元数据访问软链接对象时,软链接指向的目标对象不存在。处理建议请确保软链接指向的目标对象已存在。可先使用获取软链接-GetSymlink接口获取软链接指向的目标对象名,然后使用获取对象元数据-H - [权限和授权项说明](https://support.huaweicloud.com/api-obs/obs_04_0110.md): 如果您需要对您所拥有的OBS进行精细的权限管理,您可以使用统一身份认证服务(Identity and Access Management,简称IAM),如果所具备的权限功能已经能满足您的要求,您可以跳过本章节,不影响您使用OBS的其他功能。通过IAM,您可以通过授权的方式来控制主体对资源的访问范围。主体可以对资源发出操作请求,包含IAM用 - [策略授权参考](https://support.huaweicloud.com/api-obs/obs_04_0111.md): 本章节介绍OBS策略授权场景下支持的策略授权项。策略包含系统策略和自定义策略,如果系统策略不满足授权要求,管理员可以创建自定义策略,并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应,授权项列表说明如下:权限:允许或拒绝对指定资源在特定条件下进行某项操作。对应API接口:自定义策略实际调用的API接口。授权项: - [身份策略授权参考(新版IAM)](https://support.huaweicloud.com/api-obs/obs_04_0112.md): 云服务在IAM预置了常用的权限,称为系统身份策略。如果IAM系统身份策略无法满足授权要求,管理员可以根据各服务支持的授权项,创建IAM自定义身份策略来进行精细的访问控制,IAM自定义身份策略是对系统身份策略的扩展和补充。除IAM服务外,Organizations服务中的服务控制策略(Service Control Policy,以下简称S - [状态码](https://support.huaweicloud.com/api-obs/obs_04_0114.md): 服务器向用户返回的状态码和提示信息如表1所示,其中2xx表示访问成功,3xx表示重定向,4xx和5xx表示调用出错,具体错误码说明请参见错误码详情。注:请使用符合RFC 7230与RFC 7231规定的HTTP/1.1请求格式发送 API 请求。 - [获取访问密钥(AK/SK)](https://support.huaweicloud.com/api-obs/obs_04_0116.md): IAM用户如果希望使用AK/SK访问OBS,必须要账号为其开启“编程访问”。开启方法请参见查看或修改IAM用户信息。在调用接口的时候,需要使用AK/SK进行签名验证。AK/SK获取步骤如下:如果已开启操作保护,则需进行此验证。为防止访问密钥泄露,建议您将其保存到安全的位置。如果需要了解访问密钥相关内容,如查看访问密钥、启用/停用访问密钥、 - [获取账号、IAM用户、项目、用户组、区域、委托方账号ID、委托的名称和ID](https://support.huaweicloud.com/api-obs/obs_04_0117.md): 从控制台获取账号名、账号ID、用户名、用户ID、项目名称、项目ID在华为云首页右上角,单击“控制台”。在右上角的用户名中选择我的凭证。进入我的凭证在“我的凭证”界面,API凭证页签中,查看账号名、账号ID、用户名、用户ID、项目名称、项目ID。每个区域的项目ID有所不同,需要根据业务所在的区域获取对应的项目ID。查看账号名、账号ID、用户 - [并发一致性说明](https://support.huaweicloud.com/api-obs/obs_04_0118.md): 当客户端发起的写/删除请求返回成功之后,客户端可以获取到最新数据。当写操作客户端等待超时、服务端返回500或者503的HTTP响应错误码时,之后的读取操作有可能成功读取到数据,也有可能读不到数据。建议客户端在出现上述错误时,查询数据是否已经上传成功(如可通过HEAD请求查询对象是否存在),如果不成功则重新上传。针对同一个对象或桶的操作,比 ## SDK参考 - [SDK概述](https://support.huaweicloud.com/sdkreference-obs/obs_02_0001.md): 对象存储服务软件开发工具包(OBS SDK,Object Storage Service Software Development Kit)是对OBS服务提供的REST API进行的封装,以简化用户的开发工作。用户直接调用OBS SDK提供的接口函数即可实现使用OBS服务业务能力的目的。同时,我们针对不同语言的SDK提供了开发指南和API - [使用前须知(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0101.md): 本文介绍Java SDK的版本变更,并提供版本兼容性说明,以及其他使用前须知。如表1所示,本节将为您展示Java SDK的版本变更情况和兼容性说明。完整的版本变更情况请参见:ChangeLog。推荐使用的JDK版本:JDK 8及以上版本。旧版本(2.x)已不再维护,建议尽快升级至最新版。本文档是与OBS SDK配套的参考文档,为了您能更好 - [Java SDK接口概览(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0002.md): 桶相关接口如下表所示。并行文件系统相关接口如下表所示。对象相关接口如下表所示。临时授权访问相关接口如下表所示。多版本控制相关接口如下表所示。生命周期管理相关接口如下表所示。跨域资源共享相关接口如下表所示。设置访问日志相关接口如下表所示。静态网站托管相关接口如下表所示。标签管理相关接口如下表所示。 - [使用前准备(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0102.md): 在使用Java SDK访问对象存储服务OBS之前,您需要先完成服务环境的准备和开发环境的准备。服务环境准备包括准备账号和访问密钥,是使用SDK与OBS云服务交互的必要条件。开发环境准备是指为了您能顺利完成SDK的安装、完成基于SDK的代码开发与运行,需要提前在本地完成开发环境的搭建,比如下载安装依赖软件、安装开发工具等。使用OBS之前您必 - [下载与安装SDK(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0001.md): OBS Java SDK最新版本源码:最新版本源码下载OBS Java SDK历史版本下载地址:历史版本下载如需采用Maven依赖方式获取SDK,请参见安装SDK章节。如表1所示,Java SDK支持的安装方式如下。使用本方式安装SDK前,请确保Java环境和Maven环境正确配置并能正常使用。Bundle版本与普通版本源代码相同,区别在 - [快速入门(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0100.md): 本节介绍在完成SDK的下载和安装后,如何快速上手使用OBS的基础功能,完成创建桶、上传下载对象、列举对象和删除对象。使用SDK管理OBS资源,您需要先完成以下几项准备工作:使用前须知(Java SDK):了解并选择合适的SDK版本。使用前准备(Java SDK):完成服务环境和开发环境准备。下载与安装SDK(Java SDK):下载SDK - [初始化概述(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0201.md): 完成SDK安装之后,您还需要进行初始化工作,初始化工作主要包括两方面,一方面是客户端的创建和配置,另一方面是SDK日志配置。 - [创建并配置客户端(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0202.md): 本章节指导客户创建并配置客户端,该任务是使用SDK与OBS交互的必备前置任务。如果您已有客户端,请跳过该节,直接参考Java SDK接口概览(Java SDK)获取接口信息。初始化客户端之前,您需要先完成以下几项准备工作:使用前须知(Java SDK):了解并选择合适的SDK版本。使用前准备(Java SDK):完成服务环境和开发环境准备 - [配置SDK日志(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0204.md): OBS Java SDK基于Apache Log4j2开源库提供了日志功能,您可以通过修改日志配置文件定制日志功能。您可以从日志分析章节获取更多关于SDK日志的信息。您可以根据实际需要通过修改log4j2.xml文件来配置日志文件权限。 - [创建桶(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0401.md): OBS桶是对象的容器,您上传的文件都将以对象的形式存放在桶中。本文介绍如何使用Java SDK创建桶。调用创建桶接口,将在指定的终端节点按照用户指定的桶名创建一个新桶,接口支持根据用户诉求,在创建桶的同时配置桶的存储类别、区域及桶ACL等参数。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求 - [列举桶(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0402.md): OBS桶是对象的容器,您上传的文件都存放在桶中。调用列举桶接口,可列举当前账号所有地域下符合指定条件的桶。返回结果以桶名的字典序排序。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须拥有obs:bucket:ListAllMyBuckets权限,才能获取桶列表。建议使用IAM进行授 - [删除桶(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0403.md): 桶为空时,用户可以删除桶,以免占用桶数量配额。删除桶后需要等待30分钟才能创建同名桶。华为云无法恢复用户主动删除的OBS数据。因此调用接口删除桶后,桶相关数据无法恢复,请谨慎操作。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。待删除的桶必须为空,桶为空包含两方面含义:桶内没有任何对象, - [获取桶区域位置(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0408.md): 您可以通过ObsClient.getBucketLocation获取桶的区域位置。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取桶区域位置的权限,才能获取桶区域位置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucket - [获取桶元数据(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0405.md): 调用获取桶元数据接口,可获取指定桶的相关信息,包括指定桶的存储类别、区域位置、跨域资源共享(CORS)规则、冗余策略等信息。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取桶元数据的权限,才能获取桶元数据。建议使用IAM或桶策略进行授权,如果使用IAM则需授予o - [判断桶是否存在(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0404.md): 判断指定桶名的桶是否存在,返回的结果中HTTP状态码为200表明桶存在,返回404表明桶不存在。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有判断桶是否存在的权限,才能判断桶是否存在。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:He - [设置桶存储类别(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0411.md): OBS提供了这些存储类别:标准存储、低频访问存储、归档存储、深度归档存储,从而满足客户业务对存储性能、成本的不同诉求。调用设置桶存储类别接口,可设置指定桶的存储类别。设置了桶的默认存储类别之后,如果上传对象、复制对象和初始化多段上传任务时未指定对象的存储类别,则该对象的存储类别默认与桶的存储类别保持一致。开发过程中,您有任何问题可以在Gi - [获取桶存储类别(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0416.md): OBS提供了这些存储类别:标准存储、低频访问存储、归档存储、深度归档存储,从而满足客户业务对存储性能、成本的不同诉求。调用获取桶存储类别接口,可获取指定桶的存储类别。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取桶存储类别的权限,才能获取桶存储类别。建议使用I - [设置桶归档存储对象直读策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1732.md): 用户可通过本章节指导设置桶的归档存储对象直读策略。您必须是桶拥有者或拥有设置桶归档存储对象直读策略的权限,才能设置桶归档存储对象直读策略。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutDirectColdAccessConfiguration权限,如果使用桶策略则需授予PutDirectColdAcce - [获取桶归档存储对象直读策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1733.md): 用户可通过本章节指导获取桶的归档存储对象直读策略。您必须是桶拥有者或拥有获取桶归档存储对象直读策略的权限,才能获取桶归档存储对象直读策略。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetDirectColdAccessConfiguration权限,如果使用桶策略则需授予GetDirectColdAcce - [删除桶归档存储对象直读策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1734.md): 用户可通过本章节指导删除桶的归档存储对象直读策略。您必须是桶拥有者或拥有删除桶归档存储对象直读策略的权限,才能删除桶归档存储对象直读策略。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteDirectColdAccessConfiguration权限,如果使用桶策略则需授予DeleteDirectCo - [设置桶配额(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0410.md): 桶配额是桶容量的上限值。默认情况下,OBS系统和单个桶都没有总数据容量和对象数量的限制。您可以根据需要,为桶设置配额限制来控制桶内允许上传的对象总容量,超过设置的对象容量后,上传对象会失败。例如您为桶设置配额为100G,那么当桶内所有对象的大小总和达到100G后,再上传对象就会因为超过配额导致上传失败。容量限制只对桶配额设置生效后的对象上 - [获取桶配额(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0415.md): 桶配额是桶容量的上限值。调用获取桶配额接口,可获取指定桶的配额值。桶配额为0代表桶容量没有上限。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶配额值必须为非负整数,单位为字节。桶的拥有者的账号处于欠费冻结状态时不可以查询桶配额信息。您必须是桶拥有者或拥有获取桶配额的权限,才能获取桶配 - [获取桶存量信息(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0409.md): 桶存量信息包括桶已使用的空间大小以及桶包含的对象个数。您可以通过ObsClient.getBucketStorageInfo获取桶的存量信息。由于OBS桶存量是后台统计,因此存量会有一定的时延,不能实时更新,因此不建议对存量做实时校验。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必 - [桶标签简介(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1701.md): 开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。标签用于标识OBS中的桶,以此来达到对OBS中的桶进行分类的目的。为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,用户可以用 - [设置桶标签(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1702.md): 为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,用户可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的标签来分析此应用的成本。调用设置桶标签接口,您可为指定桶添加标签。开发过程中,您有任何问题可以在 - [获取桶标签(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1703.md): 为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,用户可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的标签来分析此应用的成本。调用获取桶标签接口,您可获取指定桶的标签。开发过程中,您有任何问题可以在 - [删除桶标签(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1704.md): 为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,用户可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的标签来分析此应用的成本。调用删除桶标签接口,您可删除指定桶的标签。开发过程中,您有任何问题可以在 - [设置桶清单规则(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0417.md): 桶清单功能可以定期生成桶内对象的相关信息,保存在CSV格式的文件中,并上传到您指定的桶中,方便您管理桶内对象。目标桶和源桶可以是同一个桶。指定的对象内容包括对象版本、大小、上次修改时间、存储类别、标签、加密状态等。支持对桶清单加密,加密方式为SSE-KMS方式。您必须是桶拥有者或者拥有设置桶清单权限,才能设置桶清单。建议使用IAM或桶策略 - [获取桶清单规则(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0418.md): 您可以使用获取桶清单规则接口获取指定桶的清单规则,可以通过配置规则id来选择指定清单规则。您必须是桶拥有者或者拥有获取桶清单权限,才能获取桶清单。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetInventoryConfiguration权限,如果使用桶策略则需授予GetInventoryConfigur - [列举桶清单规则(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0419.md): OBS使用不带清单id的GET操作来获取指定桶的所有清单配置,获取到的清单配置一次性返回,不分页。您必须是桶拥有者或者拥有列举桶清单权限,才能列举桶清单。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetInventoryConfiguration权限,如果使用桶策略则需授予GetInventoryConf - [删除桶清单规则(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0420.md): OBS使用DELETE操作来删除指定桶的清单配置(通过清单规则id来指定确认要删除的桶清单规则)。您必须是桶拥有者或者拥有获取桶清单权限,才能获取桶清单。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketInventoryConfiguration权限,如果使用桶策略则需授予DeleteB - [日志简介(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1501.md): 开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS允许您对桶设置访问日志记录,设置之后对于桶的访问会被记录成日志,日志存储在OBS上您指定的目标桶中。出于分析或审计等目的,用户可以开启日志记录功能。通过访问日志记录,桶的拥有者可以深入分析访问该桶的用户请求性质、类型或趋势。当用户开启 - [设置桶日志规则(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1502.md): 调用设置桶日志管理配置接口,您可以为指定桶打开桶日志功能,并配置日志存放的目标桶。创建桶时,默认是不生成桶的日志的,调用Java SDK的设置桶日志管理配置接口时,接口会自动为您打开桶日志配置。桶日志功能开启后,桶的每次操作将会产生一条日志,并将多条日志打包成一个日志文件。日志文件存放位置需要在开启桶日志功能时指定,可以存放到开启日志功能 - [获取桶日志规则(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1503.md): 调用获取桶日志管理配置,可获取指定桶的日志配置。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取桶日志管理配置的权限,才能获取桶日志管理配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketLogging权限,如果使 - [设置桶ACL(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0406.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [获取桶ACL(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0412.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [设置桶策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0407.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。桶策略是作用于所配置的OBS桶及桶内对象的,您可以通过桶策略可为IAM用户 - [获取桶策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0413.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。调用获取桶策略接口,您可获取指定桶的桶策略。开发过程中,您有任何问题可以在 - [删除桶策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0414.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。调用ObsClient.deleteBucketPolicy接口,您可删除 - [设置桶的BPA配置(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1718.md): 创建或修改OBS桶的PublicAccessBlock配置,以开启或关闭阻止公开访问。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有设置桶BPA配置的权限,才能设置桶BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutBu - [获取桶的BPA配置(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1719.md): 获取OBS桶的PublicAccessBlock配置。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取桶的BPA配置的权限,才能获取桶的BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPublicAcce - [删除桶的BPA配置(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1720.md): 删除OBS桶的PublicAccessBlock配置。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有删除桶的BPA配置的权限,才能删除桶的BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketPublicA - [查询桶策略公开状态(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1721.md): 获取OBS桶策略的公开状态。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取桶策略公开状态的权限,才能获取桶策略公开状态。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPolicyPublicStatus权限,如果 - [查询桶公开状态(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1722.md): 获取OBS桶的公开状态。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取桶公开状态的权限,才能获取桶公开状态。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPublicStatus权限,如果使用桶策略则需授予Get - [服务端加密简介(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1901.md): 开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。用户可以使用普通方式上传、下载对象,也可以使用服务端加密方式进行上传、下载对象。OBS支持服务端加密功能,使加密的行为在服务端进行。用户可以根据自身的需求,使用不同的密钥管理方式来使用服务端加密功能。SSE-KMS方式,OBS使用KMS(K - [加密说明(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1902.md): 开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS Java SDK支持服务端加密的接口见下表: - [加密示例(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1903.md): 开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。以下代码展示了在上传对象时使用SSE-C方式进行服务端加密。设置SSE-C方式下使用的密钥,请参考如何生成SSE-C方式的加密密钥。更多关于服务端加密的内容请参考服务端加密SSE-C方式。以下代码展示了在上传对象时使用SSE-OBS方式进行 - [设置桶加密配置(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1735.md): 设置桶的加密配置,以允许在该桶中上传对象时,采用对应加密配置对数据进行加密,数据在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用设置桶加密配置接口,您可以为指定桶创建或更新加密配置信息。您必须是桶拥有者或拥有设置桶加密配置的权限,才能设置桶加密配置。建议使用IAM或桶策略进行授权,如果使 - [获取桶加密配置(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1736.md): 桶的加密配置功能,支持在该桶中上传对象时,采用对应加密配置对数据进行加密,数据在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用获取桶加密配置接口,您可以获取指定桶的加密配置信息。您必须是桶拥有者或拥有获取桶加密配置的权限,才能获取桶加密配置。建议使用IAM或桶策略进行授权,如果使用IAM - [删除桶加密配置(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1737.md): 桶的加密配置功能,支持在该桶中上传对象时,采用对应加密配置对数据进行加密,数据会在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用删除桶加密配置接口,您可以删除指定桶的加密配置信息。您必须是桶拥有者或拥有删除桶加密配置的权限,才能删除桶加密配置。建议使用IAM或桶策略进行授权,如果使用IA - [客户端加密简介(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2302.md): 客户端加密是指在传输数据前,使用您选择的加密方法与加密信息,在本地进行数据加密,再将加密后结果发送至OBS服务器,同时将加密方法与解密所需的必要辅助信息存储到对象元数据中。在下载时OBS SDK会依据您提供的密钥与存储在对象元数据中的解密辅助信息进行数据解密,直接返回解密后结果。OBS不会以任何方式存储您的主密钥,您必须自行保证主密钥的正 - [客户端加密接口(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2303.md): OBS Java SDK提供两种加密套件。您可根据使用场景自行选择。CtrRSACipherGenerator继承于CTRCipherGenerator,不需要提供数据密钥或初始值,只需要提供RSA公钥或RSA私钥,用以加密和解密随机生成的数据密钥。CTRCipherGenerator仅需提供一个数据密钥,所有对象均使用该数据密钥进行加密 - [设置桶的自定义域名(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1726.md): 本章节主要指导用户如何设置OBS桶的自定义域名。您必须是桶拥有者或拥有设置桶的自定义域名配置的权限,才能设置桶的自定义域名配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:SetBucketCustomDomain权限,如果使用桶策略则需授予SetBucketCustomDomain权限。相关授权方式介绍可 - [获取桶的自定义域名(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1727.md): 本章节主要指导用户获取OBS桶的自定义域名列表。您必须是桶拥有者或拥有获取桶的自定义域名配置的权限,才能获取桶的自定义域名配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketCustomDomain权限,如果使用桶策略则需授予GetBucketCustomDomain权限。相关授权方式介绍可 - [删除桶的自定义域名(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1728.md): 本章节主要指导用户删除OBS桶的自定义域名。您必须是桶拥有者或拥有删除桶的自定义域名配置的权限,才能删除桶的自定义域名配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketCustomDomainConfiguration权限,如果使用桶策略则需授予DeleteBucketCustomD - [创建并行文件系统(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0501.md): 并行文件系统(Parallel File System)是对象存储服务(Object Storage Service,OBS)提供的一种经过优化的高性能文件系统,提供毫秒级别访问时延,TB/s级别带宽和百万级别的IOPS,能够快速处理高性能计算(HPC)工作负载。作为对象存储服务的子产品,并行文件系统支持用户按照标准的OBS接口读取数据。 - [列举并行文件系统(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0502.md): 并行文件系统(Parallel File System)是对象存储服务(Object Storage Service,OBS)提供的一种经过优化的高性能文件系统,提供毫秒级别访问时延,TB/s级别带宽和百万级别的IOPS,能够快速处理高性能计算(HPC)工作负载。作为对象存储服务的子产品,并行文件系统支持用户按照标准的OBS接口读取数据。 - [事件通知简介(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1801.md): OBS消息通知功能能够将桶的重要的操作及时通知到您,确保您安全、及时知道发生在桶上的关键事件。目前对象存储服务(OBS)支持包括简单通知服务(SMN)、函数工作流服务(FunctionGraph)在内的两种桶通知服务配置。更多关于事件通知的内容请参考事件通知。 - [设置事件通知(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1802.md): OBS事件通知功能帮助您对桶的重要的操作进行实时监控,重要操作触发时可及时通知到您,确保您安全、及时知道发生在桶上的关键事件。调用设置桶的事件通知配置接口,可为指定桶设置事件通知配置。您必须是桶拥有者或拥有设置桶的事件通知配置的权限,才能设置桶的事件通知配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:Pu - [查看事件通知(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1803.md): OBS事件通知功能帮助您对桶的重要的操作进行实时监控,重要操作触发时可及时通知到您,确保您安全、及时知道发生在桶上的关键事件。调用获取桶的事件通知配置接口,可获取指定桶的事件通知配置。您必须是桶拥有者或拥有获取桶的事件通知配置的权限,才能获取桶的事件通知配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:Ge - [关闭事件通知(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1804.md): 关闭桶事件通知实际上就是调用ObsClient.setBucketNotification将事件通知配置清空以下代码展示了如何清除桶的事件通知: - [跨域资源共享简介(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1401.md): 开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。跨域是指不同域名之间相互访问。跨域访问是浏览器出于安全考虑而设置的一个限制,即同源策略。由于JavaScript同源策略的限制,A域名下的JavaScript无法操作B域名或C域名下的对象。同协议、同域名(或IP)、以及同端口视为同一个域。 - [设置跨域资源共享规则(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1402.md): 跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全策略(Same Origin Policy,SOP)的存在,不同域之间的网站脚本和内容是无法进行交互 - [获取跨域资源共享规则(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1403.md): 跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全策略(Same Origin Policy,SOP)的存在,不同域之间的网站脚本和内容是无法进行交互 - [删除跨域资源共享规则(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1404.md): 跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全策略(Same Origin Policy,SOP)的存在,不同域之间的网站脚本和内容是无法进行交互 - [静态网站托管简介(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1601.md): 开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以将静态网站文件上传至OBS的桶中作为对象,并对这些对象赋予公共读权限,然后将该桶配置成静态网站托管模式,以实现在OBS上托管静态网站的目的。第三方用户在访问您网站的时候,实际上是在访问OBS的桶中的对象。在使用静态网站托管功能时,OB - [网站文件托管(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1602.md): 您可以将静态网站文件上传至OBS的桶中作为对象,并对这些对象赋予公共读权限,然后将该桶配置成静态网站托管模式,以实现在OBS上托管静态网站的目的。第三方用户在访问网站的时候,实际上是在访问OBS的桶中的对象。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有上传对象的 - [设置托管配置(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1603.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用设置桶的网站配置接口,您可以为指定桶设置网站配 - [获取托管配置(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1604.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用获取桶的网站配置接口,您可以获取指定桶的网站配 - [删除托管配置(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1605.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用删除桶的网站配置接口,您可以删除指定桶的网站配 - [生命周期管理简介(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1101.md): 开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS允许您对桶设置生命周期规则,实现自动转换对象的存储类别、自动淘汰过期的对象,以有效利用存储特性,优化存储空间。针对不同前缀的对象,您可以同时设置多条规则。一条规则包含:规则ID,用于标识一条规则,不能重复。受影响的对象前缀,此规则只作 - [设置生命周期规则(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1102.md): 您可以通过设置生命周期规则来管理对象的生命周期,例如定期将桶中的对象删除或者转换对象的存储类别。生命周期规则详情请参见生命周期。OBS系统支持指定规则来实现定时删除或迁移桶中对象,这就是生命周期配置。典型的应用场景如:周期性上传的日志文件,可能只需要保留一个星期或一个月,到期后要删除它们。某些文档在一段时间内经常访问,但是超过一定时间后就 - [获取生命周期规则(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1103.md): OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用获取桶的生命周期配置接口,您可以获取指定桶的生命周期策略。您必须是桶拥有者或拥有获取桶的生命周期配置的权限,才能获取桶的生命周期配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:b - [删除生命周期规则(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1104.md): OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用删除桶的生命周期配置接口,您可以删除指定桶的生命周期策略。您必须是桶拥有者或拥有删除桶的生命周期配置的权限,才能删除桶的生命周期配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:b - [多版本控制简介(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1001.md): OBS支持保存一个对象的多个版本,您可以利用多版本控制,在一个桶中保留多个版本的对象。多版本功能可以方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。在默认情况下,OBS中新创建的桶不会开启多版本功能,向同一个桶上传同名的对象时,新上传的对象将覆盖原有的对象。更多关于多版本控制的内容请参见多版本控制。 - [设置桶多版本状态(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1002.md): OBS支持多版本控制,您可以在一个桶中保留对象的多个版本,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。更多多版本相关信息请参见多版本控制。调用设置桶的多版本状态接口,您可以为指定桶设置多版本状态。您必须是桶拥有者或拥有设置桶的多版本状态的权限,才能设置桶的多版本状态。建议使用IAM或桶策略进行授权,如果使用IA - [获取桶多版本状态(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1003.md): OBS支持多版本控制,您可以在一个桶中保留对象的多个版本,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。更多多版本相关信息请参见多版本控制。调用获取桶的多版本状态接口,您可以获取指定桶的多版本状态。您必须是桶拥有者或拥有获取桶的多版本状态的权限,才能获取桶的多版本状态。建议使用IAM或桶策略进行授权,如果使用IA - [获取多版本对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1004.md): 您可以通过ObsClient.getObject接口传入版本号(versionId)来获取桶中指定版本的对象。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetObject权限。相关授权方式介绍可参见OBS权限 - [复制多版本对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1005.md): 用户可以根据需要将存储在OBS上的多版本对象复制到其他路径下,为指定桶中的多版本对象创建一个副本。您可以通过ObsClient.copyObject接口传入版本号(versionId)来复制多版本对象。您必须是桶拥有者或拥有复制对象的权限,才能复制对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutOb - [恢复多版本归档存储对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1006.md): 如果要下载归档存储对象,需要先将归档存储对象恢复。恢复归档存储对象的恢复选项可支持两类,见RestoreTierEnum。您可以通过ObsClient.restoreObject接口传入版本号(versionId)来恢复多版本归档存储对象。您必须是桶拥有者或拥有恢复归档存储对象的权限,才能恢复归档存储对象。建议使用IAM或桶策略进行授权, - [列举多版本对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1007.md): 用列举桶内对象接口,可列举指定桶内的部分或所有多版本对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的多版本对象信息。返回结果以多版本对象名的字典序排序。ObsClient.listVersions返回结果包含多版本对象和对象删除标记。您必须是桶拥有者或拥有列举桶内多版本对象的权限,才能列举桶内多版本对象。建 - [设置多版本对象ACL(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1008.md): OBS支持对对象的操作进行权限控制。默认情况下,只有对象的创建者才有该对象的读写权限。用户也可以设置其他的访问策略,比如对一个对象可以设置公共访问策略,允许所有人对其都有读权限。SSE-KMS方式加密的对象即使设置了ACL,跨租户也不生效。OBS用户在上传对象时可以设置权限控制策略,也可以通过ACL操作API接口对已存在的对象更改或者获取 - [获取多版本对象权限(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1010.md): OBS支持对对象的操作进行权限控制。默认情况下,只有对象的创建者才有该对象的读写权限。OBS用户可以通过ACL操作API接口对已存在的对象更改或者获取ACL(access control list) 。调用获取多版本对象权限接口,将获取指定多版本对象权限。您必须是桶拥有者或拥有获取对象ACL的权限,才能获取对象ACL。建议使用IAM或桶策 - [删除多版本对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1009.md): 为节省空间和成本,您可以根据需要删除桶中指定的多版本对象。您可以通过ObsClient.deleteObject接口传入版本号(versionId)删除多版本对象。您必须是桶拥有者或拥有删除对象的权限,才能删除对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:DeleteObject权限,如果使用桶策略则需 - [批量删除多版本对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_1011.md): 为节省空间和成本,您可以根据需要删除桶中指定的多个多版本对象。批量删除对象特性用于将一个桶内的部分对象一次性删除,删除后不可恢复。批量删除对象要求返回结果里包含每个对象的删除结果。OBS的批量删除对象使用同步删除对象的方式,每个对象的删除结果返回给请求用户。您可以通过ObsClient.deleteObjects接口传入版本号(versi - [设置桶级默认WORM策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4501.md): 本接口用于为指定桶配置默认保护策略和保护期限。当您在桶内配置了桶级默认WORM策略以后,如果您在上传对象时没有指定保护策略和保护期限,则新上传的对象会自动应用桶级默认WORM策略。和配置对象级WORM保护策略不同的地方在于,对象级WORM保护策略需要您提供一个明确的时间,在这个时间之前对象都会受到保护,桶级默认WORM策略则要求您提供一个 - [获取桶级默认WORM策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4502.md): 获取指定桶设置的桶级默认WORM策略。如果您打开了桶级WORM开关,但从未配置过桶级默认WORM策略,您依然可以使用此接口查看开关的打开情况。您必须是桶拥有者或者拥有获取桶级默认WORM策略权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketObjectLockConfigu - [设置在线解压策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4504.md): OBS支持ZIP包上传后自动解压并存放在指定目录。桶设置了在线解压策略后,上传到该桶内的ZIP包如果匹配解压策略,ZIP包将会自动解压到指定目录里。本接口用于为指定桶配置ZIP文件解压策略。了解更多在线解压相关信息,请参见在线解压。融合桶不支持在线解压。权限限制:需要使用IAM的角色与策略授权功能,增加Tenant Administrat - [获取在线解压策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4505.md): 可通过本接口查询指定桶的文件解压策略。如果策略存在,则返回成功,status code返回值为200。了解更多在线解压相关信息,请参见在线解压。需要使用IAM的角色与策略授权功能,增加Tenant Administrator权限后才能设置、获取、删除在线解压策略。在线解压源需使用IAM创建云服务委托,委托OBS获取桶内数据,上传数据到桶内 - [删除在线解压策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4506.md): 可通过本接口删除指定桶中配置的文件解压策略,删除成功status code返回值为204。了解更多在线解压相关信息,请参见在线解压。obsClient.deleteBucketCompressPolicy(DeleteBucketCompressPolicyRequest request)本示例用于删除examplebucket桶的在线解 - [设置DIS通知策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4508.md): 本接口用于为指定桶配置DIS通知策略。接口是幂等的,如果桶上已存在相同策略内容,则返回成功,status code返回值为200;否则status code返回值为201。融合桶不支持设置DIS通知策略。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是拥有Tenant Admin - [获取DIS通知策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4509.md): 本接口用于查询指定桶的DIS通知策略信息。如果策略存在,则返回成功,status code返回值为200。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或者拥有Tenant Administrator权限,才能调用本接口。配置Tenant Administrator权限 - [删除DIS通知策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4510.md): 本接口用于删除指定桶中配置的全部DIS通知策略。删除成功,status code返回值为204。融合桶不支持设置DIS通知策略。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或者拥有Tenant Administrator权限,才能调用本接口。配置Tenant Admi - [OPTIONS桶(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0551.md): OPTIONS,称为预请求,是客户端发送给服务端的一种请求,通常被用于检测客户端是否具有对服务端进行操作的权限。只有当预请求成功返回,客户端才开始执行后续的请求。OBS允许在桶内保存静态的网页资源,在正确的使用下,OBS的桶可以成为网站资源。在这种使用场景下,OBS中的桶作为服务端,需要处理客户端发送的OPTIONS预请求。要处理OPTI - [对象上传简介(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0601.md): 开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。在OBS中,用户操作的基本数据单元是对象。OBS Java SDK提供了丰富的对象上传接口,可以通过以下方式上传对象:流式上传文件上传分段上传追加上传断点续传上传基于表单上传SDK支持上传0KB~5GB的对象。流式上传、文件上传和追加上传的 - [流式上传(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0602.md): 您可以将本地文件直接通过Internet上传至OBS指定的位置。待上传的文件可以是任何类型:文本文件、图片、视频等。通过SDK的流式上传,可以上传不超过5GB的文件。本章节介绍如何使用Java SDK流式上传对象。流式上传使用java.io.InputStream作为对象的数据源,您可以通过ObsClient.putObject上传您的数 - [文件上传(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0603.md): 您可以将本地文件直接通过Internet上传至OBS指定的桶中。待上传的文件可以是任何类型。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。使用其他SDK语言上传对象,请参见文件上传(Python SDK)、文件上传(C SDK)、文件上传(Go SDK)、文件上传(BrowserJS - [获取上传进度(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0604.md): 您可以通过PutObjectRequest.setProgressListener设置数据传输监听器来获取指定对象的上传进度。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须拥有obs:object:PutObject权限,才能获取上传进度。相关授权操作可参见典型权限场景配置案例。 - [追加上传(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0609.md): 您可以根据需要上传文件或者文件夹至已有的OBS桶。待上传的文件可以是任何类型:文本文件、图片、视频等。追加对象可以实现在桶中指定的对象尾直接追加上传数据,不存在相同名称的对象则创建新对象。每次追加上传都会更新该对象的最后修改时间。每次追加上传成功后,可通过AppendObjectResult.getNextPosition获取下次追加上传 - [断点续传上传(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0611.md): 断点续传上传是对分段上传的封装和加强,解决上传大文件时由于网络不稳定或程序崩溃导致上传失败的问题。其原理是将待上传的文件分成若干个分段分别上传,并实时地将每段上传结果统一记录在checkpoint文件中,仅当所有分段都上传成功时返回上传成功的结果,否则返回错误信息提醒用户再次调用接口进行重新上传(重新上传时因为有checkpoint文件记 - [异步断点续传上传(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2314.md): 异步断点续传上传是异步执行的断点续传上传,并且支持暂停、取消、继续等功能。其原理是创建一个子线程,在子线程中进行断点续传上传,上传失败产生异常时可以通过回调获取异常,上传成功时可以从task中获取Optional封装的结果。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者 - [基于表单上传(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0612.md): 基于表单上传是使用HTML表单形式上传对象到指定桶中,对象最大不能超过5GB。您可以通过ObsClient.createPostSignature生成基于表单上传的请求参数。使用代码模拟表单上传的完整代码示例,参见PostObjectSample。您也可以通过如下步骤进行表单上传:使用SDK生成的用于鉴权的请求参数包括两个:Policy, - [分段上传概述(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0614.md): 对于较大文件上传,可以切分成段上传。用户可以在如下的应用场景内(但不仅限于此),使用分段上传的模式:上传超过100MB大小的文件。网络条件较差,和OBS服务端之间的链接经常断开。上传前无法确定将要上传文件的大小。使用分段上传具有以下优势:提高吞吐量——您可以使用并行上传段以提高吞吐量。从任何网络问题中快速恢复——较小的段大小可以将由于网络 - [初始化分段上传任务(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0615.md): 使用分段上传方式传输数据前,必须先通知OBS初始化一个分段上传任务。该操作会返回一个OBS服务端创建的全局唯一标识(Upload ID),用于标识本次分段上传任务。您可以根据这个唯一标识来发起相关的操作,如取消分段上传任务、列举分段上传任务、列举已上传的段等。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储 - [上传段(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0616.md): 初始化分段上传任务后,通过分段上传任务的ID,上传段到指定桶中。除了最后一段以外,其他段的大小范围是100KB~5GB;最后一段的大小范围是0~5GB。上传的段的编号也有范围限制,其范围是1~10000。上传段时,除了指定上传ID,还必须指定段编号。您可以选择1和10000之间的任意段编号。段编号在您正在上传的对象中唯一地标示了段及其位置 - [合并段(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0617.md): 如果用户上传完所有的段,就可以调用合并段接口,系统将在服务端将用户指定的段合并成一个完整的对象。在执行“合并段”操作以前,用户不能下载已经上传的数据。在合并段时需要将多段上传任务初始化时记录的附加消息头信息拷贝到对象元数据中,其处理过程和普通上传对象带这些消息头的处理过程相同。在并发合并段的情况下,仍然遵循Last Write Win策略 - [分段上传场景化示例(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0618.md): 分段上传的主要目的是解决大文件上传或网络条件较差的情况。通过使用UploadPartRequest.setOffset和UploadPartRequest.setPartSize来设置每段的起始结束位置。下面的示例代码展示了如何使用分段上传并发上传大文件。 - [取消分段上传任务(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0619.md): 通过分段上传任务的ID,取消指定桶中的分段上传任务。您可以选择取消多段上传任务,取消多段上传任务之后无法再次使用该上传ID上传任何段。然后,OBS将释放被取消的多段上传任务中的每个段数据的所有存储。如果有多段上传已在进行中,即使您已执行中止操作,它们仍可以上传成功或失败。如果要释放所有分段使用的所有存储,必须在完成所有多段上传后再取消多段 - [列举已上传的段(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0620.md): 通过分段上传任务的ID,列举指定桶中已上传的段。您可以列出特定多段上传任务或所有正在进行的多段上传任务的分段。列举已上传的段操作将返回特定多段上传任务中正在进行上传的段信息,单次最多列举1000个分段。如果多段上传中的段超过1000个,您必须发送一系列列举已上传的段请求以检索所有段。请注意,返回的分段列表不包括已合并的分段。开发过程中,您 - [列举分段上传任务(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0621.md): 列举指定桶中所有的初始化后还未合并或还未取消的分段上传任务。通过列举桶中的多段上传任务,您可以获得已初始化多段上传任务的列表,已初始化多段上传任务是指初始化后还未合并以及未取消的多段上传任务。每个请求将返回最多1000个多段上传任务,如果正在进行的多段上传任务超过1000个,您需要发送其他请求以检索剩余的多段上传任务。开发过程中,您有任何 - [为普通上传接口设置上传回调(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0613.md): 您可以在上传对象请求(PutObject)中设置回调参数,OBS在对象上传成功之后,将上传结果回调特定服务器,并将回调结果返回给您。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予o - [为断点续传接口设置上传回调(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1716.md): 您可以在断点续传上传请求(uploadFile)中设置回调参数,OBS在对象上传成功之后,将上传结果回调特定服务器,并将回调结果返回给您。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需 - [对象下载简介(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0701.md): 开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS Java SDK提供了丰富的对象下载接口,可以通过以下方式下载对象:流式下载范围下载断点续传下载 - [流式下载(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0702.md): 您可以根据需要将存储在OBS中的对象通过ObsClient.getObject接口进行流式下载。ObsClient.getObject返回的ObsObject实例包含对象所在的桶、对象名、对象属性、对象输入流等内容,同时可以通过操作对象输入流将对象的内容读取到本地文件或者内存中。开发过程中,您有任何问题可以在Github上提交issue, - [范围下载(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0703.md): 如果只需要下载对象的其中一部分数据,可以使用范围下载,下载指定范围的数据。如果指定的下载范围是0~1000,则返回第1到第1001个字节的数据,共1001字节的数据。如果指定的范围无效,则返回整个对象的数据。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有下载对象的 - [获取下载进度(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0704.md): 获取指定对象的下载进度。您可以通过GetObjectRequest.setProgressInterval设置数据传输接口来获取下载的进度。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有下载对象的权限,才能获取下载进度。建议使用IAM或桶策略进行授权,如果使用IA - [限定条件下载(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0705.md): 下载对象时,可以指定一个或多个限定条件,满足限定条件时则进行下载,否则返回异常码,下载对象失败。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObjec - [重写响应头(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0706.md): 下载对象时,可以重写HTTP/HTTPS中部分响应头的信息:Content-Type、Content-Language、Expires、Cache-Control、Content-Disposition、Content-Encoding。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您 - [获取自定义元数据(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0707.md): 元数据(Metadata)为描述对象属性的信息,是一组键值对,用作对象管理的一部分。本接口可以在下载对象成功后返回对象的自定义元数据。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取对象元数据的权限,才能获取自定义元数据。建议使用IAM或桶策略进行授权,如果使用 - [恢复归档或深度归档存储对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0708.md): 如果要下载归档或深度归档存储对象,需要先将归档或深度归档存储对象恢复。恢复归档存储对象的恢复选项可支持两类,见下表:开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有恢复归档或深度归档存储对象的权限,才能恢复归档或深度归档存储对象。建议使用IAM或桶策略进行授权,如果 - [断点续传下载(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0709.md): 当下载大对象到本地文件时,经常出现因网络不稳定或程序崩溃导致下载失败的情况。失败后再次重新下载不仅浪费资源,而且当网络不稳定时仍然有下载失败的风险。断点续传下载接口能有效地解决此类问题引起的下载失败,其原理是将待下载的对象分成若干个分段分别下载,并实时地将每段下载结果统一记录在checkpoint文件中,仅当所有分段都下载成功时返回下载成 - [下载对象接口实现图片处理(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0710.md): OBS为用户提供了稳定、安全、高效、易用、低成本的图片处理服务。当要下载的对象是图片文件时,您可以通过传入图片处理参数对图片文件进行图片剪切、图片缩放、图片水印、格式转换等处理。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用I - [临时授权方式实现图片处理(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0711.md): OBS为用户提供了稳定、安全、高效、易用、低成本的图片处理服务。您可以通过临时授权方式传入图片处理参数,对图片文件进行图片剪切、图片缩放、图片水印、格式转换等处理。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进 - [删除对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0804.md): 为节省空间和成本,您可以根据需要删除指定桶中的对象。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有删除对象的权限,才能删除对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:DeleteObject权限,如果使用桶策略则需授予Dele - [批量删除对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0809.md): 为节省空间和成本,您可以根据需要删除指定桶中的多个对象。批量删除对象特性用于将一个桶内的部分对象一次性删除,删除后不可恢复。批量删除对象要求返回结果里包含每个对象的删除结果。OBS的批量删除对象使用同步删除对象的方式,每个对象的删除结果返回给请求用户。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛 - [创建文件夹(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0605.md): 您可以在已创建的桶中新建一个文件夹,从而更方便地对存储在OBS中的数据进行分类管理。OBS本身是没有文件夹的概念的,桶中存储的元素只有对象。创建文件夹实际上是创建了一个大小为0且对象名以“/”结尾的对象,这类对象与其他对象无任何差异,可以进行下载、删除等操作,只是OBS控制台会将这类以“/”结尾的对象以文件夹的方式展示。开发过程中,您有任 - [重命名对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0504.md): 重命名对象操作是指将指定并行文件系统内的一个对象重命名为其他对象名。您必须是并行文件系统拥有者或拥有重命名文件的权限,才能重命名文件。建议使用IAM或策略进行授权,如果使用IAM则需授予obs:bucket:PutObject权限,如果使用策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM - [截断对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0505.md): 截断对象操作是指将指定并行文件系统内的一个对象截断到指定大小。您必须是并行文件系统拥有者或拥有截断对象的权限,才能截断对象。建议使用IAM或策略进行授权,如果使用IAM则需授予obs:bucket:PutObject权限,如果使用策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略 - [配置对象级WORM保护策略(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4515.md): 开启了WORM开关的桶,上传的对象支持配置或修改对象保护期限。如果上传对象时没有配置保护期限或自动应用桶级默认保护策略,您可以通过该操作配置对象保护期限。如果上传对象时配置了保护期限或自动应用了默认保护期限,允许用户通过该操作延长保护期限。对象保护期限仅允许修改,不允许删除。您必须是桶拥有者或拥有配置对象级WORM保护策略的权限,才能调用 - [修改写对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0503.md): 将指定并行文件系统内的一个对象从指定位置起修改为其他内容。您必须是并行文件系统拥有者或拥有修改写对象的权限,才能修改写对象。建议使用IAM或策略进行授权,如果使用IAM则需授予obs:bucket:PutObject权限,如果使用策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略 - [判断对象是否存在(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0807.md): 判断对象是否存在,返回的结果中HTTP状态码为200表明对象存在,返回404表明对象或桶不存在。您必须是桶拥有者或拥有获取对象元数据的权限,才能判断对象是否存在。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetObject权限。相关授权方式介绍可参见OBS权限 - [分段复制(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0810.md): 分段复制是分段上传的一种特殊情况,即分段上传任务中的段可以通过复制OBS指定桶中现有对象(或对象的一部分)来实现。您可以通过ObsClient.copyPart来复制段。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有复制对象的权限,才能复制对象。建议使用IAM或桶 - [复制对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0805.md): 用户可以根据需要将存储在OBS上的对象复制到其他路径下。复制对象操作将创建需要复制的对象的副本。在单次操作中,您可以创建最大5GB的对象副本。为指定桶中的对象创建一个副本。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有复制对象的权限,才能复制对象。建议使用IAM或 - [列举对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0803.md): 调用列举桶内对象接口,可列举指定桶内的部分或所有对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的对象信息。返回结果以对象名的字典序排序。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有列举桶内对象的权限,才能列举桶内对象。建议使用IA - [列举并行文件系统内对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0506.md): 您可以通过ObsClient.listObjects列举出指定并行文件系统里的对象。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是并行文件系统拥有者或拥有列举并行文件系统内对象的权限,才能列举并行文件系统内对象。建议使用IAM或策略进行授权,如果使用IAM则需授予obs:buc - [设置对象生命周期(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0608.md): OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。此接口设置的对象过期时间,其优先级高于桶生命周期规则。上传对象或者初始化分段上传任务时,您可以直接指定对象的过期时间。归档存储和深度归档存储不支持多AZ,因此不支持使用生命周期的存储类别转换功能,将多A - [设置对象过期时间(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0811.md): OBS客户端支持通过在上传时设置对象过期时间和设置已上传对象的过期时间。接口参考文件上传(Java SDK)以下代码展示如何将 bucketname 桶下的 objectkey 对象在上传时设置对象过期时间,对象将在 30 天后过期:接口参考设置对象元数据(Java SDK)。以下代码展示如何设置examplebucket桶下的objec - [设置对象标签(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/zh-cn_topic_0000001895350256.md): 用户可以通过本接口设置或更新对象标签。对象标签使用一组键值对(Key-Value)标记对象。如果请求中不携带版本号(versionId),需要确保执行者有PutObjectTagging权限。如果请求中携带版本号(versionId),需要确保执行者有PutObjectTagging+PutObjectVersionTagging权限。缺 - [获取对象标签(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2312.md): 可通过本接口获取对象的标签信息。了解更多对象标签相关信息,请参考对象标签。如果请求中不携带版本号(versionId),需要确保执行者有GetObjectTagging权限。如果请求中携带版本号(versionId),需要确保执行者有GetObjectTagging+GetObjectVersionTagging权限。缺省情况下只有对象的 - [删除对象标签(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2311.md): 可通过本接口删除对象的标签信息。了解更多对象标签相关信息,请参考对象标签。如果请求中不携带版本号(versionId),需要确保执行者有DeleteObjectTagging权限。如果请求中携带版本号(versionId),需要确保执行者有DeleteObjectTagging+DeleteObjectVersionTagging权限。缺 - [设置对象ACL(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0802.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [获取对象ACL(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0808.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [上传时使用crc64校验文件一致性(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0625.md): 您可以通过以下接口在上传时使用crc64校验文件一致性:文件上传追加上传分段上传断点续传上传以下代码展示如何在上传对象时使用CRC64校验一致性:仅支持首次追加上传时使用CRC64校验文件一致性。以下代码展示如何在使用追加上传时使用CRC64校验一致性:以下代码展示如何在使用分段上传时使用CRC64校验一致性:以下代码展示如何在断点续传上 - [下载时使用crc64校验文件一致性(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0627.md): 您可以通过断点续传下载接口获取对象的CRC64校验值,并与本地计算的CRC64校验值比较从而实现一致性校验:以下代码展示如何在断点续传下载时使用CRC64校验一致性: - [获取对象crc64(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0628.md): 您可以通过以下接口获取对象crc64校验文件,并与本地计算的crc64校验文件比较从而实现crc64一致性校验:流式下载范围下载获取对象元数据复制对象如果对象存在CRC64值,则返回CRC64,否则不返回。如果对象存在CRC64值,则返回CRC64,否则不返回。以下代码展示如何在流式下载对象时获取CRC64:以下代码展示如何在范围下载对象 - [上传时使用md5校验文件一致性(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0626.md): 您可以通过以下接口在上传时使用md5校验文件一致性:文件上传追加上传上传段本示例用于通过ObsClient.base64Md5来直接计算Content-MD5头域,将本地文件localimage.jpg上传到examplebucket桶下的objectname对象中。以下代码展示如何在使用追加上传时使用MD5校验一致性:以下代码展示如何在 - [设置对象元数据(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0806.md): 元数据(Metadata)为描述对象属性的信息,是一组名称值对,用作对象管理的一部分。当前仅支持系统定义的元数据。系统定义的元数据又分为两种类别:系统控制和用户控制。如Last-Modified日期等数据由系统控制,不可修改;如为对象配置的ContentLanguage,用户可以通过接口进行修改。对指定桶中的对象发送HEAD请求,设置对象 - [上传对象时设置对象元数据(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0606.md): 您可以在上传对象时设置对象元数据。对象元数据包含对象长度、对象MIME类型、对象MD5值(用于校验)、对象存储类别、对象自定义元数据。对象元数据可以在多种上传方式下(流式上传、文件上传、分段上传),或复制对象时进行设置。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥 - [获取对象元数据(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0801.md): 元数据(Metadata)为描述对象属性的信息,是一组名称值对,用作对象管理的一部分。拥有对象读权限的用户可以执行HEAD操作命令获取对象元数据,返回信息包含对象的元数据信息。该操作支持服务端加密功能。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取对象元数据的 - [上传软链接对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2313.md): 上传软链接对象。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有上传对象的权限,才能上传软链接对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参 - [获取软链接对象(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_3337.md): 获取软链接对象。开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有下载对象的权限,才能获取软链接对。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetObject权限。相关授权方式介绍可参见 - [通过临时URL访问OBS(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0901.md): OBS客户端支持通过访问密钥、请求方法类型、请求参数等信息生成一个在Query参数中携带鉴权信息的URL,可将该URL提供给其他用户进行临时访问。在生成URL时,您需要指定URL的有效期来限制访客用户的访问时长。如果您想授予其他用户对桶或对象临时进行其他操作的权限(例如上传或下载对象),则需要生成带对应请求的URL后(例如使用生成PUT请 - [通过Header鉴权访问OBS(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0904.md): 通过Header鉴权访问OBS,将“Hello OBS”字符串上传到桶examplebucket里的objectName中。通过Header鉴权访问OBS,初始化多段上传任务,上传的桶名为examplebucket,对象为objectName。通过Header鉴权访问OBS,将单段上传到桶examplebucket中的对象objectNa - [发送请求时添加自定义头域](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2304.md): 在使用 Java SDK 调用接口时,您可以为请求添加自定义头域,以发送当前 SDK 未集成的头域。如果您指定的头域属于需要参与签名计算,SDK 会自动进行计算。使用方法为:初始化对应接口的 Request 对象。调用 Request 对象的 addUserHeaders() 方法添加自定义头域。添加其他需要的参数。调用 SDK 对应接口 - [问题定位方法(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0301.md): 开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。使用OBS Java SDK对接OBS服务可能会遇到许多问题,您可以通过下面介绍的步骤进行问题分析和定位:您可以从这里查看关于ObsException的详细说明。 - [依赖缺失和依赖冲突的解决(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0303.md): 依赖缺失和依赖冲突是 Java 开发中的常见问题,在使用普通版本Java SDK时,如果在应用编译和运行时报错ClassNotFoundException和 NoClassDefFoundError,可怀疑是否是依赖问题而导致,针对不同情况参照下述步骤进行排查和解决。Java SDK有Bundle版和普通版本,两者比较如下:通过 mave - [其他高频问题汇总(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_0302.md): 开发过程中,您有任何问题可以在Github上提交issue,或者在华为云对象存储服务论坛中发帖求助。此类错误一般有三种原因:初始化ObsClient时传入的SK有误,解决方法:检查SK,确保正确;旧版本OBS Java SDK的BUG,解决方法:升级SDK到最新版本;OBS Java SDK 2.1.x版本与其依赖库Apache Http - [HTTP状态码(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2001.md): OBS服务端遵照HTTP规范,在接口调用完成均会返回标准的HTTP状态码,HTTP状态码分类以及OBS中常见的HTTP状态码如下:HTTP状态码分类:分类分类描述1XX信息,服务器收到请求,需要请求者继续执行操作,一般对客户调用函数不可见。2XX成功,操作被成功接收并处理。3XX重定向,需要进一步的操作以完成请求,一般对客户调用函数不可见 - [SDK错误码(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2005.md): SDK错误码是由ObsClient统一抛出的异常,继承自java.lang.RuntimeException类。通常是对象存储服务端错误,包含对象存储服务的错误码、错误信息等,便于用户定位问题,并做出适当的处理。SDK错误码包含两部分:对象存储服务的API错误码,详见OBS错误码。SDK自定义异常,详见表1。SDK自定义异常异常异常描述O - [SDK公共响应头(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2003.md): 调用ObsClient类的相关接口成功后,均会返回公共响应头类:即HeaderResponse类实例(或其子类实例),该类包含了HTTP/HTTPS的响应头信息。处理公共响应头的示例代码如下: - [日志分析(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2004.md): 将OBS SDK包中的log4j2.xml文件放到classpath根目录;或者调用Log4j2Configurator.setLogConfig直接指定log4j2.xml文件的路径。您可以从OBS Java SDK的发布软件包中获取默认的日志配置文件log4j2.xml,并在该文件基础上进行修改定制。OBS Java SDK的日志路径 - [本文档是否适用于union SDK?](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4445.md): 本文档是与OBS SDK配套的参考文档,为了您能更好地使用Java SDK,推荐前往下载与安装SDK(Java SDK)下载最新版本的Java SDK。 - [如何使对象可以被匿名用户访问?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2107.md): 如果想让对象被匿名用户访问,可通过以下三步完成。 - [SDK的重试机制是什么?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2109.md): SDK通过创建并配置客户端章节中的maxErrorRetry参数来实行重试,默认重试3次,建议值为0到5次之间。当调用ObsClient的接口发生网络连接异常或者服务端返回5XX错误时,SDK会进行指数退避重试。ObsClient.putObject接口,当数据源是非FileInputStream的其他InputStream时,由于数据流 - [如何获取桶的静态网站访问地址?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2110.md): 桶配置成静态网站托管模式后,可通过以下方式拼接桶的静态网站访问地址:https://桶名.静态网站托管域名各区域对应的静态网站托管域名可以从这里查看。例如区域为“华北-北京四”的桶名为“testbucket”的桶配置成静态网站托管模式后,该桶的静态网站访问地址为https://testbucket.obs-website.cn-north - [如何获取对象URL?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2111.md): 将桶中的对象权限设置为匿名用户读取权限后,可通过对象的URL直接下载该对象。获取对象URL的方式如下:方式一,接口查询,ObsClient上传对象后会返回PutObjectResult对象,通过调用该对象的getObjectUrl接口可获取上传对象的URL。示例代码如下:方式二,按https://桶名.域名/文件夹目录层级/对象名的方式进 - [公网环境下如何提高上传大文件速度?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2112.md): 在公网环境下对于超过100MB的大文件,建议通过分段上传方式上传。分段上传是将单个对象拆分为一系列段分别上传,每个段都是对象数据的连续部分,您可以按照任意顺序上传段。如果其中某个段传输失败,可以重新传输该段且不会影响其他段。通过多线程并发上传同一对象的多个段,可大大提高传输效率。具体代码样例可参见分段上传。 - [如何进行分段上传?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2114.md): 在上传文件时,您可以指定上传文件的某一段的数据来进行分段上传,步骤如下:详细操作可参见分段上传。 - [如何进行分段下载?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2115.md): 在下载对象时,您可以指定下载对象的某一范围内的数据进行分段下载,步骤如下:详细操作可参见范围下载。 - [如果桶内已存在同名对象,如何判定覆盖上传成功?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2117.md): 上传完成后,您可以调用ObsClient.getObjectMetadata接口获取目标对象大小和最后修改时间,再与数据源进行比较:如果两者大小一致且目标对象的最后修改时间晚于数据源的最后修改时间则表明上传成功,否则上传失败。ObsClient.getObjectMetadata接口的使用可参见18.4-获取对象元数据。 - [对于加密类型的对象如何使用URL进行下载?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2118.md): 如果是SSE-KMS方式进行加密的对象,使用URL下载时服务端会自动解密。如果对象是SSE-C方式进行加密的对象,由于解密需要设置请求头域,所以不能通过浏览器直接访问该对象。如果您是在编写代码来访问加密类型的对象,只需要为请求设置相应的头域信息即可,可参见代码示例:下载SSE-C加密类型的对象。访问服务端加密对象必须使用HTTPS协议。 - [如何生成SSE-C方式的加密密钥(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2119.md): 以下代码展示了如何生成SSE-C方式的加密密钥,以及密钥的MD5值如何生成: - [如何获取SecurityToken?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2120.md): 临时AK/SK和SecurityToken是系统颁发给IAM用户的临时访问令牌,有效期可以设置为15分钟至24小时,过期后需要重新获取。获取SecurityToken可以参考IAM开发指导文档示例,其他获取方式也可以参考通过委托获取临时访问密钥和SecurityToken。 - [SDK是否支持批量上传、下载或复制对象?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2121.md): SDK暂未提供专门的批量上传、下载或复制对象接口,但您可以通过组合现有接口自行封装实现,请参考如下步骤操作:以批量上传对象为例,示例代码如下:您可以使用多线程并发执行上传/下载/复制操作,以提高效率。 - [如何指定Content-SHA256?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2122.md): 上传对象和上传段支持携带x-obs-content-sha256头域,该头域值为请求消息体256-bit SHA256值转十六进制值,计算方式为Hex(SHA256Hash()),服务端会对携带此头域的请求计算其消息体的sha256值做校验(性能会有部分下降,在安全上推荐该算法),上传对象示例代码如下:Java SDK - [为什么SDK源码中包含acs.amazonaws.com关键字?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2123.md): OBS SDK 为了兼容访问aws s3服务,在源码中会包含acs.amazonaws.com关键字的固定格式,SDK仅作常量使用,不会对格式有其他处理,也不会对其访问。SDK会自动兼容该场景,用户可不感知。比如Java SDK: - [如何理解Content-Type(MIME)?(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_2124.md): Content-Type(MIME)用于标识请求或响应中所携带数据的媒体类型,浏览器根据该参数来决定数据的打开方式。Content-Type多用于指定一些客户端自定义的文件,以及一些媒体文件的打开方式。如果您在上传Object时未指定Content-Type,SDK会根据指定Object名称的后缀名来判定文件类型并自动填充Content- - [如何获取账号ID和用户ID?](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1712.md): 从控制台获取账号名、账号ID、用户名、用户ID、项目名称、项目ID在华为云首页右上角,单击“控制台”。在右上角的用户名中选择我的凭证。在“我的凭证”界面,API凭证页签中,查看账号名、账号ID、用户名、用户ID、项目名称、项目ID。每个区域的项目ID有所不同,需要根据业务所在的区域获取对应的项目ID。查看账号名、账号ID、用户名、用户ID - [如何实现上传对象时限速(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1713.md): 此示例用于上传对象时设置链接的限速,通过自定义头域,SDK透传x-obs-traffic-limit,服务端校验完成限速。 - [如何实现下载对象时限速(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1714.md): 此示例用于下载对象时设置链接的限速,通过自定义头域,SDK透传x-obs-traffic-limit,服务端校验完成限速。 - [如何设置Referer头域(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_23_1715.md): 此示例用于上传对象本地localfile到examplebucket桶里名称为objectkey,同时指定Referer头域为https://example.com*。 - [Java SDK如何配置OkhttpEventListener日志,打印详细阶段日志(Java SDK)](https://support.huaweicloud.com/sdk-java-devg-obs/obs_21_4522.md): 通过okhttp的EventListener,可实现统计https各个过程的耗时。仅Java SDK 3.24.9版本后支持该功能,且配置OkhttpEventListener日志时会额外消耗性能,建议在调试时才开启该日志。 - [使用前须知(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0001.md): OBS SDK合规使用指南请单击此处;OBS SDK隐私声明请单击此处。本文介绍Python SDK的版本变更,并提供版本兼容性说明,以及其他使用前须知。如表1所示,本节将为您展示Python SDK的版本变更情况,以及当前版本是否兼容某个历史版本的说明,更多版本修订信息请参见:ChangeLog。请确认您已经熟悉OBS的基本概念,如桶( - [Python SDK接口概览](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0100.md): 表1总结了OBS Python SDK支持的接口及功能描述,每个接口的详细介绍和示例代码请前往接口详情页查看。 - [使用前准备(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0300.md): 在使用Python SDK访问华为云对象存储服务OBS之前,您需要先完成服务环境的准备和开发环境的准备。服务环境准备包括准备华为账号和访问密钥,是使用SDK与OBS云服务交互的必要条件。开发环境准备是指为了您能顺利完成SDK的安装、完成基于SDK的代码开发与运行,需要提前在本地完成的开发环境搭建,比如下载安装依赖软件、安装开发工具等。使用 - [下载与安装SDK(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0400.md): 本节提供Python SDK的下载链接,并介绍SDK的安装方式。OBS Python SDK最新版本源码:最新源码下载如表1所示,Python SDK有以下安装方式。如果您的环境尚未安装pip,请参见pip官网安装。如果您使用的是Windows操作系统,当运行pip命令时提示“不是内部或外部命令”,请在Path环境变量中增加pip的安装目 - [快速入门(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0500.md): OBS通过用户账户中的AK和SK进行签名验证,确保通过授权的账户才能访问指定的OBS资源。以下是对AK和SK的解释说明:AK:Access Key ID,接入键标识,用户在对象存储服务系统中的接入键标识,一个接入键标识唯一对应一个用户,一个用户可以同时拥有多个接入键标识。对象存储服务系统通过接入键标识识别访问系统的用户。SK:Secret - [OBS客户端初始化(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0601.md): OBS客户端(ObsClient)是访问OBS服务的Python客户端,它为调用者提供一系列与OBS服务进行交互的接口,用于管理桶和对象等OBS服务上的资源。建议值为N/A的表示需要根据实际情况进行设置。如网络状况不佳,建议增大timeout的值。如果设置的server不带协议类型,则默认使用HTTPS协议。如果启用了长连接模式,使用完O - [桶客户端初始化(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0602.md): 桶客户端是访问OBS某个指定桶的Python客户端,它为调用者提供一系列与OBS服务进行交互的接口,用于管理该桶和桶内对象等OBS服务上的资源。桶客户端包含除ObsClient.listBuckets、ObsClient.downloadFile、Obsclient.uploadFile、ObsClient.createSignedUrl - [日志初始化(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0603.md): 通过开启SDK日志功能,可将接口调用过程中产生的日志信息记录到日志文件,用于后续的数据分析或问题定位。具体步骤如下:找到OBS Python SDK开发包(github获取)中的log.conf文件。其内容格式如下:[LOGCONF] #Configure log file dir LogFileDir = ./logs #Co - [SDK公共结果对象(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0604.md): 调用ObsClient的相关接口完成后均会返回SDK公共结果对象(ObsClient.createSignedUrl和ObsClient.createPostSignature接口除外),可从SDK公共结果对象中获取HTTP状态码,判断操作是否成功。成功返回结果示例{ 'status': 200, 'reason': 'O - [事件类型](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0706.md): obs.EventType - [创建桶(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0801.md): OBS桶是对象的容器,您上传的文件都将以对象的形式存放在桶中。本文介绍如何使用Python SDK创建桶。调用创建桶接口,将在当前账号按照用户指定的桶名创建一个新桶,接口支持根据用户诉求,在创建桶的同时配置桶的存储类别、区域及桶ACL等参数。您必须拥有obs:bucket:CreateBucket权限,才能创建桶。建议使用IAM进行授权, - [列举桶内对象(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0805.md): 调用列举桶内对象接口,可列举指定桶内的部分或所有对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的对象信息。返回结果以对象名的字典序排序。每次接口调用最多返回1000个对象信息。您必须是桶拥有者或拥有列举桶内对象的权限,才能列举桶内对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucke - [删除桶(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0804.md): 桶为空时,用户可以删除桶,以免占用桶数量配额。删除桶后需要等待30分钟才能创建同名桶。华为云无法恢复用户主动删除的OBS数据。因此调用接口删除桶后,桶相关数据无法恢复,请谨慎操作。待删除的桶必须为空,桶为空包含两方面含义:桶内没有任何对象,没有对象的任何历史版本,没有对象的删除标记(删除标记也视作一个历史版本)。桶内没有任何未合并的多段上 - [获取桶元数据(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0807.md): 调用获取桶元数据接口,可获取指定桶的相关信息,包括指定桶的存储类型、区域位置、跨域资源共享(CORS)规则、冗余策略等信息。您必须是桶拥有者或拥有获取桶元数据的权限,才能获取桶元数据。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:HeadBucket权限,如果使用桶策略则需授予HeadBucket权限。相关授 - [获取桶区域位置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0808.md): 获取指定桶所在的区域位置。您必须是桶拥有者或拥有获取桶区域位置的权限,才能获取桶区域位置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketLocation权限,如果使用桶策略则需授予GetBucketLocation权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策 - [获取桶列表(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0802.md): OBS桶是对象的容器,您上传的文件都存放在桶中。调用获取桶列表接口,可列举当前账号所有地域下符合指定条件的桶。返回结果以桶名的字典序排序。您必须拥有obs:bucket:ListAllMyBuckets权限,才能获取桶列表。建议使用IAM进行授权,配置方式详见使用IAM自定义策略。OBS支持的Region与Endpoint的对应关系,详细 - [判断桶是否存在(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0803.md): 判断指定桶名的桶是否存在,返回的结果中HTTP状态码为200表明桶存在,否则返回404表明桶不存在。您必须是桶拥有者或拥有判断桶是否存在的权限,才能判断桶是否存在。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:HeadBucket权限,如果使用桶策略则需授予HeadBucket权限。相关授权方式介绍可参见OB - [列举桶内多版本对象(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0806.md): 用列举桶内对象接口,可列举指定桶内的部分或所有多版本对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的多版本对象信息。返回结果以多版本对象名的字典序排序。您必须是桶拥有者或拥有列举桶内多版本对象的权限,才能列举桶内多版本对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:List - [获取桶存量信息(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0809.md): 调用获取桶存量信息接口,可查询指定桶内的对象个数,以及对象占用空间的大小。由于OBS桶存量是后台统计,因此存量会有一定的时延,不能实时更新,因此不建议对存量做实时校验。您必须是桶拥有者或拥有获取桶存量信息的权限,才能获取桶存量信息。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketStorage - [设置桶配额(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0810.md): 桶配额是桶容量的上限值。默认情况下,OBS系统和单个桶都没有总数据容量和对象数量的限制。您可以根据需要,为桶设置配额限制来控制桶内允许上传的对象总容量,超过设置的对象容量后,上传对象会失败。例如您为桶设置配额为100G,那么当桶内所有对象的大小总和达到100G后,再上传对象就会因为超过配额导致上传失败。容量限制只对桶配额设置生效后的对象上 - [获取桶配额(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0811.md): 桶配额是桶容量的上限值。调用获取桶配额接口,可获取指定桶的配额值。桶配额为0代表桶容量没有上限。桶配额值必须为非负整数,单位为字节,支持的最大值为263-1。桶的拥有者的状态是欠费冻结状态时不可以查询桶配额信息。您必须是桶拥有者或拥有获取桶配额的权限,才能获取桶配额。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucke - [设置桶存储类型(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0812.md): OBS提供了这些存储类型:标准存储、低频访问存储、归档存储、深度归档存储,从而满足客户业务对存储性能、成本的不同诉求,详情可参见OBS存储类型。调用设置桶存储类型接口,可设置指定桶的存储类型。设置了桶的默认存储类型之后,如果上传对象、复制对象和初始化多段上传任务时未指定对象的存储类型,则该对象的存储类型默认与桶的存储类型保持一致。您必须是 - [获取桶存储类型(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0813.md): OBS提供了这些存储类型:标准存储、低频访问存储、归档存储、深度归档存储,从而满足客户业务对存储性能、成本的不同诉求,详情可参见OBS存储类型。调用获取桶存储类型接口,可获取指定桶的存储类型。您必须是桶拥有者或拥有获取桶存储类型的权限,才能获取桶存储类型。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetB - [设置桶ACL(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0814.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [获取桶ACL(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0815.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [设置桶日志管理配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0816.md): 调用设置桶日志管理配置接口,您可以为指定桶打开桶日志功能,并配置日志存放的目标桶。创建桶时,默认是不生成桶的日志的,调用Python SDK的设置桶日志管理配置接口时,接口会自动为您打开桶日志配置。桶日志功能开启后,桶的每次操作将会产生一条日志,并将多条日志打包成一个日志文件。日志文件存放位置需要在开启桶日志功能时指定,可以存放到开启日志 - [获取桶日志管理配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0817.md): 调用获取桶日志管理配置,可获取指定桶的日志配置。您必须是桶拥有者或拥有获取桶日志管理配置的权限,才能获取桶日志管理配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketLogging权限,如果使用桶策略则需授予GetBucketLogging权限。相关授权方式介绍可参见OBS权限控制概述,配置 - [设置桶策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0818.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。桶策略是作用于所配置的OBS桶及桶内对象的,您可以通过桶策略可为IAM用户 - [获取桶策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0819.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。桶策略是作用于所配置的OBS桶及桶内对象的,您可以通过桶策略可为IAM用户 - [删除桶策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0820.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。桶策略是作用于所配置的OBS桶及桶内对象的,您可以通过桶策略可为IAM用户 - [设置桶的生命周期配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0821.md): OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用设置桶的生命周期配置接口,您可以为指定桶设置生命周期策略。对象生命周期到期以后,对象将会永久删除,无法恢复。归档存储和深度归档存储不支持多AZ,因此不支持使用生命周期的存储类别转换功能,将多AZ的桶 - [获取桶的生命周期配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0822.md): OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用获取桶的生命周期配置接口,您可以获取指定桶的生命周期策略。您必须是桶拥有者或拥有获取桶的生命周期配置的权限,才能获取桶的生命周配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bu - [删除桶的生命周期配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0823.md): OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用删除桶的生命周期配置接口,您可以删除指定桶的生命周期策略。您必须是桶拥有者或拥有删除桶的生命周期配置的权限,才能删除桶的生命周配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bu - [静态网站托管(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1304.md): 支持将静态网站文件上传至OBS的桶中作为对象,并对这些对象赋予公共读权限,然后将该桶配置成静态网站托管模式,以实现在OBS上托管静态网站的目的。第三方用户在访问静态托管网站的时候,实际上是在访问OBS的桶中的对象。在使用静态网站托管功能时,OBS还支持配置请求重定向,通过重定向配置可以将特定的请求或所有请求实施重定向。更多关于静态网站托管 - [设置桶的Website配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0824.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用设置桶的网站配置接口,您可以为指定桶设置网站配 - [获取桶的Website配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0825.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用获取桶的网站配置接口,您可以获取指定桶的网站配 - [删除桶的Website配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0826.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用删除桶的网站配置接口,您可以删除指定桶的网站配 - [设置桶的多版本状态(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0827.md): OBS支持多版本控制,您可以在一个桶中保留对象的多个版本,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。更多多版本相关信息请参见多版本控制。调用设置桶的多版本状态接口,您可以为指定桶设置多版本状态。您必须是桶拥有者或拥有设置桶的多版本状态的权限,才能设置桶的多版本状态。建议使用IAM或桶策略进行授权,如果使用IA - [获取桶的多版本状态(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0828.md): OBS支持多版本控制,您可以在一个桶中保留对象的多个版本,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。更多多版本相关信息请参见多版本控制。调用获取桶的多版本状态接口,您可以获取指定桶的多版本状态。您必须是桶拥有者或拥有获取桶的多版本状态的权限,才能获取桶的多版本状态。建议使用IAM或桶策略进行授权,如果使用IA - [设置桶的CORS配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0829.md): 跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全策略(Same Origin Policy,SOP)的存在,不同域之间的网站脚本和内容是无法进行交互 - [获取桶的CORS配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0830.md): 跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全策略(Same Origin Policy,SOP)的存在,不同域之间的网站脚本和内容是无法进行交互 - [删除桶的CORS配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0831.md): 跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全策略(Same Origin Policy,SOP)的存在,不同域之间的网站脚本和内容是无法进行交互 - [设置桶的事件通知配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0832.md): OBS事件通知功能帮助您对桶的重要的操作进行实时监控,重要操作触发时可及时通知到您,确保您安全、及时知道发生在桶上的关键事件。调用设置桶的事件通知配置接口,可为指定桶设置事件通知配置。您必须是桶拥有者或拥有设置桶的事件通知配置的权限,才能设置桶的事件通知配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:Pu - [获取桶的事件通知配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0833.md): OBS事件通知功能帮助您对桶的重要的操作进行实时监控,重要操作触发时可及时通知到您,确保您安全、及时知道发生在桶上的关键事件。调用获取桶的事件通知配置接口,可获取指定桶的事件通知配置。您必须是桶拥有者或拥有获取桶的事件通知配置的权限,才能获取桶的事件通知配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:Ge - [设置桶标签(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0834.md): 为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的标签来分析此应用的成本。调用设置桶标签接口,您可为指定桶添加标签。每个桶最多能设置10个标签。标签的 - [获取桶标签(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0835.md): 为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的标签来分析此应用的成本。调用获取桶标签接口,您可获取指定桶的标签。您必须是桶拥有者或拥有获取桶标签的 - [删除桶标签(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0836.md): 为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的标签来分析此应用的成本。调用删除桶标签接口,您可删除指定桶的标签。您必须是桶拥有者或拥有删除桶标签的 - [设置桶加密(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0838.md): 设置桶的加密配置,以允许在该桶中上传对象时,采用对应加密配置对数据进行加密,数据在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用设置桶加密配置接口,您可以为指定桶创建或更新加密配置信息。您必须是桶拥有者或拥有设置桶加密配置的权限,才能设置桶加密配置。建议使用IAM或桶策略进行授权,如果使 - [获取桶加密(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0839.md): 桶的加密配置功能,支持在该桶中上传对象时,采用对应加密配置对数据进行加密,数据在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用获取桶加密配置接口,您可以获取指定桶的加密配置信息。您必须是桶拥有者或拥有获取桶加密配置的权限,才能获取桶加密配置。建议使用IAM或桶策略进行授权,如果使用IAM - [删除桶加密(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0840.md): 桶的加密配置功能,支持在该桶中上传对象时,采用对应加密配置对数据进行加密,数据在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用删除桶加密配置接口,您可以删除指定桶的加密配置信息。您必须是桶拥有者或拥有删除桶加密配置的权限,才能删除桶加密配置。建议使用IAM或桶策略进行授权,如果使用IAM - [服务端加密(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1303.md): 用户可以使用普通方式上传、下载对象,也可以使用服务端加密方式进行上传、下载对象。OBS支持服务端加密功能,使加密的行为在服务端进行。用户可以根据自身的需求,使用不同的密钥管理方式来使用服务端加密功能。当前支持两种服务端加密方式: KMS托管密钥的服务端加密(SSE-KMS)和客户提供加密密钥的服务端加密(SSE-C)。上述两种方式都采用行 - [客户端加密简介(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1010.md): 客户端加密是指在传输数据前,使用您选择的加密方法与加密信息,在本地进行数据加密,再将加密后结果发送至 OBS 服务器,同时将加密方法与解密所需的必要辅助信息存储到对象元数据中。在下载时 OBS SDK 会依据您提供的密钥与存储在对象元数据中的解密辅助信息进行数据解密,直接返回解密后结果。OBS 不会以任何方式存储您的主密钥,您必须自行保证 - [客户端加密接口详情(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1011.md): 完整示例代码参考示例代码OBS Python SDK 提供两种 CryptoCipher。您可根据使用场景自行选择。CtrRSACipherGenerator 需要提供一个 RSA 公钥或 RSA 私钥,用以加密随机生产的数据密钥。方法定义接口参数CTRCipherGenerator 仅需提供一个数据密钥,所有对象均使用该数据密钥进行加密 - [设置桶的BPA配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0846.md): 创建或修改OBS桶的PublicAccessBlock配置,以开启或关闭阻止公开访问。您必须是桶拥有者或拥有设置桶BPA配置的权限,才能设置桶桶BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutBucketPublicAccessBlock权限,如果使用桶策略则需授予PutBucketPubli - [获取桶的BPA配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0847.md): 获取OBS桶的PublicAccessBlock配置。您必须是桶拥有者或拥有获取桶的BPA配置的权限,才能获取桶的BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPublicAccessBlock权限,如果使用桶策略则需授予GetBucketPublicAccessBlock权限。 - [删除桶的BPA配置(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0848.md): 删除OBS桶的PublicAccessBlock配置。您必须是桶拥有者或拥有删除桶的BPA配置的权限,才能删除桶的BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketPublicAccessBlock权限,如果使用桶策略则需授予DeleteBucketPublicAccessBl - [查询桶策略公开状态(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0849.md): 获取OBS桶策略的公开状态。您必须是桶拥有者或拥有获取桶策略公开状态的权限,才能获取桶策略公开状态。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPolicyPublicStatus权限,如果使用桶策略则需授予GetBucketPolicyPublicStatus权限。相关授权方式介绍可参见 - [查询桶的公开状态(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0850.md): 获取OBS桶的公开状态。您必须是桶拥有者或拥有获取桶公开状态的权限,才能获取桶公开状态。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPublicStatus权限,如果使用桶策略则需授予GetBucketPublicStatus权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用 - [设置桶的自定义域名(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0851.md): 设置OBS桶的自定义域名。您必须是桶拥有者或拥有设置桶的自定义域名的权限,才能设置桶的自定义域名。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutBucketCustomDomainConfiguration权限,如果使用桶策略则需授予PutBucketCustomDomainConfiguration权 - [获取桶的自定义域名(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0852.md): 获取OBS桶的自定义域名列表。您必须是桶拥有者或拥有获取桶的自定义域名的权限,才能获取桶的自定义域名。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketCustomDomainConfiguration权限,如果使用桶策略则需授予GetBucketCustomDomainConfiguratio - [删除桶的自定义域名(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0853.md): 删除OBS桶的自定义域名。您必须是桶拥有者或拥有删除桶的自定义域名的权限,才能删除桶的自定义域名。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketCustomDomainConfiguration权限,如果使用桶策略则需授予DeleteBucketCustomDomainConfigur - [创建并行文件系统(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1801.md): OBS并行文件系统是对象的容器,您上传的文件都将以对象的形式存放在并行文件系统中。本文介绍如何使用Python SDK创建并行文件系统。调用创建并行文件系统接口,将在当前账号按照用户指定的并行文件系统名创建一个新并行文件系统,接口支持根据用户诉求,在创建并行文件系统的同时配置并行文件系统的存储类别、区域及并行文件系统的访问权限等参数。您必 - [列举并行文件系统(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1802.md): OBS并行文件系统是对象的容器,您上传的文件都存放在并行文件系统中。调用获取并行文件系统列表接口,可列举当前账号所有地域下符合指定条件的并行文件系统。返回结果以并行文件系统名的字典序排序。您必须拥有obs:bucket:ListAllMyBuckets权限,才能获取并行文件系统列表。建议使用IAM进行授权,配置方式详见使用IAM自定义策略 - [列举并行文件系统内对象](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1804.md): 调用列举并行文件系统内对象接口,可列举指定并行文件系统内的部分或所有对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的对象信息。返回结果以对象名的字典序排序。每次接口调用最多返回1000个对象信息。您必须是并行文件系统拥有者或拥有列举并行文件系统内对象的权限,才能列举并行文件系统内对象。建议使用IAM或策略进 - [设置桶清单规则(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3002.md): 桶清单功能可以定期生成桶内对象的相关信息,保存在CSV格式的文件中,并上传到您指定的桶中,方便您管理桶内对象。目标桶和源桶可以是同一个桶。指定的对象内容包括对象版本、大小、上次修改时间、存储类别、标签、加密状态等。支持对桶清单加密,加密方式为SSE-KMS方式。您必须是桶拥有者或者拥有设置桶清单权限,才能设置桶清单。建议使用IAM或桶策略 - [获取桶清单规则(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3003.md): 您可以使用获取桶清单规则接口获取指定桶的清单规则,可以通过配置规则id来选择指定清单规则。您必须是桶拥有者或者拥有获取桶清单权限,才能获取桶清单。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetInventoryConfiguration权限,如果使用桶策略则需授予GetInventoryConfigur - [删除桶清单规则(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3004.md): OBS使用DELETE操作来删除指定桶的清单配置(通过清单规则id来指定确认要删除的桶清单规则)。您必须是桶拥有者或者拥有删除桶清单权限,才能删除桶清单。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketInventoryConfiguration权限,如果使用桶策略则需授予DeleteB - [列举桶清单规则(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3005.md): OBS使用不带清单id的GET操作来获取指定桶的所有清单配置,获取到的清单配置一次性返回,不分页。您必须是桶拥有者或者拥有列举桶清单权限,才能列举桶清单。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetInventoryConfiguration权限,如果使用桶策略则需授予GetInventoryConf - [设置桶归档存储冷存储对象直读策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3007.md): 归档存储冷存储对象直读是指用户可以不用恢复归档存储冷存储对象,便能直接对其进行操作。默认情况下,桶没有开启归档存储冷存储对象直读功能。本接口主要用来开启或关闭桶的归档存储冷存储对象直读功能。设置桶的归档存储冷存储对象直读状态为Enabled,开启桶的归档存储冷存储对象直读功能:桶内存在归档存储冷存储对象时,不管该归档存储冷存储对象是否已经 - [获取桶归档存储冷存储对象直读策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3008.md): 桶的所有者可以获取指定桶的归档存储冷存储对象直读状态。如果从未设置桶的归档存储冷存储对象直读状态,或者已经删除桶的归档存储冷存储对象直读状态,则此操作不会返回桶的归档存储冷存储对象直读状态。当桶设置了归档存储冷存储对象直读状态,可以通过本接口获取指定桶的归档存储冷存储对象直读状态信息。了解更多归档存储冷存储数据直读相关信息,请参见归档数据 - [删除桶归档存储冷存储对象直读策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3009.md): 删除指定桶的归档存储冷存储对象直读配置信息。删除后桶内的归档存储冷存储对象不能直接读取。对未恢复或正在恢复的归档存储冷存储对象进行操作时,会返回错误403 Forbidden。对于设置了归档存储冷存储对象直读状态的桶,可以删除指定桶的归档存储冷存储对象直读状态,删除后桶内的归档存储冷存储对象不能直接读取。了解更多归档存储冷存储数据直读相关 - [设置DIS通知策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3011.md): 本接口用于为指定桶配置DIS通知策略。接口是幂等的,如果桶上已存在相同策略内容,则返回成功,status code返回值为200;否则status code返回值为201。融合桶不支持设置DIS通知策略。您必须是拥有Tenant Administrator权限,才能调用本接口。配置Tenant Administrator权限,需要使用角色 - [获取DIS通知策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3012.md): 本接口用于查询指定桶的DIS通知策略信息。如果策略存在,则返回成功,status code返回值为200。融合桶不支持设置DIS通知策略。您必须是桶拥有者或者拥有Tenant Administrator权限,才能调用本接口。配置Tenant Administrator权限,需要使用角色与策略授权(旧版IAM,即IAM v3接口),授权操作 - [删除DIS通知策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3013.md): 本接口用于删除指定桶中配置的全部DIS通知策略。删除成功,status code返回值为204。融合桶不支持设置DIS通知策略。您必须是桶拥有者或者拥有Tenant Administrator权限,才能调用本接口。配置Tenant Administrator权限,需要使用角色与策略授权(旧版IAM,即IAM v3接口),授权操作请参考使用 - [设置在线解压策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3015.md): OBS支持ZIP包上传后自动解压并存放在指定目录。桶设置了在线解压策略后,上传到该桶内的ZIP包如果匹配解压策略,ZIP包将会自动解压到指定目录里。本接口用于为指定桶配置ZIP文件解压策略。了解更多在线解压相关信息,请参见在线解压。融合桶不支持在线解压。ObsClient.setObsCompressPolicy(bucketName, - [获取在线解压策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3016.md): 桶拥有者或拥有获取在线解压策略权限的用户可通过本接口查询指定桶的文件解压策略。如果策略存在,则返回成功,status code返回值为200。了解更多在线解压相关信息,请参见在线解压。融合桶不支持在线解压。ObsClient.getObsCompressPolicy(bucketName, extensionHeaders)本示例用于获取 - [删除在线解压策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3017.md): 桶拥有者或拥有删除在线解压策略权限的用户可通过本接口删除指定桶中配置的文件解压策略,删除成功status code返回值为204。了解更多在线解压相关信息,请参见在线解压。融合桶不支持在线解压。ObsClient.deleteObsCompressPolicy(bucketName, extensionHeaders)本示例用于删除exa - [设置桶级默认WORM策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3019.md): 本接口用于为指定桶配置默认保护策略和保护期限。当您在桶内配置了桶级默认WORM策略以后,如果您在上传对象时没有指定保护策略和保护期限,则新上传的对象会自动应用桶级默认WORM策略。和配置对象级WORM保护策略不同的地方在于,对象级WORM保护策略需要您提供一个明确的时间,在这个时间之前对象都会受到保护,桶级默认WORM策略则要求您提供一个 - [获取桶级默认WORM策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_3020.md): 获取该桶设置的桶级默认WORM策略。如果您打开了桶级WORM开关,但从未配置过桶级默认WORM策略,您依然可以使用此接口查看开关的打开情况。您必须是桶拥有者或者拥有获取桶级默认WORM策略权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketObjectLockConfigur - [上传对象简介(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0501.md): 上传对象到指定桶中。在OBS中,用户操作的基本数据单元是对象。OBS Python SDK提供了丰富的对象上传接口,可以通过以下方式上传对象:文本上传:使用字符串作为对象的数据源。流式上传:使用包含“read”属性的可读对象作为对象的数据源。文件上传:使用本地文件作为对象的数据源。分段上传:对于较大文件上传,可以切分成段上传。追加上传:对 - [上传对象-文本上传(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0901.md): 本章节介绍使用字符串作为对象的数据源,上传文本到指定桶。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对象策 - [上传对象-流式上传(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0902.md): 通过SDK的流式上传,可以上传小于5GB的文件。本章节介绍如何使用python SDK流式上传对象。流式上传使用包含“read”属性的可读对象作为对象的数据源,以网络流或文件流方式上传数据到指定桶。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObje - [上传对象-文件上传(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0903.md): 您可以将本地文件直接通过Internet上传至OBS指定的桶中。待上传的文件可以是任何类型:文本文件、图片、视频等。OBS本身是没有文件夹的概念的,桶中存储的元素只有对象。创建文件夹实际上是创建了一个大小为0且对象名以“/”结尾的对象,这类对象与其他对象无任何差异,可以进行下载、删除等操作,只是OBS控制台会将这类以“/”结尾的对象以文件 - [上传对象-追加上传(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0904.md): 您可以根据需要上传文件或者文件夹至已有的OBS桶。待上传的文件可以是任何类型:文本文件、图片、视频等。追加写对象操作是指在指定桶内的一个对象尾追加上传数据,不存在相同对象键值的对象则创建新对象。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject - [上传对象-断点续传上传(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0905.md): 对分段上传的封装和加强,解决上传大文件时由于网络不稳定或程序崩溃导致上传失败的问题。其原理是将待上传的文件分成若干个分段分别上传,并实时地将每段上传结果统一记录在checkpoint文件中,仅当所有分段都上传成功时返回上传成功的结果,否则返回错误信息提醒用户再次调用接口进行重新上传(重新上传时因为有checkpoint文件记录当前的上传进 - [上传对象-获取上传进度(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0906.md): 支持获取上传进度的接口包括:流式上传、文件上传、上传段、追加上传和断点续传上传。本示例用于通过设置回调函数来获取上传对象的进度。示例代码如下: - [上传对象-基于表单上传(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0907.md): 基于表单上传是使用HTML表单形式上传对象到指定桶中,对象最大不能超过5GB。可以通过ObsClient.createPostSignature生成基于表单上传的请求参数。使用代码模拟表单上传的完整代码示例,参见post_object_sample。您也可以通过如下步骤进行表单上传:使用ObsClient.createPostSignat - [上传对象-创建文件夹(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0915.md): 您可以在已创建的桶中新建一个文件夹,从而更方便地对存储在OBS中的数据进行分类管理。OBS本身是没有文件夹的概念的,桶中存储的元素只有对象。创建文件夹实际上是创建了一个大小为0且对象名以“/”结尾的对象,这类对象与其他对象无任何差异,可以进行下载、删除等操作,只是OBS控制台会将这类以“/”结尾的对象以文件夹的方式展示。您必须是桶拥有者或 - [下载对象简介(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0502.md): OBS Python SDK提供了丰富的对象下载接口,可以通过以下方式下载对象:二进制下载流式下载文件下载范围下载断点续传下载 - [下载对象-范围下载(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0911.md): 如果只需要下载对象的其中一部分数据,可以使用范围下载,下载时指定范围的数据。如果指定的下载范围是0~1000,则返回第0到第1000个字节的数据,包括第1000个,共1001字节的数据,即[0,1000]。如果指定的范围无效,则返回整个对象的数据。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用 - [下载对象-文件下载(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0910.md): 您可以根据需要将存储在OBS中的对象下载到本地。以文件形式下载指定桶中的对象。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM - [下载对象-流式下载(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0909.md): 您可以根据需要将存储在OBS中的对象下载到本地。如果您要下载的对象太大或者下载耗时长,可以通过流式下载的方式下载对象。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetObject权限。相关授权方式介绍可参见O - [下载对象-断点续传下载(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0912.md): 当下载大对象到本地文件时,经常出现因网络不稳定或程序崩溃导致下载失败的情况。失败后再次重新下载不仅浪费资源,而且当网络不稳定时仍然有下载失败的风险。断点续传下载接口能有效地解决此类问题引起的下载失败,其原理是将待下载的对象分成若干个分段分别下载,并实时地将每段下载结果统一记录在checkpoint文件中,仅当所有分段都下载成功时返回下载成 - [下载对象-批量下载(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0914.md): 批量下载指定的对象。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对象策略。OBS支持的Region与End - [下载对象-二进制下载(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0908.md): 您可以根据需要将存储在OBS中的对象下载到本地。指定参数loadStreamInMemory为True忽略downloadpath路径,将文件的二进制流下载到本地。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予G - [下载对象-获取下载进度(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0913.md): 支持获取下载进度的接口包括:二进制式下载,流式下载、文件下载和断点续传下载。本示例用于获取下载对象的进度。示例代码如下: - [下载对象-图片处理(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_2021.md): 本示例用于生成图片处理的带授权信息的URL。本示例用于在断点续传下载时进行图片处理。 - [删除对象(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0918.md): 为节省空间和成本,您可以根据需要删除指定桶中的单个对象。您必须是桶拥有者或拥有删除对象的权限,才能删除对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:DeleteObject权限,如果使用桶策略则需授予DeleteObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略 - [批量删除对象(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0919.md): 为节省空间和成本,您可以根据需要删除指定桶中的多个对象。OBS本身没有文件夹概念,桶中存储的元素只有对象。工具和控制台看到的目录实际上是一个大小为0且对象名以“/”结尾的对象。删除文件夹需列举目录前缀下的所有对象再调用批量删除接口。批量删除对象特性用于将一个桶内的部分对象一次性删除,删除后不可恢复。批量删除对象要求返回结果里包含每个对象的 - [复制对象(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0917.md): 用户可以根据需要将存储在OBS上的对象复制到其他路径下。复制对象操作将创建需要复制的对象的副本。在单次操作中,您可以创建最大5GB的对象副本。为指定桶中的对象创建一个副本。您必须是桶拥有者或拥有复制对象的权限,才能复制对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则 - [获取对象元数据(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0920.md): 元数据(Metadata)为描述对象属性的信息,是一组名称值对,用作对象管理的一部分。当前仅支持系统定义的元数据。系统定义的元数据又分为两种类别:系统控制和用户控制。对指定桶中的对象发送HEAD请求,获取对象的元数据信息。您必须是桶拥有者或拥有获取对象元数据的权限,才能获取对象元数据。建议使用IAM或桶策略进行授权,如果使用IAM则需授予 - [修改对象元数据(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0921.md): 元数据(Metadata)为描述对象属性的信息,是一组名称值对,用作对象管理的一部分。当前仅支持系统定义的元数据。系统定义的元数据又分为两种类别:系统控制和用户控制。如Last-Modified日期等数据由系统控制,不可修改;如为对象配置的ContentLanguage,用户可以通过接口进行修改。可以通过本接口添加、修改或删除桶中已经上传 - [判断对象是否存在(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0925.md): 判断对象是否存在,返回的结果中HTTP状态码为200表明对象存在,否则返回404表明对象或桶不存在。您必须是桶拥有者或拥有列举桶内对象的权限,才能判断判断对象是否存在。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:ListBucket权限,如果使用桶策略则需授予ListBucket权限。相关授权方式介绍可参见 - [恢复归档或深度归档存储对象(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0924.md): 归档要先将对象恢复,然后再执行下载数据的操作。对象恢复后,会产生一个标准存储类型的对象副本,也就是说会同时存在标准存储类型的对象副本和归档或深度归档存储对象,在恢复对象的保存时间到期后标准存储类型的对象副本会自动删除。该接口可以恢复指定桶中的归档或深度归档存储对象。您必须是桶拥有者或拥有恢复对象的权限,才能恢复对象。建议使用IAM或桶策略 - [配置对象级WORM保护策略(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0999.md): 开启了WORM开关的桶,上传的对象支持配置或修改对象保护期限。如果上传对象时没有配置保护期限或自动应用桶级默认保护策略,您可以通过该操作配置对象保护期限。如果上传对象时配置了保护期限或自动应用了默认保护期限,允许用户通过该操作延长保护期限。对象保护期限仅允许修改,不允许删除。您必须是桶拥有者或拥有配置对象级WORM保护策略的权限,才能调用 - [截断对象(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0998.md): 截断对象操作是指将指定文件桶内的一个已有对象截断到指定大小。您必须是桶拥有者或拥有截断对象的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置 - [修改写对象(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0997.md): 修改写对象操作是指将指定文件桶内的一个对象从指定位置起修改为其他内容。您必须是桶拥有者或拥有修改写对象的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定 - [文件重命名(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0926.md): 对于并行文件系统内的文件支持对文件的重命名操作。您必须是并行文件系统拥有者或拥有重命名文件的权限,才能重命名文件。建议使用IAM或策略进行授权,如果使用IAM则需授予obs:bucket:PutObject权限,如果使用策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对象 - [设置对象ACL(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0922.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [获取对象ACL(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0923.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [设置对象标签(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_5000.md): 用户可以通过本接口设置或更新对象(Object)的标签信息。对象标签使用一组键值对(Key-Value)标记对象。如果请求中不携带版本号(versionId),需要确保执行者有PutObjectTagging权限。如果请求中携带版本号(versionId),需要确保执行者有PutObjectTagging+PutObjectVersion - [获取对象标签(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_5001.md): 用户可以通过本接口获取对象(Object)的标签信息。如果请求中不携带版本号(versionId),需要确保执行者有GetObjectTagging权限。如果请求中携带版本号(versionId),需要确保执行者有GetObjectTagging+GetObjectVersionTagging权限。缺省情况下只有对象的所有者可以执行此操作 - [删除对象标签(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_5002.md): 用户可以通过本接口删除对象(Object)的标签信息。如果请求中不携带版本号(versionId),需要确保执行者有DeleteObjectTagging权限。如果请求中携带版本号(versionId),需要确保执行者有DeleteObjectTagging+DeleteObjectVersionTagging权限。缺省情况下只有对象的所 - [使用CRC64校验文件一致性(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0927.md): CRC计算是一个计算密集型的过程,需要进行大量的位移、异或 (XOR) 和查表操作。开启后会耗费额外时间,数据量越大,所需的CPU时间越多,C扩展模式1GB数据计算时间大约在4-6秒之间。OBS Python SDK需要crcmod计算CRC校验码,而crcmod依赖于python-devel包中的Python.h文件。crcmod包括C - [使用MD5校验文件一致性(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0928.md): 您可以通过以下接口在上传对象时使用md5校验文件一致性:文本上传文件上传追加上传上传段本示例用于上传文本对象时使用MD5校验文件一致性。本示例用于上传单个文件时使用MD5校验文件一致性。本示例用于追加上传对象时使用MD5校验文件一致性。本示例用于展示上传段时使用MD5校验段数据一致性。 - [分段上传简介(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1001.md): 对于较大文件上传,可以切分成段上传。用户可以在如下的应用场景内(但不仅限于此),使用分段上传的模式:上传超过100MB大小的文件。网络条件较差,和OBS服务端之间的链接经常断开。上传前无法确定将要上传文件的大小。分段上传分为如下3个步骤:初始化分段上传任务(ObsClient.initiateMultipartUpload)。逐个或并行上 - [分段上传-初始化上传段任务(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1002.md): 使用多段上传特性时,用户必须首先调用创建多段上传任务接口创建任务,系统会给用户返回一个全局唯一的多段上传任务号,作为任务标识。后续用户可以根据这个标识发起相关的请求,如:上传段、合并段、列举段等。创建多段上传任务不影响已有的同名对象;同一个对象可以同时存在多个多段上传任务;每个多段上传任务在初始化时可以附加消息头信息,包括acl、用户自定 - [分段上传-上传段(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1003.md): 初始化分段上传任务后,通过分段上传任务的ID,上传段到指定桶中。除了最后一段以外,其他段的大小范围是100KB~5GB;最后一段的大小范围是0~5GB。上传的段的编号也有范围限制,其范围是1~10000。上传段时,除了指定上传ID,还必须指定段编号。您可以选择1和10000之间的任意段编号。段编号在您正在上传的对象中唯一地标示了段及其位置 - [分段上传-列举已上传的段(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1004.md): 通过分段上传任务的ID,列举指定桶中已上传的段。您可以列出特定多段上传任务或所有正在进行的多段上传任务的分段。列举已上传的段操作将返回您已为特定多段上传任务而上传的段信息。对于每个列举已上传的段请求,OBS将返回有关特定多段上传任务的分段信息,最多为1000个分段。如果多段上传中的段超过1000个,您必须发送一系列列举已上传的段请求以检索 - [分段上传-列举分段上传任务(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1005.md): 列举指定桶中所有的初始化后还未合并或还未取消的分段上传任务。通过列举桶中的多段上传任务,您可以获得已初始化多段上传任务的列表,已初始化多段上传任务是指初始化后还未合并以及未取消的多段上传任务。每个请求将返回最多1000个多段上传任务,如果正在进行的多段上传任务超过1000个,您需要发送其他请求以检索剩余的多段上传任务。您必须是桶拥有者或拥 - [分段上传-合并段(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1006.md): 如果用户上传完所有的段,就可以调用合并段接口,系统将在服务端将用户指定的段合并成一个完整的对象。在执行“合并段”操作以前,用户不能下载已经上传的数据。在合并段时需要将多段上传任务初始化时记录的附加消息头信息拷贝到对象元数据中,其处理过程和普通上传对象带这些消息头的处理过程相同。在并发合并段的情况下,仍然遵循Last Write Win策略 - [分段上传-复制段(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1007.md): 初始化分段上传任务后,通过分段上传任务的ID,复制段到指定桶中。多段上传任务创建后,用户可以通过指定多段上传任务号,为特定的任务上传段。添加段的方式还包括调用段拷贝接口。允许用户将已上传对象的一部分或全部拷贝为段。将源对象object拷贝为一个段part1,如果在拷贝操作之前part1已经存在,拷贝操作执行之后,旧的段数据part1会被新 - [分段上传-取消分段上传任务(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1008.md): 通过分段上传任务的ID,取消指定桶中的分段上传任务。您可以选择取消多段上传任务,取消多段上传任务之后无法再次使用该上传ID上传任何段。然后,OBS将释放被取消的多段上传任务中的每个段数据的所有存储。如果有多段上传已在进行中,即使您已执行中止操作,它们仍可以上传成功或失败。如果要释放所有分段使用的所有存储,必须在完成所有多段上传后再取消多段 - [创建工作流(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1107.md): 根据模板创建工作流。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。关于创建工作流的API说明,请参见创建工作流。创建工作流过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。 - [查询工作流(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1108.md): 按名称查询工作流。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。关于查询工作流的API说明,请参见查询工作流。查询工作流过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。 - [删除工作流(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1109.md): 删除存在的工作流。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。关于删除工作流的API说明,请参见删除工作流。删除工作流过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。 - [更新工作流(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1110.md): 更新工作流。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。关于更新工作流的API说明,请参见更新工作流。更新工作流过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。 - [查询工作流列表(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1111.md): 查询工作流列表。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。关于查询工作流列表的API说明,请参见查询工作流列表。查询工作流列表过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。 - [API触发启动工作流(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1112.md): API触发启动工作流。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。关于API触发启动工作流的API说明,请参见API异步启动工作流。API触发启动工作流过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。 - [查询工作流实例列表(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1114.md): 查询工作流实例列表。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。关于查询工作流实例列表的API说明,请参见查询工作流实例列表。查询工作流实例列表过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。 - [查询工作流实例(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1115.md): 查询工作流实例详细。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。关于查询工作流实例的API说明,请参见查询工作流实例。查询工作流实例过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。 - [恢复失败状态的工作流实例](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1800.md): 当且仅当一个工作流实例是执行失败状态才能执行恢复操作。恢复后,工作流实例将从上次失败的状态处继续执行,而已经执行过的状态不会再执行。 - [配置桶触发器(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1118.md): 在桶上绑定工作流触发器。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。关于配置桶触发器的API说明,请参见配置桶触发器。配置桶触发器过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。 - [查询桶触发器(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1119.md): 查询桶上绑定工作流触发器。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。关于查询桶触发器的API说明,请参见查询桶触发器。查询桶触发器过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。 - [删除桶触发器(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1120.md): 删除在桶上绑定工作流触发器。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。关于删除桶触发器的API说明,请参见删除桶触发器。删除桶触发器过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码。 - [恢复失败状态的工作流实例(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1116.md): 当且仅当一个工作流实例是执行失败状态才能执行恢复操作。恢复后,工作流实例将从上次失败的状态处继续执行,而已经执行过的状态不会再执行。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。关于恢复失败状态的工作流实例的API说明,请参见恢复失败状态的工作流实例。恢复失败状态的工作流实例过程中返回的错误码含义、问 - [结构体说明](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1121.md): END State没有payload_filter_in和payload_filter_out属性 - [生成带授权信息的URL(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1301.md): 通过访问密钥、请求方法类型、请求参数等信息生成一个在Query参数中携带鉴权信息的URL,可将该URL提供给其他用户进行临时访问。在生成URL时,需要指定URL的有效期来限制访客用户的访问时长。如果想授予其他用户对桶或对象临时进行其他操作的权限(例如上传或下载对象),则需要生成带对应请求的URL后(例如使用生成PUT请求的URL上传对象) - [生成带授权信息的表单上传参数(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1302.md): 生成用于鉴权的请求参数,以进行基于浏览器的POST表单上传。使用SDK生成用于鉴权的请求参数包括两个:policy,对应表单中policy字段。signature,对应表单中的signature字段。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObj - [自定义头域(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1305.md): 在使用Python SDK调用接口时,您可以为请求添加自定义头域,以发送用户指定的头域。如果您指定的头域属于需要参与签名计算,SDK会自动进行计算。使用方法为:调用sdk接口时,在extensionHeaders参数中以字典形式传入指定的头域。extensionHeaders一般是接口的最后一个参数,为防止参数错位,请以指定形参的方法传参 - [事件通知配置](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1446.md): obs.TopicConfiguration - [过滤规则](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1448.md): obs.FilterRule - [桶加密类型响应结果](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_14100.md): obs.GetBucketEncryptionResponse - [HTTP状态码(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1501.md): OBS服务端遵照HTTP规范,在接口调用完成均会返回标准的HTTP状态码,HTTP状态码分类以及OBS中常见的HTTP状态码如下:HTTP状态码分类:分类分类描述1XX信息,服务器收到请求,需要请求者继续执行操作,一般对客户调用函数不可见。2XX成功,操作被成功接收并处理。3XX重定向,需要进一步的操作以完成请求。4XX客户端错误,请求包 - [OBS服务端错误码(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1502.md): SDK错误码是由ObsClient统一抛出的异常。用户向OBS发出请求后,如果遇到错误,此时响应中会返回错误码描述的错误信息。通常是OBS服务端错误,包含对象存储服务的错误码、错误信息等,便于用户定位问题,并做出适当的处理。了解对象存储服务的错误码更多信息,请参见OBS错误码。 - [日志分析(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1503.md): OBS Python SDK基于Python日志库提供了日志功能,您可以通过ObsClient.initLog开启日志功能并进行配置。示例代码如下:日志功能默认是关闭的,需要主动开启。日志配置文件样例(log.conf)包含在OBS Python SDK开发包中,您需要根据实际情况修改log.conf中的配置参数。OBS Python S - [如何使对象可以被匿名用户访问(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1607.md): 如果想对象可以被匿名用户访问,可通过以下三步完成:参考设置对象ACL(Python SDK)章节,设置对象ACL为公共读。参考如何获取对象URL章节,获取对象的URL提供给匿名用户。匿名用户通过浏览器打开获取的URL,可访问到该对象。 - [如何获取访问密钥(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1609.md): OBS通过用户账户中的AK和SK进行签名验证,确保通过授权的账户才能访问指定的OBS资源。以下是对AK和SK的解释说明:AK:Access Key ID,接入键标识,用户在对象存储服务系统中的接入键标识,一个接入键标识唯一对应一个用户,一个用户可以同时拥有多个接入键标识。对象存储服务系统通过接入键标识识别访问系统的用户。SK:Secret - [如何获取对象URL?(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1613.md): 通过设置对象ACL将桶中的对象权限设置为匿名用户读取权限后,可通过对象的URL直接下载该对象。获取对象URL的方式如下:方式一,接口查询,调用ObsClient.putContent或ObsClient.putFile上传对象后会返回PutContentResponse对象,通过调用该对象的objectUrl接口可获取上传对象的URL。示 - [公网环境下如何提高上传大文件速度?(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1614.md): 在公网环境下,对于超过100MB的大文件,建议通过分段上传方式上传。分段上传是将单个对象拆分为一系列段分别上传,每个段都是对象数据的连续部分,您可以按照任意顺序上传段。如果其中某个段传输失败,可以重新传输该段且不会影响其他段。通过多线程并发上传同一对象的多个段,可大大提高传输效率。具体代码样例可参见多段相关接口(Python SDK)。 - [如何指定Content-SHA256?(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1615.md): 上传对象和上传段支持携带x-obs-content-sha256头域。x-obs-content-sha256头域值为请求消息体256-bit SHA256值转十六进制值,计算方式为Hex(SHA256Hash(),服务端会对携带此头域的请求计算其消息体的sha256值做校验(性能会有部分下降,在安全上推荐该算法)。上传 - [为什么SDK源码中包含acs.amazonaws.com关键字?(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1616.md): OBS SDK为了兼容访问aws s3服务,在源码中会包含acs.amazonaws.com关键字的固定格式。SDK仅作常量使用,不会向该格式有其他处理,也不会对其访问。SDK会自动兼容该场景,用户可不感知。例如:Python SDK。 - [设置对象过期时间(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1704.md): 本示例用于上传文件流时通过header设置对象过期时间本示例用于上传文件流时通过自定义头域设置对象过期时间本示例用于设置已上传对象的过期时间 - [如何理解Content-Type(MIME)?(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1702.md): Content-Type(MIME)用于标识请求或响应中所携带数据的媒体类型,浏览器根据该参数来决定数据的打开方式。Content-Type多用于指定一些客户端自定义的文件,以及一些媒体文件的打开方式。如果您在上传Object时未指定Content-Type,SDK会根据指定Object名称的后缀名来判定文件类型并自动填充Content- - [如何获取账号ID和用户ID?(Python SDK)](https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_1703.md): 从控制台获取账号名、账号ID、用户名、用户ID、项目名称、项目ID在华为云首页右上角,单击“控制台”。在右上角的用户名中选择我的凭证。在“我的凭证”界面,API凭证页签中,查看账号名、账号ID、用户名、用户ID、项目名称、项目ID。每个区域的项目ID有所不同,需要根据业务所在的区域获取对应的项目ID。查看账号名、账号ID、用户名、用户ID - [使用前需知(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0101.md): OBS SDK合规使用指南请单击此处;OBS SDK隐私声明请单击此处。本文介绍C SDK版本功能变更情况和兼容性说明,以及其他使用前须知。3.*.* 3.0.0 兼容3.*.* 不兼容 2.*.*3.*.* 不兼容 1.*.*arm编译环境:NAME="EulerOS" VERSION="2.0 (SP8)" ID="euleros" - [下载与安装SDK(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0004.md): 本节提供C SDK的下载链接,并介绍SDK的编译方式。OBS C SDK最新版本源码:最新源码下载OBS C SDK历史版本下载:历史版本下载获取到SDK源码后,根据使用平台来开展编译工作。linux下:进入source/eSDK_OBS_API/eSDK_OBS_API_C++/目录,执行下面的脚本来编译(x86和arm略有不同请注意) - [技术支持渠道(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0006.md): 开发者社区提供的技术支持渠道如下:开发过程中,您有任何问题可以在华为云对象存储服务论坛中发帖求助。 - [OBS服务环境搭建(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0102.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。使用OBS之前必须要有一个云服务账号。打开浏览器。登录公有云网站。在页面右上角单击“注册”。按需填写注册信息并单击“同意协议并注册”。使用OBS服务之前必须先充值,才能正常使用OBS服务。登录管理控制台。单击页面右上角的“费用”进入费用中心 - [服务地址(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0104.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以从这里查看OBS当前开通的服务地址和区域信息。 - [初始化SDK(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1805.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS C SDK 提供访问OBS服务的接口,用于管理桶(Bucket)和对象(Object)等资源。使用OBS C SDK前,需调用 obs_initialize 进行初始化(进程内只需调用一次);进程退出前调用 obs_deinitia - [初始化option(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0105.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。在调用C SDK的功能函数时,都要传入option参数,您可通过init_obs_options函数初始化option配置,通过option设置AK、SK、Endpoint、bucket、超时时间、临时鉴权:永久访问密钥(AK/SK)创建并 - [创建桶(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0106.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶是OBS全局命名空间,相当于数据的容器、文件系统的根目录,可以存储若干对象。以下示例展示如何新建一个对象桶:#include "eSDKOBS.h" #include // 响应回调函数,可以在这个回调中把proper - [上传对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0107.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。数据流保存到callback_data(参见流式上传(C SDK)中的参数解释)中,使用结构体obs_put_object_handler中定义的回调函数put_object_data_callback把上传对象的内容复制到该回调函数的参数 - [下载对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0108.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。以下示例展示如何通过get_object将对象以文件形式下载到本地:#include "eSDKOBS.h" #include #include // 响应回调函数,可以在这个回调中把prope - [列举对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0109.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。以下示例展示如何通过函数list_bucket_objects列举出桶里的对象:#include "eSDKOBS.h" #include #include #include - [删除对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0110.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。以下示例展示如何通过delete_object删除单个对象:#include "eSDKOBS.h" #include #include // 响应回调函数,可以在这个回调中把propertie - [配置密钥(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0201.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。要接入OBS服务,您需要拥有一组有效的访问密钥(AK和SK)用来进行签名认证。具体可参考OBS服务环境搭建(C SDK)。获取AK和SK之后,您便可以按照以下步骤进行初始化。初始化SDK(C SDK)配置option(C SDK)配置SDK - [初始化SDK(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0202.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS C SDK 提供访问OBS服务的接口,用于管理桶(Bucket)和对象(Object)等资源。使用OBS C SDK前,需调用 obs_initialize 进行初始化(进程内只需调用一次);进程退出前调用 obs_deinitia - [配置option(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0203.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。在调用C SDK的功能函数时,都要传入obs_options参数,您可通过init_obs_options函数初始化obs_options配置,通过obs_options设置AK、SK、Endpoint、bucket、超时时间、临时鉴权。o - [配置SDK日志(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0204.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS C SDK的日志路径是通过OBS.ini中LogPath字段指定的,日志默认生成于与C SDK动态库lib目录同级的logs目录中。OBS.ini文件应与动态库同一目录(Linux 为 libeSDKLogAPI.so,Window - [配置SDK验证服务端证书(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0205.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS C SDK提供了对服务端证书验证的支持,以确保OBS服务来自于受信服务端。配置验证服务端证书的步骤如下:如果访问的OBS服务端的根证书是由权威机构颁发的,可以忽略步骤1、2(C SDK的证书库中默认已加入了权威机构的根证书)。方式一 - [创建桶(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0301.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS桶是对象的容器,您上传的文件都将以对象的形式存放在桶中。本文介绍如何使用C SDK创建桶。调用创建桶接口,将在当前账号按照用户指定的桶名创建一个新桶,接口支持根据用户诉求,在创建桶的同时配置桶的存储类别、区域及桶ACL等参数。您必须拥 - [列举桶(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0302.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS桶是对象的容器,您上传的文件都存放在桶中。调用列举桶接口,可列举当前账号所有地域下符合指定条件的桶。获取到的桶列表将按照桶名的字典顺序排列。您必须拥有obs:bucket:ListAllMyBuckets权限,才能获取桶列表。建议使用 - [删除桶(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0303.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶为空时,用户可以删除桶,以免占用桶数量配额。删除桶后需要等待30分钟才能创建同名桶。华为云无法恢复用户主动删除的OBS数据。因此调用接口删除桶后,桶相关数据无法恢复,请谨慎操作。待删除的桶必须为空,桶为空包含两方面含义:桶内没有任何对象, - [获取桶元数据(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0304.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用获取桶元数据接口,可获取指定桶的相关信息,包括指定桶的存储类型、区域位置、跨域资源共享(CORS)规则、冗余策略等信息。您必须是桶拥有者或拥有判断桶是否存在的权限,才能判断桶是否存在。建议使用IAM或桶策略进行授权,如果使用IAM则需授 - [判断桶是否存在(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3307.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。判断指定桶名的桶是否存在,返回的结果中HTTP状态码为200表明桶存在,否则返回404表明桶不存在。您必须是桶拥有者或拥有判断桶是否存在的权限,才能判断桶是否存在。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket: - [获取桶存量信息(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0306.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用获取桶存量信息接口,可查询指定桶内的对象个数,以及对象占用空间的大小。由于OBS桶存量是后台统计,因此存量会有一定的时延,不能实时更新,因此不建议对存量做实时校验。您必须是桶拥有者或拥有获取桶存量信息的权限,才能获取桶存量信息。建议使用 - [服务端加密(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1500.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。用户可以使用普通方式上传、下载对象,也可以使用服务端加密方式进行上传、下载对象。OBS支持服务端加密功能,使加密的行为在服务端进行。用户可以根据自身的需求,使用不同的密钥管理方式来使用服务端加密功能。当前支持以下两种都采用行业标准的AES2 - [设置桶ACL(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0305.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其 - [获取桶ACL(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0311.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其 - [设置桶配额(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0307.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶配额是桶容量的上限值。默认情况下,OBS系统和单个桶都没有总数据容量和对象数量的限制。您可以根据需要,为桶设置配额限制来控制桶内允许上传的对象总容量,超过设置的对象容量后,上传对象会失败。例如您为桶设置配额为100G,那么当桶内所有对象的 - [获取桶配额(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0310.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶配额是桶容量的上限值。调用获取桶配额接口,可获取指定桶的配额值。桶配额为0代表桶容量没有上限。桶配额值必须为非负整数,单位为字节,支持的最大值为263-1。桶拥有者的状态是欠费冻结时不可以查询桶配额信息。您必须是桶拥有者或拥有获取桶配额的 - [设置桶存储类别(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0308.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS提供了这些存储类型:标准存储、低频访问存储、归档存储、深度归档存储,从而满足客户业务对存储性能、成本的不同诉求,详情可参见OBS存储类别。调用设置桶存储类别接口,可设置指定桶的存储类别。设置了桶的默认存储类别之后,如果上传对象、复制对 - [获取桶存储类别(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0309.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS提供了这些存储类型:标准存储、低频访问存储、归档存储、深度归档存储,从而满足客户业务对存储性能、成本的不同诉求,详情可参见OBS存储类别。调用获取桶存储类别接口,可获取指定桶的存储类别。您必须是桶拥有者或拥有获取桶存储类别的权限,才能 - [设置桶的自定义域名(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0007.md): 设置OBS桶的自定义域名。您必须是桶拥有者或拥有设置桶的自定义域名的权限,才能设置桶的自定义域名。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:SetBucketCustomDomain权限,如果使用桶策略则需授予SetBucketCustomDomain权限。相关授权方式介绍可参见OBS权限控制概述,配置方 - [获取桶的自定义域名(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0008.md): 获取OBS桶的自定义域名列表。您必须是桶拥有者或拥有获取桶的自定义域名的权限,才能获取桶的自定义域名。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketCustomDomain权限,如果使用桶策略则需授予GetBucketCustomDomain权限。相关授权方式介绍可参见OBS权限控制概述,配 - [删除桶的自定义域名(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0009.md): 桶的加密配置功能,支持在该桶中上传对象时,采用对应加密配置对数据进行加密,数据会在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用删除桶加密配置接口,您可以删除指定桶的加密配置信息。您必须是桶拥有者或拥有删除桶加密配置的权限,才能删除桶加密配置。建议使用IAM或桶策略进行授权,如果使用IA - [生命周期管理简介(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0901.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS允许您对桶设置生命周期规则,实现自动转换对象的存储类别、自动淘汰过期的对象,以有效利用存储特性,优化存储空间。针对不同前缀的对象,您可以同时设置多条规则。一条规则包含规则ID,用于标识一条规则,不能重复。受影响的对象前缀,此规则只作用 - [设置桶的生命周期配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0902.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用设置桶的生命周期配置接口,您可以为指定桶设置生命周期策略。单个桶的生命周期规则条数没有限制,但一个 - [获取桶的生命周期配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0903.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用获取桶的生命周期配置接口,您可以获取指定桶的生命周期策略。您必须是桶拥有者或拥有获取桶的生命周期配 - [删除桶的生命周期配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0904.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用删除桶的生命周期配置接口,您可以删除指定桶的生命周期策略。您必须是桶拥有者或拥有删除桶的生命周期配 - [设置桶的CORS配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1002.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全 - [获取桶的CORS配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1003.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全 - [删除桶的CORS配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1004.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全 - [网站文件托管(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1202.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可通过以下步骤实现网站文件托管:以下示例展示如何实现网站文件托管:#include "eSDKOBS.h" #include #include // 响应回调函数,可以在这个回调中把prope - [设置桶的网站配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1203.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外 - [获取桶的网站配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1204.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外 - [删除桶的网站配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1205.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外 - [设置桶日志管理配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1102.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用设置桶日志管理配置接口,您可以为指定桶打开桶日志功能,并配置日志存放的目标桶。创建桶时,默认是不生成桶的日志的,调用C SDK的设置桶日志管理配置接口时,接口会自动为您打开桶日志配置。桶日志功能开启后,桶的每次操作将会产生一条日志,并将 - [获取桶日志管理配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1103.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用获取桶日志管理配置,可获取指定桶的日志配置。您必须是桶拥有者或拥有获取桶日志管理配置的权限,才能获取桶日志管理配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketLogging权限,如果使 - [设置桶标签(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1302.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的 - [获取桶标签(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1303.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的 - [删除桶标签(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1304.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的 - [设置桶的自定义域名(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3212.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶的自定义域名功能,支持为OBS桶配置自定义域名,用户可以通过自己的域名访问OBS服务。调用设置桶自定义域名接口,您可以设置指定桶的自定义域名配置信息。您必须是桶拥有者或拥有设置桶自定义域名的权限,才能设置桶自定义域名。建议使用IAM或桶策 - [获取桶的自定义域名(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3213.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶的自定义域名功能,支持为OBS桶配置自定义域名,用户可以通过自己的域名访问OBS服务。调用获取桶自定义域名接口,您可以获取指定桶的自定义域名配置信息。您必须是桶拥有者或拥有获取桶自定义域名的权限,才能获取桶自定义域名。建议使用IAM或桶策 - [删除桶的自定义域名(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3214.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶的自定义域名功能,支持为OBS桶配置自定义域名,用户可以通过自己的域名访问OBS服务。调用删除桶自定义域名接口,您可以删除指定桶的自定义域名配置信息。您必须是桶拥有者或拥有删除桶自定义域名的权限,才能删除桶自定义域名。建议使用IAM或桶策 - [通过自定义域名访问OBS(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/zh-cn_topic_0000001833016268.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。使用自定义域名访问服务端之前,需要先在console界面配置自定义域名。若需通过自定义域名访问OBS桶,须先将该域名绑定至OBS桶的访问域名自定义域名绑定简介,自定义域名绑定配置。当在自定义域名上配置了CDN加速服务,即自定义域名为CDN服 - [事件通知简介(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1401.md): OBS提供了事件通知功能,当启用通知功能后,桶上所发生的指定操作都会通过消息通知服务(SMN)发送给您。事件通知配置包含:配置唯一ID,如果用户未指定,则OBS自动分配一个ID。事件通知主题(Event Notification Topic)的URN,当OBS检测到桶中特定的事件后,将会发布通知消息至该主题。需要发布通知消息的事件类型列表 - [设置事件通知(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1402.md): 您可以通过函数set_notification_configuration设置桶的事件通知。参数obs_smn_notification_configuration描述如下表:参数obs_smn_topic_configuration描述如下表: - [查看事件通知(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1403.md): 您可以通过函数get_notification_configuration查看桶的事件通知。回调函数类型obs_smn_handler描述如下表: - [关闭事件通知(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1404.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。关闭桶事件通知实际上就是调用函数set_notification_configuration()将事件通知配置清空。以下示例展示如何关闭桶事件通知: - [创建并行文件系统(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1901.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS并行文件系统是对象的容器,您上传的文件都将以对象的形式存放在并行文件系统中。本文介绍如何使用C SDK创建并行文件系统。调用创建并行文件系统接口,将在当前账号按照用户指定的并行文件系统名创建一个新并行文件系统,接口支持根据用户诉求,在 - [列举并行文件系统(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1902.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以通过list_bucket_obs获取并行文件系统列表。该接口可以列举当前账户下所有的并行文件系统,返回结果按照并行文件系统名称的字典顺序排列。您必须拥有obs:bucket:ListAllMyBuckets权限,才能获取并行文件系统 - [列举并行文件系统内文件(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1903.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以通过函数list_bucket_objects列举出并行文件系统里的文件。每次接口调用最多返回1000个文件信息。您必须是并行文件系统拥有者或拥有列举并行文件系统内文件的权限,才能调用该接口。建议使用IAM或桶策略进行授权,如果使用I - [设置桶的多版本状态(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0802.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持多版本控制,您可以在一个桶中保留对象的多个版本,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。更多多版本相关信息请参见多版本控制。调用设置桶的多版本状态接口,您可以为指定桶设置多版本状态。您必须是桶拥有者 - [获取桶的多版本状态(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0803.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持多版本控制,您可以在一个桶中保留对象的多个版本,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。更多多版本相关信息请参见多版本控制。调用获取桶的多版本状态接口,您可以获取指定桶的多版本状态。您必须是桶拥有者 - [列举桶内多版本对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0807.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。用列举桶内多版本对象接口,可列举指定桶内的部分或所有多版本对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的多版本对象信息。返回结果以多版本对象名的字典序排序。您必须是桶拥有者或拥有列举桶内多版本对象的权限,才 - [设置桶策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3309.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶策略是作用于桶及桶内对象的访问控制策略,通过向桶添加桶策略,可以授权其他账号对桶及桶内资源进行指定的操作。桶策略与ACL相比,支持更精细的权限控制,不仅可以控制授权账号,还可以控制匿名用户对桶和对象的访问权限,同时支持指定资源、条件和动作 - [获取桶策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3310.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用获取桶策略接口,您可以获取指定桶的桶策略。您必须是桶拥有者或拥有获取桶策略的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPolicy权限,如果使用桶策略则需授予Ge - [删除桶策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3311.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用删除桶策略接口,您可以删除指定桶的桶策略。删除桶策略后,该桶之前通过策略授予的权限将全部失效,桶将恢复到默认的访问控制状态。您必须是桶拥有者或拥有删除桶策略的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予o - [设置桶的归档存储对象直读策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3313.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。归档存储对象直读是指用户可以不用恢复归档存储对象,便能直接对其进行操作。默认情况下,桶没有开启归档存储对象直读功能。本接口主要用来开启或关闭桶的归档存储对象直读功能。设置桶的对象直读状态为Enabled,开启桶的对象直读功能:桶内存在对象时 - [获取桶归档存储对象直读策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3314.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶的所有者可以获取指定桶的归档存储对象直读状态。如果从未设置桶的归档存储对象直读状态,或者已经删除桶的归档存储对象直读状态,则此操作不会返回桶的归档存储对象直读状态。您必须是桶拥有者或拥有获取桶归档存储对象直读策略的权限,才能调用本接口。建 - [删除桶归档存储对象直读策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3315.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。删除指定桶的归档存储对象直读配置信息。删除后桶内的归档存储对象不能直接读取。对未恢复或正在恢复的归档存储对象进行操作时,会返回错误403 Forbidden。对于设置了归档存储对象直读状态的桶,可以删除指定桶的归档存储对象直读状态,删除后桶 - [配置桶级默认WORM策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3321.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS提供合规模式的WORM功能,当桶设置了WORM策略后,如果新上传的对象没有设置保护策略和保护期限,则其会自动应用桶级WORM策略。可通过本接口为指定桶配置默认保护策略和保护期限。当您在桶内配置了桶级默认WORM策略以后,如果您在上传对 - [获取桶级默认WORM策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3322.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。当桶设置了桶级默认WORM策略,可以通过本接口获取该桶的桶级默认WORM策略。如果您打开了桶级WORM开关,但从未配置过桶级默认WORM策略,您依然可以使用此接口查看开关的打开情况。您必须是桶拥有者或拥有获取桶级默认WORM策略的权限,才能 - [设置桶级阻止公共访问配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3324.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。公共访问是指请求者无需拥有特定权限或身份验证即可访问桶和桶内数据,此操作存在数据泄露和恶意访问导致大量外网流量的风险。OBS支持为桶配置阻止公共访问功能,可通过本接口设置桶级BPA,从而确保桶内数据的安全性。如果开启阻止公开访问,则已有的公 - [获取桶级阻止公共访问配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3325.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。可通过本接口获取桶级BPA配置的相关信息。您必须是桶拥有者或拥有获取桶级阻止公共访问配置的权限,才能获取桶级阻止公共访问配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPublicAcce - [删除桶级阻止公共访问配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3326.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。可通过本接口删除桶级BPA配置。您必须是桶拥有者或拥有删除桶级阻止公共访问配置的权限,才能删除桶级阻止公共访问配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketPublicAccess - [获取桶公共状态(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3327.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用获取桶公共状态接口,您可以查询指定桶是否为公开状态。桶的公共状态综合考虑了桶策略、ACL和阻止公共访问配置等多个维度的信息,用于判断桶是否存在公共访问风险。您必须是桶拥有者或拥有获取桶公共状态的权限,才能获取桶公共状态。建议使用IAM或 - [获取桶策略公共状态(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3328.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用获取桶策略公共状态接口,您可以查询指定桶的桶策略是否为公开状态。您必须是桶拥有者或拥有获取桶策略公共状态的权限,才能获取桶策略公共状态。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPol - [设置桶清单(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3330.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶清单功能可以定期生成桶内对象的元数据信息,通过查看这些信息,可以帮助您更好地了解桶内对象的状态,调用本接口可以配置桶清单功能。您必须是桶拥有者或拥有设置桶清单的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予o - [获取桶清单(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3331.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶清单功能可以定期生成桶内对象的元数据信息,通过查看这些信息,可以帮助您更好地了解桶内对象的状态,可通过本接口获取桶清单。您必须是桶拥有者或拥有获取桶清单的权限,才能获取桶清单配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予ob - [列举桶清单(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3332.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用列举桶清单接口,您可获取指定桶的所有清单配置信息。您必须是桶拥有者或拥有列举桶清单的权限,才能列举桶清单配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketInventoryConfigu - [删除桶清单(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3333.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用删除桶清单接口,您可根据清单配置ID删除指定桶的某条清单配置。删除后,OBS将不再为该规则生成清单文件。您必须是桶拥有者或拥有删除桶清单的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket: - [设置镜像回源规则(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3335.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。镜像回源是OBS提供的一种数据自动获取功能。调用设置桶镜像回源规则接口,您可为指定桶配置镜像回源规则,当客户端访问桶中不存在的对象时,OBS会自动从源站获取数据并返回给客户端,同时将数据存储到桶中。您必须是桶拥有者或拥有设置桶镜像回源规则的 - [获取镜像回源规则(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3336.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用获取桶镜像回源规则接口,您可获取指定桶的镜像回源规则配置。您必须是桶拥有者或拥有获取桶镜像回源规则的权限,才能获取桶镜像回源规则配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketMirr - [删除镜像回源规则(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3337.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用删除桶镜像回源规则接口,您可删除指定桶的镜像回源规则配置。删除后,访问不存在的对象时将不再从源站获取数据。您必须是桶拥有者或拥有删除桶镜像回源规则的权限,才能删除桶镜像回源规则配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予 - [设置DIS通知策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3339.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。DIS通知策略是OBS提供的事件通知功能。调用设置桶DIS通知策略接口,您可为指定桶配置DIS通知规则,当桶内对象发生指定事件时,OBS会将事件信息推送到DIS数据通道中。您必须是桶拥有者或拥有设置桶DIS通知策略的权限,才能设置桶DIS通 - [获取DIS通知策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3340.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用获取桶DIS通知策略接口,您可获取指定桶的DIS通知策略配置。您必须是桶拥有者或拥有获取桶DIS通知策略的权限,才能获取桶DIS通知策略。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketDi - [删除DIS通知策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3341.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用删除桶DIS通知策略接口,您可删除指定桶的DIS通知策略配置。删除后,桶内对象的事件将不再推送到DIS数据通道。您必须是桶拥有者或拥有删除桶DIS通知策略的权限,才能删除桶DIS通知策略。建议使用IAM或桶策略进行授权,如果使用IAM则 - [设置桶的加密配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3343.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。设置桶的加密配置,以允许在该桶中上传对象时,采用对应加密配置对数据进行加密,数据会在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用设置桶加密配置接口,您可以为指定桶创建或更新加密配置信息。 - [获取桶的加密配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3344.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶的加密配置功能,支持在该桶中上传对象时,采用对应加密配置对数据进行加密,数据会在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用获取桶加密配置接口,您可以获取指定桶的加密配置信息。您必须是 - [删除桶的加密配置(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3345.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶的加密配置功能,支持在该桶中上传对象时,采用对应加密配置对数据进行加密,数据会在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用删除桶加密配置接口,您可以删除指定桶的加密配置信息。您必须是 - [设置在线解压策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3347.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用设置在线解压策略接口,您可为指定桶配置在线解压策略。在线解压策略可以在zip压缩包上传到桶时自动触发解压,将压缩包内的文件解压到指定路径,实现自动化数据处理。您必须是桶拥有者或拥有设置在线解压策略的权限,才能设置在线解压策略。建议使用I - [获取在线解压策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3348.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用获取在线解压策略接口,您可以获取指定桶的在线解压策略配置信息,包括所有解压规则的详细配置。您必须是桶拥有者或拥有获取在线解压策略的权限,才能获取在线解压策略。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:G - [删除在线解压策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3349.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用删除在线解压策略接口,您可以删除指定桶的在线解压策略。删除策略后,该桶上传的zip压缩包将不再自动触发解压操作。您必须是桶拥有者或拥有删除在线解压策略的权限,才能删除在线解压策略。建议使用IAM或桶策略进行授权,如果使用IAM则需授予o - [使用临时URL进行授权访问(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0700.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。临时授权访问是指通过访问密钥、请求方法类型、请求参数等信息生成一个临时访问权限的URL,这个URL中会包含鉴权信息,您可以使用该URL进行访问OBS服务进行特定操作。在生成URL时,您需要指定URL的有效期。生成临时授权访问的URL是通过设 - [使用自定义头域(Custom Headers)(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3350.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS C SDK 支持在发起请求时携带自定义 HTTP 头域。通过 obs_options.request_options 中的 custom_headers 字段设置,所有操作(PUT/GET/DELETE/LIST 等)均支持。以 x - [流式上传(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0401.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以将本地文件直接通过Internet上传至OBS指定的位置。待上传的文件可以是任何类型:文本文件、图片、视频等。通过SDK的流式上传,可以上传小于5GB的文件。本章节介绍如何使用C SDK流式上传对象。可以通过put_object上传数 - [文本上传(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3351.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用文本上传接口,您可以将文本内容直接上传至OBS指定桶中的对象。文本上传是对流式上传(put_object)的简化封装,无需实现put_object_data_callback回调函数,直接传入文本内容即可完成上传,适用于小文件或内存中的 - [文件上传(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0402.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以将本地文件直接通过Internet上传至OBS指定的桶中。待上传的文件可以是任何类型:文本文件、图片、视频等。本章节介绍如何使用文件上传对象。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用 - [批量上传对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3352.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以通过以下接口在上传时使用批量操作:流式上传(C SDK)文件上传(C SDK)本示例用于批量上传本地目录中的文件到OBS指定桶。您可以通过递归扫描本地目录, 再以指定并发数并发上传,文件按相对路径生成OBS对象Key,适用于本地文件批 - [创建文件夹(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0403.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以在已创建的桶中新建一个文件夹,从而更方便地对存储在OBS中的数据进行分类管理。OBS本身是没有文件夹的概念的,桶中存储的元素只有对象。创建文件夹实际上是创建了一个大小为0且对象名以“/”结尾的对象,这类对象与其他对象无任何差异,可以进 - [断点续传上传(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0407.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。对分段上传的封装和加强,解决上传大文件时由于网络不稳定或程序崩溃导致上传失败的问题。其原理是将待上传的文件分成若干个分段分别上传,并实时地将每段上传结果统一记录在checkpoint文件中,仅当所有分段都上传成功时返回上传成功的结果,否则返 - [追加写对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0408.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以根据需要上传文件或者文件夹至已有的OBS桶。待上传的文件可以是任何类型:文本文件、图片、视频等。追加写对象操作是指在指定对象尾追加上传数据,不存在相同对象键值的对象则创建新对象。每次追加上传都会更新该对象的最后修改时间。您必须是桶拥有 - [修改写对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0001.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。将指定并行文件系统内的一个对象从指定位置起修改为其他内容。目前接口仅在并行文件系统支持,普通对象桶不支持,如何创建并行文件系统请参考创建桶。您必须是并行文件系统拥有者或拥有修改写对象的权限,才能修改写对象。建议使用IAM或策略进行授权,如果 - [上传限速(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3353.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。上传限速是指在上传对象时对单链接请求的带宽进行限制,避免因单个上传请求占用过多带宽而影响其他业务。通过obs_put_properties结构体的upload_limit字段设置限速值,SDK将限速值写入x-obs-traffic-limi - [多段相关接口说明(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1811.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。对于较大文件上传,可以切分成段上传。用户可以在如下的场景内(但不仅限于此)使用分段上传的模式:上传超过100MB大小的文件。网络条件较差,和OBS服务端之间的连接经常断开。上传前无法确定将要上传文件的大小。分段上传分为如下3个步骤:初始化分 - [分段上传-初始化分段上传任务(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0405.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。使用多段上传特性时,用户必须首先调用创建多段上传任务接口创建任务,系统会给用户返回一个全局唯一的多段上传任务号,作为任务标识。后续用户可以根据这个标识发起相关的请求,如:上传段、合并段、列举段等。创建多段上传任务不影响已有的同名对象;同一个 - [分段上传-上传段(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1810.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。初始化分段上传任务后,通过分段上传任务的ID,上传段到指定桶中。除了最后一段以外,其他段的大小范围是100KB~5GB;最后一段的大小范围是0~5GB。上传的段的编号也有范围限制,其范围是1~10000。上传段时,除了指定上传ID,还必须指 - [分段上传-合并段(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1809.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。如果用户上传完所有的段,就可以调用合并段接口,系统将在服务端将用户指定的段合并成一个完整的对象。在执行“合并段”操作以前,用户不能下载已经上传的数据。在合并段时需要将多段上传任务初始化时记录的附加消息头信息复制到对象元数据中,其处理过程和普 - [分段上传-列举分段上传任务(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1808.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。列举指定桶中所有的初始化后还未合并或还未取消的分段上传任务。通过列举桶中的多段上传任务,您可以获得已初始化多段上传任务的列表,已初始化多段上传任务是指初始化后还未合并以及未取消的多段上传任务。每个请求将返回最多1000个多段上传任务,如果正 - [分段上传-列举已上传的段(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1807.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。通过分段上传任务的ID,列举指定桶中已上传的段。您可以列出特定多段上传任务或所有正在进行的多段上传任务的分段。列举已上传的段操作将返回您已为特定多段上传任务而上传的段信息。对于每个列举已上传的段请求,OBS将返回有关特定多段上传任务的分段信 - [分段上传-复制段(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0406.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。初始化分段上传任务后,通过分段上传任务的ID,复制段到指定桶中。多段上传任务创建后,用户可以通过指定多段上传任务号,为特定的任务上传段。添加段的方式还包括调用段复制接口。允许用户将已上传对象的一部分或全部复制为段。将源对象object复制为 - [分段上传-取消分段上传任务(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1806.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。通过分段上传任务的ID,取消指定桶中的分段上传任务。您可以选择取消多段上传任务,取消多段上传任务之后无法再次使用该上传ID上传任何段。然后,OBS将释放被取消的多段上传任务中的每个段数据的所有存储。如果有多段上传已在进行中,即使您已执行中止 - [对象下载(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0501.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以根据需要将存储在OBS中的对象以文本形式下载到本地。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetO - [批量下载对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3354.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以通过对象下载(C SDK)接口在下载时使用批量操作:本示例用于批量下载OBS桶中的对象到本地目录。您可以通过列举满足前缀条件的对象,再以指定并发数并发下载,文件按原Key结构保存到本地目录,适用于批量导出、离线备份等场景。 - [限定条件下载(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0502.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。下载对象时,可以指定一个或多个限定条件,满足限定条件时则进行下载,否则返回异常码,下载对象失败。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObjec - [恢复归档或深度归档存储对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0503.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。如果要获取归档或深度归档存储对象的内容,需要先将对象恢复,然后再执行下载数据的操作。对象恢复后,会产生一个标准存储类别的对象副本,也就是说会同时存在标准存储类别的对象副本和归档或深度归档存储对象,在恢复对象的保存时间到期后标准存储类别的对象 - [批量恢复归档或深度归档存储对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3355.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。本示例用于批量恢复归档或深度归档存储的对象。归档或深度归档类型的对象处于冷冻状态无法直接访问,需要先提交恢复请求,等待恢复完成后才能访问。关于恢复归档存储对象的API说明,请参见恢复归档或深度归档存储对象。更多关于恢复归档存储对象的代码示例 - [断点续传下载(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0504.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。当下载大对象到本地文件时,经常出现因网络不稳定或程序崩溃导致下载失败的情况。失败后再次重新下载不仅浪费资源,而且当网络不稳定时仍然有下载失败的风险。断点续传下载接口能有效地解决此类问题引起的下载失败,其原理是将待下载的对象分成若干个分段分别 - [图片处理(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0505.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS为用户提供了稳定、安全、高效、易用、低成本的图片处理服务。当要下载的对象是图片文件时,您可以通过传入图片处理参数对图片文件进行图片剪切、图片缩放、图片水印、格式转换等处理。您必须是桶拥有者或拥有图片处理的权限,才能进行图片处理。建议使 - [下载限速(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3356.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。下载限速是指在下载对象时对单链接请求的带宽进行限制,避免因单个下载请求占用过多带宽而影响其他业务。OBS C SDK通过在下载请求中设置download_limit参数实现下载限速,SDK会将限速值写入x-obs-traffic-limit - [删除对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0604.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。为节省空间和成本,您可以根据需要删除指定桶中的单个对象。您必须是桶拥有者或拥有删除对象的权限,才能删除对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:DeleteObject权限,如果使用桶策略则需授予De - [批量删除对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1813.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。为节省空间和成本,您可以根据需要删除指定桶中的多个对象。批量删除对象特性用于将一个桶内的部分对象一次性删除,删除后不可恢复。批量删除对象要求返回结果里包含每个对象的删除结果。OBS的批量删除对象使用同步删除对象的方式,每个对象的删除结果返回 - [设置对象属性(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0404.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以在上传对象时设置对象属性。对象属性包含对象长度、对象MIME类型、对象MD5值(用于校验)、对象存储类别、对象自定义元数据。对象属性可以在多种上传方式下(流式上传、文件上传、分段上传),或复制对象时进行设置。您必须是桶拥有者或拥有设置 - [获取对象属性(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0601.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。元数据(Metadata)为描述对象属性的信息,是一组名称值对,用作对象管理的一部分。当前仅支持系统定义的元数据。系统定义的元数据又分为两种类别:系统控制和用户控制。如Last-Modified日期等数据由系统控制,不可修改;如为对象配置的 - [列举桶内对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0603.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用列举桶内对象接口,可列举指定桶内的部分或所有对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的对象信息。返回结果以对象名的字典序排序。每次接口调用最多返回1000个对象信息。您必须是桶拥有者或拥有列举桶内对 - [重命名对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0002.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。重命名对象操作是指将指定并行文件系统内的一个对象重命名为其他对象名。您必须是并行文件系统拥有者或拥有重命名文件的权限,才能重命名文件。建议使用IAM或策略进行授权,如果使用IAM则需授予obs:bucket:PutObject权限,如果使用 - [截断对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0003.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以通过调用truncate_object来对对象进行截断操作。截断对象操作是指将指定并行文件系统内的一个对象截断到指定大小。如果对象不存在,则会报错(HTTP状态码为404)。截断对象接口只适用于并行文件系统,该接口不支持对象桶。以下示 - [复制对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0605.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。用户可以根据需要将存储在OBS上的对象复制到其他路径下。复制对象操作将创建需要复制的对象的副本,即为指定桶中的对象创建一个副本。在单次操作中,您可以创建最大5GB的对象副本。您必须是桶拥有者或拥有复制对象的权限,才能复制对象。建议使用IAM - [批量复制对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3357.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。本示例用于批量复制OBS桶中的对象到目标桶。您可以通过列举满足前缀条件的对象,再以指定并发数批量复制到目标桶,目标Key通过前缀替换生成,支持跨桶复制或同桶备份,适用于数据迁移、备份等场景。关于复制对象的API说明,请参见复制对象。更多关于 - [配置对象级WORM保护策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3358.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。开启了WORM开关的桶,上传的对象支持配置或修改对象保护期限。如果上传对象时没有配置保护期限或自动应用桶级默认保护策略,您可以通过本接口配置对象保护期限。如果上传对象时配置了保护期限或自动应用了默认保护期限,允许用户通过本接口延长保护期限。 - [对象生命周期(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3359.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。对象生命周期是指为对象设置过期时间(x-obs-expires),对象在指定天数后会被OBS服务端自动删除。OBS C SDK支持两种设置对象生命周期的方式:上传时指定:在上传对象时通过obs_put_properties结构体的obs_e - [设置对象ACL-上传对象时指定预定义ACL(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0602.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其 - [设置对象ACL-为对象设置预定义ACL(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0314.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其 - [设置对象ACL-自定义设置对象ACL(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0315.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其 - [获取对象ACL(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0316.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其 - [设置对象标签(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3361.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。用户可以通过本接口设置或更新对象(Object)的标签信息。对象标签使用一组键值对(Key-Value)标记对象。您必须是对象拥有者或拥有设置对象标签的权限,才能设置对象标签。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:o - [获取对象标签(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3362.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。用户可以通过本接口获取对象(Object)的标签信息。您必须是桶拥有者或拥有获取对象标签的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObjectTagging权限,如果使用桶策略 - [删除对象标签(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3363.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。用户可以通过本接口删除对象(Object)的标签信息。您必须是桶拥有者或拥有删除对象标签的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:DeleteObjectTagging权限,如果使用 - [获取多版本对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0804.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以通过get_object接口传入版本号(obs_object_info.version_id)来获取多版本对象。如果版本号为空,则默认下载最新版本的对象。您必须是桶拥有者或拥有下载对象的权限,才能下载多版本对象。建议使用IAM或桶策略 - [复制多版本对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0805.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。用户可以根据需要将存储在OBS上的多版本对象复制到其他路径下。复制多版本对象操作将创建需要复制的多版本对象的副本,即为指定桶中的多版本对象创建一个副本。在单次操作中,您可以创建最大5GB的多版本对象副本。您必须是桶拥有者或拥有复制对象的权限 - [恢复多版本归档存储对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0806.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。如果要获取归档或深度归档存储多版本对象的内容,需要先将多版本对象恢复,然后再执行下载数据的操作。多版本对象恢复后,会产生一个标准存储类别的多版本对象副本,也就是说会同时存在标准存储类别的多版本对象副本和归档或深度归档存储多版本对象,在恢复多 - [设置多版本对象ACL-为对象设置预定义访问策略(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0317.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持对多版本对象的操作进行权限控制。默认情况下,只有多版本对象的创建者才有该多版本对象的读写权限。用户也可以设置其他的访问策略,比如对一个多版本对象可以设置公共访问策略,允许所有人对其都有读权限。SSE-KMS方式加密的多版本对象即使 - [设置多版本对象ACL-直接设置对象ACL(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0318.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持对多版本对象的操作进行权限控制。默认情况下,只有多版本对象的创建者才有该多版本对象的读写权限。用户也可以设置其他的访问策略,比如对一个多版本对象可以设置公共访问策略,允许所有人对其都有读权限。SSE-KMS方式加密的多版本对象即使 - [获取多版本对象ACL(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0319.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,ACL按照粒度又分为桶ACL和对象ACL,本节将对多版本对象ACL接口进行详细介绍 - [删除多版本对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0809.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。为节省空间和成本,您可以根据需要删除指定桶中的单个多版本对象。您必须是桶拥有者或拥有删除对象的权限,才能删除多版本对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:DeleteObject权限,如果使用桶策略 - [批量删除多版本对象(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_23_1713.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。为节省空间和成本,您可以根据需要批量删除指定桶中的单个多版本对象。您必须是桶拥有者或拥有删除对象的权限,才能批量删除多版本对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:DeleteObject权限,如果使 - [SDK错误码(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1602.md): SDK错误码是C SDK通过 obs_status 枚举返回的状态码,用于标识请求执行结果,便于用户定位问题并做出适当的处理。SDK错误码包含两部分:对象存储服务的API错误码,详见OBS错误码。SDK自定义错误码,请参见表1。 - [libcurl状态码(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_3364.md): OBS C SDK基于libcurl实现HTTP通信。当curl_easy_perform执行失败时,SDK会在日志中输出libcurl状态码(CURLcode)及错误信息,格式如下:其中关键字段含义:SDK通过request_curl_code_to_status函数将CURLcode映射为OBS状态码,映射关系如下:CURLE_COU - [日志分析(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1603.md): OBS C SDK的日志路径是通过OBS.ini中LogPath字段指定的,默认存放于C SDK动态库所在目录的同级logs目录中。定位问题请查看logs目录下的运行日志:Linux环境为 eSDK-OBS-API-*-C.run.log,Windows环境为 obs-sdk-c.run.log。OBS.ini文件应与动态库同一目录(Li - [代理设置失效(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_1804.md): 现象:Windows端Demo中设置了代理,程序报错且代理设置未生效。问题根因:某些SDK版本中Demo使用的头文件 eSDKOBS.h 与SDK的头文件未同步更新,Demo中缺少新增的结构体成员(如 obs_upload_file_server_callback),导致代理设置失效。解决办法:升级到最新版本SDK(推荐)。如需使用旧版本 - [在Linux环境中访问OBS报错:requires a valid Date or x-obs-date header(C SDK)](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0313.md): 现象:调用OBS接口返回HTTP 403,错误信息为"requires a valid Date or x-obs-date header"。问题根因:当Linux系统的LANG环境变量为中文locale(如 zh_CN.UTF-8)时,SDK生成的HTTP请求头Date字段包含中文字符(如"三,04 9月 2024 10:41:39 G - [如何获取账号ID和用户ID?](https://support.huaweicloud.com/sdk-c-devg-obs/obs_23_1712.md): 从控制台获取账号名、账号ID、用户名、用户ID、项目名称、项目ID在华为云首页右上角,单击“控制台”。在右上角的用户名中选择我的凭证。在“我的凭证”界面,API凭证页签中,查看账号名、账号ID、用户名、用户ID、项目名称、项目ID。每个区域的项目ID有所不同,需要根据业务所在的区域获取对应的项目ID。查看账号名、账号ID、用户名、用户ID - [判断桶是否存在请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0024.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [设置桶acl请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0025.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [获取桶acl请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0026.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [获取桶配额请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0029.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [设置桶存储类别请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0030.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [获取桶存储类别请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0031.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [断点续传上传请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0033.md): 上传文件结构obs_upload_file_configuration描述如下表: - [修改写请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0035.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [创建并行文件系统请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0036.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [列举并行文件系统内对象请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0038.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [设置对象accesslabel请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0039.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [获取对象accesslabel请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0040.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [删除对象accesslabel请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0041.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [下载对象请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0042.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [设置对象属性请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0047.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [获取对象属性请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0048.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [管理对象ACL请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0049.md): 为对象设置预定义访问策略,请求参数:直接设置对象ACL,请求参数: - [列举桶内对象请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0050.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [删除对象请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0051.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [批量删除对象请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0052.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [复制对象请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0053.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [重命名对象或目录请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0054.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [截断对象请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0055.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [分段复制请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0058.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [列举分段上传任务请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0060.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [列举已上传的段请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0061.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [取消分段上传任务请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0062.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [设置桶多版本状态请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0063.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [查看桶多版本状态请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0064.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [列举多版本对象请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0065.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [设置桶生命周期规则请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0066.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [获取桶的生命周期配置请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0067.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [删除桶的生命周期配置请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0068.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [设置桶的CORS配置请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0069.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [获取桶的CORS配置请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0070.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [删除桶的CORS配置请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0071.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [开启桶日志请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0072.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [查看桶日志配置请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0073.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [设置托管配置请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0074.md): 重定向规则结构bucket_website_routingrule描述如下表: - [查看托管配置请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0075.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [清除托管配置请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0076.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [设置桶标签请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0077.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [查看桶标签请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0078.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [删除桶标签请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0079.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [设置事件通知请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0080.md): 参数obs_smn_notification_configuration描述如下表:参数obs_smn_topic_configuration描述如下表: - [查看事件通知请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0081.md): 回调函数类型obs_smn_handler描述如下表: - [服务端加密请求参数](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0082.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_options](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0085.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_create_bucket_params](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0086.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_response_handler](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0087.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [other_response_handlers](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0088.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_canned_acl](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0089.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [manager_acl_info](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0090.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_storage_class](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0091.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_put_properties](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0092.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_list_versions](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0093.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [server_side_encryption_params](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0094.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_upload_file_configuration](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0095.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_object_info](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0098.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_object_delivered](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0099.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_acl_grant](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0111.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_lifecycle_conf](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0116.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_bucket_cors_conf](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0117.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [bucket_logging_message](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0119.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_set_bucket_redirect_all_conf](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0120.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [obs_set_bucket_website_conf](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0121.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [bucket_website_routingrule](https://support.huaweicloud.com/sdk-c-devg-obs/obs_20_0122.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [使用前须知(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0001.md): OBS SDK合规使用指南请单击此处;OBS SDK隐私声明请单击此处。本文介绍Go SDK的版本变更,并提供版本兼容性说明,以及其他使用前须知。如表1所示,本节将为您展示Go SDK的版本变更情况和兼容性说明。请确认您已经熟悉OBS的基本概念,如桶(Bucket)、对象(Object)、访问密钥(AK和SK)、终端节点(Endpoint - [Go SDK接口概览](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0002.md): 表1总结了Go SDK支持的接口及功能描述,每个接口的详细介绍和示例代码请前往接口详情页查看。 - [使用前准备(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0104.md): 在使用Go SDK访问华为云对象存储服务OBS之前,您需要先完成服务环境的准备和开发环境的准备。服务环境准备包括准备华为账号和访问密钥,是使用SDK与OBS云服务交互的必要条件。开发环境准备是指为了您能顺利完成SDK的安装、完成基于SDK的代码开发与运行,需要提前在本地完成的开发环境搭建,比如下载安装依赖软件、安装开发工具等。使用OBS之 - [下载与安装SDK(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0001.md): 本节提供Go SDK的下载链接,并介绍SDK的安装方式。OBS Go SDK最新版本源码下载:最新源码下载OBS Go SDK历史版本源码下载:请单击此处如表1所示,Go SDK有以下安装方式。以安装OBS Go SDK最新版本为例,步骤如下:下载OBS Go SDK开发包。解压该开发包,可以看到其中包含obs文件夹(SDK源码)、mai - [快速入门(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0103.md): OBS通过用户账户中的AK和SK进行签名验证,确保通过授权的账户才能访问指定的OBS资源。以下是对AK和SK的解释说明:AK:Access Key ID,接入键标识,用户在对象存储服务系统中的接入键标识,一个接入键标识唯一对应一个用户,一个用户可以同时拥有多个接入键标识。对象存储服务系统通过接入键标识识别访问系统的用户。SK:Secret - [ObsClient初始化(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0102.md): ObsClient是访问OBS服务的Go客户端,它为调用者提供一系列与OBS服务进行交互的接口,用于管理、操作桶(Bucket)和对象(Object)等OBS服务上的资源。使用OBS Go SDK向OBS发起请求,您需要初始化一个ObsClient实例,并根据需要调整客户端配置参数。您可通过configurer(obs命名空间中的私有类型 - [日志初始化(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0103.md): 通过开启SDK日志功能,可将接口调用过程中产生的日志信息记录到日志文件,用于后续的数据分析或问题定位。您可以通过InitLog开启日志;CloseLog关闭日志并同步缓存中的日志内容到日志文件。日志功能默认是关闭的,需要主动开启。您可以从日志分析章节获取更多关于SDK日志的信息。日志默认首先写入缓存(累积一定量后再写入文件),程序退出前调 - [SDK自定义错误(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0104.md): 调用ObsClient的相关接口发生错误时,通常会返回SDK自定义错误,其包含服务端返回的HTTP状态码、OBS错误码、错误信息等,便于用户定位问题,并做出适当的处理。 - [SDK接口拓展配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0105.md): 增加拓展配置extensionOptions(obs包中的私有类型),当前可以通过调用如下拓展配置项为对应请求配置额外的拓展请求头。携带单链接限速头域调用下载对象接口携带callback回调头域调用上传对象接口 - [创建桶(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0402.md): OBS桶是对象的容器,您上传的文件都将以对象的形式存放在桶中。本文介绍如何使用Go SDK创建桶。调用创建桶接口,将在当前账号按照用户指定的桶名创建一个新桶,接口支持根据用户诉求,在创建桶的同时配置桶的存储类别、区域及桶ACL等参数。您必须拥有obs:bucket:CreateBucket权限,才能创建桶。建议使用IAM进行授权,配置方式 - [获取桶列表(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0403.md): OBS桶是对象的容器,您上传的文件都存放在桶中。调用获取桶列表接口,可列举当前账号所有地域下符合指定条件的桶。返回结果以桶名的字典序排序。您必须拥有obs:bucket:ListAllMyBuckets权限,才能获取桶列表。建议使用IAM进行授权,配置方式详见使用IAM自定义策略。OBS支持的Region与Endpoint的对应关系,详细 - [列举桶内多版本对象(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0407.md): 用列举桶内对象接口,可列举指定桶内的部分或所有多版本对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的多版本对象信息。返回结果以多版本对象名的字典序排序。您必须是桶拥有者或拥有列举桶内多版本对象的权限,才能列举桶内多版本对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:List - [获取桶元数据(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0409.md): 调用获取桶元数据接口,可获取指定桶的相关信息,包括指定桶的存储类型、区域位置、跨域资源共享(CORS)规则、冗余策略等信息。您必须是桶拥有者或拥有获取桶元数据的权限,才能获取桶元数据。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:HeadBucket权限,如果使用桶策略则需授予HeadBucket权限。相关授 - [获取桶区域位置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0410.md): 获取指定桶所在的区域位置。您必须是桶拥有者或拥有获取桶区域位置的权限,才能获取桶区域位置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketLocation权限,如果使用桶策略则需授予GetBucketLocation权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策 - [删除桶(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0405.md): 桶为空时,用户可以删除桶,以免占用桶数量配额。删除桶后需要等待30分钟才能创建同名桶。华为云无法恢复用户主动删除的OBS数据。因此调用接口删除桶后,桶相关数据无法恢复,请谨慎操作。待删除的桶必须为空,桶为空包含两方面含义:桶内没有任何对象,没有对象的任何历史版本,没有对象的删除标记(删除标记也视作一个历史版本)。桶内没有任何未合并的多段上 - [判断桶是否存在(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0404.md): 判断指定桶名的桶是否存在,返回的结果中HTTP状态码为200表明桶存在,否则返回404表明桶不存在。您必须是桶拥有者或拥有判断桶是否存在的权限,才能判断桶是否存在。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:HeadBucket权限,如果使用桶策略则需授予HeadBucket权限。相关授权方式介绍可参见OB - [列举桶内对象(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0406.md): 调用列举桶内对象接口,可列举指定桶内的部分或所有对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的对象信息。返回结果以对象名的字典序排序。每次接口调用最多返回1000个对象信息。您必须是桶拥有者或拥有列举桶内对象的权限,才能列举桶内对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucke - [设置桶存储类型(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0414.md): OBS提供了这些存储类型:标准存储、低频访问存储、归档存储、深度归档存储,从而满足客户业务对存储性能、成本的不同诉求,详情可参见OBS存储类型。调用设置桶存储类型接口,可设置指定桶的存储类型。设置了桶的默认存储类型之后,如果上传对象、复制对象和初始化多段上传任务时未指定对象的存储类型,则该对象的存储类型默认与桶的存储类型保持一致。您必须是 - [获取桶存储类型(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0415.md): OBS提供了这些存储类型:标准存储、低频访问存储、归档存储、深度归档存储,从而满足客户业务对存储性能、成本的不同诉求,详情可参见OBS存储类型。调用获取桶存储类型接口,可获取指定桶的存储类型。您必须是桶拥有者或拥有获取桶存储类型的权限,才能获取桶存储类型。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetB - [设置桶配额(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0412.md): 桶配额是桶容量的上限值。默认情况下,OBS系统和单个桶都没有总数据容量和对象数量的限制。您可以根据需要,为桶设置配额限制来控制桶内允许上传的对象总容量,超过设置的对象容量后,上传对象会失败。例如您为桶设置配额为100G,那么当桶内所有对象的大小总和达到100G后,再上传对象就会因为超过配额导致上传失败。容量限制只对桶配额设置生效后的对象上 - [获取桶配额(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0413.md): 桶配额是桶容量的上限值。调用获取桶配额接口,可获取指定桶的配额值。桶配额为0代表桶容量没有上限。桶配额值必须为非负整数,单位为字节,支持的最大值为263-1。桶的拥有者的状态是欠费冻结状态时不可以查询桶配额信息。您必须是桶拥有者或拥有获取桶配额的权限,才能获取桶配额。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucke - [获取桶存量信息(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0411.md): 调用获取桶存量信息接口,可查询指定桶内的对象个数,以及对象占用空间的大小。由于OBS桶存量是后台统计,因此存量会有一定的时延,不能实时更新,因此不建议对存量做实时校验。您必须是桶拥有者或拥有获取桶存量信息的权限,才能获取桶存量信息。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketStorage - [设置桶标签(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0436.md): 为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的标签来分析此应用的成本。调用设置桶标签接口,您可为指定桶添加标签。每个桶最多能设置20个标签。标签的 - [获取桶标签(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0437.md): 为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的标签来分析此应用的成本。调用获取桶标签接口,您可获取指定桶的标签。您必须是桶拥有者或拥有获取桶标签的 - [删除桶标签(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0438.md): 为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的标签来分析此应用的成本。调用删除桶标签接口,您可删除指定桶的标签。您必须是桶拥有者或拥有删除桶标签的 - [设置桶日志管理配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0418.md): 调用设置桶日志管理配置接口,您可以为指定桶打开桶日志功能,并配置日志存放的目标桶。创建桶时,默认是不生成桶的日志的,调用Go SDK的设置桶日志管理配置接口时,接口会自动为您打开桶日志配置。桶日志功能开启后,桶的每次操作将会产生一条日志,并将多条日志打包成一个日志文件。日志文件存放位置需要在开启桶日志功能时指定,可以存放到开启日志功能的桶 - [获取桶日志管理配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0419.md): 调用获取桶日志管理配置,可获取指定桶的日志配置。您必须是桶拥有者或拥有获取桶日志管理配置的权限,才能获取桶日志管理配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketLogging权限,如果使用桶策略则需授予GetBucketLogging权限。相关授权方式介绍可参见OBS权限控制概述,配置 - [设置桶策略(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0420.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。桶策略是作用于所配置的OBS桶及桶内对象的,您可以通过桶策略可为IAM用户 - [获取桶策略(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0421.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。桶策略是作用于所配置的OBS桶及桶内对象的,您可以通过桶策略可为IAM用户 - [删除桶策略(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0422.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。桶策略是作用于所配置的OBS桶及桶内对象的,您可以通过桶策略可为IAM用户 - [设置桶ACL(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0416.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [获取桶ACL(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0417.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [设置桶的BPA配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1717.md): 创建或修改OBS桶的PublicAccessBlock配置,以开启或关闭阻止公开访问。您必须是桶拥有者或拥有设置桶BPA配置的权限,才能设置桶的BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutBucketPublicAccessBlock权限,如果使用桶策略则需授予PutBucketPubli - [获取桶的BPA配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1718.md): 获取OBS桶的PublicAccessBlock配置。您必须是桶拥有者或拥有获取桶的BPA配置的权限,才能获取桶的BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPublicAccessBlock权限,如果使用桶策略则需授予GetBucketPublicAccessBlock权限。 - [删除桶的BPA配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1719.md): 删除OBS桶的PublicAccessBlock配置。您必须是桶拥有者或拥有删除桶的BPA配置的权限,才能删除桶的BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketPublicAccessBlock权限,如果使用桶策略则需授予DeleteBucketPublicAccessBl - [查询桶策略公开状态(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1720.md): 获取OBS桶策略的公开状态。您必须是桶拥有者或拥有获取桶策略公开状态的权限,才能获取桶策略公开状态。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPolicyPublicStatus权限,如果使用桶策略则需授予GetBucketPolicyPublicStatus权限。相关授权方式介绍可参见 - [查询桶公开状态(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1721.md): 获取OBS桶的公开状态。您必须是桶拥有者或拥有获取桶公开状态的权限,才能获取桶公开状态。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPublicStatus权限,如果使用桶策略则需授予GetBucketPublicStatus权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用 - [服务端加密(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0603.md): 用户可以使用普通方式上传、下载对象,也可以使用服务端加密方式进行上传、下载对象。OBS支持服务端加密功能,使加密的行为在服务端进行。用户可以根据自身的需求,使用不同的密钥管理方式来使用服务端加密功能。当前支持两种服务端加密方式: KMS托管密钥的服务端加密(SSE-KMS)和客户提供加密密钥的服务端加密(SSE-C)。上述两种方式都采用行 - [设置桶加密配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0441.md): 设置桶的加密配置,以允许在该桶中上传对象时,采用对应加密配置对数据进行加密,数据会在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用设置桶加密配置接口,您可以为指定桶创建或更新加密配置信息。您必须是桶拥有者或拥有设置桶加密配置的权限,才能设置桶加密配置。建议使用IAM或桶策略进行授权,如果 - [获取桶加密配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0442.md): 桶的加密配置功能,支持在该桶中上传对象时,采用对应加密配置对数据进行加密,数据会在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用获取桶加密配置接口,您可以获取指定桶的加密配置信息。您必须是桶拥有者或拥有获取桶加密配置的权限,才能获取桶加密配置。建议使用IAM或桶策略进行授权,如果使用IA - [删除桶加密配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0443.md): 桶的加密配置功能,支持在该桶中上传对象时,采用对应加密配置对数据进行加密,数据会在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用删除桶加密配置接口,您可以删除指定桶的加密配置信息。您必须是桶拥有者或拥有删除桶加密配置的权限,才能删除桶加密配置。建议使用IAM或桶策略进行授权,如果使用IA - [设置桶的CORS配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0431.md): 跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全策略(Same Origin Policy,SOP)的存在,不同域之间的网站脚本和内容是无法进行交互 - [获取桶的CORS配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0432.md): 跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全策略(Same Origin Policy,SOP)的存在,不同域之间的网站脚本和内容是无法进行交互 - [删除桶的CORS配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0433.md): 跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全策略(Same Origin Policy,SOP)的存在,不同域之间的网站脚本和内容是无法进行交互 - [设置桶的自定义域名(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0444.md): 调用设置桶的自定义域名配置接口,您可以为指定设置桶的自定义域名信息。您必须是桶拥有者或拥有设置桶的自定义域名的权限,才能设置桶的自定义域名信息。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutBucketCustomDomainConfiguration权限,如果使用桶策略则需授予PutBucketCus - [获取桶的自定义域名(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0445.md): 调用获取桶的自定义域名配置接口,您可以获取指定桶的自定义域名配置信息。您必须是桶拥有者或拥有获取桶的自定义域名配置的权限,才能获取桶的自定义域名配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketCustomDomainConfiguration权限,如果使用桶策略则需授予GetBucket - [删除桶的自定义域名(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0446.md): 调用删除桶的自定义域名接口,您可以删除指定桶的自定义域名信息。您必须是桶拥有者或拥有删除桶的自定义域名的权限,才能删除桶的自定义域名。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketCustomDomainConfiguration权限,如果使用桶策略则需授予DeleteBucketCu - [设置桶的多版本状态(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0429.md): OBS支持多版本控制,您可以在一个桶中保留对象的多个版本,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。更多多版本相关信息请参见多版本控制。调用设置桶的多版本状态接口,您可以为指定桶设置多版本状态。您必须是桶拥有者或拥有设置桶的多版本状态的权限,才能设置桶的多版本状态。建议使用IAM或桶策略进行授权,如果使用IA - [获取桶的多版本状态(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0430.md): OBS支持多版本控制,您可以在一个桶中保留对象的多个版本,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。更多多版本相关信息请参见多版本控制。调用获取桶的多版本状态接口,您可以获取指定桶的多版本状态。您必须是桶拥有者或拥有获取桶的多版本状态的权限,才能获取桶的多版本状态。建议使用IAM或桶策略进行授权,如果使用IA - [设置桶的生命周期配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0423.md): OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用设置桶的生命周期配置接口,您可以为指定桶设置生命周期策略。对象生命周期到期以后,对象将会永久删除,无法恢复。归档存储和深度归档存储不支持多AZ,因此不支持使用生命周期的存储类别转换功能,将多AZ的桶 - [获取桶的生命周期配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0424.md): OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用获取桶的生命周期配置接口,您可以获取指定桶的生命周期策略。您必须是桶拥有者或拥有获取桶的生命周期配置的权限,才能获取桶的生命周配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bu - [删除桶的生命周期配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0425.md): OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用删除桶的生命周期配置接口,您可以删除指定桶的生命周期策略。您必须是桶拥有者或拥有删除桶的生命周期配置的权限,才能删除桶的生命周配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bu - [设置桶的事件通知配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0434.md): OBS事件通知功能帮助您对桶的重要的操作进行实时监控,重要操作触发时可及时通知到您,确保您安全、及时知道发生在桶上的关键事件。调用设置桶的事件通知配置接口,可为指定桶设置事件通知配置。您必须是桶拥有者或拥有设置桶的事件通知配置的权限,才能设置桶的事件通知配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:Pu - [获取桶的事件通知配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0435.md): OBS事件通知功能帮助您对桶的重要的操作进行实时监控,重要操作触发时可及时通知到您,确保您安全、及时知道发生在桶上的关键事件。调用获取桶的事件通知配置接口,可获取指定桶的事件通知配置。您必须是桶拥有者或拥有获取桶的事件通知配置的权限,才能获取桶的事件通知配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:Ge - [设置桶的网站配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0426.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用设置桶的网站配置接口,您可以为指定桶设置网站配 - [获取桶的网站配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0427.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用获取桶的网站配置接口,您可以获取指定桶的网站配 - [删除桶的网站配置(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0428.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用删除桶的网站配置接口,您可以删除指定桶的网站配 - [设置桶归档存储对象直读策略](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8002.md): 归档存储对象直读是指用户可以不用恢复归档存储对象,便能直接对其进行操作。默认情况下,桶没有开启归档存储对象直读功能。本接口主要用来开启或关闭桶的归档存储对象直读功能。设置桶的归档存储对象直读状态为Enabled,开启桶的归档存储对象直读功能:桶内存在归档存储对象时,不管该归档存储对象是否已经恢复,均可以直接操作该归档存储对象。如果归档存储 - [获取桶归档存储对象直读策略](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8003.md): 桶的所有者可以获取指定桶的归档存储对象直读状态。如果从未设置桶的归档存储对象直读状态,或者已经删除桶的归档存储对象直读状态,则此操作不会返回桶的归档存储对象直读状态。当桶设置了归档存储对象直读状态,可以通过本接口获取指定桶的归档存储冷存储对象直读状态信息。了解更多归档存储数据直读相关信息,请参见归档数据直读。您必须是桶拥有者或拥有获取桶归 - [删除桶归档存储对象直读策略](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8004.md): 删除指定桶的归档存储对象直读配置信息。删除后桶内的归档存储对象不能直接读取。对未恢复或正在恢复的归档存储对象进行操作时,会返回错误403 Forbidden。要正确执行此操作,需要确保执行者有DeleteDirectColdAccessConfiguration权限。默认情况下只有桶的所有者可以执行此操作,也可以通过设置桶策略或用户策略授 - [设置在线解压策略](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8006.md): 本接口用于为指定桶配置ZIP文件解压策略。接口是幂等的,如果桶上已存在相同策略内容,则返回成功,status code返回值为200;否则status code返回值为201。您必须是桶拥有者或拥有设置在线解压策略的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。OBS支持的 - [获取在线解压策略](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8007.md): 桶拥有者或拥有获取在线解压策略权限的用户可通过本接口查询指定桶的文件解压策略。如果策略存在,则返回成功,status code返回值为200。您必须是桶拥有者或拥有获取在线解压策略的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。OBS支持的Region与Endpoint的对 - [删除在线解压策略](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8008.md): 桶拥有者或拥有删除在线解压策略权限的用户可通过本接口删除指定桶中配置的文件解压策略,删除成功status code返回值为204。您必须是桶拥有者或拥有删除在线解压策略的权限,才能调用本接口,建议使用IAM或桶策略进行授权。了解更多OBS授权方式请参见OBS不同权限控制方式的区别。OBS支持的Region与Endpoint的对应关系,详细 - [设置桶清单](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8010.md): 桶清单功能可以定期生成桶内对象的元数据信息,通过查看这些信息,可以帮助您更好地了解桶内对象的状态。桶拥有者或拥有设置桶清单的用户,可以通过本接口为桶配置清单规则,每个桶最多配置10条清单规则。有关更多桶清单的介绍和使用限制,请参见桶清单。要使用此操作,需确保执行者有PutBucketInventoryConfiguration操作的权限 - [获取桶清单](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8011.md): OBS使用GET操作来获取指定桶的某个清单配置。要正确执行此操作,需要确保执行者拥有GetBucketInventoryConfiguration权限。桶拥有者默认具有此权限,并且可以将此权限授予其他人。融合桶场景,主桶支持配置桶清单,备桶不支持配置桶清单。您必须是桶拥有者或拥有获取桶清单的权限,才能调用本接口,建议使用IAM或桶策略进行 - [删除桶清单](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8012.md): 用户可以通过本接口删除指定桶的清单配置(通过清单id来指定清单配置)。有关更多桶清单的介绍和使用限制,请参考《对象存储服务用户指南》的桶清单章节。要正确执行此操作,需要确保执行者有DeleteBucketInventoryConfiguration权限。缺省情况下只有桶的所有者可以执行此操作,也可以通过设置桶策略或用户策略授权给其他用户。 - [列举桶清单](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8013.md): 桶清单功能可以定期生成桶内对象的元数据信息,通过查看这些信息,可以帮助您更好地了解桶内对象的状态。调用本接口可以获取桶的所有清单配置,获取到的清单配置一次性返回,不分页。要正确执行此操作,需要确保执行者有GetBucketInventoryConfiguration权限。缺省情况下只有桶的所有者可以执行此操作,也可以通过设置桶策略或用户策 - [设置DIS通知策略](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8015.md): 如果需要将OBS桶中对象变化的事件推送到DIS的事件通道中,可以调用此接口来配置DIS通知策略。接口是幂等的,如果桶上已存在相同策略内容,则返回成功,status code返回值为200;否则status code返回值为201。融合桶不支持设置DIS通知策略。需要使用IAM的角色与策略授权功能,增加Tenant Administrato - [获取DIS通知策略](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8016.md): 如果想查询OBS桶上配置的DIS通知策略,可以调用此接口,接口会返回桶上配置的所有策略,一次性返回,不分页。了解更多设置DIS通知策略的相关信息,请参见使用DIS发送OBS事件通知。融合桶不支持设置DIS通知策略。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。须知:调用DIS策略相关接口前,需在初始化 - [删除DIS通知策略](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8017.md): 如果清空OBS桶上配置的DIS通知策略,可以调用此接口,删除操作会移除桶的所有 DIS 策略。删除接口是幂等的,如果桶上未配置DIS通知策略,调用删除接口依然会成功,status code返回值为204。了解更多设置DIS通知策略的相关信息,请参见使用DIS发送OBS事件通知。融合桶不支持设置DIS通知策略。您必须是桶拥有者或者拥有Ten - [设置桶级WORM保护策略](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8023.md): OBS提供合规模式的WORM功能,当桶设置了WORM策略后,如果新上传的对象没有设置保护策略和保护期限,则其会自动应用桶级WORM策略。可通过本接口为指定桶配置默认保护策略和保护期限。当您在桶内配置了桶级默认WORM策略以后,如果您在上传对象时没有指定保护策略和保护期限,则新上传的对象会自动应用桶级默认WORM策略。和配置对象级WORM保 - [获取桶级WORM保护策略](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8024.md): 当桶设置了桶级默认WORM策略,可以通过本接口获取该桶的桶级默认WORM策略。如果您打开了桶级WORM开关,但从未配置过桶级默认WORM策略,您依然可以使用此接口查看开关的打开情况。您必须是桶拥有者或拥有获取桶级WORM保护策略的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBuc - [创建并行文件系统(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1901.md): OBS并行文件系统是对象的容器,您上传的文件都将以对象的形式存放在并行文件系统中。本文介绍如何使用Go SDK创建并行文件系统。调用创建并行文件系统接口,将在当前账号按照用户指定的并行文件系统名创建一个新并行文件系统,接口支持根据用户诉求,在创建并行文件系统的同时配置并行文件系统的存储类别、区域及并行文件系统的访问权限等参数。您必须拥有o - [列举并行文件系统(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1902.md): 指定列举POSIX的桶功能是指在OBS中筛选并列举类型为POSIX的并行文件系统。该功能允许用户列出账户下所有的POSIX桶,或者通过指定桶名称前缀进行批量筛选,方便用户管理和查找POSIX类型的存储桶。您必须拥有obs:bucket:ListAllMyBuckets权限,才能获取并行文件系统列表。建议使用IAM进行授权,配置方式详见使用 - [列举并行文件系统内对象(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_3903.md): 调用列举并行文件系统内对象接口,可列举指定并行文件系统内的部分或所有对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的对象信息。返回结果以对象名的字典序排序。每次接口调用最多返回1000个对象信息。您必须是并行文件系统拥有者或拥有列举并行文件系统内对象的权限,才能列举并行文件系统内对象。建议使用IAM或并行文 - [对象相关接口说明(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0501.md): OBS Go SDK为对象相关接口(断点续传除外),均提供了使用带授权信息的URL访问OBS服务的方法,这些方法可能包含以下三个参数(ObsClient.PutFileWithSignedUrl除外):带授权信息的URL通过带授权信息的URL发起请求时实际应携带的头域请求携带的数据(可选)关于如何生成带授权信息的URL,请参考生成带授权信 - [上传对象-流式上传(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0402.md): 您可以将本地文件直接上传至OBS指定的位置。待上传的文件可以是任何类型:文本文件、图片、视频等。通过SDK的流式上传,可以上传小于5GB的文件。本章节介绍如何使用Go SDK流式上传对象。流式上传使用io.Reader作为对象的数据源,可以通过ObsClient.PutObject上传数据流到OBS。您必须是桶拥有者或拥有上传对象的权限, - [上传对象-文件上传(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0403.md): 您可以将本地文件直接上传至OBS指定的桶中。待上传的文件可以是任何类型:文本文件、图片、视频等。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置 - [上传对象-追加上传(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0404.md): 您可以根据需要上传文件或者文件夹至已有的OBS桶。待上传的文件可以是任何类型:文本文件、图片、视频等。追加写对象操作是指在指定桶内的一个对象尾追加上传数据,不存在相同对象键值的对象则创建新对象。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject - [上传对象-断点续传上传(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0409.md): 对分段上传的封装和加强,解决上传大文件时由于网络不稳定或程序崩溃导致上传失败的问题。其原理是将待上传的文件分成若干个分段分别上传,并实时地将每段上传结果统一记录在checkpoint文件中,仅当所有分段都上传成功时返回上传成功的结果,否则返回错误信息提醒用户再次调用接口进行重新上传(重新上传时因为有checkpoint文件记录当前的上传进 - [上传对象-基于表单上传(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_7408.md): 基于表单上传是使用HTML表单形式上传对象到指定桶中,对象最大不能超过5GB。可以通过如下步骤进行表单上传:使用ObsClient.CreateBrowserBasedSignature生成用于鉴权的请求参数。准备表单HTML页面。将生成的请求参数填入HTML页面。选择本地文件,进行表单上传。使用SDK生成的用于鉴权的请求参数包括两个:P - [上传对象-异步断点续传上传](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8025.md): 断点续传上传对分段上传的封装和加强,解决上传大文件时由于网络不稳定或程序崩溃导致上传失败的问题。其原理是将待上传的文件分成若干个分段分别上传,并实时地将每段上传结果统一记录在checkpoint文件中,仅当所有分段都上传成功时返回上传成功的结果,否则返回错误信息提醒用户再次调用接口进行重新上传(重新上传时因为有checkpoint文件记录 - [上传对象-进度条(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0610.md): 获取上传对象进度是指在进行对象上传操作时,实时监控并获取上传进度的功能。通过实现进度监听接口,可以获取到上传任务的开始、数据传输中、上传完成或失败等状态信息,以及已上传字节数和总字节数。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如 - [下载对象-流式下载(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0502.md): 您可以根据需要将存储在OBS中的对象下载到本地。流式下载指定文件。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、 - [下载对象-范围下载(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0503.md): 如果只需要下载对象的其中一部分数据,可以使用范围下载,下载指定范围的数据。如果指定的下载范围是0~1000,则返回第0到第1000个字节的数据,包括第1000个,共1001字节的数据,即[0, 1000]。如果指定的范围无效,则返回整个对象的数据。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用 - [下载对象-限定条件下载(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0504.md): 下载对象时,可以指定一个或多个限定条件,满足限定条件时则进行下载,否则返回异常码,下载对象失败。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetObject权限。相关授权方式介绍可参见OBS权限控制概述,配置 - [下载对象-断点续传下载(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0509.md): 当下载大对象到本地文件时,经常出现因网络不稳定或程序崩溃导致下载失败的情况。失败后再次重新下载不仅浪费资源,而且当网络不稳定时仍然有下载失败的风险。断点续传下载接口能有效地解决此类问题引起的下载失败,其原理是将待下载的对象分成若干个分段分别下载,并实时地将每段下载结果统一记录在checkpoint文件中,仅当所有分段都下载成功时返回下载成 - [下载对象-异步断点续传下载](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_8026.md): 当下载大对象到本地文件时,经常出现因网络不稳定或程序崩溃导致下载失败的情况。失败后再次重新下载不仅浪费资源,而且当网络不稳定时仍然有下载失败的风险。断点续传下载接口能有效地解决此类问题引起的下载失败,其原理是将待下载的对象分成若干个分段分别下载,并实时地将每段下载结果统一记录在checkpoint文件中,仅当所有分段都下载成功时返回下载成 - [下载对象-进度条(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0623.md): 获取下载对象进度是指在进行对象下载操作时,实时监控并获取下载进度的功能。通过实现进度监听接口,可以获取到下载任务的开始、数据传输中、下载完成或失败等状态信息,以及已下载字节数和总字节数。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如 - [重命名对象(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1907.md): 重命名对象操作是指将指定并行文件系统内的一个对象重命名为其他对象名。您必须是并行文件系统拥有者或拥有重命名文件的权限,才能重命名文件。建议使用IAM或策略进行授权,如果使用IAM则需授予obs:bucket:PutObject权限,如果使用策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM - [复制对象(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0505.md): 用户可以根据需要将存储在OBS上的对象复制到其他路径下。复制对象操作将创建需要复制的对象的副本。在单次操作中,您可以创建最大5GB的对象副本。为指定桶中的对象创建一个副本。您必须是桶拥有者或拥有复制对象的权限,才能复制对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则 - [设置对象元数据(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0920.md): 元数据(Metadata)为描述对象属性的信息,是一组名称值对,用作对象管理的一部分。当前仅支持系统定义的元数据。系统定义的元数据又分为两种类别:系统控制和用户控制。如Last-Modified日期等数据由系统控制,不可修改;如为对象配置的ContentLanguage,用户可以通过接口进行修改。对指定桶中的对象发送HEAD请求,设置对象 - [获取对象元数据(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0508.md): 元数据(Metadata)为描述对象属性的信息,是一组名称值对,用作对象管理的一部分。当前仅支持系统定义的元数据。系统定义的元数据又分为两种类别:系统控制和用户控制。对指定桶中的对象发送HEAD请求,获取对象的元数据信息。您必须是桶拥有者或拥有获取对象元数据的权限,才能获取对象元数据。建议使用IAM或桶策略进行授权,如果使用IAM则需授予 - [修改写对象(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0519.md): 将指定并行文件系统内的一个对象从指定位置起修改为其他内容。目前接口仅在并行文件系统支持,普通对象桶不支持,如何创建并行文件系统请参考创建桶。您必须拥有obs:object:PutObject权限,才能修改写对象。相关授权操作可参见典型权限场景配置案例。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。fu - [删除对象(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0506.md): 为节省空间和成本,您可以根据需要删除指定桶中的单个对象。您必须是桶拥有者或拥有删除对象的权限,才能删除对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:DeleteObject权限,如果使用桶策略则需授予DeleteObject权限。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与 - [批量删除对象(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0507.md): 为节省空间和成本,您可以根据需要删除指定桶中的多个对象。批量删除对象特性用于将一个桶内的部分对象一次性删除,删除后不可恢复。批量删除对象要求返回结果里包含每个对象的删除结果。OBS的批量删除对象使用同步删除对象的方式,每个对象的删除结果返回给请求用户。您必须是桶拥有者或拥有批量删除对象的权限,才能批量删除对象。建议使用IAM或桶策略进行授 - [恢复归档或深度归档存储对象(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0517.md): 如果要获取归档或深度归档存储对象的内容,需要先将对象恢复,然后再执行下载数据的操作。对象恢复后,会产生一个标准存储类型的对象副本,也就是说会同时存在标准存储类型的对象副本和归档或深度归档存储对象,在恢复对象的保存时间到期后标准存储类型的对象副本会自动删除。该接口可以恢复指定桶中的归档或深度归档存储对象。您必须是桶拥有者或拥有恢复归档或深度 - [判断对象是否存在(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0518.md): 您可以使用HeadObject接口来检查指定桶中是否存在指定的对象。该接口通过发送HTTP HEAD请求到对象,只返回对象的元数据信息而不返回对象内容,因此性能高效。您必须是对象拥有者或拥有获取对象元数据的权限,才能判断对象是否存在。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:HeadObject权限,如果 - [创建文件夹(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0510.md): 您可以在已创建的桶中新建一个文件夹,从而更方便地对存储在OBS中的数据进行分类管理。OBS本身是没有文件夹的概念的,桶中存储的元素只有对象。创建文件夹实际上是创建了一个大小为0且对象名以“/”结尾的对象,这类对象与其他对象无任何差异,可以进行下载、删除等操作,只是OBS控制台会将这类以“/”结尾的对象以文件夹的方式展示。您必须是桶拥有者或 - [重写响应头(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0505.md): 下载对象时,可以重写部分HTTP/HTTPS响应头信息。可重写的响应头信息见下表:您必须拥有obs:object:GETObject权限,才能重写响应头。相关授权操作可参见典型权限场景配置案例。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。func (obsClient ObsClient) GetO - [图片处理(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_0508.md): OBS为用户提供了稳定、安全、高效、易用、低成本的图片处理服务。当要下载的对象是图片文件时,您可以通过传入图片处理参数对图片文件进行图片剪切、图片缩放、图片水印、格式转换等处理。您必须拥有obs:object:PutObject权限,才能进行图片处理。相关授权操作可参见典型权限场景配置案例。OBS支持的Region与Endpoint的对应 - [分段相关接口说明(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0521.md): 对于较大文件上传,可以切分成段上传。用户可以在如下的应用场景内(但不仅限于此),使用分段上传的模式:上传超过100MB大小的文件。网络条件较差,和OBS服务端之间的链接经常断开。上传前无法确定将要上传文件的大小。分段上传分为如下3个步骤:初始化分段上传任务(ObsClient.InitiateMultipartUpload)。逐个或并行上 - [分段上传-初始化分段上传任务(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0511.md): 使用多段上传特性时,用户必须首先调用创建多段上传任务接口创建任务,系统会给用户返回一个全局唯一的多段上传任务号,作为任务标识。后续用户可以根据这个标识发起相关的请求,如:上传段、合并段、列举段等。创建多段上传任务不影响已有的同名对象;同一个对象可以同时存在多个多段上传任务;每个多段上传任务在初始化时可以附加消息头信息,包括acl、用户自定 - [分段上传-上传段(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0512.md): 初始化分段上传任务后,通过分段上传任务的ID,上传段到指定桶中。除了最后一段以外,其他段的大小范围是100KB~5GB;最后一段的大小范围是0~5GB。上传的段的编号也有范围限制,其范围是1~10000。上传段时,除了指定上传ID,还必须指定段编号。您可以选择1和10000之间的任意段编号。段编号在您正在上传的对象中唯一地标示了段及其位置 - [分段上传-合并段(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0515.md): 如果用户上传完所有的段,就可以调用合并段接口,系统将在服务端将用户指定的段合并成一个完整的对象。在执行“合并段”操作以前,用户不能下载已经上传的数据。在合并段时需要将多段上传任务初始化时记录的附加消息头信息拷贝到对象元数据中,其处理过程和普通上传对象带这些消息头的处理过程相同。在并发合并段的情况下,仍然遵循Last Write Win策略 - [分段上传-列举分段上传任务(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0408.md): 列举指定桶中所有的初始化后还未合并或还未取消的分段上传任务。通过列举桶中的多段上传任务,您可以获得已初始化多段上传任务的列表,已初始化多段上传任务是指初始化后还未合并以及未取消的多段上传任务。每个请求将返回最多1000个多段上传任务,如果正在进行的多段上传任务超过1000个,您需要发送其他请求以检索剩余的多段上传任务。您必须是桶拥有者或拥 - [分段上传-列举已上传的段(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0514.md): 通过分段上传任务的ID,列举指定桶中已上传的段。您可以列出特定多段上传任务或所有正在进行的多段上传任务的分段。列举已上传的段操作将返回您已为特定多段上传任务而上传的段信息。对于每个列举已上传的段请求,OBS将返回有关特定多段上传任务的分段信息,最多为1000个分段。如果多段上传中的段超过1000个,您必须发送一系列列举已上传的段请求以检索 - [分段上传-复制段(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0513.md): 初始化分段上传任务后,通过分段上传任务的ID,复制段到指定桶中。多段上传任务创建后,用户可以通过指定多段上传任务号,为特定的任务上传段。添加段的方式还包括调用段拷贝接口。允许用户将已上传对象的一部分或全部拷贝为段。将源对象object拷贝为一个段part1,如果在拷贝操作之前part1已经存在,拷贝操作执行之后,旧的段数据part1会被新 - [分段上传-取消分段上传任务(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0516.md): 通过分段上传任务的ID,取消指定桶中的分段上传任务。您可以选择取消多段上传任务,取消多段上传任务之后无法再次使用该上传ID上传任何段。然后,OBS将释放被取消的多段上传任务中的每个段数据的所有存储。如果有多段上传已在进行中,即使您已执行中止操作,它们仍可以上传成功或失败。如果要释放所有分段使用的所有存储,必须在完成所有多段上传后再取消多段 - [分段上传-清理碎片(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0617.md): 清理碎片是指删除未完成的多段上传任务产生的分片数据。当多段上传任务中断或失败时,会在桶中遗留未合并的分片数据,占用存储空间和产生费用。通过清理碎片功能可以删除这些无用的分片数据。OBS SDK提供以下清理碎片的方式:单次清理:通过AbortMultipartUpload接口清理单个未完成的上传任务。批量清理:通过ListMultipart - [设置对象ACL(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0509.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [获取对象ACL(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0510.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [上传回调(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0605.md): 用户可以在上传对象请求中设置回调参数,对象上传成功之后,OBS将上传结果回调特定服务器,并将回调结果返回给用户。回调成功,返回回调结果给客户端,同时将上传对象的Etag以头域返回,当回调结果也包含Etag时,将对Etag拼接后返回。回调失败,返回203,表示对象上传成功但是回调失败。更多回调原因请参考如何定位上传回调失败的问题?您必须是桶 - [设置对象标签(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0614.md): 用户可以通过本接口设置或更新对象(Object)的标签信息。对象标签使用一组键值对(Key-Value)标记对象。您必须是对象拥有者或拥有设置对象标签的权限,才能设置对象标签。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObjectTagging权限,如果使用桶策略则需授予PutObjectTaggi - [获取对象标签(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0615.md): 用户可以通过本接口获取对象(Object)的标签信息。您必须是对象拥有者或拥有获取对象标签的权限,才能获取对象标签。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObjectTagging权限,如果使用桶策略则需授予GetObjectTagging权限。相关授权方式介绍可参见OBS权限控制概述,配置方式 - [删除对象标签(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0616.md): 用户可以通过本接口删除对象(Object)的标签信息。您必须是对象拥有者或拥有删除对象标签的权限,才能删除对象标签。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:DeleteObjectTagging权限,如果使用桶策略则需授予DeleteObjectTagging权限。相关授权方式介绍可参见OBS权限控制概 - [配置对象级WORM保护策略](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_1617.md): 开启了WORM开关的桶,上传的对象支持配置或修改对象保护期限。如果上传对象时没有配置保护期限或自动应用桶级默认保护策略,您可以通过本接口配置对象保护期限。如果上传对象时配置了保护期限或自动应用了默认保护期限,允许用户通过本接口延长保护期限。对象保护期限仅允许修改,不允许删除。您必须是桶拥有者或拥有设置桶级WORM保护策略的权限,才能调用本 - [生成带授权信息的URL](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0601.md): 通过访问密钥、请求方法类型、请求参数等信息生成一个在Query参数中携带鉴权信息的URL,可将该URL提供给其他用户进行临时访问。在生成URL时,需要指定URL的有效期来限制访客用户的访问时长。如果想授予其他用户对桶或对象临时进行其他操作的权限(例如上传或下载对象),则需要生成带对应请求的URL后(例如使用生成PUT请求的URL上传对象) - [生成带授权信息的表单上传参数(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0602.md): 生成用于鉴权的请求参数,以进行基于浏览器的POST表单上传。使用SDK生成的用于鉴权的请求参数包括两个:Policy,对应表单中policy字段,Signature,对应表单中的x-obs-signature字段。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object - [单链接限速(Go SDK)](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_0900.md): 客户端访问OBS对象时占用大量带宽,会影响其他应用的正常使用,可以通过使用单链接限速功能解决该问题。目前仅支持GetObject方法。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。func (obsClient ObsClient) GetObject(input *GetObjectInput, o - [SDK错误码](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1602.md): 调用ObsClient的相关接口发生错误时,通常会返回SDK自定义错误,其包含服务端返回的HTTP状态码、OBS错误码、错误信息等,便于用户定位问题,并做出适当的处理。该结构体的具体定义如下:SDK错误码包含两部分:对象存储服务的API错误码,详见OBS错误码。SDK自定义异常,其字段名与说明请参见表1。SDK自定义异常异常异常描述Obs - [日志分析](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1603.md): OBS Go SDK基于标准库log提供了日志功能,您可以通过InitLog开启日志、CloseLog关闭并同步缓存中的日志内容到日志文件。示例代码如下:日志功能默认是关闭的,需要主动开启。日志默认首先写入缓存(累积一定量后再写入文件),程序退出前调用obs.CloseLog()可同步缓存中的日志内容到日志文件。SDK日志格式为:日志时间 - [如何获取账号ID和用户ID?](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1712.md): 从控制台获取账号名、账号ID、用户名、用户ID、项目名称、项目ID在华为云首页右上角,单击“控制台”。在右上角的用户名中选择我的凭证。在“我的凭证”界面,API凭证页签中,查看账号名、账号ID、用户名、用户ID、项目名称、项目ID。每个区域的项目ID有所不同,需要根据业务所在的区域获取对应的项目ID。查看账号名、账号ID、用户名、用户ID - [如何理解Content-Type(MIME)?](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1713.md): Content-Type(MIME)用于标识请求或响应中所携带数据的媒体类型,浏览器根据该参数来决定数据的打开方式。Content-Type多用于指定一些客户端自定义的文件,以及一些媒体文件的打开方式。如果您在上传Object时未指定Content-Type,SDK会根据指定Object名称的后缀名来判定文件类型并自动填充Content- - [如何指定Content-SHA256?](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1715.md): 上传对象和上传段支持携带x-obs-content-sha256头域,该头域值为请求消息体256-bit SHA256值转十六进制值,计算方式为Hex(SHA256Hash(),服务端会对携带此头域的请求计算其消息体的sha256值做校验(性能会有部分下降,在安全上推荐该算法),示例代码如下:本示例用于流式上传到exam - [为什么SDK源码中包含acs.amazonaws.com关键字?](https://support.huaweicloud.com/sdk-go-devg-obs/obs_23_1716.md): OBS SDK 为了兼容访问aws s3服务,在源码中会包含acs.amazonaws.com关键字的固定格式。SDK仅作常量使用,不会向该格式有其他处理,也不会对其访问。SDK会自动兼容该场景,用户可不感知。例如:Go SDK。 - [如何定位上传回调失败的问题?](https://support.huaweicloud.com/sdk-go-devg-obs/obs_33_1800.md): OBS 上传回调(Callback)允许在对象上传成功后,OBS 服务端自动向指定的回调 URL 发起 HTTP 请求。SDK 支持以下操作的上传回调:PutObject/ PutFileCompleteMultipartUpload(合并段完成时)SDK 通过 WithCallbackHeader 扩展参数将回调配置写入 x-obs-c - [使用前须知](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0101.md): OBS SDK合规使用指南请单击此处;OBS SDK隐私声明请单击此处。使用OBS BrowserJS SDK访问桶前,必须参考6.1 配置桶的CORS。请确认您已经熟悉OBS的基本概念,如桶(Bucket)、对象(Object)、访问密钥(AK和SK)等。您可以先参考OBS客户端通用示例,了解OBS BrowserJS SDK接口调用的 - [SDK下载](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0001.md): OBS BrowserJS SDK最新版本源码:最新源码下载OBS BrowserJS SDK历史版本下载地址:历史版本下载OBS BrowserJS SDK API文档:OBS BrowserJS SDK API参考版本修订记录信息:ChangeLog。推荐的浏览器版本:完全支持HTML5的浏览器。完全支持HTML5的浏览器。功能限制: - [示例程序](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0002.md): OBS BrowserJS SDK提供了丰富的示例程序,方便用户参考或直接使用。您可以从OBS BrowserJS SDK开发包中获取示例程序。下载eSDK_Storage_OBS__BrowserJS.zip,解压后eSDK_Storage_OBS__BrowserJS/examples为示例 - [技术支持渠道](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0003.md): 您可以通过关键字在左侧搜索框中搜索本产品的文档,帮助您快速找到需要的文档。开发者社区提供的技术支持渠道如下:开发过程中,您有任何问题可以在华为云对象存储服务论坛中发帖求助。 - [OBS服务环境搭建](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0102.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。使用OBS之前必须要有一个云服务账号。打开浏览器。登录公有云网站。在页面右上角单击“注册”。按需填写注册信息并单击“同意协议并注册”。使用OBS服务之前必须先充值,才能正常使用OBS服务。登录 - [开发环境准备](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0104.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。从Eclipse官网下载并安装Eclipse IDE for JavaScript and Web Developer最新版本。下载并安装支持HTML5标准的浏览器,例如Chrome 64。 - [安装SDK](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0105.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。如表1所示,BrowserJS SDK有2种安装方式。以安装OBS BrowserJS SDK最新版本为例,步骤如下:SDK内部集成了axios作为HTTP库,该库依赖于promise特性。d - [获取服务地址](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0106.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以从这里查看OBS当前开通的服务地址和区域信息。SDK支持带协议名和不带协议名两种方式传入服务地址,例如获取到的服务地址为“your-endpoint”,则初始化OBS客户端时传入的服务地 - [配置桶允许跨域请求](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0107.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。要使用OBS BrowserJS SDK访问OBS服务的桶,必须配置该桶允许跨域请求(桶的CORS),推荐为桶的CORS配置的规则如下:配置项配置值说明AllowedOrigin*允许任意请求 - [初始化OBS客户端](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0108.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。向OBS发送任一HTTP/HTTPS请求之前,必须先创建一个ObsClient实例:// 创建ObsClient实例 var obsClient = new ObsClient({ / - [上传对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0109.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于上传字符串“Hello OBS”到桶名为“bucketname”里,名称为“objectname”。代码示例如下所示:更多上传对象的信息,请参见上传对象。 - [下载对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0110.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于下载桶名为“bucketname”里,名称为“objectname”的对象。代码示例如下所示:更多下载对象的信息,请参见下载对象。 - [列举对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0111.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。当完成一系列上传对象操作后,可能需要查看桶中包含哪些对象。以下代码展示如何列举指定桶中的对象:上面的代码默认列举1000个对象(Object)。更丰富的列举功能,请参见列举对象。 - [删除对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0112.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于删除桶名为“bucketname”里,名称为“objectname”的对象。代码示例如下所示:本示例仅用于删除单个对象,OBS批量删除对象,需自行遍历构建待批量删除对象的列表。更丰富 - [OBS客户端通用示例](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0113.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS客户端可通过回调函数的形式返回结果,回调函数依次包含异常信息和SDK公共结果对象两个参数。如果回调函数中异常信息参数不为空,则表明接口调用异常;反之,则表明接口调用完成,此时应从SDK公 - [预定义常量](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0114.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS BrowserJS SDK提供了一组预定义常量,方便用户直接使用。您可以通过ObsClient.enums获取预定义常量对象。更多关于预定义常量的介绍详见《对象存储服务BrowserJ - [配置桶的CORS](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0201.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。由于OBS以桶为单位提供基于HTTP/HTTPS协议的分布式存储服务,而浏览器默认不允许Ajax跨域请求,因此使用OBS BrowserJS SDK访问桶前必须配置该桶的CORS。您可以通过O - [配置密钥](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0202.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。要接入OBS服务,您需要拥有一组有效的访问密钥(AK和SK)用来进行签名认证。具体可参考OBS服务环境搭建。获取AK和SK之后,您便可以按照以下步骤进行初始化。创建OBS客户端配置OBS客户端 - [创建OBS客户端](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0203.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS客户端(ObsClient)是访问OBS服务的BrowserJS客户端,它为调用者提供一系列与OBS服务进行交互的接口,用于管理、操作桶(Bucket)和对象(Object)等OBS服务 - [配置OBS客户端](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0204.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可通过初始化参数对ObsClient进行配置,可以配置的参数见下表:建议值为N/A的表示需要根据实际情况进行设置。如网络状况不佳或者上传文件较大,建议增大timeout的值。 - [配置SDK日志](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0205.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.initLog开启日志功能并进行配置。示例代码如下:SDK打印的日志均会显示在浏览器提供的开发者工具的控制台上。日志功能默认是关闭的,需要主动开启。您可以从日志分 - [问题定位方法](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0301.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。使用OBS BrowserJS SDK对接OBS服务可能会遇到许多问题,您可以通过下面介绍的步骤进行问题分析和定位:您可以从这里查看关于SDK公共结果对象的详细说明。 - [高频问题汇总](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0302.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。此错误一般是初始化ObsClient时传入的SK有误,解决方法:检查SK,确保正确。此错误一般是请求的OBS服务端未上线ObsClient接口依赖的特性,请联系OBS运维团队进行进一步确认。此 - [删除桶](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0403.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.deleteBucket删除桶。以下代码展示如何删除一个桶:如果桶不为空(包含对象或分段上传碎片),则该桶无法删除。删除桶非幂等操作,删除不存在的桶会失败。 - [获取桶区域位置](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0406.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketLocation获取桶的区域位置。本示例用于获取桶名为“bucketname”的区域位置信息。代码示例如下所示:获取桶区域位置过程中返回的错误码 - [获取桶元数据](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0401.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketMetadata接口获取桶元数据。本示例用于获取桶名为“bucketname”的元数据信息。代码示例如下所示:获取桶元数据过程中返回的错误码含义 - [判断桶是否存在](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0402.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.headBucket接口判断该桶是否已存在。本示例用于判断桶名为“bucketname”是否存在。代码示例如下所示:如果返回的HTTP状态码为404,表明桶不存在 - [获取桶存量信息](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0407.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。桶存量信息包括桶的空间大小以及桶包含的对象个数。您可以通过ObsClient.getBucketStorageInfo获取桶的存量信息。本示例用于获取桶名为“bucketname”的存量信息。 - [桶配额](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0408.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketQuota设置桶配额。以下代码展示如何设置桶配额:使用StorageQuota参数指定桶的配额大小。桶配额值必须为非负整数,单位为字节,支持的最 - [管理桶ACL](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0404.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全 - [管理桶策略](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0405.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。除了桶ACL外,桶的拥有者还可以通过桶策略,提供对桶和桶内对象的集中访问控制。更多关于桶策略的内容请参考桶策略。您可以通过ObsClient.setBucketPolicy设置桶策略。示例代码 - [桶存储类型](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0409.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS允许您对桶配置不同的存储类型,桶中对象的存储类型默认将与桶的存储类型保持一致。不同的存储类型可以满足客户业务对存储性能、成本的不同诉求。桶的存储类型分为三类,见下表:更多关于桶存储类型的 - [设置桶的BPA配置](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0410.md): 创建或修改OBS桶的PublicAccessBlock配置,以开启或关闭阻止公开访问。您必须是桶拥有者或拥有设置桶BPA配置的权限,才能设置桶BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutBucketPublicAccessBlock权限,如果使用桶策略则需授予PutBucketPublic - [获取桶的BPA配置](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0411.md): 获取OBS桶的PublicAccessBlock配置。您必须是桶拥有者或拥有获取桶的BPA配置的权限,才能获取桶的BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPublicAccessBlock权限,如果使用桶策略则需授予GetBucketPublicAccessBlock权限。 - [删除桶的BPA配置](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0412.md): 删除OBS桶的PublicAccessBlock配置。您必须是桶拥有者或拥有删除桶的BPA配置的权限,才能删除桶的BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketPublicAccessBlock权限,如果使用桶策略则需授予DeleteBucketPublicAccessBl - [查询桶策略公开状态](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0413.md): 获取OBS桶策略的公开状态。您必须是桶拥有者或拥有获取桶策略公开状态的权限,才能获取桶策略公开状态。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPolicyPublicStatus权限,如果使用桶策略则需授予GetBucketPolicyPublicStatus权限。相关授权方式介绍可参见 - [获取桶的公开状态](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0414.md): 获取OBS桶的公开状态。您必须是桶拥有者或拥有获取桶公开状态的权限,才能获取桶公开状态。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPublicStatus权限,如果使用桶策略则需授予GetBucketPublicStatus权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用 - [设置桶的自定义域名](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0415.md): 设置OBS桶的自定义域名。您必须是桶拥有者或拥有设置桶自定义域名的权限,才能设置桶的自定义域名。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:SetBucketCustomDomain权限,如果使用桶策略则需授予SetBucketCustomDomain权限。相关授权方式介绍可参见OBS权限控制概述,配置方式 - [获取桶的自定义域名](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0416.md): 获取OBS桶的自定义域名列表。您必须是桶拥有者或拥有获取桶自定义域名的权限,才能获取桶的自定义域名。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketCustomDomain权限,如果使用桶策略则需授予GetBucketCustomDomain权限。相关授权方式介绍可参见OBS权限控制概述,配置 - [删除桶的自定义域名](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0417.md): 删除OBS桶的自定义域名。您必须是桶拥有者或拥有删除桶自定义域名的权限,才能删除桶自定义域名。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketCustomDomain权限,如果使用桶策略则需授予PutEncryptionConfiguration权限。相关授权方式介绍可参见OBS权限控制 - [设置桶归档存储对象直读策略](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0421.md): 设置桶的归档存储对象直读策略。您必须是桶拥有者或拥有设置桶归档存储对象直读策略的权限,才能设置桶归档存储对象直读策略。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutDirectColdAccessConfiguration权限,如果使用桶策略则需授予PutDirectColdAccessConfigur - [获取桶归档存储对象直读策略](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0422.md): 获取桶的归档存储对象直读策略。您必须是桶拥有者或拥有获取桶归档存储对象直读策略的权限,才能获取桶归档存储对象直读策略。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetDirectColdAccessConfiguration权限,如果使用桶策略则需授予GetDirectColdAccessConfigur - [删除桶归档存储对象直读策略](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0423.md): 删除桶的归档存储对象直读策略。您必须是桶拥有者或拥有删除桶归档存储对象直读策略的权限,才能删除桶归档存储对象直读策略。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteDirectColdAccessConfiguration权限,如果使用桶策略则需授予DeleteDirectColdAccessCo - [标签简介](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1301.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。标签用于标识OBS中的桶,以此来达到对OBS中的桶进行分类的目的。更多关于桶标签的内容请参考标签。 - [设置桶标签](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1302.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketTagging设置桶标签。以下代码展示了如何设置桶标签:使用Tags参数指定桶的标签信息。每个桶支持最多10个标签。标签的Key和Value支持 - [查看桶标签](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1303.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketTagging查看桶标签。以下代码展示了如何查看桶标签: - [删除桶标签](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1304.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.deleteBucketTagging删除桶标签。以下代码展示了如何删除桶标签: - [静态网站托管简介](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1201.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。静态网站通常仅包含静态网页,以及可能包含部分可在客户端运行的脚本,如JavaScript、Flash等。相比之下,动态网站则依赖于服务器端处理脚本,包括PHP、JSP或ASP.Net等。您可以 - [网站文件托管](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1202.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可通过以下步骤实现网站文件托管:以下代码展示了如何实现网站文件托管:上例中您可以使用http://bucketname.your-endpoint/test.html在浏览器直接访问托管的文 - [设置托管配置](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1203.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketWebsite设置桶的托管配置。以下代码展示了如何配置默认主页和错误页面:以下代码展示了如何配置重定向规则:使用RoutingRules参数指定 - [查看托管配置](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1204.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketWebsite查看桶的托管配置。本示例用于查看桶名为“bucketname”的托管配置。代码示例如下所示:查看桶托管配置过程中返回的错误码含义、 - [清除托管配置](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1205.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.deleteBucketWebsite清除桶的托管配置。本示例用于清除桶名为“bucketname”的托管配置。代码示例如下所示:清除桶托管配置过程中返回的错误码 - [多版本控制简介](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0901.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS支持保存一个对象的多个版本,您可以利用多版本控制,在一个桶中保留多个版本的对象。多版本功能可以方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。在默认情况下,OBS中新创 - [设置桶多版本状态](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0902.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketVersioning设置桶的多版本状态。OBS中的桶支持两种多版本状态:以下代码展示了如何设置桶的多版本状态:使用VersionStatus参数 - [查看桶多版本状态](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0903.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketVersioning查看桶的多版本状态。本示例用于获取桶名为“bucketname”的多版本状态。代码示例如下所示:查看桶多版本状态过程中返回的 - [生命周期管理简介](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1001.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS允许您对桶设置生命周期规则,实现自动转换对象的存储类型、自动淘汰过期的对象,以有效利用存储特性,优化存储空间。针对不同前缀的对象,您可以同时设置多条规则。一条规则包含:规则ID,用于标识 - [设置生命周期规则](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1002.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketLifecycle设置桶的生命周期规则。以下代码展示了如何设置最新版本对象和历史版本对象的转换策略:// 创建ObsClient实例 var o - [查看生命周期规则](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1003.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketLifecycle查看桶的生命周期规则。本示例用于查看桶名为“bucketname”的生命周期规则。代码示例如下所示:查看桶生命周期规则过程中返 - [删除生命周期规则](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1004.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.deleteBucketLifecycle删除桶的生命周期规则。本示例用于删除桶名为“bucketname”的生命周期规则。代码示例如下所示:删除桶生命周期规则过 - [事件通知简介](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1401.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS消息通知功能能够帮助您对桶的重要的操作及时通知到您,确保您安全、及时知道发生在桶上的关键事件。目前对象存储服务(OBS)支持包括简单通知服务(SMN)、函数工作流服务(FunctionG - [设置事件通知](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1402.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketNotification设置桶的事件通知。以下代码展示了如何设置桶的事件通知:使用TopicConfigurations参数指定简单通知配置,使 - [查看事件通知](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1403.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketNotification查看桶的事件通知。以下代码展示了如何查看桶的事件通知: - [关闭事件通知](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1404.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。关闭桶事件通知实际上就是调用ObsClient.setBucketNotification将事件通知配置清空,以下代码展示了如何清除桶的事件通知: - [服务端加密简介](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1501.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。用户可以使用普通方式上传、下载对象,也可以使用服务端加密方式进行上传、下载对象。OBS支持服务端加密功能,使加密的行为在服务端进行。用户可以根据自身的需求,使用不同的密钥管理方式来使用服务端加 - [加密说明](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1502.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS BrowserJS SDK支持服务端加密的接口见下表:OBS BrowserJS SDK两种加密方式支持的请求参数: - [加密示例](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1503.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。以下代码展示了在上传对象时使用服务端加密功能:以下代码展示了在下载对象时使用服务端解密功能: - [设置桶加密配置](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_3001.md): 设置桶的加密配置,以允许在该桶中上传对象时,采用对应加密配置对数据进行加密,数据在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用设置桶加密配置接口,您可以为指定桶创建或更新加密配置信息。您必须是桶拥有者或拥有设置桶加密配置的权限,才能设置桶加密配置。建议使用IAM或桶策略进行授权,如果使 - [获取桶加密配置](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_3002.md): 桶的加密配置功能,支持在该桶中上传对象时,采用对应加密配置对数据进行加密,数据在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用获取桶加密配置接口,您可以获取指定桶的加密配置信息。您必须是桶拥有者或拥有获取桶加密配置的权限,才能获取桶加密配置。建议使用IAM或桶策略进行授权,如果使用IAM - [删除桶加密配置](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_3003.md): 桶的加密配置功能,支持在该桶中上传对象时,采用对应加密配置对数据进行加密,数据在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用删除桶加密配置接口,您可以删除指定桶的加密配置信息。您必须是桶拥有者或拥有删除桶加密配置的权限,才能删除桶加密配置。建议使用IAM或桶策略进行授权,如果使用IAM - [日志简介](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1101.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS允许您对桶设置访问日志记录,设置之后对于桶的访问会被记录成日志,日志存储在OBS上您指定的目标桶中。出于分析或审计等目的,用户可以开启日志记录功能。通过访问日志记录,桶的拥有者可以深入分 - [开启桶日志](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1102.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketLogging开启桶日志功能。日志目标桶与源桶必须在同一个区域(region)。如果桶的存储类型为低频访问存储或归档存储,则不能作为日志目标桶。 - [查看桶日志配置](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1103.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketLogging查看桶日志配置。本示例用于查看桶名为“bucketname”的日志配置。代码示例如下所示:查看桶日志过程中返回的错误码含义、问题原 - [关闭桶日志](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1104.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。关闭桶日志功能实际上就是调用ObsClient.setBucketLoggingConfiguration将日志配置清空。本示例用于关闭桶名为“bucketname”的日志配置。代码示例如下所 - [对象上传简介](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0501.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。在OBS中,用户操作的基本数据单元是对象。OBS BrowserJS SDK提供了丰富的对象上传接口,可以通过以下方式上传对象:文本上传文件上传分段上传追加上传基于表单上传SDK支持上传0KB - [文本上传](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0502.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。文本上传用于直接上传字符串。您可以通过ObsClient.putObject直接上传字符串到OBS。本示例用于上传字符串“Hello OBS”到桶名为“bucketname”里,名称为“obj - [文件上传](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0503.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档的“上传对象”章节详细介绍了参数和使用方法。使用SDK管理OBS资源,您需要先完成以下准备工作:使用前须知:了解并选择合适的SDK版本。SDK下载:下载SDK并完成安装。文件上传使用本地文件作为对象的数据源。以下代码展示了如何进 - [批量上传](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_3004.md): 本示例用于批量上传文件。使用SourceFile参数指定待上传的文件,其必须是File对象或者Blob对象,例如在HTML页面中使用类型为“file”的input标签指定待上传的文件:。SourceFile参数和Body参数不能同时使用。上传的内容大小不能超过5GB。 - [追加上传](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0509.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。追加上传可实现对同一个对象追加数据内容的功能。您可以通过ObsClient.appendObject进行追加上传。示例代码如下:使用Position参数指定追加上传的位置,且第一次追加上传的位 - [断点续传上传](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0511.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。断点续传上传的原理是将待上传的文件分成若干个分段分别上传,并实时地将每段上传结果统一记录在断点续传记录对象中,仅当所有分段都上传成功时返回上传成功的结果,否则在回调函数中返回错误码提醒用户通过 - [基于表单上传](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0512.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。基于表单上传是使用HTML表单形式上传对象到指定桶中,对象最大不能超过5GB。您可以通过ObsClient.createPostSignatureSync生成基于表单上传的请求参数。使用Bro - [对象下载简介](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0601.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS BrowserJS SDK提供了丰富的对象下载接口,可以通过以下方式下载对象:文本下载二进制式下载文件下载范围下载限定条件下载您可以通过ObsClient.getObject下载对象。 - [文本下载](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0602.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于下载桶名为“bucketname”里,名称为“objectname”的对象。代码示例如下所示:文本下载方式下返回结果中的InterfaceResult.Content是一个Strin - [二进制式下载](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0603.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。以下代码展示了如何进行二进制式下载:设置SaveByType参数为“arraybuffer”指定使用二进制式下载。二进制式下载方式下返回结果中的InterfaceResult.Content是 - [批量下载](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_3005.md): 本示例用于批量下载对象。设置SaveByType参数为“arraybuffer”指定使用二进制式下载。二进制式下载方式下返回结果中的InterfaceResult.Content是一个ArrayBuffer对象。 - [文件下载](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0604.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于下载桶名为“bucketname”里,名称为“objectname”的对象,并保存到“file”。代码示例如下所示:设置SaveByType参数为“file”生成文件下载路径。 - [范围下载](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0605.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。如果只需要下载对象的其中一部分数据,可以使用范围下载,下载指定范围的数据。如果指定的下载范围是0~1000,则返回第0到第1000个字节的数据,包括第1000个,共1001字节的数据,即[0, - [获取下载进度](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0606.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过设置回调函数来获取下载的进度。本示例用于下载桶名为“bucketname”里,名称为“objectname”的对象并通过ProgressCallback监控下载进度。代码示例如下所示 - [限定条件下载](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0607.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。下载对象时,可以指定一个或多个限定条件,满足限定条件时则进行下载,否则返回异常码,下载对象失败。您可以使用的限定条件如下:对象的ETag值是指对象数据的MD5校验值。如果包含IfUnmodif - [重写响应头](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0608.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。下载对象时,可以重写部分HTTP/HTTPS响应头信息。可重写的响应头信息见下表:以下代码展示了如何重写ContentType响应头:// 创建ObsClient实例 var obsClien - [下载归档存储对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0610.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。如果要下载归档存储对象,需要先将归档存储对象恢复。恢复归档存储对象的恢复选项可支持两类,见下表:重复恢复归档或深度归档存储数据时,系统将延长恢复有效期。同时,将对恢复操作产生的费用进行重复收取 - [初始化分段上传任务](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1901.md): 使用分段上传方式传输数据前,必须先通知OBS初始化一个分段上传任务。该操作会返回一个OBS服务端创建的全局唯一标识(Upload ID),用于标识本次分段上传任务。您可以根据这个唯一标识来发起相关的操作,如取消分段上传任务、列举分段上传任务、列举已上传的段等。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储 - [上传段](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1902.md): 初始化分段上传任务后,通过分段上传任务的ID,上传段到指定桶中。除了最后一段以外,其他段的大小范围是100KB~5GB;最后一段的大小范围是0~5GB。上传的段的编号也有范围限制,其范围是1~10000。上传段时,除了指定上传ID,还必须指定段编号。您可以选择1和10000之间的任意段编号。段编号在您正在上传的对象中唯一地标示了段及其位置 - [合并段](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1903.md): 如果用户上传完所有的段,就可以调用合并段接口,系统将在服务端将用户指定的段合并成一个完整的对象。在执行“合并段”操作以前,用户不能下载已经上传的数据。在合并段时需要将多段上传任务初始化时记录的附加消息头信息拷贝到对象元数据中,其处理过程和普通上传对象带这些消息头的处理过程相同。在并发合并段的情况下,仍然遵循Last Write Win策略 - [取消分段上传任务](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1904.md): 通过分段上传任务的ID,取消指定桶中的分段上传任务。您可以选择取消多段上传任务,取消多段上传任务之后无法再次使用该上传ID上传任何段,并且OBS将释放被取消的多段上传任务中的每个段数据的所有存储。如果有多段上传已在进行中,即使您已执行中止操作,它们仍可以上传成功或失败。如果要释放所有分段使用的所有存储,必须在完成所有多段上传后再取消多段上 - [列举已上传的段](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1905.md): 通过分段上传任务的ID,列举指定桶中已上传的段。您可以列出特定多段上传任务或所有正在进行的多段上传任务的分段。列举已上传的段操作将返回特定多段上传任务中正在进行上传的段信息,单次最多列举1000个分段。如果多段上传中的段超过1000个,您必须发送一系列列举已上传的段请求以检索所有段。请注意,返回的分段列表不包括已合并的分段。开发过程中,您 - [列举分段上传任务](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1906.md): 列举指定桶中所有的初始化后还未合并或还未取消的分段上传任务。通过列举桶中的多段上传任务,您可以获得已初始化多段上传任务的列表,已初始化多段上传任务是指初始化后还未合并以及未取消的多段上传任务。每个请求将返回最多1000个多段上传任务,如果正在进行的多段上传任务超过1000个,您需要发送其他请求以检索剩余的多段上传任务。开发过程中,您有任何 - [分段上传](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0507.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。对于较大文件上传,可以切分成段上传。用户可以在如下的应用场景内(但不仅限于此),使用分段上传的模式:上传超过100MB大小的文件。网络条件较差,和OBS服务端之间的连接经常断开。上传前无法确定 - [分段复制](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1908.md): 分段复制是分段上传的一种特殊情况,即分段上传任务中的段可以通过复制OBS指定桶中现有对象(或对象的一部分)来实现。您可以通过ObsClient.copyPart来复制段。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您必须是桶拥有者或拥有 - [上传回调](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1811.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。用户可以在上传对象请求中设置回调参数,OBS在对象上传成功之后,将上传结果回调特定服务器,并将回调结果返回给用户。本示例用于文件上传,并指定上传回调服务器为http://example.com - [删除对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0704.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.deleteObject删除单个对象。以下代码展示如何删除单个对象:您可以通过ObsClient.deleteObjects批量删除对象。每次最多删除1000个对 - [创建文件夹](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0505.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS本身是没有文件夹的概念的,桶中存储的元素只有对象。创建文件夹实际上是创建了一个大小为0且对象名以“/”结尾的对象,这类对象与其他对象无任何差异,可以进行下载、删除等操作,只是OBS控制台 - [获取上传进度](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0504.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过设置回调函数来获取上传的进度。本示例用于上传文件到桶名为“bucketname”里,名称为“objectname”的对象并通过ProgressCallback获取上传进度。代码示例如 - [获取自定义元数据](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0609.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。下载对象成功后会返回对象的自定义元数据。本示例用于下载桶名为“bucketname”里,名称为“objectname”的对象,同时返回该对象的自定义元数据。代码示例如下所示:要获取对象的自定义 - [设置对象属性](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0506.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以在上传对象时设置对象属性。对象属性包含对象长度、对象MIME类型、对象MD5值(用于校验)、对象存储类型、对象自定义元数据。对象属性可以在多种上传方式下(文本上传、文件上传、分段上传等) - [列举对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0703.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.listObjects列举出桶里的对象。该接口可设置的参数如下:以下代码展示如何简单列举对象,最多返回1000个对象:每次至多返回1000个对象,如果指定桶包含的 - [复制对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0705.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。复制对象特性用来为OBS上已经存在的对象创建一个副本。您可以通过ObsClient.copyObject来复制对象。复制对象时,可重新指定新对象的属性和设置对象权限,且支持条件复制。如果待复制 - [批量复制对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_3006.md): 复制对象特性用来为OBS上已经存在的对象创建一个副本。您可以通过列举对象和复制对象接口实现批量复制对象。复制对象时,可重新指定新对象的属性和设置对象权限,且支持条件复制。如果待复制的源对象是归档存储类型,则必须先恢复源对象才能进行复制。本示例用于批量复制对象。使用CopySource参数指定复制时的源对象信息。 - [管理对象ACL](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0702.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全 - [获取对象属性](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0701.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getObjectMetadata来获取对象属性,包括对象长度,对象MIME类型,对象自定义元数据等信息。本示例用于获取桶名为“bucketname”里,名称为“ - [设置对象元数据](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0706.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setObjectMetadata来设置对象属性,包括CacheControl,ContentDisposition,ContentType,StorageCla - [恢复归档或深度归档存储对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_3007.md): 归档要先将对象恢复,然后再执行下载数据的操作。对象恢复后,会产生一个标准存储类型的对象副本,也就是说会同时存在标准存储类型的对象副本和归档或深度归档存储对象,在恢复对象的保存时间到期后标准存储类型的对象副本会自动删除。该接口可以恢复指定桶中的归档或深度归档存储对象。重复恢复归档或深度归档存储数据时,系统将延长恢复有效期。同时,将对恢复操作 - [批量恢复归档或深度归档存储对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_3008.md): 您可以使用列举对象和恢复归档或深度归档存储对象接口实现批量恢复。本示例用于批量恢复对象。 - [图片处理](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0611.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS为用户提供了稳定、安全、高效、易用、低成本的图片处理服务。当要下载的对象是图片文件时,您可以通过传入图片处理参数对图片文件进行图片剪切、图片缩放、图片水印、格式转换等处理。以下代码展示了 - [使用MD5校验文件一致性](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1812.md): 您可以通过以下接口在上传对象时使用md5校验文件一致性:文本上传文件上传追加上传上传段断点续传上传本示例用于上传文本时使用md5校验数据一致性。本示例用于上传文件时使用md5校验数据一致性。本示例用于追加上传时使用md5校验数据一致性。本示例用于上传段时使用md5校验数据一致性。本示例用于断点续传上传时使用md5校验每个段数据的一致性。 - [获取多版本对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0904.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getObject接口指定VersionId参数来获取多版本对象,示例代码如下:versionId参数为对象的版本号,可通过指定前缀列举多版本对象获取。如果版本号 - [复制多版本对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0905.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.copyObject接口在CopySource参数中指定待复制对象的versionId来复制多版本对象。本示例用于通过设置versionId复制sourcebuc - [恢复多版本归档存储对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0906.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.restoreObject接口指定VersionId参数来恢复多版本归档存储对象。本示例用于通过设置versionId值将bucketname桶中objectna - [列举多版本对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0907.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.listVersions列举多版本对象。该接口可设置的参数如下:如果VersionIdMarker不是KeyMarker的一个版本号,则该参数无效。ObsClie - [多版本对象权限](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0908.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setObjectAcl接口指定VersionId参数设置多版本对象ACL,示例代码如下:使用Owner参数指定对象的所有者信息;使用Grants参数指定被授权的 - [删除多版本对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0909.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.deleteObject接口指定VersionId参数删除多版本对象。本示例用于通过设置多版本对象的VersionId值,删除桶名为“bucketname”里,名 - [设置对象生命周期](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0508.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。上传对象或者初始化分段上传任务时,您可以直接指定对象的过期时间。示例代码如下:使用Expires参数指定对象的过期时间。上述方式仅支持设置以天为单位的对象过期时间,过期后的对象会被OBS服务端 - [上传软链接对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0707.md): 上传软链接对象。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您必须是桶拥有者或拥有上传对象的权限,才能上传软链接对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则需 - [获取软链接对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0708.md): 获取软链接对象。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您必须是桶拥有者或拥有下载对象的权限,才能获取软链接对。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授 - [设置对象标签](https://support.huaweicloud.com/sdk-browserjs-devg-obs/zh-cn_topic_0000002602843987.md): 用户可以通过本接口设置或更新对象(Object)的标签信息。对象标签使用一组键值对(Key-Value)标记对象。如果请求中不携带版本号(versionId),需要确保执行者有PutObjectTagging权限。如果请求中携带版本号(versionId),需要确保执行者有PutObjectTagging和PutObjectVersion - [获取对象标签](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_3011.md): 用户可以通过本接口获取对象(Object)的标签信息。如果请求中不携带版本号(versionId),需要确保执行者有GetObjectTagging权限。如果请求中携带版本号(versionId),需要确保执行者有GetObjectTagging和GetObjectVersionTagging权限。缺省情况下只有对象的所有者可以执行此操作 - [删除对象标签](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_3012.md): 用户可以通过本接口删除对象(Object)的标签信息。如果请求中不携带版本号(versionId),需要确保执行者有DeleteObjectTagging权限。如果请求中携带版本号(versionId),需要确保执行者有DeleteObjectTagging+DeleteObjectVersionTagging权限。缺省情况下只有对象的所 - [使用临时URL进行授权访问](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_0801.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS客户端支持通过访问密钥、请求方法类型、请求参数等信息生成一个在Query参数中携带鉴权信息的URL,可将该URL提供给其他用户进行临时访问。在生成URL时,您需要指定URL的有效期来限制 - [HTTP状态码](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1601.md): OBS服务端遵照HTTP规范,在接口调用完成均会返回标准的HTTP状态码,HTTP状态码分类以及OBS中常见的HTTP状态码如下:HTTP状态码分类:分类分类描述1XX信息,服务器收到请求,需要请求者继续执行操作,一般对客户调用函数不可见。2XX成功,操作被成功接收并处理。3XX重定向,需要进一步的操作以完成请求。4XX客户端错误,请求包 - [OBS服务端错误码](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1602.md): SDK错误码是由ObsClient统一抛出的异常,继承自java.lang.RuntimeException类。用户向OBS发出请求后,如果遇到错误,此时响应中会返回错误码描述的错误信息。通常是OBS服务端错误,包含对象存储服务的错误码、错误信息等,便于用户定位问题,并做出适当的处理。了解对象存储服务的错误码更多信息,请参见OBS错误码。 - [SDK公共结果对象](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1603.md): 调用ObsClient的相关接口完成后,如异常信息参数为空,则均会返回公共结果对象。该对象包含的内容见下表:处理公共结果对象的示例代码如下: - [日志分析](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1604.md): OBS BrowserJS SDK提供了日志功能,您可以通过ObsClient.initLog开启日志功能并进行配置。示例代码如下:SDK打印的日志均显示在浏览器提供的开发者工具的Console中。日志功能默认是关闭的,需要主动开启。SDK日志格式为:日志时间|日志级别|调用接口|日志内容。示例如下:当系统出现问题需要定位且当前的日志无法 - [如何在不支持window.File的浏览器上传文件?](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1702.md): 在不支持window.File的浏览器上(例如低版本的IE浏览器),不能使用ObsClient.putObject或ObsClient.uploadFile上传对象,如果要支持这类浏览器上传,请参考基于表单上传。 - [如何使对象可以被匿名用户访问?](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1708.md): 如果希望对象可以被匿名用户访问,可通过以下三步完成。 - [如何获取桶的静态网站访问地址?](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1712.md): 桶配置成静态网站托管模式后,可通过以下方式拼接桶的静态网站访问地址:https://桶名.静态网站托管域名各区域对应的静态网站托管域名可以从这里查看。例如区域为“华北-北京四”的桶名为“testbucket”的桶配置成静态网站托管模式后,该桶的静态网站访问地址为https://testbucket.obs-website.cn-north - [如何获取对象URL?](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1713.md): 按https://桶名.域名/文件夹目录层级/对象名的方式进行拼接。如果该对象存在于桶的根目录下,则链接地址将不需要有文件夹目录层级。各区域对应的域名可以从这里的终端节点查看。例如需访问区域为“华北-北京四”的桶名为“testbucket”中“test”文件夹下对象名为“test.txt”的对象,则该对象的URL为https://test - [公网环境下如何提高上传大文件速度?](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1714.md): 在公网环境下对于超过100MB的大文件建议通过分段上传方式上传。分段上传是将单个对象拆分为一系列段分别上传。每个段都是对象数据的连续部分。您可以按照任意顺序上传段。如果其中某个段传输失败,可以重新传输该段且不会影响其他段。通过多线程并发上传同一对象的多个段,可大大提高传输效率。具体代码样例可参见分段上传。您也可以使用SDK提供的断点续传上 - [如何暂停断点续传上传任务?](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1715.md): 断点续传上传接口支持暂停上传任务,示例代码如下: - [如何在不暴露AKSK的条件下实现与OBS交互?](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1717.md): 使用BrowserJS SDK与OBS服务交互时,必须将AK/SK暴露到前端,这样会存在安全问题。为避免该问题出现,可让后端生成临时签名URL给前端后,前端再与OBS交互。比如:实现上传功能。// 后端使用NodeJS SDK // 引入obs库 const ObsClient = require('esdk-obs-nodejs'); - [如何上传base64编码的图片?](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1718.md): base64先转码成指定格式图片,然后调用OBS上传接口进行上传。const base64ImgtoFile = function base64ImgtoFile(base64Content, filename) { const arr = base64Content.split(','); const mime = ar - [如何解决断点续传接口报400 InvalidPart的错误?](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1719.md): 可能存在的原因有:合并段时请求段列表中包含了不存在的段;合并段时请求段列表中包含的段的Etag错误。可按照以下步骤排查原因:如果发现请求体Body中的ETag值都是undefined,则说明ETag字段未配置成CORS的扩展头域,请参考配置桶的CORS章节进行配置,符合原因2的场景。排查请求段列表中是否包含了不存在的段信息,例如:对象A分 - [如何理解Content-Type(MIME)?](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1803.md): Content-Type(MIME)用于标识请求或响应中所携带数据的媒体类型,浏览器根据该参数来决定数据的打开方式。Content-Type多用于指定一些客户端自定义的文件,以及一些媒体文件的打开方式。如果您在上传Object时未指定Content-Type,SDK会根据指定Object名称的后缀名来判定文件类型并自动填充Content- - [如何获取账号ID和用户ID?](https://support.huaweicloud.com/sdk-browserjs-devg-obs/obs_24_1815.md): 从控制台获取账号名、账号ID、用户名、用户ID、项目名称、项目ID在华为云首页右上角,单击“控制台”。在右上角的用户名中选择我的凭证。进入我的凭证在“我的凭证”界面,API凭证页签中,查看账号名、账号ID、用户名、用户ID、项目名称、项目ID。每个区域的项目ID有所不同,需要根据业务所在的区域获取对应的项目ID。查看账号名、账号ID、用户 - [使用前须知](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0000.md): OBS SDK合规使用指南请单击此处;OBS SDK隐私声明请单击此处。本文介绍.NET SDK的版本变更,并提供版本兼容性说明,以及其他使用前须知。如表1所示,本节将为您展示.NET SDK的版本变更情况和兼容性说明。版本修订记录信息:ChangeLog。推荐使用的.NET版本:.NET Framework 3.5、4.0、4.5版本, - [SDK下载](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0001.md): OBS .NET SDK最新版本源码:最新版本源码下载OBS .NET SDK历史版本下载地址:历史版本下载OBS .NET SDK API文档:OBS .NET SDK API参考 - [示例程序](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0002.md): OBS .NET SDK提供了丰富的示例程序,方便用户参考或直接使用。您可以从OBS .NET SDK开发包的demo文件夹中获取示例程序。示例包括以下内容: - [技术支持渠道](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0003.md): 您可以通过关键字在左侧搜索框中搜索本产品的文档,帮助您快速找到需要的文档。开发者社区提供的技术支持渠道如下:开发过程中,您有任何问题可以在华为云对象存储服务论坛中发帖求助。 - [OBS服务环境搭建](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0102.md): 使用OBS之前必须要有一个云服务账号。打开浏览器。登录公有云网站。在页面右上角单击“注册”。按需填写注册信息并单击“同意协议并注册”。使用OBS服务之前必须先充值,才能正常使用OBS服务。登录管理控制台。单击页面右上角的“费用和成本”进入费用中心页面。选择“资金管理 > 充值”,系统自动跳转到充值窗口。根据界面提示信息,对账户进行充值。充 - [安装SDK](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0105.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。方式一、通过visual studio 软件的NuGet包管理器安装SDK,步骤如下:方式二、以安装OBS .NET SDK最新版本为例,步骤如下: - [获取服务地址](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0106.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以从这里查看OBS当前开通的服务地址和区域信息。SDK支持带协议名和不带协议名两种方式传入服务地址,例如获取到的服务地址为“your-endpoint”,则初始化OBS客户端时传入的服务地 - [初始化OBS客户端](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0107.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。向OBS发送任一HTTP/HTTPS请求之前,必须先创建一个ObsClient实例:更多关于OBS客户端初始化的操作请参考“初始化”章节。日志配置详见配置SDK日志。 - [创建桶](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0108.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。桶是OBS全局命名空间,相当于数据的容器、文件系统的根目录,可以存储若干对象。以下代码展示如何新建一个桶:桶的名字是全局唯一的,所以您需要确保不与已有的桶名称重复。桶命名规则如下:3~63个字 - [上传对象](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0109.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于上传字符串“Hello OBS”到桶名为“bucketname”里,名称为“objectname”。代码示例如下所示:更多上传对象的信息,请参见上传对象。 - [下载对象](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0110.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于下载桶名为“bucketname”里,名称为“objectname”的对象。代码示例如下所示:更多下载对象的信息,请参见下载对象。 - [列举对象](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0111.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。当完成一系列上传对象操作后,可能需要查看桶中包含哪些对象。以下代码展示如何列举指定桶中的对象:可通过ListObjectsResponse.ObsObjects获取所有对象(Object)的描 - [删除对象](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0112.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于删除桶名为“bucketname”里,名称为“objectname”的对象。代码示例如下所示:本示例仅用于删除单个对象,OBS批量删除对象,需自行遍历构建待批量删除对象的列表。更丰富 - [OBS客户端通用示例](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0113.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。调用ObsClient类的相关接口时,没有异常抛出,则表明返回值有效,返回SDK公共响应头子类实例;如果抛出异常,则说明操作失败,此时应从SDK自定义异常实例中获取错误信息。OBS客户端提供同 - [配置密钥](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0201.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。要接入OBS服务,您需要拥有一组有效的访问密钥(AK和SK)用来进行签名认证。具体可参考OBS服务环境搭建。获取AK和SK之后,您便可以按照以下步骤进行初始化。创建OBS客户端配置OBS客户端 - [创建OBS客户端](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0202.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS客户端(ObsClient)是访问OBS服务的.NET客户端,它为调用者提供一系列与OBS服务进行交互的接口,用于管理、操作桶(Bucket)和对象(Object)等OBS服务上的资源。 - [配置OBS客户端](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0203.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。当使用配置类(ObsConfig)创建OBS客户端(ObsClient)时,您可通过ObsConfig配置类对ObsClient进行配置,可配置代理、连接超时、最大连接数等参数。通过ObsCo - [配置SDK日志](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_24_3010.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS .NET SDK基于Apache Log4net开源库提供了日志功能,您可以通过加入日志配置文件开启日志功能。具体步骤如下:如果不引入日志库和日志配置文件,则视为关闭日志功能,不会有日 - [创建桶](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0301.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.CreateBucket创建桶。创建桶时可以指定桶的访问权限、存储类型和区域位置。OBS支持的桶的存储类型有三类,参见桶存储类型。示例代码如下:// 初始化配置参 - [列举桶](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0302.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.ListBuckets列举桶。以下代码展示如何获取桶列表:获取到的桶列表将按照桶名字典顺序排列。设置ListBucketsRequest.IsQueryLocat - [删除桶](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0303.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.DeleteBucket删除桶。以下代码展示如何删除一个桶:如果桶不为空(包含对象或分段上传碎片),则该桶无法删除。删除桶非幂等操作,删除不存在的桶会报错。 - [判断桶是否存在](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0304.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.HeadBucket接口判断该桶是否已存在。本示例用于判断桶名为“bucketname”是否存在。代码示例如下所示:如果抛出异常且HTTP状态码为404,表明桶不 - [获取桶元数据](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0305.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.GetBucketMetadata接口获取桶元数据。本示例用于获取桶名为“bucketname”的元数据信息。代码示例如下所示:获取桶元数据过程中返回的错误码含义、问题原 - [管理桶ACL](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0306.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [管理桶策略](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0307.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。除了桶ACL外,桶的拥有者还可以通过桶策略,提供对桶和桶内对象的集中访问控制。更多关于桶策略的内容请参考桶策略。您可以通过ObsClient.SetBucketPolicy设置桶策略。示例代码 - [获取桶区域位置](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0308.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.GetBucketLocation获取桶的区域位置。本示例用于获取桶名为“bucketname”的区域位置信息。代码示例如下所示:创建桶时可以指定桶的区域位置,请 - [获取桶存量信息](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0309.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。桶存量信息包括桶已使用的空间大小以及桶包含的对象个数。您可以通过ObsClient.GetBucketStorageInfo获取桶的存量信息。本示例用于获取桶名为“bucketname”的存量 - [桶配额](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0310.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.SetBucketQuota设置桶配额。以下代码展示如何设置桶配额:桶配额值类型为字符串,支持的最大值为263 - 1的字符串形式。您可以通过ObsClient. - [桶存储类型](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0311.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS允许您对桶配置不同的存储类型,桶中对象的存储类型默认将与桶的存储类型保持一致。不同的存储类型可以满足客户业务对存储性能、成本的不同诉求。桶的存储类型分为三类,见下表:更多关于桶存储类型的 - [生命周期管理简介](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0901.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS允许您对桶设置生命周期规则,实现自动转换对象的存储类型、自动淘汰过期的对象,以有效利用存储特性,优化存储空间。针对不同前缀的对象,您可以同时设置多条规则。一条规则包含:规则ID,用于标识 - [设置生命周期规则](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0902.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.SetBucketLifecycle设置桶的生命周期规则。以下代码展示了如何设置最新版本对象和历史版本对象的转换策略:// 初始化配置参数 ObsConfig c - [查看生命周期规则](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0903.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.GetBucketLifecycle查看桶的生命周期规则。本示例用于查看桶名为“bucketname”的生命周期规则。代码示例如下所示:查看生命周期规则过程中返回 - [删除生命周期规则](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0904.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.DeleteBucketLifecycle删除桶的生命周期规则。本示例用于删除桶名为“bucketname”的生命周期规则。代码示例如下所示:删除生命周期规则过程 - [跨域资源共享简介](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1001.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。跨域是指不同域名之间相互访问。跨域访问是浏览器出于安全考虑而设置的一个限制,即同源策略。由于JavaScript同源策略的限制,A域名下的JavaScript无法操作B域名或C域名下的对象。同 - [设置跨域规则](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1002.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.SetBucketCors设置桶的跨域规则,如果原规则存在则覆盖原规则。本示例用于设置桶名为“bucketname”的跨域规则。代码示例如下所示:AllowedO - [查看跨域规则](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1003.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.GetBucketCors查看桶的跨域规则。本示例用于查看桶名为“bucketname”的跨域规则。代码示例如下所示:查看跨域规则过程中返回的错误码含义、问题原因 - [删除跨域规则](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1004.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.DeleteBucketCors删除桶的跨域规则。本示例用于删除桶名为“bucketname”的跨域规则。代码示例如下所示:删除跨域规则过程中返回的错误码含义、问 - [标签简介](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1301.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。标签用于标识OBS中的桶,以此来达到对OBS中的桶进行分类的目的。更多关于桶标签的内容请参考标签。 - [设置桶标签](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1302.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.SetBucketTagging设置桶标签。以下代码展示了如何设置桶标签:每个桶支持最多10个标签。标签的Key和Value支持Unicode。 - [查看桶标签](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1303.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.GetBucketTagging查看桶标签。以下代码展示了如何查看桶标签: - [删除桶标签](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1304.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.DeleteBucketTagging删除桶标签。以下代码展示了如何删除桶标签: - [日志简介](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1101.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS允许您对桶设置访问日志记录,设置之后对于桶的访问会被记录成日志,日志存储在OBS上您指定的目标桶中。出于分析或审计等目的,用户可以开启日志记录功能。通过访问日志记录,桶的拥有者可以深入分 - [开启桶日志](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1102.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.SetBucketLogging开启桶日志功能。日志目标桶与源桶必须在同一个区域(region)。如果桶的存储类型为低频访问存储或归档存储,则不能作为日志目标桶。 - [查看桶日志配置](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1103.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.GetBucketLogging查看桶日志配置。本示例用于查看桶名为“bucketname”的日志配置。代码示例如下所示:查看桶日志过程中返回的错误码含义、问题原 - [关闭桶日志](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1104.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。关闭桶日志功能实际上就是调用ObsClient.SetBucketLogging将日志配置清空。本示例用于关闭桶名为“bucketname”的日志配置。代码示例如下所示:关闭桶日志过程中返回的 - [静态网站托管简介](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1201.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。静态网站通常仅包含静态网页,以及可能包含部分可在客户端运行的脚本,如JavaScript、Flash等。相比之下,动态网站则依赖于服务器端处理脚本,包括PHP、JSP或ASP.Net等。您可以 - [网站文件托管](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1202.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可通过以下步骤实现网站文件托管:以下代码展示了如何实现网站文件托管:上例中您可以使用https://bucketname.your-endpoint/test.html在浏览器直接访问托管的 - [设置托管配置](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1203.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.SetBucketWebsite设置桶的托管配置。以下代码展示了如何配置默认主页和错误页面:以下代码展示了如何配置重定向规则:以下代码展示了如何配置所有请求重定向 - [查看托管配置](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1204.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.GetBucketWebsite查看桶的托管配置。本示例用于查看桶名为“bucketname”的托管配置。代码示例如下所示:查看桶托管配置过程中返回的错误码含义、 - [清除托管配置](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1205.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.DeleteBucketWebsite清除桶的托管配置。本示例用于清除桶名为“bucketname”的托管配置。代码示例如下所示:清除桶托管配置过程中返回的错误码 - [事件通知简介](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1401.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了 每个接口的参数和使用方法。OBS消息通知功能能够帮助您对桶的重要的操作及时通知到您,确保您安全、及时知道发生在桶上的关键事件。目前对象存储服务(OBS)支持包括简单通知服务(SMN)、函数工作流服务(Function - [设置事件通知](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1402.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.SetBucketNotification设置桶的事件通知。在该操作前,需要在消息通知服务SMN创建主题,并设置主题策略为OBS。以下代码展示了如何设置桶的事件通 - [查看事件通知](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1403.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.GetBucketNotification查看桶的事件通知。以下代码展示了如何查看桶的事件通知: - [关闭事件通知](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1404.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。关闭桶事件通知实际上就是调用ObsClient.SetBucketNotification将事件通知配置清空,以下代码展示了如何清除桶的事件通知: - [服务端加密简介](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1501.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档 详细介绍了每个接口的参数和使用方法。OBS支持服务端加密功能,使对象加密的行为在OBS服务端进行。更多关于服务端加密的内容请参考服务端加密。 - [加密说明](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1502.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS .NET SDK支持服务端加密的接口见下表: - [加密示例](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1503.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。以下代码展示了在上传对象时使用服务端加密功能:以下代码展示了在下载对象时使用服务端解密功能: - [多版本控制简介](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0801.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS支持保存一个对象的多个版本,您可以利用多版本控制,在一个桶中保留多个版本的对象。多版本功能可以方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。在默认情况下,OBS中新创 - [设置桶多版本状态](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0802.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.SetBucketVersioning设置桶的多版本状态。OBS中的桶支持两种多版本状态:以下代码展示了如何设置桶的多版本状态: - [查看桶多版本状态](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0803.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.GetBucketVersioning查看桶的多版本状态。本示例用于获取桶名为“bucketname”里的多版本状态。代码示例如下所示:获取桶多版本状态过程中返回 - [对象上传简介](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0401.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。在OBS中,用户操作的基本数据单元是对象。OBS .NET SDK提供了丰富的对象上传接口,可以通过以下方式上传对象:流式上传文件上传异步上传分段上传追加上传断点续传上传SDK支持上传0KB~ - [流式上传](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0402.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。流式上传使用System.IO.Stream作为对象的数据源。您可以通过ObsClient.PutObject上传您的数据流到OBS。以下代码展示了如何进行流式上传:大文件上传建议使用分段上传 - [文件上传](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0403.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。文件上传使用本地文件作为对象的数据源。使用SDK管理OBS资源,您需要先完成以下准备工作:使用前须知:了解并选择合适的SDK版本。SDK下载:下载SDK并完成安装。本示例用于上传本地“loca - [异步上传](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0404.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.BeginPutObject和ObsClient.EndPutObject,进行异步上传对象。本示例用于异步上传本地“localfile”文件到桶名为“bucke - [追加上传](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0410.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。追加上传可实现对同一个对象追加数据内容的功能。您可以通过ObsClient.AppendObject进行追加上传。示例代码如下:ObsClient.PutObject上传的对象可覆盖ObsCl - [对象下载简介](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0501.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS .NET SDK提供了丰富的对象下载接口,可以通过以下方式下载对象:流式下载范围下载异步下载限定条件下载断点续传下载您可以通过ObsClient.GetObject下载对象。 - [流式下载](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0502.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。以下代码展示了如何进行流式下载:响应结果GetObjectResponse中GetObjectResponse.OutputStream为响应流(System.IO.Stream类型),通过操 - [范围下载](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0503.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。如果只需要下载对象的其中一部分数据,可以使用范围下载,下载指定范围的数据。如果指定的下载范围是0~1000,则返回第0到第1000个字节的数据,包括第1000个,共1001字节的数据,即[0, - [异步下载](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0504.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.BeginGetObject和ObsClient.EndGetObject,进行异步下载对象。本示例用于异步下载桶名为“bucketname”里,名称为“obje - [获取下载进度](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0505.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过GetObjectRequest.DownloadProgress注册System.EventHandler回调函数来获取下载的进度。本示例用于下载桶名为“bucketname”里, - [限定条件下载](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0506.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。下载对象时,可以指定一个或多个限定条件,满足限定条件时则进行下载,否则抛出异常,下载对象失败。您可以使用的限定条件如下:对象的ETag值是指对象数据的MD5校验值。如果包含IfUnmodifi - [下载归档存储对象](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0509.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。如果要下载归档存储对象,需要先将归档存储对象恢复。恢复归档存储对象的恢复选项可支持两类,见下表:重复恢复归档或深度归档存储数据时,系统将延长恢复有效期。同时,将对恢复操作产生的费用进行重复收取 - [获取上传进度](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0405.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过PutObjectRequest.UploadProgress注册System.EventHandler回调函数来获取上传的进度。本示例用于上传本地“localfile”文件到桶名为 - [创建文件夹](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0406.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS本身是没有文件夹的概念的,桶中存储的元素只有对象。创建文件夹实际上是创建了一个大小为0且对象名以“/”结尾的对象,这类对象与其他对象无任何差异,可以进行下载、删除等操作,只是OBS控制台 - [设置对象属性](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0407.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以在上传对象时设置对象属性。对象属性包含对象MIME类型、对象MD5值(用于校验)、对象存储类型、对象自定义元数据。对象属性可以在多种上传方式下(流式上传、文件上传、分段上传),或复制对象 - [设置对象生命周期](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0409.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。上传对象或者初始化分段上传任务时,您可以直接指定对象的过期时间。示例代码如下:上述方式仅支持设置以天为单位的对象过期时间,过期后的对象会被OBS服务端自动清理。上述方式设置的对象过期时间,其优 - [重写响应头](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0507.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。下载对象时,可以重写部分HTTP/HTTPS响应头信息。可重写的响应头信息见下表:以下代码展示了如何重写响应头:// 初始化配置参数 ObsConfig config = new ObsCon - [获取自定义元数据](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0508.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。下载对象成功后会返回对象的自定义元数据。本示例用于获取桶名为“bucketname”,名称为“objectname”的对象自定义元数据。代码示例如下所示: - [图片处理](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0511.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS为用户提供了稳定、安全、高效、易用、低成本的图片处理服务。当要下载的对象是图片文件时,您可以通过传入图片处理参数对图片文件进行图片剪切、图片缩放、图片水印、格式转换等处理。更多关于图片处 - [判断对象是否存在](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0606.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.HeadObject来判断指定的对象是否存在。代码示例如下所示:如果抛出异常且HTTP状态码为404,表明桶不存在。 - [复制对象](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0605.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。复制对象特性用来为OBS上已经存在的对象创建一个副本。您可以通过ObsClient.CopyObject来复制对象。复制对象时,可重新指定新对象的属性和设置对象权限,且支持条件复制。如果待复制 - [删除对象](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0604.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。请您谨慎使用删除操作,如果对象所在的桶未开启多版本控制功能,该对象一旦删除将无法恢复。您可以通过ObsClient.DeleteObject删除单个对象。以下代码展示如何删除单个对象:您可以通 - [列举对象](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0603.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.ListObjects列举出桶里的对象。该接口可设置的参数如下:以下代码展示如何简单列举对象,最多返回1000个对象:每次至多返回1000个对象,如果指定桶包含的 - [管理对象ACL](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0602.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [获取对象属性](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0601.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.GetObjectMetadata来获取对象属性,包括对象最后修改时间、版本号、对象自定义元数据等信息。以下代码展示了如何获取对象属性:// 初始化配置参数 Ob - [分段上传](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0408.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。对于较大文件上传,可以切分成段上传。用户可以在如下的应用场景内(但不仅限于此),使用分段上传的模式:上传超过100MB大小的文件。网络条件较差,和OBS服务端之间的链接经常断开。上传前无法确定 - [分段复制](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0411.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。分段复制是分段上传的一种特殊情况,即分段上传任务中的段通过复制OBS指定桶中现有对象(或对象的一部分)来实现。您可以通过ObsClient.CopyPart来复制段。本示例用于分段复制桶名为“ - [断点续传上传](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0412.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。当上传大文件时,经常出现因网络不稳定或程序崩溃导致上传失败的情况。失败后再次重新上传不仅浪费资源,而且当网络不稳定时仍然有上传失败的风险。断点续传上传接口能有效地解决此类问题引起的上传失败,其 - [断点续传下载](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0510.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。当下载大对象到本地文件时,经常出现因网络不稳定或程序崩溃导致下载失败的情况。失败后再次重新下载不仅浪费资源,而且当网络不稳定时仍然有下载失败的风险。断点续传下载接口能有效地解决此类问题引起的下 - [获取多版本对象](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0804.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.GetObject接口传入版本号(VersionId)来获取多版本对象。本示例用于下载桶名为“bucketname”里,名称为“objectname”,指定Ver - [复制多版本对象](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0805.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.CopyObject接口传入版本号(SourceVersionId )来复制多版本对象。本示例用于通过设置SourceVersionId 复制sourcebuck - [恢复多版本归档存储对象](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0806.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.RestoreObject接口传入版本号(VersionId)来恢复多版本归档存储对象。本示例用于通过设置versionId值将destbucketname桶中d - [列举多版本对象](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0807.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.ListVersions列举多版本对象。该接口可设置的参数如下:如果VersionIdMarker不是KeyMarker的一个版本号,则该参数无效。ObsClie - [多版本对象权限](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0808.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.SetObjectAcl接口传入版本号(VersionId)设置多版本对象ACL,示例代码如下:ACL中需要填写的所有者(Owner)或者被授权用户(Grante - [删除多版本对象](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0809.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.DeleteObject接口传入版本号(VersionId)删除多版本对象。本示例用于通过设置多版本对象的VersionId值,删除桶名为“bucketname” - [使用临时URL进行授权访问](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_0701.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS客户端支持通过访问密钥、请求方法类型、请求参数等信息生成一个在Query参数中携带鉴权信息的URL,可将该URL提供给其他用户进行临时访问。在生成URL时,您需要指定URL的有效期来限制 - [日志分析](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1602.md): OBS .NET SDK生成的日志文件路径是通过Log4Net.config配置文件指定的,一般将该配置文件放于工程编译生成的可执行文件所在目录。当系统出现问题需要定位且当前的日志无法满足要求时,可以通过修改日志的级别来获取更多的信息。其中DEBUG日志信息最丰富,ERROR日志信息最少。具体说明如下:DEBUG:调试级别。INFO:信息 - [SDK错误码](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1606.md): SDK错误码是由ObsClient统一抛出的异常,通常是OBS服务端错误,包含OBS错误码、错误信息等,便于用户定位问题,并做出适当的处理。SDK错误码包含两部分:对象存储服务的API错误码,详见OBS错误码。SDK自定义异常,详见表1。SDK自定义异常异常异常描述ObsException.getResponseCode()HTTP状态码 - [SDK公共响应头](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1605.md): 调用ObsClient类的相关接口成功后,返回结果均是公共响应头(ObsWebServiceResponse)的子类。公共响应头类中包含了HTTP/HTTPS的响应头等信息。此示例用于创建桶时,从公共响应头中获取request-id。 - [如何解决进程偶现卡死的问题?](https://support.huaweicloud.com/sdk-dotnet-devg-obs/obs_25_1710.md): 问题现象:在调用.NET SDK方法时,进程偶现卡死的情况。解决办法:如果遇到该问题,可以将方法调用加上using方式。以下示例展示使用using方式调用接口。 - [SDK 安装](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0001.md): OBS Android SDK最新版本源码:GitHub其他安装方式请参考 安装SDKSDK源码请参见:GitHub接口参考文档地址:SDK API文档版本修订记录信息:ChangeLog。推荐使用的Android系统版本:Android 7.0,8.0,8.1,9.0,10.0版本(HTTP/HTTPS协议)。jdk1.8环境建议使用3 - [示例程序](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0002.md): OBS Android SDK提供了丰富的示例程序,方便用户参考或直接使用。您可以从OBS Android SDK开发包中获取示例程序,如eSDK_Storage_OBS__Android.zip,解压后eSDK_Storage_OBS__Android/samples_android为示例程序 - [技术支持渠道](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0003.md): 您可以通过关键字在左侧搜索框中搜索本产品的文档,帮助您快速找到需要的文档。开发者社区提供的技术支持渠道如下:开发过程中,您有任何问题可以在华为云对象存储服务论坛中发帖求助。 - [使用前需知](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0101.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。请确认您已经熟悉OBS的基本概念,如桶(Bucket)、对象(Object)、访问密钥(AK和SK)等。您可以先参考OBS客户端通用示例,了解OBS Android SDK接口调用的通用方式。 - [OBS服务环境搭建](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0102.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。使用OBS之前必须要有一个云服务账号。打开浏览器。登录华为云网站。在页面右上角单击“注册”。按需填写注册信息并单击“同意协议并注册”。使用OBS服务之前必须先充值,才能正常使用OBS服务。登录 - [开发环境准备](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0104.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。从Android官网下载并安装Android Studio最新版本。打开安装好的Android Studio,选择Settings -> Appearance & Behavior -> Sy - [安装SDK](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0105.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。使用Android Studio自带的gradle下载安装OBS Android SDK,步骤如下: - [获取服务地址](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0106.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以从这里查看OBS当前开通的服务地址和区域信息。SDK支持带协议名和不带协议名两种方式传入服务地址,例如获取到的服务地址为“your-endpoint”,则初始化OBS客户端时传入的服务地 - [初始化OBS客户端](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0107.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。向OBS发送任一HTTP/HTTPS请求之前,必须先创建一个ObsClient实例:更多关于OBS客户端初始化的操作请参见“初始化”章节。日志配置详见配置SDK日志 - [创建桶](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0108.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。桶是OBS全局命名空间,相当于数据的容器、文件系统的根目录,可以存储若干对象。以下代码展示如何新建一个桶:桶的名字是全局唯一的,所以您需要确保不与已有的桶名称重复。桶命名规则如下:3~63个字 - [上传对象](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0109.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于上传字符串“Hello OBS”到桶名为“bucketname”里,名称为“objectname”。代码示例如下所示:更多上传对象的信息,请参见上传对象。 - [下载对象](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0110.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于下载桶名为“bucketname”里,名称为“objectname”的对象。代码示例如下所示:调用ObsClient.getObject返回一个ObsObject实例,该实例包含对象 - [列举对象](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0111.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。当完成一系列上传对象操作后,可能需要查看桶中包含哪些对象。以下代码展示如何列举指定桶中的对象:调用ObsClient.listObjects返回ObjectListing实例,该实例包含此次l - [删除对象](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0112.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于删除桶名为“bucketname”里,名称为“objectname”的对象。代码示例如下所示:本示例仅用于删除单个对象,OBS批量删除对象,需自行遍历构建待批量删除对象的列表。更丰富 - [OBS客户端通用示例](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0113.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。使用OBS客户端进行接口调用操作完成后,没有异常抛出,则表明返回值有效,返回SDK公共响应头实例或其子类实例;如果抛出异常,则说明操作失败,此时应从SDK自定义异常实例中获取错误信息。OBS客 - [配置密钥](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0201.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。要接入OBS服务,您需要拥有一组有效的访问密钥(AK和SK)用来进行签名认证。具体可参考OBS服务环境搭建。获取AK和SK之后,您便可以按照以下步骤进行初始化。创建OBS客户端配置OBS客户端 - [创建OBS客户端](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0202.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS客户端(ObsClient)是访问OBS服务的Android客户端,它为调用者提供一系列与OBS服务进行交互的接口,用于管理、操作桶(Bucket)和对象(Object)等OBS服务上的 - [配置OBS客户端](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0203.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。当使用配置类(ObsConfiguration)创建OBS客户端(ObsClient)时,您可通过ObsConfiguration配置类对ObsClient进行配置,可配置代理、连接超时、最大 - [配置SDK日志](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0204.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS Android SDK基于java.util.logging库提供了日志功能,您可以通过LogConfigurator.enableLog开启或LogConfigurator.disa - [创建桶](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0301.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.createBucket创建桶。创建桶时可以指定桶ACL、存储类型和区域位置。OBS支持的桶的存储类型有三类,参见桶存储类型。示例代码如下:以下代码展示如何新建一 - [列举桶](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0302.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.listBuckets列举桶。以下代码展示如何获取桶列表:获取到的桶列表将按照桶名字典顺序排列。设置ListBucketsRequest.setQueryLoca - [删除桶](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0303.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.deleteBucket删除桶。以下代码展示如何删除一个桶:如果桶不为空(包含对象或分段上传碎片),则该桶无法删除。删除桶非幂等操作,删除不存在的桶会报错。 - [判断桶是否存在](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0304.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.headBucket接口判断该桶是否已存在。本示例用于判断桶名为“bucketname”是否存在。代码示例如下所示:如果抛出异常且HTTP状态码为404,表明桶不 - [获取桶元数据](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0305.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketMetadata接口获取桶元数据。本示例用于获取桶名为“bucketname”的元数据信息。代码示例如下所示:BucketMetadataInf - [管理桶ACL](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0306.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [管理桶策略](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0307.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。除了桶ACL外,桶的拥有者还可以通过桶策略,提供对桶和桶内对象的集中访问控制。更多关于桶策略的内容请参考桶策略。您可以通过ObsClient.setBucketPolicy设置桶策略。示例代码 - [获取桶区域位置](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0308.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketLocation获取桶的区域位置。本示例用于获取桶名为“bucketname”的区域位置信息。代码示例如下所示:创建桶时可以指定桶的区域位置,请 - [获取桶存量信息](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0309.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。桶存量信息包括桶已使用的空间大小以及桶包含的对象个数。您可以通过ObsClient.getBucketStorageInfo获取桶的存量信息。本示例用于获取桶名为“bucketname”的存量 - [桶配额](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0310.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketQuota设置桶配额。以下代码展示如何设置桶配额:桶配额值必须为非负整数,单位为字节,支持的最大值为263 - 1。您可以通过ObsClient - [桶存储类型](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0311.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS允许您对桶配置不同的存储类型,桶中对象的存储类型默认将与桶的存储类型保持一致。不同的存储类型可以满足客户业务对存储性能、成本的不同诉求。桶的存储类型分为三类,见下表:更多关于桶存储类型的 - [多版本控制简介](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0801.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS支持保存一个对象的多个版本,您可以利用多版本控制,在一个桶中保留多个版本的对象。多版本功能可以方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。在默认情况下,OBS中新创 - [设置桶多版本状态](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0802.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketVersioning设置桶的多版本状态。OBS中的桶支持两种多版本状态:以下代码展示了如何设置桶的多版本状态: - [查看桶多版本状态](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0803.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketVersioning查看桶的多版本状态。本示例用于获取桶名为“bucketname”里的多版本状态。代码示例如下所示:获取桶多版本状态过程中返回 - [生命周期管理简介](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0901.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS允许您对桶设置生命周期规则,实现自动转换对象的存储类型、自动淘汰过期的对象,以有效利用存储特性,优化存储空间。针对不同前缀的对象,您可以同时设置多条规则。一条规则包含:规则ID,用于标识 - [设置生命周期规则](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0902.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketLifecycle设置桶的生命周期规则。以下代码展示了如何设置最新版本对象和历史版本对象的转换策略:以下代码展示了如何设置最新版本对象和历史版本 - [查看生命周期规则](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0903.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketLifecycle查看桶的生命周期规则。本示例用于查看桶名为“bucketname”的生命周期规则。代码示例如下所示:查看生命周期规则过程中返回 - [删除生命周期规则](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0904.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.deleteBucketLifecycle删除桶的生命周期规则。本示例用于删除桶名为“bucketname”的生命周期规则。代码示例如下所示:删除生命周期规则过程 - [跨域资源共享简介](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1001.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。跨域是指不同域名之间相互访问。跨域访问是浏览器出于安全考虑而设置的一个限制,即同源策略。由于JavaScript同源策略的限制,A域名下的JavaScript无法操作B域名或C域名下的对象。同 - [设置跨域规则](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1002.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketCors设置桶的跨域规则,如果原规则存在则覆盖原规则。本示例用于设置桶名为“bucketname”的跨域规则。代码示例如下所示:AllowedO - [查看跨域规则](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1003.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketCors查看桶的跨域规则。本示例用于查看桶名为“bucketname”的跨域规则。代码示例如下所示:查看跨域规则过程中返回的错误码含义、问题原因 - [删除跨域规则](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1004.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.deleteBucketCors删除桶的跨域规则。本示例用于删除桶名为“bucketname”的跨域规则。代码示例如下所示:删除跨域规则过程中返回的错误码含义、问 - [日志简介](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1101.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS允许您对桶设置访问日志记录,设置之后对于桶的访问会被记录成日志,日志存储在OBS上您指定的目标桶中。出于分析或审计等目的,用户可以开启日志记录功能。通过访问日志记录,桶的拥有者可以深入分 - [开启桶日志](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1102.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketLogging开启桶日志功能。日志目标桶与源桶必须在同一个区域(region)。如果桶的存储类型为低频访问存储或归档存储,则不能作为日志目标桶。 - [查看桶日志配置](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1103.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketLogging查看桶日志配置。本示例用于查看桶名为“bucketname”的日志配置。代码示例如下所示:查看桶日志过程中返回的错误码含义、问题原 - [关闭桶日志](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1104.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。关闭桶日志功能实际上就是调用ObsClient.setBucketLogging将日志配置清空。本示例用于关闭桶名为“bucketname”的日志配置。代码示例如下所示:关闭桶日志过程中返回的 - [静态网站托管简介](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1201.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。静态网站通常仅包含静态网页,以及可能包含部分可在客户端运行的脚本,如JavaScript、Flash等。相比之下,动态网站则依赖于服务器端处理脚本,包括PHP、JSP或ASP.Net等。您可以 - [网站文件托管](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1202.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可通过以下步骤实现网站文件托管:以下代码展示了如何实现网站文件托管:上例中您可以使用https://bucketname.your-endpoint/test.html在浏览器直接访问托管的 - [设置托管配置](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1203.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketWebsite设置桶的托管配置。以下代码展示了如何配置默认主页和错误页面:以下代码展示了如何配置重定向规则:以下代码展示了如何配置所有请求重定向 - [查看托管配置](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1204.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketWebsite查看桶的托管配置。本示例用于查看桶名为“bucketname”的托管配置。代码示例如下所示:查看桶托管配置过程中返回的错误码含义、 - [清除托管配置](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1205.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.deleteBucketWebsite清除桶的托管配置。本示例用于清除桶名为“bucketname”的托管配置。代码示例如下所示:清除桶托管配置过程中返回的错误码 - [标签简介](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1301.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。标签用于标识OBS中的桶,以此来达到对OBS中的桶进行分类的目的。更多关于桶标签的内容请参考标签。 - [设置桶标签](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1302.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketTagging设置桶标签。以下代码展示了如何设置桶标签:每个桶支持最多10个标签。标签的Key和Value支持Unicode。 - [查看桶标签](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1303.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketTagging查看桶标签。以下代码展示了如何查看桶标签: - [删除桶标签](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1304.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.deleteBucketTagging删除桶标签。以下代码展示了如何删除桶标签: - [事件通知简介](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1401.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS消息通知功能能够帮助您对桶的重要的操作及时通知到您,确保您安全、及时知道发生在桶上的关键事件。目前对象存储服务(OBS)支持包括简单通知服务(SMN)、函数工作流服务(FunctionG - [设置事件通知](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1402.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setBucketNotification设置桶的事件通知。在该操作前,需要在消息通知服务SMN创建主题,并设置主题策略为OBS。以下代码展示了如何设置桶的事件通 - [查看事件通知](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1403.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getBucketNotification查看桶的事件通知。以下代码展示了如何查看桶的事件通知: - [关闭事件通知](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1404.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。关闭桶事件通知实际上就是调用ObsClient.setBucketNotification将事件通知配置清空,以下代码展示了如何清除桶的事件通知: - [服务端加密简介](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1501.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS支持服务端加密功能,使对象加密的行为在OBS服务端进行。更多关于服务端加密的内容请参考服务端加密。 - [加密说明](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1502.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS Android SDK支持服务端加密的接口见下表: - [加密示例](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1503.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。以下代码展示了在上传对象时使用服务端加密功能:设置SSE-C方式下使用的密钥,请参考如何生成SSE-C方式的加密密钥。更多关于服务端加密的内容请参考服务端加密SSE-C方式。以下代码展示了在下 - [对象上传简介](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0401.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。在OBS中,用户操作的基本数据单元是对象。OBS Android SDK提供了丰富的对象上传接口,可以通过以下方式上传对象:流式上传文件上传分段上传追加上传断点续传上传基于表单上传SDK支持上 - [流式上传](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0402.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。流式上传使用java.io.InputStream作为对象的数据源。您可以通过ObsClient.putObject上传您的数据流到OBS。以下代码展示了如何进行流式上传:推荐使用文件上传的形 - [文件上传](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0403.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。使用SDK管理OBS资源,您需要先根据SDK 安装了解并选择合适的SDK版本,然后下载SDK并完成安装。文件上传使用本地文件作为对象的数据源。以下代码展示了如何进行文件上传:上传内容大小不能超 - [获取上传进度](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0404.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过PutObjectRequest.setProgressListener设置数据传输接口来获取上传的进度。示例代码如下:支持获取上传进度的接口包括:流式上传、文件上传、上传段、追加上 - [追加上传](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0409.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。追加上传可实现对同一个对象追加数据内容的功能。您可以通过ObsClient.appendObject进行追加上传。示例代码如下:ObsClient.putObject上传的对象可覆盖ObsCl - [基于表单上传](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0412.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。基于表单上传是使用HTML表单形式上传对象到指定桶中,对象最大不能超过5GB。您可以通过ObsClient.createPostSignature生成基于表单上传的请求参数。使用代码模拟表单上 - [对象下载简介](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0501.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS Android SDK提供了丰富的对象下载接口,可以通过以下方式下载对象:流式下载范围下载断点续传下载您可以通过ObsClient.getObject下载对象。 - [流式下载](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0502.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。以下代码展示了如何进行流式下载:ObsClient.getObject的返回实例ObsObject实例包含对象所在的桶、对象名、对象属性、对象输入流等。通过操作对象输入流可将对象的内容读取到本 - [范围下载](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0503.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。如果只需要下载对象的其中一部分数据,可以使用范围下载,下载指定范围的数据。如果指定的下载范围是0~1000,则返回第0到第1000个字节的数据,包括第1000个,共1001字节的数据,即[0, - [获取下载进度](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0504.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过GetObjectRequest.setProgressInterval设置数据传输接口来获取下载的进度。本示例用于下载桶名为“bucketname”里,名称为“objectname - [限定条件下载](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0505.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。下载对象时,可以指定一个或多个限定条件,满足限定条件时则进行下载,否则抛出异常,下载对象失败。您可以使用的限定条件如下:对象的ETag值是指对象数据的MD5校验值。如果包含If-Unmodif - [下载归档存储对象](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0508.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。如果要下载归档存储对象,需要先将归档存储对象恢复。恢复归档存储对象的恢复选项可支持两类,见下表:重复恢复归档存储数据时在延长恢复有效期的同时,也将会对恢复时产生的恢复费用进行重复收取。产生的标 - [设置对象属性](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0406.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以在上传对象时设置对象属性。对象属性包含对象长度、对象MIME类型、对象MD5值(用于校验)、对象自定义元数据。对象属性可以在多种上传方式下(流式上传、文件上传、分段上传),或复制对象时进 - [创建文件夹](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0405.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS本身是没有文件夹的概念的,桶中存储的元素只有对象。创建文件夹实际上是创建了一个大小为0且对象名以“/”结尾的对象,这类对象与其他对象无任何差异,可以进行下载、删除等操作,只是OBS控制台 - [设置对象生命周期](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0408.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。上传对象或者初始化分段上传任务时,您可以直接指定对象的过期时间。示例代码如下:该方式仅支持设置以天为单位的对象过期时间,过期后的对象会被OBS服务端自动清理。该方式设置的对象过期时间,其优先级 - [重写响应头](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0506.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。下载对象时,可以重写部分HTTP/HTTPS响应头信息。可重写的响应头信息见下表:以下代码展示了如何重写响应头: - [获取自定义元数据](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0507.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。下载对象成功后会返回对象的自定义元数据。以下代码展示了如何获取自定义元数据:ObsClient.getObject的返回实例ObsObject实例包含对象所在的桶、对象名、对象属性、对象输入流 - [图片处理](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0510.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS为用户提供了稳定、安全、高效、易用、低成本的图片处理服务。当要下载的对象是图片文件时,您可以通过传入图片处理参数对图片文件进行图片剪切、图片缩放、图片水印、格式转换等处理。以下代码展示了 - [复制对象](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0605.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。复制对象特性用来为OBS上已经存在的对象创建一个副本。您可以通过ObsClient.copyObject来复制对象。复制对象时,可重新指定新对象的属性和设置对象权限,且支持条件复制。如果待复制 - [删除对象](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0604.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。请您谨慎使用删除操作,如果对象所在的桶未开启多版本控制功能,该对象一旦删除将无法恢复。您可以通过ObsClient.deleteObject删除单个对象。以下代码展示如何删除单个对象:您可以通 - [列举对象](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0603.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.listObjects列举出桶里的对象。该接口可设置的参数如下:以下代码展示如何简单列举对象,最多返回1000个对象:每次至多返回1000个对象,如果指定桶包含的 - [管理对象ACL](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0602.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [设置对象属性](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0606.md): 您可以通过ObsClient.setObjectMetadata来设置对象属性,包括对象自定义元数据等信息。除了 HTTP 标准头域外,您也可以指定自定义元数据,自定义元数据仅支持英文字符、数字与中划线【-】。以下代码展示了如何设置对象属性:以下代码展示了如何设置对象过期时间:由于 HTTP 编码规范限制,无法发送非 ASCII 码字符, - [获取对象属性](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0601.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getObjectMetadata来获取对象属性,包括对象长度,对象MIME类型,对象自定义元数据等信息。以下代码展示了如何获取对象属性:由于 HTTP 编码规范 - [普通上传设置上传回调](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0413.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以在上传对象请求(PutObject)中设置回调参数,OBS在对象上传成功之后,将上传结果回调特定服务器,并将回调结果返回给您。此示例用于普通上传对象(PutObject)时设置上传回调: - [分段上传](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0407.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。对于较大文件上传,可以切分成段上传。用户可以在如下的应用场景内(但不仅限于此),使用分段上传的模式:上传超过100MB大小的文件。网络条件较差,和OBS服务端之间的连接经常断开。上传前无法确定 - [分段复制](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0410.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。分段复制是分段上传的一种特殊情况,即分段上传任务中的段通过复制OBS指定桶中现有对象(或对象的一部分)来实现。您可以通过ObsClient.copyPart来复制段。本示例用于分段复制桶名为“ - [断点续传上传](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0411.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。当上传大文件时,经常出现因网络不稳定或程序崩溃导致上传失败的情况。失败后再次重新上传不仅浪费资源,而且当网络不稳定时仍然有上传失败的风险。断点续传上传接口能有效地解决此类问题引起的上传失败,其 - [异步断点续传上传](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0415.md): 异步断点续传上传是异步执行的断点续传上传,并且支持暂停、取消、继续等功能。其原理是创建一个子线程,在子线程中进行断点续传上传,上传失败产生异常时可以通过回调获取异常,上传成功时可以从task中获取Optional封装的结果。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细 - [断点续传下载](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0509.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。当下载大对象到本地时,经常出现因网络不稳定或程序崩溃导致下载失败的情况。失败后再次重新下载不仅浪费资源,而且当网络不稳定时仍然有下载失败的风险。断点续传下载接口能有效地解决此类问题引起的下载失 - [获取多版本对象](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0804.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.getObject接口传入版本号(versionId)来获取多版本对象。本示例用于下载桶名为“bucketname”里,名称为“objectname”,指定Ver - [复制多版本对象](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0805.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.copyObject接口传入版本号(versionId)来复制多版本对象。本示例用于通过设置versionId复制sourcebucketname桶中source - [恢复多版本归档存储对象](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0806.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.restoreObject接口传入版本号(versionId)来恢复多版本归档存储对象。本示例用于通过设置versionId值将destbucketname桶中d - [列举多版本对象](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0807.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.listVersions列举多版本对象。该接口可设置的参数如下:如果versionIdMarker不是keyMarker的一个版本号,则该参数无效。ObsClie - [多版本对象ACL](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0808.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.setObjectAcl接口传入版本号(versionId)设置多版本对象ACL,示例代码如下:ACL中需要填写的所有者(Owner)或者被授权用户(Grante - [删除多版本对象](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0809.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient.deleteObject接口传入版本号(versionId)删除多版本对象。本示例用于通过设置多版本对象的VersionId值,删除桶名为“bucketname” - [使用临时URL进行授权访问](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_0701.md): 开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS客户端支持通过访问密钥、请求方法类型、请求参数等信息生成一个在Query参数中携带鉴权信息的URL,可将该URL提供给其他用户进行临时访问。在生成URL时,您需要指定URL的有效期来限制 - [SDK错误码](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1608.md): SDK错误码是由ObsClient统一抛出的异常。通常是OBS服务端错误,包含OBS错误码、错误信息等,便于用户定位问题,并做出适当的处理。SDK错误码包含两部分:对象存储服务的API错误码,详见OBS错误码。SDK自定义异常,详见表1。SDK自定义异常异常异常描述ObsException.getResponseCode()HTTP状态码 - [SDK公共响应头](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1602.md): 调用ObsClient类的相关接口成功后,均会返回公共响应头类,即HeaderResponse类实例(或其子类实例),该类包含了HTTP/HTTPS的响应头信息。处理公共响应头的示例代码如下: - [日志分析](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1603.md): OBS Android SDK的日志路径是通过LogConfigurator.setLogFileDir指定的,默认存放于SD卡的logs目录下。日志文件名为:OBS-SDK.log。SDK日志格式为:日志时间|线程号|日志级别|日志内容。示例如下:当系统出现问题需要定位且当前的日志无法满足要求时,可以通过修改日志的级别来获取更多的信息。 - [缺少类错误](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1604.md): 使用 OBS Android SDK 进行二次开发时如果报缺少类错误,请检查libs目录下除esdk-obs-java-x.x.x.jar外是否包含以下依赖库:java-xmlbuilder-1.3.jarokhttp-4.8.0.jarokio-2.7.0.jar - [连接超时异常](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1605.md): 如果通过ObsException.getResponseCode获取到的错误码为408,表明连接OBS服务超时。出现这类异常的原因如下:1. 服务地址(Endpoint)错误或网络不通导致无法连接OBS服务,此时请检查服务地址和网络状况。2. 客户端到OBS服务端的网络时延过大,请检查客户端到OBS服务端的网络健康状况。 - [资源无法释放](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1606.md): 如果发现使用OBS Android SDK后存在内存泄露或OBS服务端连接未断开等情况,请按如下办法解决:1. 请检查是否正确调用了ObsClient.close。2. 请检查是否正确调用了ObsObject.getObjectContent.close释放资源。 - [签名不匹配异常](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1607.md): 如果从ObsException中获取到HTTP状态码为403,OBS服务端错误码为SignatureDoesNotMatch。此类错误一般有如下原因:初始化ObsClient时传入的SK有误,请检查SK,确保正确。旧版本OBS Android SDK的BUG,请升级SDK到最新版本。初始化ObsClient时传入的endpoint有误,请 - [报错NetworkOnMainThreadException](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1609.md): NetworkOnMainThreadException 一般是因为网络请求在MainThread类中产生的异常。原因:Android3.0版本开始,强制程序不能在主线程中访问网络,要把访问网络放在独立的线程中。解决办法:1. 为了防止访问网络阻塞主线程,一般都要把访问网络放在独立线程中或者异步线程AsyncTask中。2. 建议和网络请 - [SDK是否支持批量上传、下载或复制对象?](https://support.huaweicloud.com/sdk-android-devg-obs/obs_26_1711.md): 不支持。目前SDK暂未提供此类接口,您需要自己封装批量上传、下载或复制对象的业务代码。步骤如下:以批量上传对象为例,示例代码如下:您可以使用多线程并发执行上传/下载/复制操作,以提高效率。 - [SDK下载](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0001.md): OBS SDK合规使用指南请单击此处;OBS SDK隐私声明请单击此处。OBS iOS SDK的最新版本:OBS iOS SDKSDK API文档地址: SDK API文档iOS兼容性:推荐使用iOS 8.0-12.3.1版本。开发工具兼容性:推荐使用Xcode 8.0-10.0版本。接口函数:与旧版本(V2.1.4)不再兼容。iOS S - [技术支持渠道](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0003.md): 您可以通过关键字在左侧搜索框中搜索本产品的文档,帮助您快速找到需要的文档。开发者社区提供的技术支持渠道如下:开发过程中,您有任何问题可以在华为云对象存储服务论坛中发帖求助。 - [使用前须知](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0101.md): 请确认您已经熟悉OBS的基本概念,如桶(Bucket)、对象(Object)、访问密钥(AK和SK)等。您可以先参考OBS客户端通用示例,了解OBS iOS SDK接口调用的通用方式。 - [OBS服务环境搭建](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0102.md): 使用OBS之前必须要有一个云服务账号。打开浏览器。登录公有云网站。在页面右上角单击“注册”。按需填写注册信息并单击“同意协议并注册”。使用OBS服务之前必须先充值,才能正常使用OBS服务。登录管理控制台。单击页面右上角的“费用和成本”进入费用中心页面。选择“资金管理 > 充值”,系统自动跳转到充值窗口。根据界面提示信息,对账户进行充值。充 - [安装SDK](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0105.md): 从Xcode官网下载并安装最新版Xcode。“-force_load$(SRCROOT)/XXX/OBS.framework/OBS”其中“XXX”代表OBS.framework在工程文件夹下的位置。常见问题 - [初始化OBS客户端](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0107.md): 向OBS发送任一HTTP/HTTPS请求之前,必须先创建一个OBSClient实例。以下代码展示如何创建客户端:更多OBS客户端初始化的内容请参考“初始化”章节。 - [创建桶](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0108.md): 桶是OBS全局命名空间,相当于数据的容器、文件系统的根目录,可以存储若干对象。以下代码展示如何新建一个桶:桶的名字是全局唯一的,所以您需要确保不与已有的桶名称重复。桶命名规则如下:3~63个字符,数字或字母开头,支持小写字母、数字、“-”、“.”。禁止使用IP地址。禁止以“-”或“.”开头及结尾。禁止两个“.”相邻(如:“my..buck - [上传对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0109.md): 本示例用于将本地文件上传到桶名为“bucketname”里,名称为“objectname”。代码示例如下:当前SDK的文件上传接口(OBSPutObjectWithFileRequest、OBSUploadFileRequest)的uploadFilePath参数仅接受NSString类型的文件路径,不支持直接传入[NSURL fileU - [下载对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0110.md): 以下代码展示如何获取对象的内容:调用getObject返回一个OBSObject实例,该实例包含对象内容及其属性。更多下载对象的信息,请参见下载对象。 - [列举对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0111.md): 当完成一系列上传对象操作后,可能需要查看桶中包含哪些对象。以下代码展示如何列举指定桶中的对象:调用listObjects返回OBSListObjectsResponse实例,该实例包含此次listObject请求的返回结果。上面的代码默认列举1000个对象(Object)。更丰富的列举功能,请参见列举对象。 - [删除对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0112.md): 本示例用于删除桶名为“bucketname”里,名称为“objectname”的对象。代码示例如下:更多删除对象的信息,请参见删除对象。 - [OBS客户端通用示例](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0113.md): 调用OBSClient类的相关接口时,没有错误产生则说明调用成功;当有错误产生时,则说明操作失败。以下代码展示了使用OBS客户端的通用方式:在调用OBSClient类的相关接口时,如果将Client声明为局部变量,则应该通过对请求任务执行waitUntilFinished操作以保证Client在请求任务执行期间始终有效,否则可能造成网络请 - [配置密钥](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0201.md): 要接入OBS服务,您需要拥有一组有效的访问密钥(AK和SK)用来进行签名认证。具体可参考OBS服务环境搭建。获取AK和SK之后,您便可以按照以下步骤进行初始化。创建OBS客户端配置OBS客户端 - [创建OBS客户端](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0202.md): OBS客户端(OBSClient)是访问OBS服务的iOS客户端,它为调用者提供一系列与OBS服务进行交互的接口,用于管理、操作桶(Bucket)和对象(Object)等OBS服务上的资源。使用OBS iOS SDK向OBS发起请求,您需要初始化一个OBSClient实例,并根据需要修改OBSServiceConfiguration的默认 - [配置OBS客户端](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0203.md): 您可通过OBSServiceConfiguration配置类对OBSClient进行配置,可配置代理、连接超时、最大连接数等参数。通过OBSServiceConfiguration可以设置的参数见下表:建议值为N/A的表示需要根据实际情况进行设置。出于安全性考虑,endpoint建议使用https协议。OBSStaticCredentia - [创建桶](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0301.md): 您可以通过createBucket创建桶。以下代码展示如何新建一个桶:桶的名字是全局唯一的,所以您需要确保不与已有的桶名称重复。桶命名规则如下:3~63个字符,数字或字母开头,支持小写字母、数字、“-”、“.”。禁止使用IP地址。禁止以“-”或“.”开头及结尾。禁止两个“.”相邻(如:“my..bucket”)。禁止“.”和“-”相邻(如 - [列举桶](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0302.md): 您可以通过listBuckets来列举桶。代码示例如下:获取到的桶列表将按照桶名字典顺序排列。 - [删除桶](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0303.md): 您可以通过deleteBucket来删除桶。以下代码展示如何删除桶:如果桶不为空(包含对象或分段上传碎片),则该桶无法删除。删除桶非幂等操作,删除不存在的桶会报错。 - [获取桶元数据](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0304.md): 您可以通过getBucketMetaData获取桶元数据。代码示例如下:获取桶元数据过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [管理桶ACL](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0305.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [获取桶区域位置](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0306.md): 您可以通过getBucketLocation获取桶的区域位置。代码示例如下:创建桶时可以指定桶的区域位置,请参见创建桶。 - [管理桶策略](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0307.md): 除了桶ACL外,桶的拥有者还可以通过桶策略,提供对桶和桶内对象的集中访问控制。更多关于桶策略的内容请参考桶策略。您可以通过setBucketPolicy设置桶策略。示例代码如下:桶策略内容的具体格式(JSON格式字符串)请参考《对象存储服务API参考》。您可以通过getBucketPolicy获取桶策略。示例代码如下:您可以通过delet - [获取桶存量信息](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0308.md): 桶存量信息包括桶已使用的空间大小以及桶包含的对象个数。您可以通过getBucketStorageInfo获取桶的存量信息。以下代码展示如何获取桶存量信息:获取桶存量信息过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [桶配额](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0309.md): 您可以通过setBucketQuota设置桶配额。以下代码展示如何设置桶配额:桶配额值必须为非负整数,单位为字节,支持的最大值为263 - 1。您可以通过getBucketQuota获取桶配额。以下代码展示如何获取桶配额: - [桶存储类型](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0310.md): OBS允许您对桶配置不同的存储类型,桶中对象的存储类型默认将与桶的存储类型保持一致。不同的存储类型可以满足客户业务对存储性能、成本的不同诉求。桶的存储类型分为三类,见下表:更多关于桶存储类型的内容请参考桶的存储类别。您可以通过setBucketStoragePolicy设置桶存储类型。以下代码展示如何设置桶存储类型:您可以通过getBuc - [生命周期管理简介](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0901.md): OBS允许您对桶设置生命周期规则,实现自动转换对象的存储类型、自动淘汰过期的对象,以有效利用存储特性,优化存储空间。针对不同前缀的对象,您可以同时设置多条规则。一条规则包含:规则ID,用于标识一条规则,不能重复。受影响的对象前缀,此规则只作用于符合前缀的对象。最新版本对象的转换策略,指定方式为:指定满足前缀的对象创建后第几天时转换为指定的 - [设置生命周期规则](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0902.md): 您可以通过setBucketLifecycle设置桶的生命周期规则。以下代码展示了如何设置最新版本对象和历史版本对象的转换策略:以下代码展示了如何设置最新版本对象和历史版本对象的过期时间: - [查看生命周期规则](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0903.md): 您可以通过getBucketLifecycle查看桶的生命周期规则,以下代码展示了如何查看桶的生命周期规则:查看生命周期规则过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [删除生命周期规则](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0904.md): 您可以通过deleteBucketLifecycle删除桶的生命周期规则,以下代码展示了如何删除桶的生命周期规则:static OBSClient *client; NSString *endPoint = @"https://your-endpoint"; // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险,建议在配置 - [跨域资源共享简介](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1001.md): 跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全策略(Same Origin Policy,SOP)的存在,不同域之间的网站脚本和内容是无法进行交互 - [设置跨域规则](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1002.md): 您可以通过setBucketCORS设置桶的跨域规则,如果原规则存在则覆盖原规则。以下代码展示了如何设置跨域规则:设置跨域规则过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [查看跨域规则](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1003.md): 您可以通过getBucketCORS查看桶的跨域规则。以下代码展示了如何查看跨域规则:查看跨域规则过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [删除跨域规则](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1004.md): 您可以通过deleteBucketCORS删除桶的跨域规则。以下代码展示了如何删除跨域规则:删除跨域规则过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [静态网站托管简介](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1201.md): 您可以将静态网站文件上传至OBS的桶中作为对象,并对这些对象赋予公共读权限,然后将该桶配置成静态网站托管模式,以实现在OBS上托管静态网站的目的。第三方用户在访问您网站的时候,实际上是在访问OBS的桶中的对象。在使用静态网站托管功能时,OBS还支持配置请求重定向,通过重定向配置您可以将特定的请求或所有请求实施重定向。您可通过以下步骤实现网 - [设置托管配置](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1202.md): 您可以通过setBucketWebsite设置桶的托管配置。以下代码展示了如何配置默认主页和错误页面:以下代码展示了如何配置所有请求重定向: - [查看托管配置](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1203.md): 您可以通过getBucketWebsite查看桶的托管配置。以下代码展示了如何查看托管配置:查看托管配置过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [清除托管配置](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1204.md): 您可以通过deleteBucketWebsite清除桶的托管配置。以下代码展示了如何清除托管配置:清除托管配置过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [日志简介](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1101.md): 调用设置桶日志管理配置接口,您可以为指定桶打开桶日志功能,并配置日志存放的目标桶。创建桶时,默认是不生成桶的日志的,调用IOS SDK的设置桶日志管理配置接口时,接口会自动为您打开桶日志配置。桶日志功能开启后,桶的每次操作将会产生一条日志,并将多条日志打包成一个日志文件。日志文件存放位置需要在开启桶日志功能时指定,可以存放到开启日志功能的 - [开启桶日志](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1102.md): 您可以通过setBucketLogging开启桶日志功能。日志目标桶与源桶必须在同一个区域(region)。已支持日志目标桶的存储类型:低频访问存储或归档存储或标准存储。以下代码展示了如何开启桶日志: - [查看桶日志配置](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1103.md): 您可以通过getBucketLogging查看桶日志配置。以下代码展示了如何查看桶日志配置:查看桶日志配置过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [关闭桶日志](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1104.md): 关闭桶日志功能实际上就是调用setBucketLogging将日志配置清空,以下代码展示了如何关闭桶日志:关闭桶日志配置过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [标签简介](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1301.md): 标签用于标识OBS中的桶,以此来达到对OBS中的桶进行分类的目的。为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,我们可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的标签来分析此应用的成本。更多关 - [设置桶标签](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1302.md): 您可以通过setBucketTagging设置桶标签。以下代码展示了如何设置桶标签:每个桶支持最多10个标签。标签的key和value支持unicode。 - [查看桶标签](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1303.md): 您可以通过getBucketTagging查看桶标签。以下代码展示了如何查看桶标签:查看桶标签过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [删除桶标签](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1304.md): 您可以通过deleteBucketTagging删除桶标签。以下代码展示了如何删除桶标签:删除桶标签过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [事件通知简介](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1401.md): OBS提供了事件通知功能,当启用通知功能后,桶上所发生的指定操作都会通过消息通知服务(SMN)发送给您。事件通知配置包含:配置ID,如果用户未指定,则OBS自动分配一个ID。事件通知主题的URN(Topic),当OBS检测到桶中特定的事件后,将会发布通知消息至该主题。需要发布通知消息的事件类型列表。过滤规则配置,用以匹配对象名前缀或者后缀 - [设置事件通知](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1402.md): 您可以通过setBucketNotification设置桶的事件通知。以下代码展示了如何设置桶的事件通知: - [查看事件通知](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1403.md): 您可以通过getBucketNotification查看桶的事件通知。以下代码展示了如何查看桶的事件通知: - [关闭事件通知](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1404.md): 关闭桶事件通知实际上就是调用setBucketNotification将事件通知配置清空,以下代码展示了如何清除桶的事件通知: - [服务端加密简介](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1501.md): 如果您的业务对数据存储的安全性和合规性有较高要求,可使用OBS提供的服务端加密功能,对上传到OBS存储的数据进行加密保护。服务器端加密是指OBS服务端对客户端上传到OBS的对象进行加密存储。在访问对象时,由OBS服务端对文件进行解密,然后向客户端返回解密后的数据。IOS SDK支持SSE-KMS、SSE-C两种加密方式 。更多关于服务端加 - [加密说明](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1502.md): OBS iOS SDK支持服务端加密的接口见下表: - [加密示例](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1503.md): 以下代码展示了在上传对象时如何使用服务端加密功能:SSE-C加密key:密钥通过AES256加密生成。keyMD5:密钥通过MD5生成值,再将此值通过base64加密。SSE-KMS加密以下代码展示了在下载对象时使用服务端解密功能:当前SDK的文件上传接口(OBSPutObjectWithFileRequest、OBSUploadFile - [多版本控制简介](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0801.md): OBS支持保存一个对象的多个版本,您可以利用多版本控制,在一个桶中保留多个版本的对象。多版本功能可以方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。在默认情况下,OBS中新创建的桶不会开启多版本功能,向同一个桶上传同名的对象时,新上传的对象将覆盖原有的对象。更多关于多版本控制的内容请参见多版本控制。 - [设置桶多版本状态](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0802.md): 您可以通过setBucketVersioning设置桶的多版本状态。OBS中的桶支持两种多版本状态:以下代码展示了如何设置桶的多版本状态: - [查看桶多版本状态](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0803.md): 您可以通过getBucketVersioning查看桶的多版本状态。以下代码展示了如何查看桶的多版本状态:查看桶多版本状态过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [对象上传简介](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0401.md): 在OBS中,用户操作的基本数据单元是对象。OBS iOS SDK提供了丰富的对象上传接口,可以通过以下方式上传对象:流式上传文件上传分段上传追加上传断点续传上传SDK支持上传0KB~5GB的对象。流式上传、文件上传和追加上传的内容大小不能超过5GB;当上传较大文件时,请使用分段上传,分段上传每段内容大小不能超过5GB。如果上传的对象权限设 - [流式上传](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0402.md): 流式上传使用OBSPutObjectWithDataRequest作为对象的数据源。您可以通过putObject上传您的数据流到OBS。以下代码展示了如何进行流式上传:推荐使用文件上传的形式上传本地文件,而不是文件流形式。大文件上传建议使用分段上传。上传的内容大小不能超过5GB。 - [文件上传](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0403.md): 使用SDK管理OBS资源,您需要先根据SDK下载了解并选择合适的SDK版本,然后下载SDK并完成安装。文件上传使用本地文件作为对象的数据源。以下代码展示了如何进行文件上传:当前SDK的文件上传接口(OBSPutObjectWithFileRequest、OBSUploadFileRequest)的uploadFilePath参数仅接受NS - [创建文件夹](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0404.md): OBS本身是没有文件夹的概念的,桶中存储的元素只有对象。创建文件夹实际上是创建了一个大小为0且对象名以“/”结尾的对象,这类对象与其他对象无任何差异,可以进行下载、删除等操作,只是OBS控制台会将这类以“/”结尾的对象以文件夹的方式展示。创建文件夹本质上来说是创建了一个大小为0且对象名以“/”结尾的对象。多级文件夹创建最后一级即可,比如s - [设置对象属性](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0405.md): 您可以在上传对象时设置对象属性。对象属性包含对象MD5值(用于校验)、对象存储类型、对象自定义元数据。对象属性可以在多种上传方式下(流式上传、文件上传、分段上传),或复制对象时进行设置。对象属性详细说明见下表:您可以通过contentMD5来设置对象MD5值。以下代码展示如何设置对象MD5值:对象数据的MD5值必须经过Base64编码。O - [追加上传](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0408.md): 追加上传可实现对同一个对象追加数据内容的功能。您可以通过appendObject进行追加上传。示例代码如下:NSString *filePath = [[NSBundle mainBundle] pathForResource:@"FileName" ofType:@"FileSuffix"]; //第一次追加上传 OBS - [批量上传](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0509.md): 本示例用于批量上传本地文件到OBS桶中。您可以指定本地文件路径和目标对象Key的映射关系,以指定并发数并发上传,上传过程实时显示每个文件的进度和ETag,适用于批量迁移、资料同步等场景。#import #import #pragma mark - Result M - [下载对象简介](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0501.md): OBS iOS SDK提供了丰富的对象下载接口,可以通过以下方式下载对象:流式下载范围下载断点续传下载您可以通过getObject下载对象。 - [流式下载](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0502.md): 以下代码展示了如何进行流式下载:流式下载过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。获取对象自定义元数据,在下载对象成功后response中包含了对象的元数据(mataDataDict)里。 - [范围下载](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0503.md): 如果只需要下载对象的其中一部分数据,可以使用范围下载,下载指定范围的数据。如果指定的下载范围是0~1000,则返回第0到第1000个字节的数据,包括第1000个,共1001字节的数据,即[0,1000]。如果指定的范围无效,则返回整个对象的数据。以下代码展示了如何进行范围下载:如果指定的范围无效(比如开始位置、结束位置为负数,大于文件大小 - [限定条件下载](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0504.md): 下载对象时,可以指定一个或多个限定条件,满足限定条件时则进行下载,否则抛出异常,下载对象失败。您可以使用的限定条件如下:对象的ETag值是指对象数据的MD5校验值。如果限制条件不符合,则会返回错误preconditionFailed。以下代码展示了如何进行限定条件下载:当使用OBSGetObjectToFileRequest时,可以设置b - [批量下载](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0510.md): 本示例用于批量下载OBS桶中的对象到本地目录。您可以通过列举满足前缀条件的对象,再以指定并发数并发下载,文件按原Key结构保存到本地目录,适用于批量导出、离线备份等场景。 - [重写响应头](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0505.md): 下载对象时,可以重写部分HTTP/HTTPS响应头信息。可重写的响应头信息见下表:以下代码展示了如何重写响应头: - [下载归档存储对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0507.md): 如果要下载归档存储对象,需要先将归档存储对象恢复。恢复选项分为以下两类,见下表:重复恢复归档或深度归档存储数据时,系统将延长恢复有效期。同时,将对恢复操作产生的费用进行重复收取。您可以通过OBSRestoreObjectRequest恢复归档存储对象。以下代码展示了如何下载归档存储对象: - [断点续传下载](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0508.md): 当下载大对象到本地文件时,经常出现因网络不稳定或程序崩溃导致下载失败的情况。失败后再次重新下载不仅浪费资源,而且当网络不稳定时仍然有下载失败的风险。断点续传下载接口能有效地解决此类问题引起的下载失败,其原理是将待下载的对象分成若干个分段分别下载,并实时地将每段下载结果统一记录在checkpoint文件中,仅当所有分段都下载成功时返回下载成 - [设置对象生命周期](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0407.md): 上传对象时,您可以直接指定对象的过期时间。示例代码如下:上述方式仅支持设置以天为单位的对象过期时间,过期后的对象会被OBS服务端自动清理。上述方式设置的对象过期时间,其优先级高于桶生命周期规则。 - [复制对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0605.md): 复制对象特性用来为OBS上已经存在的对象创建一个副本。您可以通过copyObject来复制对象。复制对象时,可重新指定新对象的属性和设置对象权限,且支持条件复制。以下代码展示了如何进行简单复制:以下代码展示了如何在复制对象时重写对象属性:复制对象时,可以指定一个或多个限定条件,满足限定条件时则进行复制,否则抛出异常,复制对象失败。您可以使 - [批量复制对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0511.md): 本示例用于批量复制OBS中的对象,支持同桶复制和跨桶复制。您可以指定源对象Key和目标对象Key的对应关系,以指定并发数并发执行复制操作,并可选保留源对象元数据或替换为新元数据,适用于数据迁移、跨区域备份等场景。 - [删除对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0604.md): 您可以通过deleteObject删除单个对象。以下代码展示如何删除单个对象:您可以通过deleteObjects批量删除对象。每次最多删除1000个对象,并支持两种响应模式:详细(verbose)模式和简单(quiet)模式。详细模式:返回的删除成功和删除失败的所有结果,默认模式。简单模式:只返回的删除过程中出错的结果。以下代码展示了如 - [列举对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0603.md): 您可以通过listObjects列举出桶里的对象。该接口可设置的参数如下:以下代码展示如何简单列举对象,最多返回1000个对象:每次至多返回1000个对象,如果指定桶包含的对象数量大于1000,则返回结果中response.isTruncated为YES表明本次没有返回全部对象,并可通过response.nextMarker获取下次列举的 - [管理对象ACL](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0602.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [恢复归档存储对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0512.md): 如果要下载归档存储对象,需要先将归档存储对象恢复。恢复选项分为以下两类,见下表:重复恢复归档或深度归档存储数据时,系统将延长恢复有效期。同时,将对恢复操作产生的费用进行重复收取。您可以通过OBSRestoreObjectRequest恢复归档存储对象。以下代码展示了如何恢复归档存储对象: - [批量恢复归档存储对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0513.md): 本示例用于批量恢复归档存储中的对象。您可以指定待恢复的对象Key列表、恢复速率(Expedited/Standard)和保留天数,并发发起恢复请求,适用于大规模归档数据的批量恢复场景。 - [获取对象属性](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0601.md): 您可以通过getObjectMetaData来获取对象属性,包括对象长度,对象MIME类型,对象自定义元数据等信息。以下代码展示了如何获取对象属性:获取对象属性过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [分段上传](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0406.md): 用户可以在如下的应用场景内(但不仅限于此),使用分段上传的模式:上传超过100MB大小的文件。网络条件较差,和OBS服务端之间的连接经常断开。上传前无法确定将要上传文件的大小。分段上传分为如下3个步骤:使用分段上传方式传输数据前,必须先通知OBS初始化一个分段上传任务。该操作会返回一个OBS服务端创建的全局唯一标识(Upload ID), - [分段复制](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0409.md): 分段复制是分段上传的一种特殊情况,即分段上传任务中的段通过复制OBS指定桶中现有对象(或对象的一部分)来实现。您可以通过copyPart来复制段。以下代码展示了如何使用分段复制对象:分段复制过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [断点续传上传](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0410.md): 当上传大文件时,经常出现因网络不稳定或程序崩溃导致上传失败的情况。失败后再次重新上传不仅浪费资源,而且当网络不稳定时仍然有上传失败的风险。断点续传上传接口能有效地解决此类问题引起的上传失败,其原理是将待上传的文件分成若干个分段分别上传,并实时地将每段上传结果统一记录在checkpoint文件中,仅当所有分段都上传成功时返回上传成功的结果, - [普通上传设置上传回调](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1804.md): 您可以在上传对象请求(PutObject)中设置回调参数,OBS在对象上传成功之后,将上传结果回调特定服务器,并将回调结果返回给您。此示例用于普通上传对象(PutObject)时设置上传回调:当前SDK的文件上传接口(OBSPutObjectWithFileRequest、OBSUploadFileRequest)的uploadFileP - [断点续传上传设置上传回调](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1805.md): 您可以在断点续传上传请求(uploadFile)中设置回调参数,OBS在对象上传成功之后,将上传结果回调特定服务器,并将回调结果返回给您。此示例用于断点续传上传(uploadFile)时设置上传回调:void testPutObjectWithCallback(){ // NSString *endPoint = @"https:/ - [获取多版本对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0804.md): 您可以通过OBSAbstractGetObjectRequest的子类,通过设置request.versionID来获取多版本对象。示例代码如下:如果版本号为空则默认下载最新版本的对象。 - [复制多版本对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0805.md): 您可以通过OBSCopyObjectRequest接口传入版本号(versionID)来复制多版本对象,示例代码如下:复制多版本对象过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。 - [恢复多版本归档存储对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0806.md): 您可以通过OBSRestoreObjectRequest接口传入版本号(versionID)来恢复多版本归档存储对象,示例代码如下:恢复多版本归档存储对象过程中返回的错误码含义、问题原因及处理措施可参考OBS错误码、sdk自定义异常、sdk公共响应头。重复恢复归档或深度归档存储数据时,系统将延长恢复有效期。同时,将对恢复操作产生的费用进行 - [列举多版本对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0807.md): 您可以通过OBSListObjectsVersionsRequest列举多版本对象。该接口可设置的参数如下:如果versionIDMarker不是keyMarker的一个版本号,则该参数无效。OBSListObjectsVersionsRequest返回结果包含多版本对象和对象删除标记。以下代码展示如何简单列举多版本对象,最多返回1000 - [多版本对象权限](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0808.md): 您可以通过OBSSetObjectACLRequest接口传入版本号(versionID)设置多版本对象ACL,示例代码如下:ACL中需要填写的所有者(Owner)或者被授权用户(Grantee)的ID,是指用户的账号ID,可通过OBS控制台“我的凭证”页面查看。您可以通过OBSGetObjectACLRequest接口传入版本号(ver - [删除多版本对象](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0809.md): 您可以通过OBSDeleteObjectRequest接口传入版本号(versionID)删除多版本对象。示例代码如下:您可以通过OBSDeleteObjectsRequest接口传入每个待删除对象的版本号(versionID)批量删除多版本对象。示例代码如下: - [使用临时URL进行授权访问](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_0701.md): 临时授权访问是指通过访问密钥、请求方法类型、请求参数等信息生成一个临时访问权限的URL,这个URL中会包含鉴权信息,您可以使用该URL进行访问OBS服务进行特定操作。在生成URL时,您需要指定URL的有效期。所有继承OBSBaseRequest的子类都能使用临时鉴权访问。临时授权访问支持的操作以及相关信息见下表:如果遇到跨域报错、签名不匹 - [自定义头域](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1901.md): 在使用IOS SDK调用接口时,您可以为请求添加自定义头域,以发送用户指定的头域。如果您指定的头域属于需要参与签名计算,SDK会自动进行计算。使用方法为:调用sdk接口时,在 request.customHeaders 参数中以字典形式传入指定的头域。OBS支持的Region与Endpoint的对应关系,详细信息请参见地区与终端节点。 - [OBS服务端错误码](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1601.md): SDK错误码是由ObsClient统一抛出的异常,继承自java.lang.RuntimeException类。用户向OBS发出请求后,如果遇到错误,此时响应中会返回错误码描述的错误信息。通常是OBS服务端错误,包含对象存储服务的错误码、错误信息等,便于用户定位问题,并做出适当的处理。了解对象存储服务的错误码更多信息,请参见OBS错误码。 - [SDK自定义异常](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1604.md): 通过响应中的error来判断请求是否异常。如果error等于空则请求无异常,否则请求失败。同时您可以将错误信息打印在窗口中。示例代码如下: - [SDK公共响应头](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1602.md): 调用OBSClient类的相关接口成功后,均会返回公共响应头类,即OBSBaseResponse类实例(或其子类实例)。该类包含了HTTP/HTTPS的响应头信息。处理公共响应头的示例代码如下: - [日志分析](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1603.md): 开启系统日志记录,代码如下所示:当系统出现问题需要定位且当前的日志无法满足要求时,可以通过修改日志的级别来获取更多的信息。其中OBSDDLogLevelVerbose日志信息最丰富,OBSDDLogLevelError日志信息最少。默认为OBSDDLogLevelInfo。 - [如何获取临时AK/SK](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1707.md): 临时AK/SK和SecurityToken是系统颁发给用户的临时访问令牌,通过接口设置有效期,范围为15分钟至24小时,过期后需要重新获取。临时AK/SK和SecurityToken遵循权限最小化原则。使用临时AK/SK鉴权时,临时AK/SK和SecurityToken必须同时使用。获取临时访问密钥的接口请参考获取临时AK/SK和secu - [项目打包出错](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1708.md): 打包时候报如下错误:OBS.framework” did not contain a “archived-expanded-entitlements.xcent” resource.修复方法:OBS.framework为静态库,请确保Embedded Binaries中不包含OBS.framework - [项目编译报错duplicate symbols](https://support.huaweicloud.com/sdk-ios-devg-obs/obs_27_1803.md): 将已有的Swift项目中集成OBS.framework,在Build Settings的Other Linker Flags中添加了-force_load $(SRCROOT)/XXX/OBS.framework/OBS,然后将Allow Nonmodular includes in Framework Modules设置为Yes,编译时 - [使用前须知](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_8000.md): OBS SDK合规使用指南请单击此处;OBS SDK隐私声明请单击此处。请确认您已经熟悉OBS的基本概念,如桶(Bucket)、对象(Object)、访问密钥(AK和SK)、终端节点(Endpoint)和访问域名等。当前各区域特性开放不一致,部分特性仅在特定区域开放,使用过程中如果接口HTTP状态码为405,请确认该区域是否支持该功能特性 - [SDK下载](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0001.md): OBS PHP SDK最新版本源码:最新源码下载OBS PHP SDK历史版本下载地址:历史版本下载SDK源码请参见:GitHub接口参考文档地址:SDK API 文档版本修订记录信息:ChangeLog。推荐的PHP版本:PHP 5.6,PHP 7.x。PHP SDK 3.22.6 及以上版本至少需要PHP 7.1 版本才支持使用。PH - [示例程序](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0002.md): OBS PHP SDK提供了丰富的示例程序,方便用户参考或直接使用。您可以从OBS PHP SDK开发包中获取示例程序。您也可以从下面表格中直接下载示例程序。示例包括以下内容: - [技术支持渠道](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0003.md): 您可以通过关键字在左侧搜索框中搜索本产品的文档,帮助您快速找到需要的文档。开发者社区提供的技术支持渠道如下:开发过程中,您有任何问题可以在华为云对象存储服务论坛中发帖求助。 - [使用前需知](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0101.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。请确认您已经熟悉OBS的基本概念,如桶(Bucket)、对象(Object)、访问密钥(AK和SK)等。您可以先参考OBS客户端通用示例,了解OBS PHP SDK接口调用的通用方式。调用Ob - [使用前准备](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0102.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。在使用PHP SDK访问对象存储服务OBS之前,您需要先完成服务环境的准备和开发环境的准备。服务环境准备包括准备账号和访问密钥,是使用SDK与OBS云服务交互的必要条件。开发环境准备是指为了您 - [下载并安装SDK](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0105.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。如表1所示,PHP SDK有2种安装方式。以安装OBS PHP SDK最新版本为例,步骤如下:如果您的环境尚未安装composer,请参见Packagist官网安装;安装完成后,您的目录结构应 - [获取服务地址](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0106.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。终端节点(endpoint):OBS为每个区域提供一个终端节点,终端节点可以理解为OBS在不同区域的区域域名,用于处理各自区域的访问请求。访问域名:OBS会为每一个桶分配默认的访问域名。访问域 - [初始化OBS客户端](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0108.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。向OBS发送任一HTTP/HTTPS请求之前,必须先创建一个ObsClient实例:更多关于OBS客户端初始化的内容请参考“初始化”章节。日志配置详见配置SDK日志 - [创建桶](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0109.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。桶是OBS全局命名空间,相当于数据的容器、文件系统的根目录,可以存储若干对象。以下代码展示如何新建一个桶:更多创建桶的信息,请参见创建桶。创建桶时,如果使用的终端节点归属于默认区域华北-北京一 - [上传对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0110.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于上传字符串“Hello OBS”到桶名为“bucketname”里,名称为“objectname”。代码示例如下所示:Body 参数支持字符串和资源类型。上传文件时可使用 'Sour - [下载对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0111.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于下载桶名为“bucketname”里,名称为“objectname”的对象。代码示例如下所示:更多下载对象的信息,请参见下载对象。 - [列举对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0112.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于列举桶名为“bucketname”里的对象。代码示例如下所示:上面的代码默认列举1000个对象(Object)。更丰富的列举功能,请参见列举对象。 - [删除对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0113.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于删除桶名为“bucketname”里,名称为“objectname”的对象。代码示例如下所示:本示例仅用于删除单个对象。如需批量删除,可使用 deleteObjects 接口,详见删 - [OBS客户端通用示例](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0114.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。调用ObsClient的相关接口均需要传入请求数组(associative array类型)作为输入。对于桶操作接口,请求数组中固定包含Bucket用于指定桶名(ObsClient->list - [预定义常量](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0115.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS PHP SDK提供了一组预定义常量,方便用户直接使用。您可以通过ObsClient获取预定义常量。更多关于预定义常量的介绍详见《对象存储服务PHP SDK API参考》。 - [创建并配置OBS客户端](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0203.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本章节指导客户创建并配置客户端,该任务是使用SDK与OBS交互的必备前置任务初始化客户端之前,您需要先完成以下几项准备工作:使用前需知了解并选择合适的SDK版本。使用前准备完成服务环境和开发环 - [配置SDK日志](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0204.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS PHP SDK基于monolog日志组件提供了日志功能,您可以通过ObsClient->initLog开启日志功能并进行配置。示例代码如下:日志功能默认是关闭的,需要主动开启。您可以从 - [异步调用](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0206.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS PHP SDK的桶相关接口和对象相关接口均支持以“Async”结尾的方式进行异步调用(例如,同步方法为ObsClient->putObject,则异步方法为ObsClient->put - [创建桶](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0301.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->createBucket创建桶。以下代码展示如何新建一个桶:同一用户在同一区域多次创建同名桶不会报错,创建的桶属性以第一次请求为准。本示例创建的桶ACL默认是公 - [列举桶](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0302.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->listBuckets列举桶。以下代码展示如何获取桶列表:获取到的桶列表将按照桶名字典顺序排列。设置 QueryLocation 参数为 true 后,可在列举 - [删除桶](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0303.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->deleteBucket删除桶。以下代码展示如何删除一个桶:如果桶不为空(包含对象或分段上传碎片),则该桶无法删除。删除桶是非幂等操作,删除不存在的桶会报错。 - [判断桶是否存在](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0304.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->headBucket接口判断该桶是否已存在。本示例用于判断桶名为“bucketname”是否存在。代码示例如下所示:如果抛出异常且HTTP状态码为404,表明桶 - [获取桶元数据](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0305.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->getBucketMetadata接口获取桶元数据。本示例用于获取桶名为“bucketname”的元数据信息。代码示例如下所示:获取桶元数据过程中返回的错误码含 - [管理桶ACL](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0306.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源拥有完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和 - [管理桶策略](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0307.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。除了桶ACL外,桶的拥有者还可以通过桶策略,提供对桶和桶内对象的集中访问控制。更多关于桶策略的内容请参考桶策略。您可以通过ObsClient->setBucketPolicy设置桶策略。示例代 - [获取桶区域位置](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0308.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->getBucketLocation获取桶的区域位置。本示例用于获取桶名为“bucketname”的区域位置信息。代码示例如下所示:创建桶时可以指定桶的区域位置, - [获取桶存量信息](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0309.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。桶存量信息包括桶已使用的空间大小以及桶包含的对象个数。您可以通过ObsClient->getBucketStorageInfo获取桶的存量信息。本示例用于获取桶名为“bucketname”的存 - [桶配额](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0310.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->setBucketQuota设置桶配额。以下代码展示如何设置桶配额:使用StorageQuota参数指定桶的配额大小。桶配额值必须为非负整数,单位为字节,支持的 - [桶存储类型](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0311.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS允许您对桶配置不同的存储类型,桶中对象的存储类型默认将与桶的存储类型保持一致。不同的存储类型可以满足客户业务对存储性能、成本的不同诉求。桶的存储类型分为以下几类,详见下表:更多关于桶存储 - [设置桶的BPA配置](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_9302.md): 创建或修改OBS桶的PublicAccessBlock配置,以开启或关闭阻止公开访问。开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您必须是桶拥有者或拥有设置桶BPA配置的权限,才能设置桶桶BPA配置。建议使用IAM或桶策略进行授权,如果 - [生命周期管理简介](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0901.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS允许您对桶设置生命周期规则,实现自动转换对象的存储类型、自动淘汰过期的对象,以有效利用存储特性,优化存储空间。针对不同前缀的对象,您可以同时设置多条规则。一条规则包含:规则ID,用于标识 - [设置生命周期规则](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0902.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->setBucketLifecycle设置桶的生命周期规则。以下代码展示了如何设置最新版本对象和历史版本对象的转换策略:getBucketLifecycle查看桶的生命周期规则。本示例用于查看桶名为“bucketname”的生命周期规则。代码示例如下所示:deleteBucketLifecycle删除桶的生命周期规则。本示例用于删除桶名为“bucketname”的生命周期规则。代码示例如下所示:删除桶生命周期规则 - [静态网站托管简介](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1201.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。静态网站通常仅包含静态网页,以及可能包含部分可在客户端运行的脚本,如JavaScript、Flash等。相比之下,动态网站则依赖于服务器端处理脚本,包括PHP、JSP或ASP.Net等。您可以 - [网站文件托管](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1202.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可通过以下步骤实现网站文件托管:以下代码展示了如何实现网站文件托管:上例中您可以使用http://bucketname.your-endpoint/index.html在浏览器直接访问托管的 - [设置托管配置](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1203.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->setBucketWebsite设置桶的托管配置。以下代码展示了如何配置默认主页和错误页面:以下代码展示了如何配置重定向规则:使用RoutingRules参数指 - [查看托管配置](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1204.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->getBucketWebsite查看桶的托管配置。本示例用于查看桶名为“bucketname”的托管配置。代码示例如下所示:查看桶托管配置过程中返回的错误码含义 - [清除托管配置](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1205.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->deleteBucketWebsite清除桶的托管配置。本示例用于清除桶名为“bucketname”的托管配置。代码示例如下所示:清除桶托管配置过程中返回的错误 - [多版本控制简介](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0801.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS支持保存一个对象的多个版本,您可以利用多版本控制,在一个桶中保留多个版本的对象。多版本功能可以方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。在默认情况下,OBS中新创 - [设置桶多版本状态](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0802.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->setBucketVersioning设置桶的多版本状态。OBS中的桶支持两种多版本状态:以下代码展示了如何设置桶的多版本状态:使用Status参数指定桶的多版 - [查看桶多版本状态](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0803.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->getBucketVersioning查看桶的多版本状态。本示例用于获取桶名为 bucketname的多版本状态。代码示例如下所示:获取桶多版本状态过程中返回的 - [跨域资源共享简介](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1001.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。跨域是指不同域名之间相互访问。跨域访问是浏览器出于安全考虑而设置的一个限制,即同源策略。由于JavaScript同源策略的限制,A域名下的JavaScript无法操作B域名或C域名下的对象。同 - [设置跨域规则](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1002.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->setBucketCors设置桶的跨域规则,如果原规则存在则覆盖原规则。以下代码展示了如何设置跨域规则:使用CorsRules参数指定桶的CORS配置信息。Al - [查看跨域规则](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1003.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->getBucketCors查看桶的跨域规则。本示例用于查看桶名为“bucketname”的跨域规则。代码示例如下所示:查看桶的跨域规则过程中返回的错误码含义、问 - [删除跨域规则](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1004.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->deleteBucketCors删除桶的跨域规则。本示例用于删除桶名为“bucketname”的跨域规则。代码示例如下所示:删除桶的跨域规则过程中返回的错误码含 - [日志简介](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1101.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS允许您对桶设置访问日志记录,设置之后对于桶的访问会被记录成日志,日志存储在OBS上您指定的目标桶中。出于分析或审计等目的,用户可以开启日志记录功能。通过访问日志记录,桶的拥有者可以深入分 - [开启桶日志](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1102.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->setBucketLogging开启桶日志功能。日志目标桶与源桶必须在同一个区域(region)。setBucketLogging 为全量覆盖操作,调用后会覆盖 - [查看桶日志配置](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1103.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->getBucketLogging查看桶日志配置。本示例用于查看桶名为“bucketname”的日志配置。代码示例如下所示:查看桶日志过程中返回的错误码含义、问题 - [关闭桶日志](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1104.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。关闭桶日志功能即调用ObsClient->setBucketLogging清空日志配置。本示例用于关闭桶名为“bucketname”的日志配置,代码示例如下所示:关闭桶日志过程中返回的错误码含 - [标签简介](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1301.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。标签用于标识 OBS 中的桶或对象,实现对资源的分类管理如何在控制台配置桶标签请参考标签。更多关于桶标签的内容请参考标签。 - [设置桶标签](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1302.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->setBucketTagging设置桶标签。以下代码展示了如何设置桶标签:使用Tags参数指定桶的标签信息。每个桶支持最多10个标签。标签的 Key 和 Val - [查看桶标签](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1303.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->getBucketTagging查看桶标签。以下代码展示了如何查看桶标签: - [删除桶标签](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1304.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->deleteBucketTagging删除桶标签。以下代码展示了如何删除桶标签: - [事件通知简介](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1401.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS提供了事件通知功能,当启用通知功能后,桶上所发生的指定操作都会通过消息通知服务(SMN)发送给您。事件通知配置包含:配置ID,如果用户未指定,则OBS自动分配一个ID。事件通知主题URN - [设置事件通知](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1402.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->setBucketNotification设置桶的事件通知。以下代码展示了如何设置桶的事件通知:关于Topic参数的描述:事件通知主题的URN,当OBS检测到桶 - [查看事件通知](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1403.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->getBucketNotification查看桶的事件通知。以下代码展示了如何查看桶的事件通知: - [关闭事件通知](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1404.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。关闭桶事件通知即调用ObsClient->setBucketNotification清空事件通知配置,以下代码展示了如何清除桶的事件通知: - [服务端加密简介](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1501.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS支持服务端加密功能,使对象加密的行为在OBS服务端进行。更多关于服务端加密的内容请参考服务端加密。 - [加密说明](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1502.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS PHP SDK支持服务端加密的接口见下表:OBS PHP SDK两种加解密方式支持的请求参数: - [加密示例](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1503.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。以下代码展示了在上传对象时使用服务端加密功能:以下代码展示了在下载对象时使用服务端解密功能: - [创建并行文件系统](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_7415.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->createBucket接口,并设置BucketType参数为POSIX来创建并行文件系统。以下代码展示如何新建一个并行文件系统:并行文件系统的名称是全局唯一的 - [列举并行文件系统](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_7416.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->listBuckets列举所有桶,再通过BucketType属性筛选出并行文件系统。以下代码展示如何获取并行文件系统列表:获取到的桶列表将按照桶名字典顺序排列。 - [列举并行文件系统内对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_7417.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->listObjects列举指定POSIX并行文件系统内的文件夹和对象: - [对象上传简介](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0401.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。在OBS中,用户操作的基本数据单元是对象。OBS PHP SDK提供了丰富的对象上传接口,可以通过以下方式上传对象:文本上传流式上传文件上传分段上传基于表单上传SDK支持上传0KB~5GB的对 - [文本上传](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0402.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。文本上传用于直接上传字符串。您可以通过ObsClient->putObject直接上传字符串到OBS。本示例用于上传字符串“Hello OBS”到桶名为“bucketname”里,名称为“ob - [流式上传](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0403.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。流式上传使用resource或GuzzleHttp\Psr7\StreamInterface作为对象的数据源。以下代码展示了如何进行流式上传:使用Body参数指定待上传的流数据时,其值必须是一 - [文件上传](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0404.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。使用SDK管理OBS资源,您需要先根据SDK下载了解并选择合适的SDK版本,然后下载SDK并完成安装。文件上传使用本地文件作为对象的数据源。以下代码展示了如何进行文件上传:使用SourceFi - [基于表单上传](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0409.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。基于表单上传是使用HTML表单形式上传对象到指定桶中,对象最大不能超过5GB。您可以通过ObsClient->createPostSignature生成基于表单上传的请求参数。您也可以通过如下 - [批量上传对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_7409.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。批量上传基于以下三种单次上传方式,您可以根据文件类型和大小选择合适的上传方式,结合下方的示例代码实现批量上传。文本上传流式上传文件上传本示例用于批量上传本地目录中的文件到OBS指定桶。您可以通 - [对象下载简介](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0501.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS PHP SDK提供了丰富的对象下载接口,可以通过以下方式下载对象:文本下载流式下载文件下载范围下载限定条件下载您可以通过ObsClient->getObject下载对象。 - [文本下载](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0502.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于下载桶名为“bucketname”里,名称为“objectname”的对象。代码示例如下所示:文本下载会将对象内容全部加载到内存,大文件(>100MB)建议使用流式下载(SaveAs - [流式下载](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0503.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。以下代码展示了如何进行流式下载:使用SaveAsStream参数指定使用流式下载。返回结果中的Body是一个可读的GuzzleHttp\Psr7\StreamInterface对象,可将对象的 - [文件下载](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0504.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于下载桶名为“bucketname”里,名称为“objectname”的对象,并保存到“localfile”。代码示例如下所示:使用SaveAsFile参数指定文件下载的路径。文件下载 - [范围下载](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0505.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。如果只需要下载对象的其中一部分数据,可以使用范围下载,下载指定范围的数据。如果指定的下载范围是0~1000,则返回第0到第1000个字节的数据,包括第1000个,共1001字节的数据,即[0, - [限定条件下载](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0506.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。下载对象时,可以指定一个或多个限定条件,满足限定条件时则进行下载,否则返回异常码,下载对象失败。您可以使用的限定条件如下:对象的ETag值是指对象数据的MD5校验值。如果包含IfUnmodif - [重写响应头](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0507.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。下载对象时,可以重写部分HTTP/HTTPS响应头信息。可重写的响应头信息见下表:以下代码展示了如何重写响应头:restoreObject恢复归档存储对象。以下代码展示了如何下 - [批量下载对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_7410.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过以下方式批量下载对象:文本下载流式下载文件下载本示例用于批量下载OBS桶中的对象到本地目录。您可以通过列举满足前缀条件的对象, 再以指定并发数并发下载,文件按原Key结构保存到本地目 - [批量恢复归档或深度归档存储对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_7411.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于批量恢复归档或深度归档存储的对象。 归档或深度归档类型的对象处于冷冻状态无法直接访问,需要先提交恢复请求,等待恢复完成后才能访问。存储恢复通常需要3~5小时(标准模式),深度归档存储 - [图片处理](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0510.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS为用户提供了稳定、安全、高效、易用、低成本的图片处理服务。当要下载的对象是图片文件时,您可以通过传入图片处理参数对图片文件进行图片剪切、图片缩放、图片水印、格式转换等处理。更多关于图片处 - [获取自定义元数据](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0508.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。下载对象成功后会返回对象的自定义元数据。本示例用于下载桶名为“bucketname”里,名称为“objectname”的对象,同时返回该对象的自定义元数据。代码示例如下所示:如果返回的Meta - [创建文件夹](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0405.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS本身是没有文件夹的概念的,桶中存储的元素只有对象。创建文件夹实际上是创建了一个大小为0且对象名以“/”结尾的对象,这类对象与其他对象无任何差异,可以进行下载、删除等操作,只是OBS控制台 - [设置对象属性](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0406.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以在上传对象时设置对象属性。对象属性包含对象长度、对象MIME类型、对象MD5值(用于校验)、对象存储类型、对象自定义元数据。对象属性可以在多种上传方式下(文本上传、流式上传、文件上传、分 - [复制对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0605.md): 用户可以根据需要将存储在OBS上的对象复制到其他路径下。复制对象操作将创建需要复制的对象的副本。在单次操作中,您可以创建最大5GB的对象副本。为指定桶中的对象创建一个副本。开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您必须是桶拥有者或拥 - [批量复制对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_7412.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。本示例用于批量复制OBS桶中的对象到目标桶。您可以通过列举满足前缀条件的对象, 再以指定并发数批量复制到目标桶,目标Key通过前缀替换生成,支持跨桶复制或同桶备份,适用于数据迁移、备份等场景。 - [删除对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0604.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。请您谨慎使用删除操作,如果对象所在的桶未开启多版本控制功能,该对象一旦删除将无法恢复。您可以通过ObsClient->deleteObject删除单个对象。以下代码展示如何删除单个对象:您可以 - [列举对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0603.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->listObjects列举出桶里的对象。该接口可设置的参数如下:以下代码展示如何简单列举对象,最多返回1000个对象:每次至多返回1000个对象,如果指定桶包含 - [管理对象ACL](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0602.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源拥有完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和 - [获取对象属性](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0601.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->getObjectMetadata来获取对象属性,包括对象长度,对象MIME类型,对象自定义元数据等信息。本示例用于获取桶名为“bucketname”里,名称为 - [分段上传](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0407.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。对于较大文件上传,可以切分成段上传。用户可以在如下的应用场景内(但不仅限于此),使用分段上传的模式:上传超过100MB大小的文件。网络条件较差,和OBS服务端之间的链接经常断开。上传前无法确定 - [分段复制](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0408.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。分段复制是分段上传的一种特殊情况,即多段上传任务中的段通过复制OBS指定桶中现有对象(或对象的一部分)来实现。您可以通过ObsClient->copyPart来复制段。本示例用于分段复制桶 s - [清理多段上传任务碎片](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_7413.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。清理碎片是指删除未完成的多段上传任务产生的分片数据。当多段上传任务中断或失败时,会在桶中遗留未合并的分片数据,占用存储空间和产生费用。通过清理碎片功能可以删除这些无用的分片数据。建议定期清理7 - [设置对象标签](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1305.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。用户可以通过本接口设置或更新对象(Object)的标签信息。对象标签使用一组键值对(Key-Value)标记对象。不携带版本号时需要 PutObjectTagging 权限;携带版本号时需要 - [获取对象标签](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1306.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。用户可以通过本接口获取对象(Object)的标签信息。如果请求中不携带版本号(versionId),需要确保执行者有GetObjectTagging权限。如果请求中携带版本号(versionI - [删除对象标签](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1307.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。用户可以通过本接口删除对象(Object)的标签信息。如果请求中不携带版本号(versionId),需要确保执行者有DeleteObjectTagging权限。如果请求中携带版本号(versi - [获取多版本对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0804.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->getObject接口指定VersionId参数来获取多版本对象。本示例用于下载桶名为“bucketname”里,名称为“objectname”,指定Versi - [复制多版本对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0805.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->copyObject接口在CopySource参数中指定待复制对象的versionId来复制多版本对象,本示例用于通过设置versionId复制sourcebu - [恢复多版本归档存储对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0806.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->restoreObject接口指定VersionId参数来恢复多版本归档存储对象。本示例用于通过设置versionId值将destbucketname桶中des - [列举多版本对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0807.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->listVersions列举多版本对象。该接口可设置的参数如下:如果VersionIdMarker不是KeyMarker的一个版本号,则该参数无效。ObsCli - [多版本对象权限](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0808.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->setObjectAcl接口指定VersionId参数设置多版本对象ACL,示例代码如下:使用Owner参数指定对象的所有者信息;使用Grants参数指定被授权 - [删除多版本对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0809.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。您可以通过ObsClient->deleteObject接口指定VersionId参数删除多版本对象。本示例用于通过设置多版本对象的VersionId值,删除桶名为“bucketname”里, - [使用临时URL进行授权访问](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_0701.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。OBS客户端支持通过访问密钥、请求方法类型、请求参数等信息生成一个在Query参数中携带鉴权信息的URL,可将该URL提供给其他用户进行临时访问。在生成URL时,您需要指定URL的有效期来限制 - [SDK错误码](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1602.md): SDK错误码是由ObsClient统一抛出的异常,继承自\RuntimeException类。通常是OBS服务端错误,包含OBS错误码、错误信息等,便于用户定位问题,并做出适当的处理。SDK错误码包含两部分:对象存储服务的API错误码,详见OBS错误码。SDK自定义异常,请参见表1。SDK自定义异常异常异常信息ObsException.g - [SDK公共结果对象](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1603.md): 调用ObsClient的相关接口完成后,没有异常抛出,则会返回结果SDK公共结果对象,表明操作成功。该对象包含的内容见下表: - [日志分析](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1604.md): OBS PHP SDK基于monolog日志组件提供了日志功能,您可以通过ObsClient->initLog开启日志功能并进行配置。示例代码如下:日志功能默认是关闭的,需要主动开启。使用FilePath参数配置日志文件路径,可配置相对路径或绝对路径。SDK日志格式为:日志时间|日志级别|打印日志所在文件和对应的代码行数|日志内容。示例如 - [时区配置异常](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1608.md): 使用OBS PHP SDK进行二次开发时如果出现异常信息如“Uncaught exception 'Exception' with message 'DateTime::__construct():”,表明时区配置有误。可通过以下两种方式配置:修改php.ini文件,在[Date]标签下新增date.timezone = xxx,例如:d - [如何解决 Declaration of xxxx must be compatible with xxxx?](https://support.huaweicloud.com/sdk-php-devg-obs/obs_28_1713.md): 如果遇到这种报错,基本上都是版本不兼容导致的,因为社区开源软件依赖会不定期更新。比如遇到以下报错:从报错得知,CheckoutStream::read($length) 缺少int类型声明,很大可能就是psr/http-message版本太高(可以从composer.lock找到准确的版本号),另外查看Github社区发现psr/http - [如何获取账号ID和用户ID?](https://support.huaweicloud.com/sdk-php-devg-obs/obs_23_1712.md): 从控制台获取账号名、账号ID、用户名、用户ID、项目名称、项目ID在华为云首页右上角,单击“控制台”。在右上角的用户名中选择我的凭证。在“我的凭证”界面,API凭证页签中,查看账号名、账号ID、用户名、用户ID、项目名称、项目ID。每个区域的项目ID有所不同,需要根据业务所在的区域获取对应的项目ID。查看账号名、账号ID、用户名、用户ID - [使用前须知](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_9000.md): OBS SDK合规使用指南请单击此处;OBS SDK隐私声明请单击此处。请确认您已经熟悉OBS的基本概念,如桶(Bucket)、对象(Object)、访问密钥(AK和SK)、终端节点(Endpoint)和访问域名等。当前各区域特性开放不一致,部分特性只在部分区域开放,使用过程中如果接口HTTP状态码为405,请确认该区域是否支持该功能特性 - [SDK下载(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0001.md): OBS Node.js SDK最新版本源码:最新源码下载OBS Node.js SDK历史版本下载地址:历史版本下载SDK源码请参见:GitHub版本修订记录信息:ChangeLog。支持的Node.js版本:Node 10.12.0及以上。接口函数:与旧版本(2.1.x)不完全兼容,接口变化如下表:接口函数变化说明ObsClient.l - [示例程序(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0002.md): OBS Node.js SDK提供了丰富的示例程序,方便用户参考或直接使用。您可以从OBS Node.js SDK开发包中获取示例程序,如eSDK_Storage_OBS__Node.js.zip,解压后eSDK_Storage_OBS__Node.js/examples为示例程序。您也可以从下 - [技术支持渠道(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0003.md): 您可以通过关键字在左侧搜索框中搜索本产品的文档,帮助您快速找到需要的文档。开发者社区提供的技术支持渠道如下:开发过程中,您有任何问题可以在华为云对象存储服务论坛中发帖求助。 - [使用前需知(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0101.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。请确认您已经熟悉OBS的基本概念,如桶(Bucket)、对象(Object)、访问密钥(AK和SK)等。您可以先参考OBS客户端通用示例,了解OBS Node.js SDK接口调用的通用方式。OBS客户端支持回调函数和Promise对象两种 - [OBS服务环境搭建(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0102.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。使用OBS之前必须要有一个云服务账号。打开浏览器。登录公有云网站。在页面右上角单击“注册”。按需填写注册信息并单击“同意协议并注册”。使用OBS服务之前必须先充值,才能正常使用OBS服务。登录管理控制台。单击页面右上角的“费用和成本”进入费 - [开发环境准备(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0104.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。从Node.js官网下载并安装推荐使用的版本。从Eclipse官网下载并安装Eclipse IDE for JavaScript and Web Developer最新版本。 - [安装SDK(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0105.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。如果您使用的是Windows操作系统,当运行npm命令时提示“不是内部或外部命令”,请在Path环境变量中增加npm的安装目录(一般为Node.js的安装目录)。您可能需要重启电脑使环境变量生效。如果您使用npm安装依赖时出现网络错误,请使 - [获取服务地址(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0106.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以从这里查看OBS当前开通的服务地址和区域信息。SDK支持带协议名和不带协议名两种方式传入服务地址,例如获取到的服务地址为“your-endpoint”,则初始化OBS客户端时传入的服务地址可以为“http://your-endpoin - [初始化OBS客户端(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0107.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。向OBS发送任一HTTP/HTTPS请求之前,必须先创建一个ObsClient实例:由于JavaScript是异步编程语言,所以不能在访问OBS期间调用close方法。obsClient在调用obsClient.close方法关闭后不能再次 - [创建桶(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0108.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶是OBS全局命名空间,相当于数据的容器、文件系统的根目录,可以存储若干对象。以下代码展示如何新建一个桶:桶的名字是全局唯一的,所以您需要确保不与已有的桶名称重复。桶命名规则如下:3~63个字符,数字或字母开头,支持小写字母、数字、“-”、 - [上传对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0109.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。本示例用于上传字符串“Hello OBS”到桶名为“examplebucket”里,名称为“example/objectname”。代码示例如下所示:更多上传对象的信息,请参见上传对象。 - [下载对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0110.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。本示例用于下载桶名为“examplebucket”里,名称为“example/objectname”的对象。代码示例如下所示:更多下载对象的信息,请参见下载对象。 - [列举对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0111.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。当完成一系列上传对象操作后,可能需要查看桶中包含哪些对象。以下代码展示如何列举指定桶中的对象:// 引入obs库 // 使用npm安装 const ObsClient = require("esdk-obs-nodejs"); // 使用源 - [删除对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0112.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。本示例用于删除桶名为“examplebucket”里,名称为“example/objectname”的对象。代码示例如下所示:更多删除对象的信息,请参见删除对象。 - [OBS客户端通用示例(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0113.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS客户端可通过回调函数的形式返回结果,回调函数依次包含异常信息和SDK公共结果对象两个参数。如果回调函数中异常信息参数不为空,则表明接口调用异常;反之,则表明接口调用完成,此时应从SDK公共结果对象中获取HTTP状态码,判断操作是否成功 - [配置密钥(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0201.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。要接入OBS服务,您需要拥有一组有效的访问密钥(AK和SK)用来进行签名认证。具体可参考OBS服务环境搭建。获取AK和SK之后,可以通过创建OBS客户端,调用SDK接口。获取AK和SK之后,您便可以按照以下步骤进行初始化。创建OBS客户端( - [创建OBS客户端(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0202.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS客户端(ObsClient)是访问OBS服务的Node.js客户端,它为调用者提供一系列与OBS服务进行交互的接口,用于管理、操作桶(Bucket)和对象(Object)等OBS服务上的资源。使用OBS Node.js SDK发起OB - [配置OBS客户端(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0203.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可通过初始化参数对ObsClient进行配置,可以配置的参数见下表:建议值为N/A的表示需要根据实际情况进行设置。如网络状况不佳,建议增大timeout的值。如果设置的server不带协议类型,则默认使用HTTPS协议。如果启用了长连接模 - [配置SDK日志(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0204.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS Node.js SDK基于log4js开源库提供了日志功能,您可以通过ObsClient.initLog开启日志功能并进行配置。代码示例如下:日志功能默认是关闭的,需要主动开启。您可以从日志分析章节获取更多关于SDK日志的信息。 - [配置SDK代理(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0206.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。 - [创建桶(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0301.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS桶是对象的容器,您上传的文件都将以对象的形式存放在桶中。本文介绍如何使用Node.js SDK创建桶。调用创建桶接口,将在当前账号按照用户指定的桶名创建一个新桶,接口支持根据用户诉求,在创建桶的同时配置桶的存储类别、区域及桶ACL等参 - [列举桶列表(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0302.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS桶是对象的容器,您上传的文件都存放在桶中。调用获取桶列表接口,可列举当前账号所有区域下符合指定条件的桶。返回结果以桶名的字典序排序。您必须拥有obs:bucket:ListAllMyBuckets权限,才能获取桶列表。建议使用IAM进 - [判断桶是否存在(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0304.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。判断指定桶名的桶是否存在,返回的结果中HTTP状态码为200表明桶存在,否则返回404表明桶不存在。您必须是桶拥有者或拥有判断桶是否存在的权限,才能判断桶是否存在。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket: - [删除桶(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0303.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶为空时,用户可以删除桶,以免占用桶数量配额。删除桶后需要等待30分钟才能创建同名桶。华为云无法恢复用户主动删除的OBS数据。因此调用接口删除桶后,桶相关数据无法恢复,请谨慎操作。待删除的桶必须为空,桶为空包含两方面含义:桶内没有任何对象, - [获取桶元数据(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0305.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用获取桶元数据接口,可获取指定桶的相关信息,包括指定桶的存储类别、区域位置、跨域资源共享(CORS)规则、数据冗余存储策略等信息。您必须是桶拥有者或拥有获取桶元数据的权限,才能获取桶元数据。建议使用IAM或桶策略进行授权,如果使用IAM则 - [获取桶存量信息(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0312.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用获取桶存量信息接口,可查询指定桶内的对象个数,以及对象占用空间的大小。由于OBS桶存量是后台统计,因此存量会有一定的时延,不能实时更新,因此不建议对存量做实时校验。您必须是桶拥有者或拥有获取桶存量信息的权限,才能获取桶存量信息。建议使用 - [获取桶区域位置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0311.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。获取指定桶所在的区域位置。您必须是桶拥有者或拥有获取桶区域位置的权限,才能获取桶区域位置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketLocation权限,如果使用桶策略则需授予GetBuc - [设置桶ACL(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0306.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其 - [获取桶ACL(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0307.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [设置桶策略(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0308.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》 - [获取桶策略(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0309.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。桶策略是作用于所配置的OBS桶及桶内对象的,您可以通过桶策略可为IAM用户 - [删除桶策略(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0310.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。桶策略是作用于所配置的OBS桶及桶内对象的,您可以通过桶策略可为IAM用户 - [设置桶清单规则(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4001.md): 桶清单功能可以定期生成桶内对象的相关信息,保存在CSV格式的文件中,并上传到您指定的桶中,方便您管理桶内对象。目标桶和源桶可以是同一个桶。指定的对象内容包括对象版本、大小、上次修改时间、存储类别、标签、加密状态等。支持对桶清单加密,加密方式为SSE-KMS方式。您必须是桶拥有者或者拥有设置桶清单权限,才能设置桶清单。建议使用IAM或桶策略 - [获取桶清单规则(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4002.md): 您可以使用获取桶清单规则接口获取指定桶的清单规则,可以通过配置规则id来选择指定清单规则。您必须是桶拥有者或者拥有获取桶清单权限,才能获取桶清单。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetInventoryConfiguration权限,如果使用桶策略则需授予GetInventoryConfigur - [删除桶清单规则(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4003.md): OBS使用DELETE操作来删除指定桶的清单配置(通过清单规则id来指定确认要删除的桶清单规则)。您必须是桶拥有者或者拥有删除桶清单权限,才能删除桶清单。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketInventoryConfiguration权限,如果使用桶策略则需授予DeleteB - [列举桶清单规则(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4004.md): OBS使用不带清单id的GET操作来获取指定桶的所有清单配置,获取到的清单配置一次性返回,不分页。您必须是桶拥有者或者拥有列举桶清单权限,才能列举桶清单。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetInventoryConfiguration权限,如果使用桶策略则需授予GetInventoryConf - [设置桶级默认WORM策略(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4006.md): 本接口用于为指定桶配置默认保护策略和保护期限。当您在桶内配置了桶级默认WORM策略以后,如果您在上传对象时没有指定保护策略和保护期限,则新上传的对象会自动应用桶级默认WORM策略。和配置对象级WORM保护策略不同的地方在于,对象级WORM保护策略需要您提供一个明确的时间,在这个时间之前对象都会受到保护,桶级默认WORM策略则要求您提供一个 - [获取桶级默认WORM策略(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4007.md): 获取指定桶设置的桶级默认WORM策略。如果您打开了桶级WORM开关,但从未配置过桶级默认WORM策略,您依然可以使用此接口查看开关的打开情况。您必须是桶拥有者或者拥有获取桶级默认WORM策略权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketObjectLockConfigu - [设置镜像回源规则(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4009.md): OBS提供数据回源功能,可以在被请求的数据不存在时,通过回源规则从源站获取对应数据。ObsClient.setBucketMirrorBackToSource(params)您可以通过ObsClient.setBucketMirrorBackToSource设置镜像回源规则。代码示例如下: - [获取镜像回源规则(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4010.md): 获取指定桶设置的镜像回源规则。您必须是桶拥有者或者拥有获取镜像回源规则的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetMirrorBackToSource权限,如果使用桶策略则需授予GetMirrorBackToSource权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详 - [删除镜像回源规则(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4011.md): 删除指定桶的镜像回源规则。您必须是桶拥有者或者拥有删除镜像回源规则的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteMirrorBackToSource权限,如果使用桶策略则需授予DeleteMirrorBackToSource权限。相关授权方式介绍可参见OBS权限控制概述,配 - [设置在线解压策略(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4013.md): OBS支持ZIP包上传后自动解压并存放在指定目录。桶设置了在线解压策略后,上传到该桶内的ZIP包如果匹配解压策略,ZIP包将会自动解压到指定目录里。本接口用于为指定桶配置ZIP文件解压策略。了解更多在线解压相关信息,请参见在线解压。融合桶不支持在线解压。权限限制:需要使用IAM的角色与策略授权功能,增加Tenant Administrat - [获取在线解压策略(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4014.md): 可通过本接口查询指定桶的文件解压策略。如果策略存在,则返回成功,status code返回值为200。了解更多在线解压相关信息,请参见在线解压。需要使用IAM的角色与策略授权功能,增加Tenant Administrator权限后才能设置、获取、删除在线解压策略。在线解压源需使用IAM创建云服务委托,委托OBS获取桶内数据,上传数据到桶内 - [删除在线解压策略(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4015.md): 可通过本接口删除指定桶中配置的文件解压策略,删除成功status code返回值为204。了解更多在线解压相关信息,请参见在线解压。ObsClient.deleteBucketCompressPolicy(params)您可以通过ObsClient.deleteBucketCompressPolicy删除在线解压策略。代码示例如下: - [设置桶配额(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0313.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。桶配额是桶容量的上限值。默认情况下,OBS系统和单个桶都没有总数据容量和对象数量的限制。您可以根据需要,为桶设置配额限制来控制桶内允许上传的对象总容量,超过设置的对象容量后,上传对象会失败。例如您为桶设置配额为100G,那么当桶内所有对象的 - [获取桶配额(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0314.md): 桶配额是桶容量的上限值。调用获取桶配额接口,可获取指定桶的配额值。桶配额为0代表桶容量没有上限。桶配额值必须为非负整数,单位为字节,支持的最大值为263-1。桶的拥有者的状态是欠费冻结状态时不可以查询桶配额信息。您必须是桶拥有者或拥有获取桶配额的权限,才能获取桶配额。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucke - [设置桶存储类别(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0315.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS提供了这几种存储类别:标准存储、低频访问存储、归档存储、深度归档存储,从而满足客户业务对存储性能、成本的不同诉求,详情可参见存储类别。调用设置桶存储类别接口,可设置指定桶的存储类别。设置了桶的默认存储类别之后,若上传对象、复制对象和初 - [获取桶存储类别(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0316.md): OBS提供了这几种存储类别:标准存储、低频访问存储、归档存储、深度归档存储,从而满足客户业务对存储性能、成本的不同诉求,详情可参见存储类别。调用获取桶存储类别接口,可获取指定桶的存储类别。您必须是桶拥有者或拥有获取桶存储类别的权限,才能获取桶存储类别。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBuc - [设置桶的BPA配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0317.md): 创建或修改OBS桶的PublicAccessBlock配置,以开启或关闭阻止公开访问。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有设置桶BPA配置的权限,才能设置桶桶BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutB - [获取桶的BPA配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0318.md): 获取OBS桶的PublicAccessBlock配置。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取桶的BPA配置的权限,才能获取桶的BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPublicAcce - [删除桶的BPA配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0319.md): 删除OBS桶的PublicAccessBlock配置。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有删除桶的BPA配置的权限,才能删除桶的BPA配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketPublicA - [查询桶策略公开状态(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0320.md): 获取OBS桶策略的公开状态。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取桶策略公开状态的权限,才能获取桶策略公开状态。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPolicyPublicStatus权限,如果 - [查询桶公开状态(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0321.md): 获取OBS桶的公开状态。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取桶公开状态的权限,才能获取桶公开状态。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPublicStatus权限,如果使用桶策略则需授予Get - [设置桶的自定义域名(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_2317.md): 设置OBS桶的自定义域名。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有设置桶的自定义域名的权限,才能设置桶的自定义域名。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:SetBucketCustomDomain权限,如果使用桶策略则需 - [获取桶的自定义域名(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_2318.md): 获取OBS桶的自定义域名列表。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取桶的自定义域名的权限,才能获取桶的自定义域名配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketCustomDomain权限,如果使用桶 - [删除桶的自定义域名(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_2319.md): 删除OBS桶的自定义域名。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有删除桶的桶的自定义域名的权限,才能删除桶的自定义域名配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketCustomDomain权限,如果 - [设置桶归档存储对象直读策略(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_2321.md): 用户可通过本章节指导设置桶的归档存储对象直读策略。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有设置桶归档存储对象直读策略的权限,才能设置桶归档存储对象直读策略。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutDirectCold - [获取桶归档存储对象直读策略(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_2322.md): 用户可通过本章节指导获取桶的归档存储对象直读策略。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有获取桶归档存储对象直读策略的权限,才能获取桶归档存储对象直读策略相关信息。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetDirect - [删除桶归档存储对象直读策略(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_2323.md): 用户可通过本章节指导删除桶的归档存储对象直读策略。开发过程中,您有任何问题可以在github上提交issue,或者在华为云对象存储服务论坛中发帖求助。您必须是桶拥有者或拥有删除桶归档存储对象直读策略的权限,才能删除桶归档存储对象直读策略。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteDirectC - [多版本控制简介(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0801.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持保存一个对象的多个版本,您可以利用多版本控制,在一个桶中保留多个版本的对象。多版本功能可以方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。在默认情况下,OBS中新创建的桶不会开启多版本功能,向同一个桶上传同名的对 - [设置桶多版本状态(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0802.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持多版本控制,您可以在一个桶中保留对象的多个版本,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。更多多版本相关信息请参见多版本控制。调用设置桶的多版本状态接口,您可以为指定桶设置多版本状态。您必须是桶拥有者 - [查看桶多版本状态(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0803.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持多版本控制,您可以在一个桶中保留对象的多个版本,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。更多多版本相关信息请参见多版本控制。调用获取桶的多版本状态接口,您可以获取指定桶的多版本状态。您必须是桶拥有者 - [列举桶内多版本对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0807.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。用列举桶内对象接口,可列举指定桶内的部分或所有多版本对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的多版本对象信息。返回结果以多版本对象名的字典序排序。您必须是桶拥有者或拥有列举桶内多版本对象的权限,才能列举 - [设置桶的生命周期配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0902.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用设置桶的生命周期配置接口,您可以为指定桶设置生命周期策略。对象生命周期到期以后,对象将会永久删除, - [获取桶的生命周期配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0903.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用获取桶的生命周期配置接口,您可以获取指定桶的生命周期策略。您必须是桶拥有者或拥有获取桶的生命周期配 - [删除桶的生命周期配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0904.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用删除桶的生命周期配置接口,您可以删除指定桶的生命周期策略。您必须是桶拥有者或拥有删除桶的生命周期配 - [服务端加密简介(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1501.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS支持服务端加密功能,使对象加密的行为在OBS服务端进行。更多关于服务端加密的内容请参考服务端加密。 - [加密说明(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1502.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS Node.js SDK支持服务端加密的接口见下表:OBS Node.js SDK两种加密方式支持的请求参数: - [加密示例(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1503.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。本示例使用SSE-C方式加密上传example/objectname到examplebucket桶中。本示例用于流式下载examplebucket桶中的example/objectname加密对象。 - [静态网站托管简介(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1201.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以将静态网站文件上传至OBS的桶中作为对象,并对这些对象赋予公共读权限,然后将该桶配置成静态网站托管模式,以实现在OBS上托管静态网站的目的。第三方用户在访问您网站的时候,实际上是在访问OBS的桶中的对象。在使用静态网站托管功能时,OB - [设置托管配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1203.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外 - [获取托管配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1204.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外 - [删除托管配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1205.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外 - [设置桶的CORS配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1002.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全 - [获取桶的CORS配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1003.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全 - [删除桶的CORS配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1004.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全 - [设置桶日志管理配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1102.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。如果桶的存储类别为低频访问存储或归档存储,则不能作为日志目标桶。调用设置桶日志管理配置接口,您可以为指定桶打开桶日志功能,并配置日志存放的目标桶。创建桶时,默认是不生成桶的日志的,调用Node.js SDK的设置桶日志管理配置接口时,接口会 - [获取桶日志管理配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1103.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用获取桶日志管理配置,可获取指定桶的日志配置。您必须是桶拥有者或拥有获取桶日志管理配置的权限,才能获取桶日志管理配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketLogging权限,如果使 - [事件通知简介(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1401.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS消息通知功能能够帮助您对桶的重要的操作及时通知到您,确保您安全、及时知道发生在桶上的关键事件。目前对象存储服务(OBS)支持包括消息通知服务(SMN)、函数工作流服务(FunctionGraph)在内的两种桶通知服务配置。更多关于事件 - [设置桶的事件通知配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1402.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。设置桶的通知配置,桶上所发生的指定操作,都能及时得到通知。您可以通过ObsClient.setBucketNotification设置桶的事件通知。以下代码展示了如何设置桶的事件通知:使用TopicConfigurations参数指定简单通 - [获取桶的事件通知配置(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1403.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。获取指定桶的通知配置信息。您可以通过ObsClient.getBucketNotification查看桶的事件通知。以下代码展示了如何查看桶的事件通知:// 引入obs库 // 使用npm安装 var ObsClient = require - [设置桶标签(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1302.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,我们可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用 - [获取桶标签(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1303.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,我们可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用 - [删除桶标签(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1304.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,我们可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用 - [对象上传简介(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0401.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。在OBS中,用户操作的基本数据单元是对象。OBS Node.js SDK提供了丰富的对象上传接口,可以通过以下方式上传对象:文本上传(Node.js SDK)流式上传(Node.js SDK)文件上传(Node.js SDK)初始化多段上传 - [文本上传(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0402.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。本章节介绍上传单个对象到指定桶中。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则需授予PutObject权限。相关授权 - [流式上传(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0403.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。本章节介绍上传单个对象到指定桶中。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则需授予PutObject权限。相关授权 - [文件上传(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0404.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。本章节介绍上传单个对象到指定桶中。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则需授予PutObject权限。相关授权 - [创建文件夹(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0405.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。本章节介绍上传文件夹对象到指定桶中,来实现新建一个文件夹,从而更方便地对存储在对象桶中的数据进行分类管理。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:Put - [设置对象元数据(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0406.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。元数据(Metadata)为描述对象属性的信息,是一组名称值对,用作对象管理的一部分。当前仅支持系统定义的元数据。系统定义的元数据又分为两种类别:系统控制和用户控制。对指定桶中的对象发送HEAD请求,获取对象的元数据信息。您必须是桶拥有者或 - [上传对象时设置指定对象生命周期(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0407.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。上传对象或者初始化分段上传任务时,您可以使用Expires参数直接指定对象的过期时间。此方式仅支持设置以天为单位的对象过期时间,过期后的对象会被OBS服务端自动清理,其优先级高于桶生命周期规则。上传对象时,您可以直接指定对象的过期时间。代码 - [追加上传(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0409.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以根据需要上传文件或者文件夹至已有的OBS桶。待上传的文件可以是任何类型:文本文件、图片、视频等。追加写对象操作是指在指定对象末尾追加上传数据,不存在相同对象键值的对象则创建新对象。每次追加上传都会更新该对象的最后修改时间。您必须是桶拥 - [断点续传上传(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0411.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。断点续传上传接口是利用分段上传特性实现的,是对分段上传的封装和加强,解决上传大文件时由于网络不稳定或程序崩溃导致上传失败的问题。当上传大文件时,经常出现因网络不稳定或程序崩溃导致上传失败的情况。失败后再次重新上传不仅浪费资源,而且当网络不稳 - [基于表单上传(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0412.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。基于表单上传是使用HTML表单形式上传对象到指定桶中,对象最大不能超过5GB。您可以通过ObsClient.createPostSignatureSync生成基于表单上传的请求参数。使用Node.js代码模拟表单上传的完整代码示例,参见po - [数据一致性校验(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_2324.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以通过以下接口在上传时使用md5校验文件一致性:文本上传(Node.js SDK)流式上传(Node.js SDK)文件上传(Node.js SDK)追加上传(Node.js SDK)以下代码展示如何在使用追加上传时使用MD5校验一致性 - [批量上传对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_5000.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以通过以下接口在上传时使用批量操作:文本上传(Node.js SDK)流式上传(Node.js SDK)文件上传(Node.js SDK)追加上传(Node.js SDK)本示例用于批量上传本地目录中的文件到OBS指定桶。您可以通过递归 - [对象下载简介(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0501.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS Node.js SDK提供了丰富的对象下载接口,可以通过以下方式下载对象:文本下载(Node.js SDK)流式下载(Node.js SDK)文件下载(Node.js SDK)范围下载(Node.js SDK)断点续传下载(Node - [文本下载(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0502.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以根据需要将存储在OBS中的对象以文本形式下载到本地。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetO - [流式下载(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0503.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以根据需要将存储在OBS中的对象流式下载到本地。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetObje - [文件下载(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0504.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以根据需要将存储在OBS中的对象以文件形式下载到本地。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetO - [范围下载(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0505.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以根据需要将存储在OBS中的对象下载到本地。如果只需要下载对象的其中一部分数据,可以使用范围下载,下载指定范围的数据。如果指定的下载范围是0~1000,则返回第0到第1000个字节的数据,包括第1000个,共1001字节的数据,即[0, - [限定条件下载(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0506.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以根据需要将存储在OBS中的对象在满足限定条件的前提下下载到本地。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需 - [重写响应头(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0507.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。下载对象时,可以重写部分HTTP/HTTPS响应头信息。可重写的响应头信息见下表:以下代码展示了如何重写响应头: - [下载归档存储对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0509.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。重复恢复归档或深度归档存储数据时,系统将延长恢复有效期。同时,将对恢复操作产生的费用进行重复收取。如果要获取归档或深度归档存储对象的内容,需要先将对象恢复,然后再执行下载数据的操作。对象恢复后,会产生一个标准存储类别的对象副本,也就是说会同 - [断点续传下载(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0510.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。断点续传下载接口是利用范围下载特性实现的,是对范围下载的封装和加强,当下载大对象到本地文件时,经常出现因网络不稳定或程序崩溃导致下载失败的情况。失败后再次重新下载不仅浪费资源,而且当网络不稳定时仍然有下载失败的风险。断点续传下载接口能有效地 - [图片处理(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0511.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS为用户提供了稳定、安全、高效、易用、低成本的图片处理服务。当要下载的对象是图片文件时,您可以使用ImageProcess参数指定图片处理参数对图片文件进行图片剪切、图片缩放、图片水印、格式转换等处理。您必须是桶拥有者或拥有下载对象的权 - [获取下载进度(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_2325.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。获取下载对象进度是指在进行对象下载操作时,实时监控并获取下载进度的功能。通过实现进度监听接口,可以获取到下载任务的开始、数据传输中、下载完成或失败等状态信息,以及已下载字节数和总字节数。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建 - [批量下载对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_5001.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以通过以下接口在下载时使用批量操作:文本下载(Node.js SDK)流式下载(Node.js SDK)文件下载(Node.js SDK)本示例用于批量下载OBS桶中的对象到本地目录。您可以通过列举满足前缀条件的对象, 再以指定并发数并 - [设置对象过期时间(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_2306.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。OBS客户端支持通过在上传时设置对象过期时间和设置已上传对象的过期时间。本示例用于断点下载examplebucket桶中的example/objectname对象,并监听下载进度。// 引入obs库 // 使用npm安装 const Obs - [恢复归档或深度归档存储对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_2307.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。如果要获取归档或深度归档存储对象的内容,需要先恢复对象,然后再执行下载数据的操作。对象恢复后,会产生一个标准存储类型的对象副本,也就是说会同时存在标准存储类型的对象副本和归档或深度归档存储对象,在恢复对象的保存时间到期后标准存储类型的对象副 - [批量恢复归档或深度归档存储对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_5002.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。本示例用于批量恢复归档或深度归档存储的对象。 归档或深度归档类型的对象处于冷冻状态无法直接访问,需要先提交恢复请求,等待恢复完成后才能访问。重复恢复归档或深度归档存储数据时,系统将延长恢复有效期。同时,将对恢复操作产生的费用进行重复收取。 - [复制对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0608.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。用户可以根据需要将存储在OBS上的对象复制到指定路径下。复制对象操作将创建需要复制的对象的副本。在单次操作中,您可以创建最大5GB的对象副本。您必须是桶拥有者或拥有复制对象的权限,才能复制对象。建议使用IAM或桶策略进行授权,如果使用IAM - [批量复制对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_5003.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。本示例用于批量复制OBS桶中的对象到目标桶。您可以通过列举满足前缀条件的对象, 再以指定并发数批量复制到目标桶,目标Key通过前缀替换生成,支持跨桶复制或同桶备份,适用于数据迁移、备份等场景。 - [删除对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0606.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。请您谨慎使用删除操作,如果对象所在的桶未开启多版本控制功能,该对象一旦删除将无法恢复。为节省空间和成本,您可以根据需要删除指定桶中的单个对象。您必须是桶拥有者或拥有删除对象的权限,才能删除对象。建议使用IAM或桶策略进行授权,如果使用IAM - [批量删除对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0607.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。请您谨慎使用批量删除操作,如果对象所在的桶未开启多版本控制功能,该对象一旦删除将无法恢复。为节省空间和成本,您可以根据需要删除指定桶中的多个对象。批量删除对象特性用于将一个桶内的部分对象一次性删除,删除后不可恢复。批量删除对象要求返回结果里 - [列举桶内对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0605.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。调用列举桶内对象接口,可列举指定桶内的部分或所有对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的对象信息。返回结果以对象名的字典序排序。每次接口调用最多返回1000个对象信息。您必须是桶拥有者或拥有列举桶内对 - [判断对象是否存在(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_2308.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。判断对象是否存在,返回的结果中HTTP状态码为200表明对象存在,否则返回404表明对象或桶不存在。您必须是桶拥有者或拥有获取对象元数据的权限,才能获取对象元数据。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object: - [截断对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4016.md): 截断对象操作是指将指定桶内的一个对象截断到指定大小。您必须是并行文件系统拥有者或拥有截断对象的权限,才能执行截断操作。建议使用IAM或策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置 - [配置对象级WORM保护策略(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_4017.md): 开启了WORM开关的桶,上传的对象支持配置或修改对象保护期限。如果上传对象时没有配置保护期限或自动应用桶级默认保护策略,您可以通过该操作配置对象保护期限。如果上传对象时配置了保护期限或自动应用了默认保护期限,允许用户通过该操作延长保护期限。对象保护期限仅允许修改,不允许删除。您必须是桶拥有者或拥有配置对象级WORM保护策略的权限,才能调用 - [多段相关接口说明(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1901.md): 对于较大文件上传,可以切分成段上传。用户可以在如下的应用场景内(但不仅限于此),使用分段上传的模式:上传超过100MB大小的文件。网络条件较差,和OBS服务端之间的链接经常断开。上传前无法确定将要上传文件的大小。分段上传分为如下3个步骤:初始化分段上传任务。逐个或并行上传段。合并段或取消分段上传任务。分段上传的主要目的是解决大文件上传或网 - [初始化多段上传任务(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1902.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。使用多段上传特性时,用户必须首先调用创建多段上传任务接口创建任务,系统会给用户返回一个全局唯一的多段上传任务号,作为任务标识。后续用户可以根据这个标识发起相关的请求,如:上传段、合并段、列举段等。创建多段上传任务不影响已有的同名对象;同一个 - [上传段(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1903.md): 初始化分段上传任务后,通过分段上传任务的ID,上传段到指定桶中。上传段时,除了指定上传ID,还必须指定段编号。您可以选择1和10000之间的任意段编号。段编号在您正在上传的对象中唯一地标示了段及其位置。如果您使用之前上传的段的同一段编号上传新段,则之前上传的段将被覆盖。无论您何时上传段,OBS都将在其响应中返回ETag标头。对于每个段上传 - [合并段(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1904.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。如果用户上传完所有的段,就可以调用合并段接口,系统将在服务端将用户指定的段合并成一个完整的对象。在执行“合并段”操作以前,用户不能下载已经上传的数据。在合并段时需要将多段上传任务初始化时记录的附加消息头信息复制到对象元数据中,其处理过程和普 - [列举已上传的段(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1905.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。通过分段上传任务的ID,列举指定桶中已上传的段。您可以列出特定多段上传任务或所有正在进行的多段上传任务的分段。列举已上传的段操作将返回您已为特定多段上传任务而上传的段信息。对于每个列举已上传的段请求,OBS将返回有关特定多段上传任务的分段信 - [列举分段上传任务(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1906.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。列举指定桶中所有的初始化后还未合并或还未取消的分段上传任务。通过列举桶中的多段上传任务,您可以获得已初始化多段上传任务的列表,已初始化多段上传任务是指初始化后还未合并以及未取消的多段上传任务。每个请求将返回最多1000个多段上传任务,如果指 - [复制段(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1907.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。初始化分段上传任务后,通过指定分段上传任务的ID,复制段到指定桶中。多段上传任务创建后,用户可以通过指定多段上传任务的ID,为特定的任务上传段。添加段的方式还包括调用段复制接口。允许用户将已上传对象的一部分或全部复制为段。将源对象objec - [取消分段上传任务(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1908.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。通过分段上传任务的ID,取消指定分段上传任务。您可以选择取消多段上传任务,取消多段上传任务之后无法再次使用该上传ID上传任何段。然后,OBS将释放被取消的多段上传任务中的每个段数据的所有存储。如果有多段上传已在进行中,即使您已执行中止操作, - [获取多版本对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0804.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。您可以根据需要将存储在OBS中对象的某一个版本下载到本地。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetO - [复制多版本对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0805.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。用户可以根据需要将存储在OBS上的多版本对象复制到其他路径下,为指定桶中的多版本对象创建一个副本。在单次操作中,您可以创建最大5GB的对象副本。您必须是桶拥有者或拥有复制对象的权限,才能复制对象。建议使用IAM或桶策略进行授权,如果使用IA - [恢复多版本归档或深度归档存储对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0806.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。如果要获取归档或深度归档存储对象的内容,需要先将对象恢复,然后再执行下载数据的操作。对象恢复后,会产生一个标准存储类型的对象副本,也就是说会同时存在标准存储类型的对象副本和归档或深度归档存储对象,在恢复对象的保存时间到期后标准存储类型的对象 - [设置多版本对象权限(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0808.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。可以通过ObsClient.setObjectAcl接口指定VersionId参数设置多版本对象ACL,接口定义请参见设置对象ACL(Node.js SDK)。本示例用于设置examplebucket桶下对象example/objectna - [获取多版本对象权限(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1308.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。可以通过ObsClient.getObjectAcl接口指定VersionId参数获取多版本对象ACL,接口定义请参见获取对象ACL(Node.js SDK)。本示例用于获取名为examplebucket桶下example/objectna - [删除多版本对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0809.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。可以通过ObsClient.deleteObject接口指定VersionId参数删除多版本对象,接口定义请参见删除对象(Node.js SDK)。可以通过ObsClient.deleteObjects接口传入每个待删除对象的Version - [设置对象ACL(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0604.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其 - [获取对象ACL(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0603.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其 - [设置对象元数据(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0602.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。元数据(Metadata)为描述对象属性的信息,是一组名称值对,用作对象管理的一部分。当前支持系统定义的元数据和自定义元数据。系统定义的元数据又分为两种类别:系统控制和用户控制。如Last-Modified日期等数据由系统控制,不可修改;如 - [获取对象元数据(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0601.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。元数据(Metadata)为描述对象属性的信息,是一组名称值对,用作对象管理的一部分。当前仅支持系统定义的元数据。系统定义的元数据又分为两种类别:系统控制和用户控制。如Last-Modified日期等数据由系统控制,不可修改;如为对象配置的 - [设置对象标签(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1305.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。用户可以通过本接口设置或更新对象(Object)的标签信息。对象标签使用一组键值对(Key-Value)标记对象。您必须是桶拥有者或拥有设置对象标签的权限,才能设置对象标签。建议使用IAM或桶策略进行授权,如果请求中不携带版本号(versi - [获取对象标签(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1306.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。用户可以通过本接口获取对象(Object)的标签信息。对象标签使用一组键值对(Key-Value)标记对象。您必须是桶拥有者或拥有获取对象标签的权限,才能获取对象标签。建议使用IAM或桶策略进行授权,如果请求中不携带版本号(versionI - [删除对象标签(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1307.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。用户可以通过本接口删除对象(Object)的标签信息。对象标签使用一组键值对(Key-Value)标记对象。您必须是桶拥有者或拥有删除对象标签的权限,才能删除对象标签。建议使用IAM或桶策略进行授权,如果请求中不携带版本号(versionI - [使用临时URL进行授权访问(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_0701.md): 开发过程中,您有任何问题可以在GitHub上提交issue,或者在华为云对象存储服务论坛中发帖求助。通过访问密钥、请求方法类型、请求参数等信息生成一个在Query参数中携带鉴权信息的URL,可将该URL提供给其他用户进行临时访问。在生成URL时,需要指定URL的有效期来限制访客用户的访问时长。如果想授予其他用户对桶或对象临时进行其他操作的 - [OBS服务端错误码(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1601.md): SDK错误码是由ObsClient统一抛出的异常,继承自java.lang.RuntimeException类。用户向OBS发出请求后,如果遇到错误,此时响应中会返回错误码描述的错误信息。通常是OBS服务端错误,包含对象存储服务的错误码、错误信息等,便于用户定位问题,并做出适当的处理。了解对象存储服务的错误码更多信息,请参见OBS错误码。 - [SDK公共结果对象(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1602.md): 调用ObsClient的相关接口完成后,如果未发生异常,则均会返回公共结果对象。该对象包含的内容见下表:处理公共结果对象的代码示例如下: - [日志分析(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1603.md): OBS Node.js SDK基于log4js开源库提供了日志功能,您可以通过ObsClient.initLog开启日志功能并进行配置。代码示例如下:日志功能默认是关闭的,需要主动开启。使用file_full_path参数配置日志文件路径,可配置相对路径或绝对路径。SDK日志格式为:日志时间|日志级别|调用接口|日志内容。示例如下:当系统 - [缺少模块异常(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1604.md): 异常说明:使用OBS Node.js SDK进行二次开发时如果报缺少模块异常,如“Cannot find module 'xml2js'”。解决方案:请检查本地Node.js SDK版本号,是否为最新版本。请确保依赖库已正确安装,参见安装SDK。 - [连接超时异常(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1605.md): 异常说明:调用接口时出现“connect ETIMEDOUT”错误,表明连接超时,其原因一般是服务地址(Endpoint)错误或网络不通导致无法连接OBS服务。解决方案:请检查服务地址是否为空,或者是非法的服务器地址。请检查网络状况。检查服务端是否返回了异常的结果,并联系服务端运维团队。 - [签名不匹配异常(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1606.md): 异常说明:如果从返回结果的CommonMsg.Status中获取到的HTTP状态码为403,CommonMsg.Code中获取到的OBS服务端错误码为SignatureDoesNotMatch。解决方案:检查endpoint:是否在endpoint前多加了桶名,这个也会报签名不匹配错误。检查AK、SK:请确保AK、SK输入正确,成对匹配, - [如何指定Content-SHA256?(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1713.md): 上传对象和上传段支持携带x-obs-content-sha256头域,该头域值为请求消息体256-bit SHA256值转十六进制值,计算方式为Hex(SHA256Hash(),服务端会对携带此头域的请求计算其消息体的sha256值做校验(性能会有部分下降,在安全上推荐该算法),上传对象代码示例如下:// 引入obs库 - [为什么SDK源码中包含acs.amazonaws.com关键字?(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1714.md): OBS SDK 为了兼容访问aws s3服务,在源码中会包含acs.amazonaws.com关键字的固定格式,SDK仅作常量使用,不会向该格式有其他处理,也不会对其访问。SDK会自动兼容该场景,用户可不感知。比如Node.js SDK: - [如何获取账号ID和用户ID?(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1715.md): 从控制台获取账号名、账号ID、用户名、用户ID、项目名称、项目ID在华为云首页右上角,单击“控制台”。在右上角的用户名中选择我的凭证。在“我的凭证”界面,API凭证页签中,查看账号名、账号ID、用户名、用户ID、项目名称、项目ID。每个区域的项目ID有所不同,需要根据业务所在的区域获取对应的项目ID。在华为云首页右上角,单击“控制台”。在 - [如何理解Content-Type(MIME)(Node.js SDK)](https://support.huaweicloud.com/sdk-nodejs-devg-obs/obs_29_1716.md): Content-Type(MIME)用于标识请求或响应中所携带数据的媒体类型,浏览器根据该参数来决定数据的打开方式。Content-Type多用于指定一些客户端自定义的文件,以及一些媒体文件的打开方式。如果您在上传Object时未指定Content-Type,SDK会根据指定Object名称的后缀名来判定文件类型并自动填充Content- - [使用前须知(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0652.md): OBS SDK合规使用指南请单击此处;OBS SDK隐私声明请单击此处。本文介绍HarmonyOS SDK的版本变更,并提供版本兼容性说明,以及其他使用前须知。如表1所示,本节将为您展示HarmonyOS SDK的版本变更情况和兼容性说明。推荐使用的HarmonyOS版本:API 12及以上版本。本文档是与OBS SDK配套的参考文档,为 - [HarmonyOS SDK接口概览(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0651.md): 表1总结了OBS HarmonyOS SDK所有接口的描述与使用方式、方法定义及参数说明等内容。 - [使用前准备(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0650.md): 在使用HarmonyOS SDK访问华为云对象存储服务OBS之前,您需要先完成服务环境的准备和开发环境的准备。服务环境准备包括准备华为账号和访问密钥,是使用SDK与OBS云服务交互的必要条件。开发环境准备是让您能顺利完成SDK的安装、完成基于SDK的代码开发与运行,需要提前在本地完成的开发环境搭建,比如下载安装依赖软件、安装开发工具等。使 - [下载与安装SDK(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0649.md): 本节提供HarmonyOS SDK的下载链接,并介绍SDK的安装方式。OBS HarmonyOS SDK最新版本:OBS HarmonyOS SDK。OBS HarmonyOS SDK最新版本源码下载:最新源码下载。如表1所示,HarmonyOS SDK有以下安装方式。以安装HarmonyOS SDK最新版本为例,步骤如下: - [快速入门(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0648.md): OBS SDK对OBS服务提供的REST API进行封装,以简化用户的开发工作。您直接调用OBS SDK提供的接口函数即可使用OBS管理数据。本章节介绍了OBS HarmonyOS SDK的快速入门,帮助您快速上手OBS的基础功能,包括创建桶、上传对象、下载对象、列举对象。使用HarmonyOS SDK之前,您需要拥有一个华为账号并实名认 - [OBS客户端初始化(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0101.md): ObsClient是访问OBS服务的Harmony客户端,它为调用者提供一系列与OBS服务进行交互的接口,用于管理、操作桶(Bucket)和对象(Object)等OBS服务上的资源。使用OBS HarmonyOS SDK向OBS发起请求,您需要初始化一个ObsClient实例,并根据需要调整客户端配置参数。使用永久访问密钥(AK/SK)创 - [日志初始化(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0102.md): 通过开启SDK日志功能,可将接口调用过程中产生的日志信息记录到日志文件,用于后续的数据分析或问题定位。开启日志打印,并指定日志级别是LogLevel.INFO。 - [创建桶(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0301.md): OBS桶是对象的容器,您上传的文件都将以对象的形式存放在桶中。本文介绍如何使用HarmonyOS SDK创建桶。调用创建桶接口,将在当前账号按照用户指定的桶名创建一个新桶,接口支持根据用户诉求,在创建桶的同时配置桶的存储类别、区域及桶ACL等参数。您必须拥有obs:bucket:CreateBucket权限,才能创建桶。建议使用IAM进行 - [获取桶列表(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0641.md): OBS桶是对象的容器,您上传的文件都存放在桶中。调用获取桶列表接口,可列举当前账号所有地域下符合指定条件的桶。返回结果以桶名的字典序排序。您必须拥有obs:bucket:ListAllMyBuckets权限,才能获取桶列表。建议使用IAM进行授权,配置方式详见使用IAM自定义策略。OBS支持的Region与Endpoint的对应关系,详细 - [判断桶是否存在(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0302.md): 判断指定桶名的桶是否存在,返回的结果中HTTP状态码为200表明桶存在,否则返回404表明桶不存在。您必须是桶拥有者或拥有判断桶是否存在的权限,才能判断桶是否存在。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:HeadBucket权限,如果使用桶策略则需授予HeadBucket权限。相关授权方式介绍可参见OB - [删除桶(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0303.md): 桶为空时,用户可以删除桶,以免占用桶数量配额。删除桶后需要等待30分钟才能创建同名桶。华为云无法恢复用户主动删除的OBS数据。因此调用接口删除桶后,桶相关数据无法恢复,请谨慎操作。您必须是桶拥有者或拥有删除桶的权限,才能删除桶。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucket权限,如果使 - [列举桶内对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0304.md): 调用列举桶内对象接口,可列举指定桶内的部分或所有对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的对象信息。返回结果以对象名的字典序排序。每次接口调用最多返回1000个对象信息。如需获取更多对象,可使用Marker参数指定起始位置进行分页获取。您必须是桶拥有者或拥有列举桶内对象的权限,才能列举桶内对象。建议使 - [获取桶元数据(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0307.md): 调用获取桶元数据接口,可获取指定桶的相关信息,包括指定桶的存储类型、区域位置、跨域资源共享(CORS)规则、冗余策略等信息。您必须是桶拥有者或拥有获取桶元数据的权限,才能获取桶元数据。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:HeadBucket权限,如果使用桶策略则需授予HeadBucket权限。相关授 - [获取桶区域位置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0308.md): 获取指定桶所在的区域位置。您必须是桶拥有者或拥有获取桶区域位置的权限,才能获取桶区域位置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketLocation权限,如果使用桶策略则需授予GetBucketLocation权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策 - [获取桶存量信息(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0309.md): 调用获取桶存量信息接口,可查询指定桶内的对象个数,以及对象占用空间的大小。由于OBS桶存量是后台统计,因此存量会有一定的时延,不能实时更新,因此不建议对存量做实时校验。您必须是桶拥有者或拥有获取桶存量信息的权限,才能获取桶存量信息。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketStorage - [设置桶配额(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0310.md): 桶配额是桶容量的上限值。默认情况下,OBS系统和单个桶都没有总数据容量和对象数量的限制。您可以根据需要,为桶设置配额限制来控制桶内允许上传的对象总容量,超过设置的对象容量后,上传对象会失败。例如您为桶设置配额为100G,那么当桶内所有对象的大小总和达到100G后,再上传对象就会因为超过配额导致上传失败。容量限制只对桶配额设置生效后的对象上 - [获取桶配额(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0311.md): 桶配额是桶容量的上限值。调用获取桶配额接口,可获取指定桶的配额值。桶配额为0代表桶容量没有上限。桶配额值必须为非负整数,单位为字节,支持的最大值为263-1。桶的拥有者的状态是欠费冻结状态时不可以查询桶配额信息。您必须是桶拥有者或拥有获取桶配额的权限,才能获取桶配额。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucke - [设置桶存储类型(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0312.md): OBS提供了以下存储类型:标准存储、低频访问存储、归档存储、深度归档存储,从而满足客户业务对存储性能、成本的不同诉求,详情可参见OBS存储类型。调用设置桶存储类型接口,可设置指定桶的存储类型。设置了桶的默认存储类型之后,若上传对象、复制对象和初始化多段上传任务时未指定对象的存储类型,则该对象的存储类型默认与桶的存储类型保持一致。您必须是桶 - [获取桶存储类型(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0313.md): OBS提供了四种存储类型:标准存储、低频访问存储、归档存储、深度归档存储,从而满足客户业务对存储性能、成本的不同诉求,详情可参见OBS存储类型。调用获取桶存储类型接口,可获取指定桶的存储类型。您必须是桶拥有者或拥有获取桶存储类型的权限,才能获取桶存储类型。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetB - [设置桶ACL(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0314.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [获取桶ACL(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0315.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [设置桶日志管理配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0316.md): 调用设置桶日志管理配置接口,您可以为指定桶打开桶日志功能,并配置日志存放的目标桶。创建桶时,默认是不生成桶的日志的,调用HarmonyOS SDK的设置桶日志管理配置接口时,接口会自动为您打开桶日志配置。桶日志功能开启后,桶的每次操作将会产生一条日志,并将多条日志打包成一个日志文件。日志文件存放位置需要在开启桶日志功能时指定,可以存放到开 - [获取桶日志管理配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0317.md): 调用获取桶日志管理配置,可获取指定桶的日志配置。您必须是桶拥有者或拥有获取桶日志管理配置的权限,才能获取桶日志管理配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketLogging权限,如果使用桶策略则需授予GetBucketLogging权限。相关授权方式介绍可参见OBS权限控制概述,配置 - [设置桶策略(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0318.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。桶策略是作用于所配置的OBS桶及桶内对象的,您可以通过桶策略可为IAM用户 - [获取桶策略(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0319.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。桶策略是作用于所配置的OBS桶及桶内对象的,您可以通过桶策略可为IAM用户 - [删除桶策略(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0320.md): OBS支持对桶操作进行权限控制,您可以为桶设置访问策略,指定某一个用户对某一个桶是否有权行使某一项指定操作。OBS权限控制的方式有IAM、桶策略和ACL三种,本节将对桶策略接口进行详细介绍,更多权限相关内容可参见《对象存储服务权限配置指南》的OBS权限控制概述章节。桶策略是作用于所配置的OBS桶及桶内对象的,您可以通过桶策略可为IAM用户 - [设置桶的生命周期配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0321.md): OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用更多生命周期相关信息请参见生命周期管理。调用设置桶的生命周期配置接口,您可以为指定桶设置生命周期策略。对象生命周期到期以后,对象将会永久删除,无法恢复。归档存储和深度归档存储不支持多AZ,因此不支持使用生命周期的存储类别转换功能,将多AZ的桶或 - [获取桶的生命周期配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0322.md): OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用获取桶的生命周期配置接口,您可以获取指定桶的生命周期策略。您必须是桶拥有者或拥有获取桶的生命周期配置的权限,才能获取桶的生命周配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bu - [删除桶的生命周期配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0323.md): OBS支持用户配置指定的规则,实现定时删除桶中的对象或者定时转换对象的存储类别,从而节省存储费用,更多生命周期相关信息请参见生命周期管理。调用删除桶的生命周期配置接口,您可以删除指定桶的生命周期策略。您必须是桶拥有者或拥有删除桶的生命周期配置的权限,才能删除桶的生命周配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bu - [设置桶的Website配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0324.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用设置桶的网站配置接口,您可以为指定桶设置网站配 - [获取桶的Website配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0325.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用获取桶的网站配置接口,您可以获取指定桶的网站配 - [删除桶的Website配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0326.md): OBS允许在桶内保存静态的网页资源,如.html网页文件、flash文件、音视频文件等,当客户端通过桶的Website接入点访问这些对象资源时,浏览器可以直接解析出这些支持的网页资源,呈现给最终用户。典型的应用场景有:重定向所有的请求到另外一个站点。设定特定的重定向规则来重定向特定的请求。调用删除桶的网站配置接口,您可以删除指定桶的网站配 - [设置桶的多版本状态(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0327.md): OBS支持多版本控制,您可以在一个桶中保留对象的多个版本,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。更多多版本相关信息请参见多版本控制。调用设置桶的多版本状态接口,您可以为指定桶设置多版本状态。您必须是桶拥有者或拥有设置桶的多版本状态的权限,才能设置桶的多版本状态。建议使用IAM或桶策略进行授权,如果使用IA - [获取桶的多版本状态(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0328.md): OBS支持多版本控制,您可以在一个桶中保留对象的多个版本,使您更方便地检索和还原各个版本,在意外操作或应用程序故障时快速恢复数据。更多多版本相关信息请参见多版本控制。调用获取桶的多版本状态接口,您可以获取指定桶的多版本状态。您必须是桶拥有者或拥有获取桶的多版本状态的权限,才能获取桶的多版本状态。建议使用IAM或桶策略进行授权,如果使用IA - [列举桶内多版本对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0305.md): 用列举桶内对象接口,可列举指定桶内的部分或所有多版本对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的多版本对象信息。以多版本对象名的字典序排序。您必须是桶拥有者或拥有列举桶内多版本对象的权限,才能列举桶内多版本对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:ListBuck - [设置桶的CORS配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0640.md): 跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全策略(Same Origin Policy,SOP)的存在,不同域之间的网站脚本和内容是无法进行交互 - [获取桶的CORS配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0329.md): 跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全策略(Same Origin Policy,SOP)的存在,不同域之间的网站脚本和内容是无法进行交互 - [删除桶的CORS配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0330.md): 跨域资源共享(Cross Origin Resource Sharing,CORS)是由W3C标准化组织提出的一种网络浏览器的规范机制,定义了一个域中加载的客户端Web应用程序与另一个域中的资源交互的方式。而在通常的网页请求中,由于同源安全策略(Same Origin Policy,SOP)的存在,不同域之间的网站脚本和内容是无法进行交互 - [设置桶标签(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0333.md): 为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,我们可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的标签来分析此应用的成本。调用设置桶标签接口,您可为指定桶添加标签。每个桶最多能设置10个标签。标 - [获取桶标签(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0334.md): 为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,我们可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的标签来分析此应用的成本。调用获取桶标签接口,您可获取指定桶的标签。您必须是桶拥有者或拥有获取桶标 - [删除桶标签(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0335.md): 为桶添加标签后,该桶上所有请求产生的计费话单里都会带上这些标签,从而可以针对话单报表做分类筛选,进行更详细的成本分析。例如:某个应用程序在运行过程会往桶里上传数据,我们可以用应用名称作为标签,设置到被使用的桶上。在分析话单时,就可以通过应用名的标签来分析此应用的成本。调用删除桶标签接口,您可删除指定桶的标签。您必须是桶拥有者或拥有删除桶标 - [设置桶的加密配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0639.md): 设置桶的加密配置,以允许在该桶中上传对象时,采用对应加密配置对数据进行加密,数据会在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用设置桶加密配置接口,您可以为指定桶创建或更新加密配置信息。您必须是桶拥有者或拥有设置桶加密配置的权限,才能设置桶加密配置。建议使用IAM或桶策略进行授权,如果 - [获取桶的加密配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0638.md): 桶的加密配置功能,支持在该桶中上传对象时,采用对应加密配置对数据进行加密,数据会在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用获取桶加密配置接口,您可以获取指定桶的加密配置信息。您必须是桶拥有者或拥有获取桶加密配置的权限,才能获取桶加密配置。建议使用IAM或桶策略进行授权,如果使用IA - [删除桶的加密配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0637.md): 桶的加密配置功能,支持在该桶中上传对象时,采用对应加密配置对数据进行加密,数据会在服务端被加密成密文后存储,用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。调用删除桶加密配置接口,您可以删除指定桶的加密配置信息。您必须是桶拥有者或拥有删除桶加密配置的权限,才能删除桶加密配置。建议使用IAM或桶策略进行授权,如果使用IA - [设置桶的自定义域名(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0636.md): 调用设置桶的自定义域名配置接口,您可以您可以为指定桶设置的自定义域名信息。您必须是桶拥有者或拥有设置桶的自定义域名的权限,才能设置桶的自定义域名信息。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutBucketCustomDomainConfiguration权限,如果使用桶策略则需授予PutBucket - [获取桶的自定义域名(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0635.md): 调用获取桶的自定义域名配置接口,您可以获取指定桶的自定义域名配置信息。您必须是桶拥有者或拥有获取桶的自定义域名配置的权限,才能获取桶的自定义域名配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketCustomDomainConfiguration权限,如果使用桶策略则需授予GetBucket - [删除桶的自定义域名(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0634.md): 调用删除桶的自定义域名接口,您可以删除指定桶的自定义域名信息。您必须是桶拥有者或拥有删除桶的自定义域名的权限,才能删除桶的自定义域名。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketCustomDomainConfiguration权限,如果使用桶策略则需授予DeleteBucketCu - [设置镜像回源规则(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0702.md): 镜像回源是OBS提供的一种数据自动获取功能。调用设置桶镜像回源规则接口,您可为指定桶配置镜像回源规则,当客户端访问桶中不存在的对象时,OBS会自动从源站获取数据并返回给客户端,同时将数据存储到桶中。您必须是桶拥有者或拥有设置桶镜像回源规则的权限,才能设置桶镜像回源规则。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:buck - [获取镜像回源规则(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0703.md): 调用获取桶镜像回源规则接口,您可获取指定桶的镜像回源规则配置。您必须是桶拥有者或拥有获取桶镜像回源规则的权限,才能获取桶镜像回源规则配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketMirrorBackToSource权限,如果使用桶策略则需授予GetBucketMirrorBackToS - [删除镜像回源规则(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0704.md): 调用删除桶镜像回源规则接口,您可删除指定桶的镜像回源规则配置。删除后,访问不存在的对象时将不再从源站获取数据。您必须是桶拥有者或拥有删除桶镜像回源规则的权限,才能删除桶镜像回源规则配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketMirrorBackToSource权限,如果使用桶策 - [设置桶级阻止公共访问配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0706.md): 公共访问是指请求者无需拥有特定权限或身份验证即可访问桶和桶内数据,此操作存在数据泄露和恶意访问导致大量外网流量的风险。OBS支持为桶配置阻止公共访问功能,可通过本接口设置桶级BPA,从而确保桶内数据的安全性。如果开启阻止公开访问,则已有的公开访问权限会被忽略,并且不允许配置新的公开访问权限。如果关闭阻止公开访问,则已有的公开访问权限仍然生 - [获取桶级阻止公共访问配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0707.md): 可通过本接口获取桶级BPA配置的相关信息。您必须是桶拥有者或拥有获取桶级阻止公共访问配置的权限,才能获取桶级阻止公共访问配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPublicAccessBlock权限,如果使用桶策略则需授予GetBucketPublicAccessBlock权限。 - [删除桶级阻止公共访问配置(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0710.md): 可通过本接口删除桶级BPA配置。您必须是桶拥有者或拥有删除桶级阻止公共访问配置的权限,才能删除桶级阻止公共访问配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketPublicAccessBlock权限,如果使用桶策略则需授予DeleteBucketPublicAccessBlock权限 - [获取桶公共状态(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0711.md): 调用获取桶公共状态接口,您可以查询指定桶是否为公开状态。桶的公共状态综合考虑了桶策略、ACL和阻止公共访问配置等多个维度的信息,用于判断桶是否存在公共访问风险。您必须是桶拥有者或拥有获取桶公共状态的权限,才能获取桶公共状态。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPublicStatu - [获取桶策略公共状态(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0712.md): 调用获取桶策略公共状态接口,您可以查询指定桶的桶策略是否为公开状态。您必须是桶拥有者或拥有获取桶策略公共状态的权限,才能获取桶策略公共状态。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketPolicyStatus权限,如果使用桶策略则需授予GetBucketPolicyStatus权限。相关授 - [设置桶清单(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0714.md): 桶清单功能可以定期生成桶内对象的元数据信息,通过查看这些信息,可以帮助您更好地了解桶内对象的状态,调用本接口可以配置桶清单功能。您必须是桶拥有者或拥有设置桶清单的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutBucketInventoryConfiguration权限,如果使用桶策 - [获取桶清单(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0715.md): 桶清单功能可以定期生成桶内对象的元数据信息,通过查看这些信息,可以帮助您更好地了解桶内对象的状态,可通过本接口获取桶清单。您必须是桶拥有者或拥有设置桶清单的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:PutBucketInventoryConfiguration权限,如果使用桶策略则需 - [列举桶清单(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0716.md): 调用列举桶清单接口,您可获取指定桶的所有清单配置信息。您必须是桶拥有者或拥有列举桶清单的权限,才能列举桶清单配置。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:GetBucketInventoryConfiguration权限,如果使用桶策略则需授予GetBucketInventoryConfiguratio - [删除桶清单(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0717.md): 调用删除桶清单接口,您可根据清单配置ID删除指定桶的某条清单配置。删除后,OBS将不再为该规则生成清单文件。您必须是桶拥有者或拥有删除桶清单的权限,才能调用本接口。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:bucket:DeleteBucketInventoryConfiguration权限,如果使用桶策略则需授予De - [创建并行文件系统(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0632.md): OBS并行文件系统是对象的容器,您上传的文件都将以对象的形式存放在并行文件系统中。本文介绍如何使用HarmonyOS SDK创建并行文件系统。调用创建并行文件系统接口,将在当前账号按照用户指定的并行文件系统名创建一个新并行文件系统,接口支持根据用户诉求,在创建并行文件系统的同时配置并行文件系统的存储类别、区域及并行文件系统的访问权限等参数 - [列举并行文件系统(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0631.md): 调用获取并行文件系统列表接口,可列举当前账号所有地域下符合指定条件的并行文件系统。返回结果以并行文件系统名的字典序排序。您必须拥有obs:bucket:ListAllMyBuckets权限,才能获取并行文件系统列表。建议使用IAM进行授权,配置方式详见使用IAM自定义策略。OBS支持的Region与Endpoint的对应关系,详细信息请参 - [列举并行文件系统内对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0630.md): 调用列举并行文件系统内对象接口,可列举指定并行文件系统内的部分或所有对象的描述信息。您还可以通过设置前缀、数量、起始位置等参数,返回符合您筛选条件的对象信息。返回结果以对象名的字典序排序。您必须是并行文件系统拥有者或拥有列举并行文件系统内对象的权限,才能列举并行文件系统内对象。建议使用IAM或策略进行授权,如果使用IAM则需授予obs:b - [重命名对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0626.md): 对于并行文件系统内的文件,支持对文件的重命名操作。您必须是并行文件系统拥有者或拥有重命名文件的权限,才能重命名文件。建议使用IAM或策略进行授权,如果使用IAM则需授予obs:bucket:PutObject权限,如果使用策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对 - [修改写对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0625.md): 将指定并行文件系统内的一个对象从指定位置起修改为其他内容。您必须是并行文件系统拥有者或拥有修改写对象的权限,才能修改写对象。建议使用IAM或策略进行授权,如果使用IAM则需授予obs:bucket:PutObject权限,如果使用策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略 - [截断对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0624.md): 截断对象操作是指将指定并行文件系统内的一个对象截断到指定大小。您必须是并行文件系统拥有者或拥有截断对象的权限,才能截断对象。建议使用IAM或策略进行授权,如果使用IAM则需授予obs:bucket:PutObject权限,如果使用策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略 - [上传对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0623.md): 本章节介绍上传单个对象到指定桶中。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则需授予PutObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对象策略。OBS支持的Reg - [批量上传(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0718.md): 本示例用于将多个本地文件批量上传到 OBS 桶。通过指定并发数控制同时上传的任务数量,并利用 Promise.all 分批并发执行 putObject 请求,每个文件上传完成后实时记录结果,便于统计成功与失败情况。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object - [断点续传上传(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0719.md): 断点续传上传基于分段上传实现,适用于大文件上传场景。SDK 按指定的分段大小将本地文件切片,并发上传各段,合并完成对象写入。开启断点续传后,上传中断可依据检查点文件续传未完成段,避免全量重传。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权 - [追加上传(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0403.md): 您可以根据需要上传文件或者文件夹至已有的OBS桶。待上传的文件可以是任何类型:文本文件、图片、视频等。追加写对象操作是指在指定桶内的一个对象尾追加上传数据,不存在相同对象键值的对象则创建新对象。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject - [下载对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0404.md): 您可以根据需要将存储在OBS中的对象下载到本地。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObject权限,如果使用桶策略则需授予GetObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对象策略。OB - [批量下载(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0720.md): 本示例用于将 OBS 桶内满足指定前缀的对象批量下载到本地目录。先通过 listObjects 列举满足前缀的对象,再利用 Promise.all 分批并发执行 getObject 请求,将对象下载到本地指定路径。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object - [断点续传下载(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0721.md): 断点续传下载基于 Range 分段下载实现,适用于大文件下载场景。SDK 按分段大小并发下载各段到临时文件,下载完成后将临时文件原子重命名为目标文件。开启断点续传后,下载中断可依据检查点续传未完成段。您必须是桶拥有者或拥有下载对象的权限,才能下载对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObj - [复制对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0405.md): 用户可以根据需要将存储在OBS上的对象复制到其他路径下。复制对象操作将创建需要复制的对象的副本。在单次操作中,您可以创建最大5GB的对象副本。为指定桶中的对象创建一个副本。您必须是桶拥有者或拥有复制对象的权限,才能复制对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:PutObject权限,如果使用桶策略则 - [批量复制对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0722.md): 本示例用于将 OBS 对象批量复制到目标桶,支持同桶或跨桶复制。通过对象列表构造源对象到目标对象的映射,利用 Promise.all 分批并发执行 copyObject 请求,每个对象复制完成后实时记录结果。您必须是桶拥有者或拥有复制对象的权限,才能复制对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:Pu - [删除对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0406.md): 为节省空间和成本,您可以根据需要删除指定桶中的单个对象。您必须是桶拥有者或拥有删除对象的权限,才能删除对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:DeleteObject权限,如果使用桶策略则需授予DeleteObject权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略 - [批量删除对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0407.md): 为节省空间和成本,您可以根据需要删除指定桶中的多个对象。批量删除对象特性用于将一个桶内的部分对象一次性删除,删除后不可恢复。批量删除对象要求返回结果里包含每个对象的删除结果。OBS的批量删除对象使用同步删除对象的方式,每个对象的删除结果返回给请求用户。您必须是桶拥有者或拥有批量删除对象的权限,才能批量删除对象。建议使用IAM或桶策略进行授 - [恢复归档或深度归档存储对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0417.md): 如果要获取归档或深度归档存储对象的内容,需要先将对象恢复,然后再执行下载数据的操作。对象恢复后,会产生一个标准存储类型的对象副本,也就是说会同时存在标准存储类型的对象副本和归档或深度归档存储对象,在恢复对象的保存时间到期后标准存储类型的对象副本会自动删除。该接口可以恢复指定桶中的归档或深度归档存储对象。您必须是桶拥有者或拥有恢复归档或深度 - [批量恢复归档或深度归档存储对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0723.md): 本示例用于批量恢复归档或深度归档存储的对象,使其临时转换为可读状态。通过对象列表指定需要恢复的对象,利用 Promise.all 分批并发执行 restoreObject 请求,可指定恢复速率(Tier)和保留天数(Days)。您必须是桶拥有者或拥有恢复归档或深度归档存储对象的权限,才能恢复归档或深度归档存储对象。建议使用IAM或桶策略进 - [进度回调(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0724.md): 进度回调是 SDK 本地能力:应用在上传或下载接口的入参中设置 ProgressCallback 回调函数,SDK 在数据传输过程中按已传字节数调用该函数,应用据此刷新界面进度。回调函数仅上报已传字节数等进度信息,不干预主传输流程。回调失败不影响主数据传输,SDK 捕获并忽略回调异常。ProgressCallback 是一个函数类型的参数 - [上传回调(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0725.md): 用户可以在上传对象请求中设置回调参数,对象上传成功之后,OBS将上传结果回调特定服务器,并将回调结果返回给用户。回调成功,返回回调结果给客户端,同时将上传对象的Etag以头域返回,当回调结果也包含Etag时,将对Etag拼接后返回。回调失败,返回203,表示对象上传成功但是回调失败。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议 - [分段相关接口概述(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0620.md): 对于较大文件上传,可以切分成段上传。用户可以在如下的应用场景内(但不仅限于此),使用分段上传的模式:上传超过100MB大小的文件。网络条件较差,和OBS服务端之间的链接经常断开。上传前无法确定将要上传文件的大小。分段上传分为如下3个步骤:初始化分段上传任务。逐个或并行上传段。合并段或取消分段上传任务。以下代码简单展示了分段上传的各个步骤: - [初始化分段上传任务(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0411.md): 使用多段上传特性时,用户必须首先调用创建多段上传任务接口创建任务,系统会给用户返回一个全局唯一的多段上传任务号,作为任务标识。后续用户可以根据这个标识发起相关的请求,如:上传段、合并段、列举段等。创建多段上传任务不影响已有的同名对象;同一个对象可以同时存在多个多段上传任务;每个多段上传任务在初始化时可以附加消息头信息,包括acl、用户自定 - [上传段(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0412.md): 初始化分段上传任务后,通过分段上传任务的ID,上传段到指定桶中。除了最后一段以外,其他段的大小范围是100KB~5GB;最后一段的大小范围是0~5GB。上传的段的编号也有范围限制,其范围是1~10000。上传段时,除了指定上传ID,还必须指定段编号。您可以选择1和10000之间的任意段编号。段编号在您正在上传的对象中唯一地标示了段及其位置 - [合并段(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0415.md): 如果用户上传完所有的段,就可以调用合并段接口,系统将在服务端将用户指定的段合并成一个完整的对象。在执行“合并段”操作以前,用户不能下载已经上传的数据。在合并段时需要将多段上传任务初始化时记录的附加消息头信息复制到对象元数据中,其处理过程和普通上传对象带这些消息头的处理过程相同。在并发合并段的情况下,仍然遵循Last Write Win策略 - [列举已上传的段(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0414.md): 通过分段上传任务的ID,列举指定桶中已上传的段。您可以列出特定多段上传任务或所有正在进行的多段上传任务的分段。列举已上传的段操作将返回您已为特定多段上传任务而上传的段信息。对于每个列举已上传的段请求,OBS将返回有关特定多段上传任务的分段信息,最多为1000个分段。如果多段上传中的段超过1000个,您必须发送一系列列举已上传的段请求以检索 - [列举分段上传任务(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0306.md): 列举指定桶中所有初始化后还未合并或还未取消的分段上传任务。通过列举桶中的多段上传任务,您可以获得已初始化多段上传任务的列表,已初始化多段上传任务是指初始化后还未合并以及未取消的多段上传任务。每个请求将返回最多1000个多段上传任务,如果正在进行的多段上传任务超过1000个,您需要发送其他请求以检索剩余的多段上传任务。您必须是桶拥有者或拥有 - [复制段(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0413.md): 初始化分段上传任务后,通过分段上传任务的ID,复制段到指定桶中。多段上传任务创建后,用户可以通过指定多段上传任务号,为特定的任务上传段。添加段的方式还包括调用段复制接口。允许用户将已上传对象的一部分或全部复制为段。将源对象object复制为一个段part1,如果在复制操作之前part1已经存在,复制操作执行之后,旧的段数据part1会被新 - [取消分段上传任务(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0416.md): 通过分段上传任务的ID,取消指定桶中的分段上传任务。您可以选择取消多段上传任务,取消多段上传任务之后无法再次使用该上传ID上传任何段。然后,OBS将释放被取消的多段上传任务中的每个段数据的所有存储。如果有多段上传已在进行中,即使您已执行中止操作,它们仍可以上传成功或失败。如果要释放所有分段使用的所有存储,必须在完成所有多段上传后再取消多段 - [设置对象元数据(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0408.md): 元数据(Metadata)为描述对象属性的信息,是一组名称值对,用作对象管理的一部分。当前仅支持系统定义的元数据。系统定义的元数据又分为两种类别:系统控制和用户控制。如Last-Modified日期等数据由系统控制,不可修改;如为对象配置的ContentLanguage,用户可以通过接口进行修改。对指定桶中的对象发送HEAD请求,设置对象 - [获取对象元数据(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0622.md): 元数据(Metadata)为描述对象属性的信息,是一组名称值对,用作对象管理的一部分。当前仅支持系统定义的元数据。系统定义的元数据又分为两种类别:系统控制和用户控制。对指定桶中的对象发送HEAD请求,获取对象的元数据信息。您必须是桶拥有者或拥有获取对象元数据的权限,才能获取对象元数据。建议使用IAM或桶策略进行授权,如果使用IAM则需授予 - [设置对象ACL(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0409.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [获取对象ACL(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0410.md): 访问控制列表(Access Control List,ACL)用于资源拥有者给其他账号授予资源的访问权限。默认情况下,创建存储桶或对象时仅资源拥有者对资源的完全控制权限,即桶创建者对桶拥有完全控制权限,对象上传者对对象拥有完全控制权限,而其他账号默认无权访问资源。如果资源拥有者想授予其他账号资源的读写权限,可以使用ACL实现。OBS桶和对 - [设置对象存储类别(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0727.md): 调用本接口修改对象的存储类别。您必须是桶拥有者或拥有设置对象存储类别的权限,才能设置对象存储类别。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:ModifyObjectMetaData权限,如果使用桶策略则需授予ModifyObjectMetaData权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详 - [获取对象存储类别(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0728.md): 调用本接口查询对象的存储类别。您必须是桶拥有者或拥有获取对象存储类别的权限,才能获取对象存储类别。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object:GetObjectAcl权限,如果使用桶策略则需授予GetObjectAcl权限。相关授权方式介绍可参见OBS权限控制概述,配置方式详见使用IAM自定义策略、配置对象 - [生成带授权信息的URL(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0501.md): 通过访问密钥、请求方法类型、请求参数等信息生成一个在Query参数中携带鉴权信息的URL,可将该URL提供给其他用户进行临时访问。在生成URL时,需要指定URL的有效期来限制访客用户的访问时长。如果想授予其他用户对桶或对象临时进行其他操作的权限(例如上传或下载对象),则需要生成带对应请求的URL后(例如使用生成PUT请求的URL上传对象) - [生成带授权信息的表单上传参数(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0502.md): 生成用于鉴权的请求参数,以进行基于浏览器的POST表单上传。使用SDK生成的用于鉴权的请求参数包括两个:Policy,对应表单中policy字段。Signature,对应表单中的x-obs-signature字段。您必须是桶拥有者或拥有上传对象的权限,才能上传对象。建议使用IAM或桶策略进行授权,如果使用IAM则需授予obs:object - [自定义头域(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0729.md): OBS HarmonyOS SDK 支持在发起请求时携带自定义 HTTP 头域。通过请求参数中传入ExtensionHeaders 字段设置,所有操作(PUT/GET/DELETE/LIST 等)均支持。以 x-obs- 开头的头域名称会自动转为小写,并参与请求签名计算其他头域保持原始大小写,仅作为 HTTP 头发送,不参与签名本示例在上 - [HTTP状态码(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0609.md): OBS服务端遵照HTTP规范,在接口调用完成均会返回标准的HTTP状态码,HTTP状态码分类以及OBS中常见的HTTP状态码如下:HTTP状态码分类:分类分类描述1XX信息,服务器收到请求,需要请求者继续执行操作,一般对用户调用函数不可见。2XX成功,操作被成功接收并处理。3XX重定向,需要进一步的操作以完成请求。4XX客户端错误,请求包 - [OBS服务端错误码(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0608.md): 用户向OBS发出请求后,如果遇到错误,此时响应中会返回错误码和错误信息。通常是OBS服务端错误,包含对象存储服务的错误码、错误信息等,便于用户定位问题,并做出适当的处理。了解对象存储服务的错误码更多信息,请参见OBS错误码。 - [SDK公共结果对象(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0104.md): 调用OBS客户端的相关接口完成后,如果未发生异常,则均会返回公共结果对象。 - [日志分析(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0607.md): 日志功能默认是关闭的,需要主动开启。SDK日志格式为:日志时间|打印日志所在的文件:行号|日志级别|日志内容。示例如下:当系统出现问题需要定位且当前的日志无法满足要求时,可以通过修改日志的级别来获取更多的信息。SDK提供了代表日志级别的枚举常量以设置不同的日志级别,具体说明如下: - [如何获取账号ID和用户ID?(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0605.md): 从控制台获取账号名、账号ID、用户名、用户ID、项目名称、项目ID在华为云首页右上角,单击“控制台”。在右上角的用户名中选择我的凭证。进入我的凭证在“我的凭证”界面,API凭证页签中,查看账号名、账号ID、用户名、用户ID、项目名称、项目ID。每个区域的项目ID有所不同,需要根据业务所在的区域获取对应的项目ID。查看账号名、账号ID、用户 - [如何理解Content-Type(MIME)?(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0604.md): Content-Type(MIME)用于标识请求或响应中所携带数据的媒体类型,浏览器根据该参数来决定数据的打开方式。Content-Type多用于指定一些客户端自定义的文件,以及一些媒体文件的打开方式。如果您在上传Object时未指定Content-Type,SDK会根据指定Object名称的后缀名来判定文件类型并自动填充Content- - [如何使对象可以被匿名用户访问?(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0603.md): 如果想让对象可以被匿名用户访问,可通过以下三步完成。 - [如何获取对象URL?(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0602.md): 按https://桶名.域名/文件夹目录层级/对象名的方式进行拼接。如果该对象存在于桶的根目录下,则链接地址将不需要有文件夹目录层级。各区域对应的域名可以从这里的终端节点查看。例如需访问区域为“华北-北京四”的桶名为“testbucket”中“test”文件夹下对象名为“test.txt”的对象,则该对象的URL为https://test - [如何定位上传回调失败的问题?(HarmonyOS SDK)](https://support.huaweicloud.com/sdk-harmony-devg-obs/obs_34_0730.md): 按https://桶名.域名/文件夹目录层级/对象名的方式进行拼接。如果该对象存在于桶的根目录下,则链接地址将不需要有文件夹目录层级。各区域对应的域名可以从这里的终端节点查看。例如需访问区域为“华北-北京四”的桶名为“testbucket”中“test”文件夹下对象名为“test.txt”的对象,则该对象的URL为https://test ## 常见问题 - [如何获取OBS的终端节点?](https://support.huaweicloud.com/obs_faq/obs_faq_0124.md): OBS可以通过域名进行访问,在使用API、第三方工具等方式使用OBS时,可通过域名方便定位OBS中的资源。在使用OBS之前,请确保客户端环境已经正确配置DNS服务器地址,用于OBS域名解析。不同的数据中心分配对应的域名,域名详情请参见地区和终端节点。 - [我可以在OBS中存储多少数据?](https://support.huaweicloud.com/obs_faq/obs_faq_0010.md): OBS系统和单个桶都没有总数据容量和对象/文件数量的限制,但对于单次上传对象的大小有如下限制:OBS管理控制台支持批量上传文件,单次最多支持1000个文件同时上传,总大小不超过5GB。如果只上传1个文件,则这个文件最大为5GB。OBS Browser+、obsutil、API和SDK上传的单个对象最大是48.8TB。用户所购买的资源包的大 - [我如何选择将数据存储在哪个区域?](https://support.huaweicloud.com/obs_faq/obs_faq_0019.md): 选择区域时,您需要考虑以下几个因素:地理位置一般情况下,建议就近选择靠近您或者您的目标用户的区域,这样可以减少网络时延,提高访问速度。不过,在基础设施、BGP网络品质、资源的操作与配置等方面,中国大陆各个区域间区别不大,如果您或者您的目标用户在中国大陆,可以不用考虑不同区域造成的网络时延问题。在除中国大陆以外的亚太地区有业务的用户,可以选 - [OBS支持使用HTTPS协议访问吗?](https://support.huaweicloud.com/obs_faq/obs_03_0071.md): OBS对HTTPS的支持情况如下:OBS桶域名:支持,在浏览器中将桶或对象的URL的http替换成https即可。OBS自定义域名:支持,如需使用请参见证书托管。开启CDN加速后的OBS加速域名:支持,开启CDN加速后可通过CDN控制台进行HTTPS证书管理,即可使用HTTPS访问。CDN管理控制台HTTPS证书管理方式,详见HTTPS配 - [OBS中的数据可以让其他用户访问吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0125.md): 可以。对于桶,可以通过桶ACL和桶策略授予其他用户桶的读取权限,其他用户即可访问该桶。对于对象,可以通过对象ACL,对象策略和桶策略来授予其他用户对象的读取权限,或者设置对象分享功能,其他用户即可访问该对象。 - [访问OBS链接提示告警信息的原因和解决办法](https://support.huaweicloud.com/obs_faq/obs_faq_0144.md): 因为部分用户使用OBS桶时上传了包含色情、暴恐、涉政等违法违规内容,OBS和第三方平台(微信/支付宝/百度等)检测到后会封禁此资源。第三方平台在封禁此资源的同时,会将OBS域名列为不信任域名,导致其他合法使用OBS域名的用户也受到影响。需要通过第三方平台,如微信/支付宝/百度等平台或小程序使用OBS的用户,建议使用自定义域名访问OBS资源 - [已删除的数据是否可以恢复?](https://support.huaweicloud.com/obs_faq/obs_03_0139.md): 已删除的数据能否恢复取决于您是否开启了多版本控制功能:桶开启了多版本控制功能时:对象列表页未开启“历史版本”开关时,单击“删除”按钮删除对象后,在对象列表中无法看到已删除对象,而打开“历史版本”开关后,在对象列表中可以看到带删除标记的当前版本对象和被删除后成为历史版本的对象。此时,单击带删除标记的当前版本对象操作列的“彻底删除”,即可恢复 - [访问OBS域名失败,连接不上CA证书](https://support.huaweicloud.com/obs_faq/obs_faq_0066.md): 在证书不受信的情况下,访问OBS域名会失败,需要重新获取OBS证书并将其导入客户端信任库。在浏览器中访问OBS域名:https://obs.myhuaweicloud.com。单击域名左侧的,选择“证书”。导出证书单击“详细信息 > 复制到文件”,根据向导提示获取OBS证书(obs.cer)。以Java运行环境为例,需要将证书导入cace - [为什么OBS存储的数据丢失了?](https://support.huaweicloud.com/obs_faq/obs_03_0138.md): 如果您的OBS中存储的数据丢失了,请按照以下原因排查:请检查桶中是否设置了生命周期过期删除规则,符合规则的对象会被删除。请检查桶是否授权了其他用户桶的写权限,被授权的用户都可以删除对象。如果您开启了日志记录功能,可以通过日志记录查询到删除对象的用户。 - [OBS是否支持流量监控?](https://support.huaweicloud.com/obs_faq/obs_faq_0111.md): OBS支持流量监控功能:通过OBS管理控制台的用量统计,能监控统计周期内的流量指标。查看方法,请参见查看用量统计。通过云监控CES,能查看的OBS相关指标请参见对象存储服务监控指标说明。 - [OBS上传下载速率的影响因素有哪些?](https://support.huaweicloud.com/obs_faq/obs_03_0100.md): 影响OBS上传下载速率的因素有:单个华为云账号默认的OBS读写带宽(GET请求带宽与PUT请求带宽的总和)上限是16Gbit/s(包括公网和内网带宽一共16Gbit/s)。如果带宽达到该阈值,请求会触发流控。如果用户购买的虚拟机网卡带宽低于16Gbit/s,那么节点带宽会先受虚机带宽限制,需要购买多台虚拟机并发运行才能达到16Gbit/s - [对象存储与SAN存储和NAS存储相比较有什么优势?](https://support.huaweicloud.com/obs_faq/obs_faq_0006.md): SAN存储提供给应用的是一个LUN或者是一个卷,LUN和卷是面向磁盘空间的一种组织方式,上层应用要通过FC或者ISCSI协议访问SAN。SAN存储处理的是管理磁盘的问题,其他事情都要依靠上层的应用程序实现。NAS存储提供给应用的是一个文件系统或者是一个文件夹,上层应用通过NFS和CIFS协议进行访问。文件系统要维护一个目录树。对象存储更加 - [OBS的文件夹与文件系统的文件夹是否一样?](https://support.huaweicloud.com/obs_faq/obs_faq_0016.md): 不一样。OBS并没有文件系统中的文件和文件夹概念。为了使用户更方便进行管理数据,OBS提供了一种方式模拟文件夹。实际上在OBS内部是通过在对象的名称中增加“/”,将该对象在OBS管理控制台上模拟成一个文件夹的形式展现。 - [OBS、EVS和SFS有什么区别?](https://support.huaweicloud.com/obs_faq/obs_faq_0074.md): 对象存储服务OBS、云硬盘EVS与弹性文件服务SFS之间的对比如表1所示。专属企业存储服务(Dedicated Enterprise Storage Service,以下简称DESS),是基于华为企业存储构建的专属存储服务,面向Oracle RAC、SAP HANA TDI等企业关键应用场景,可以提供与企业私有云环境一致的性能和可靠性,简 - [OBS网段查询及访问类型判断](https://support.huaweicloud.com/obs_faq/obs_faq_0148.md): 要查询OBS的网段以及判断访问OBS是内网还是公网访问,可以使用以下命令查询并判断。华为云OBS桶访问域名通过DNS解析的IP地址是会发生变化的,不推荐直接使用IP地址访问OBS。要查询OBS的内网IP,使用以下命令(三选一即可)从内网(如:同区域内访问)发起请求。要查询OBS的公网IP,使用以下命令(三选一即可)从公网(如:不同区域间使 - [我的OBS桶性能是否会受其他用户业务的影响?](https://support.huaweicloud.com/obs_faq/obs_faq_0149.md): 不会。OBS对不同的桶之间做了隔离,多个桶之间不会相互影响存储性能。OBS对不同账号的访问做了性能隔离,不同账号之间不会出现性能干扰或影响。 - [OBS总览页数据不一致的原因是什么?](https://support.huaweicloud.com/obs_faq/obs_faq_0155.md): 进入OBS总览页的步骤如下:在“总览”页可以查看某个区域或全部区域下所有OBS资源的使用情况,包括我的资源(存储量、流量、请求)、资源统计等。总览页在查询数据时,可能会出现多个数据不一致的情况,具体说明如下所示。标准存储量+低频访问存储量+归档存储量不等于总存储量,可能的原因有:数据来源不一致:总存储量数据来源于OBS实时数据,标准存储量 - [境外数据传输回国场景下的丢包和网络稳定性问题](https://support.huaweicloud.com/obs_faq/obs_faq_0196.md): 在数据跨境传输场景下,由于您所在的网络环境可能处在运营商网络边缘节点,向运营商网络请求成功率比较低,所以可能会出现丢包和网络稳定性问题。建议您先使用跨区域复制或者云连接 CC将数据传输回国,然后再从国内访问和下载数据。 - [增加重试机制以提高OBS访问成功率](https://support.huaweicloud.com/obs_faq/obs_faq_0197.md): 客户端访问OBS时,可能会因为网络抖动、丢包、客户端资源占用等因素导致请求超时失败,报错现象可能是返回错误码RequestTimeout、HTTP状态码为5XX或其他错误信息。为了提高请求成功率,建议客户端代码增加重试机制,建议重试值为3次。同时OBS SDK已均支持重试,默认为3次,建议您使用SDK访问OBS。了解更多SDK相关信息请参 - [访问OBS时会报错499怎么处理?](https://support.huaweicloud.com/obs_faq/obs_faq_0198.md): OBS服务端机制是客户端和服务端建连后,如果客户端30s没有往OBS服务端传数据或接收数据,OBS服务端会关闭连接,系统报错499。请用户检查网络连接是否正常,并建议退出OBS后重新登录访问。 - [默认存储类别和存储资源包类别有什么关系?](https://support.huaweicloud.com/obs_faq/obs_faq_120231.md): 默认存储类别指的是桶存储类别,与存储资源包类别无直接对应关系,存储资源包类别与桶中存放的对象存储类别有关。OBS当前提供的存储资源包如表1所示:有以下两点需要特别注意:需要确保已购买的存储资源包类别和桶中的对象存储类别一致,否则可能出现资源包抵扣失败的情况,产生按需计费。目前暂无低频访问存储包。如果桶中存在低频访问存储类别的对象,则会直接 - [如何获取OBS的终端节点?](https://support.huaweicloud.com/obs_faq/obs_faq_0124.md): OBS可以通过域名进行访问,在使用API、第三方工具等方式使用OBS时,可通过域名方便定位OBS中的资源。在使用OBS之前,请确保客户端环境已经正确配置DNS服务器地址,用于OBS域名解析。不同的数据中心分配对应的域名,域名详情请参见地区和终端节点。 - [我可以在OBS中存储多少数据?](https://support.huaweicloud.com/obs_faq/obs_faq_0010.md): OBS系统和单个桶都没有总数据容量和对象/文件数量的限制,但对于单次上传对象的大小有如下限制:OBS管理控制台支持批量上传文件,单次最多支持1000个文件同时上传,总大小不超过5GB。如果只上传1个文件,则这个文件最大为5GB。OBS Browser+、obsutil、API和SDK上传的单个对象最大是48.8TB。用户所购买的资源包的大 - [我如何选择将数据存储在哪个区域?](https://support.huaweicloud.com/obs_faq/obs_faq_0019.md): 选择区域时,您需要考虑以下几个因素:地理位置一般情况下,建议就近选择靠近您或者您的目标用户的区域,这样可以减少网络时延,提高访问速度。不过,在基础设施、BGP网络品质、资源的操作与配置等方面,中国大陆各个区域间区别不大,如果您或者您的目标用户在中国大陆,可以不用考虑不同区域造成的网络时延问题。在除中国大陆以外的亚太地区有业务的用户,可以选 - [OBS支持使用HTTPS协议访问吗?](https://support.huaweicloud.com/obs_faq/obs_03_0071.md): OBS对HTTPS的支持情况如下:OBS桶域名:支持,在浏览器中将桶或对象的URL的http替换成https即可。OBS自定义域名:支持,如需使用请参见证书托管。开启CDN加速后的OBS加速域名:支持,开启CDN加速后可通过CDN控制台进行HTTPS证书管理,即可使用HTTPS访问。CDN管理控制台HTTPS证书管理方式,详见HTTPS配 - [OBS中的数据可以让其他用户访问吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0125.md): 可以。对于桶,可以通过桶ACL和桶策略授予其他用户桶的读取权限,其他用户即可访问该桶。对于对象,可以通过对象ACL,对象策略和桶策略来授予其他用户对象的读取权限,或者设置对象分享功能,其他用户即可访问该对象。 - [访问OBS链接提示告警信息的原因和解决办法](https://support.huaweicloud.com/obs_faq/obs_faq_0144.md): 因为部分用户使用OBS桶时上传了包含色情、暴恐、涉政等违法违规内容,OBS和第三方平台(微信/支付宝/百度等)检测到后会封禁此资源。第三方平台在封禁此资源的同时,会将OBS域名列为不信任域名,导致其他合法使用OBS域名的用户也受到影响。需要通过第三方平台,如微信/支付宝/百度等平台或小程序使用OBS的用户,建议使用自定义域名访问OBS资源 - [已删除的数据是否可以恢复?](https://support.huaweicloud.com/obs_faq/obs_03_0139.md): 已删除的数据能否恢复取决于您是否开启了多版本控制功能:桶开启了多版本控制功能时:对象列表页未开启“历史版本”开关时,单击“删除”按钮删除对象后,在对象列表中无法看到已删除对象,而打开“历史版本”开关后,在对象列表中可以看到带删除标记的当前版本对象和被删除后成为历史版本的对象。此时,单击带删除标记的当前版本对象操作列的“彻底删除”,即可恢复 - [访问OBS域名失败,连接不上CA证书](https://support.huaweicloud.com/obs_faq/obs_faq_0066.md): 在证书不受信的情况下,访问OBS域名会失败,需要重新获取OBS证书并将其导入客户端信任库。在浏览器中访问OBS域名:https://obs.myhuaweicloud.com。单击域名左侧的,选择“证书”。导出证书单击“详细信息 > 复制到文件”,根据向导提示获取OBS证书(obs.cer)。以Java运行环境为例,需要将证书导入cace - [为什么OBS存储的数据丢失了?](https://support.huaweicloud.com/obs_faq/obs_03_0138.md): 如果您的OBS中存储的数据丢失了,请按照以下原因排查:请检查桶中是否设置了生命周期过期删除规则,符合规则的对象会被删除。请检查桶是否授权了其他用户桶的写权限,被授权的用户都可以删除对象。如果您开启了日志记录功能,可以通过日志记录查询到删除对象的用户。 - [OBS是否支持流量监控?](https://support.huaweicloud.com/obs_faq/obs_faq_0111.md): OBS支持流量监控功能:通过OBS管理控制台的用量统计,能监控统计周期内的流量指标。查看方法,请参见查看用量统计。通过云监控CES,能查看的OBS相关指标请参见对象存储服务监控指标说明。 - [OBS上传下载速率的影响因素有哪些?](https://support.huaweicloud.com/obs_faq/obs_03_0100.md): 影响OBS上传下载速率的因素有:单个华为云账号默认的OBS读写带宽(GET请求带宽与PUT请求带宽的总和)上限是16Gbit/s(包括公网和内网带宽一共16Gbit/s)。如果带宽达到该阈值,请求会触发流控。如果用户购买的虚拟机网卡带宽低于16Gbit/s,那么节点带宽会先受虚机带宽限制,需要购买多台虚拟机并发运行才能达到16Gbit/s - [对象存储与SAN存储和NAS存储相比较有什么优势?](https://support.huaweicloud.com/obs_faq/obs_faq_0006.md): SAN存储提供给应用的是一个LUN或者是一个卷,LUN和卷是面向磁盘空间的一种组织方式,上层应用要通过FC或者ISCSI协议访问SAN。SAN存储处理的是管理磁盘的问题,其他事情都要依靠上层的应用程序实现。NAS存储提供给应用的是一个文件系统或者是一个文件夹,上层应用通过NFS和CIFS协议进行访问。文件系统要维护一个目录树。对象存储更加 - [OBS的文件夹与文件系统的文件夹是否一样?](https://support.huaweicloud.com/obs_faq/obs_faq_0016.md): 不一样。OBS并没有文件系统中的文件和文件夹概念。为了使用户更方便进行管理数据,OBS提供了一种方式模拟文件夹。实际上在OBS内部是通过在对象的名称中增加“/”,将该对象在OBS管理控制台上模拟成一个文件夹的形式展现。 - [OBS、EVS和SFS有什么区别?](https://support.huaweicloud.com/obs_faq/obs_faq_0074.md): 对象存储服务OBS、云硬盘EVS与弹性文件服务SFS之间的对比如表1所示。专属企业存储服务(Dedicated Enterprise Storage Service,以下简称DESS),是基于华为企业存储构建的专属存储服务,面向Oracle RAC、SAP HANA TDI等企业关键应用场景,可以提供与企业私有云环境一致的性能和可靠性,简 - [OBS网段查询及访问类型判断](https://support.huaweicloud.com/obs_faq/obs_faq_0148.md): 要查询OBS的网段以及判断访问OBS是内网还是公网访问,可以使用以下命令查询并判断。华为云OBS桶访问域名通过DNS解析的IP地址是会发生变化的,不推荐直接使用IP地址访问OBS。要查询OBS的内网IP,使用以下命令(三选一即可)从内网(如:同区域内访问)发起请求。要查询OBS的公网IP,使用以下命令(三选一即可)从公网(如:不同区域间使 - [我的OBS桶性能是否会受其他用户业务的影响?](https://support.huaweicloud.com/obs_faq/obs_faq_0149.md): 不会。OBS对不同的桶之间做了隔离,多个桶之间不会相互影响存储性能。OBS对不同账号的访问做了性能隔离,不同账号之间不会出现性能干扰或影响。 - [OBS总览页数据不一致的原因是什么?](https://support.huaweicloud.com/obs_faq/obs_faq_0155.md): 进入OBS总览页的步骤如下:在“总览”页可以查看某个区域或全部区域下所有OBS资源的使用情况,包括我的资源(存储量、流量、请求)、资源统计等。总览页在查询数据时,可能会出现多个数据不一致的情况,具体说明如下所示。标准存储量+低频访问存储量+归档存储量不等于总存储量,可能的原因有:数据来源不一致:总存储量数据来源于OBS实时数据,标准存储量 - [境外数据传输回国场景下的丢包和网络稳定性问题](https://support.huaweicloud.com/obs_faq/obs_faq_0196.md): 在数据跨境传输场景下,由于您所在的网络环境可能处在运营商网络边缘节点,向运营商网络请求成功率比较低,所以可能会出现丢包和网络稳定性问题。建议您先使用跨区域复制或者云连接 CC将数据传输回国,然后再从国内访问和下载数据。 - [增加重试机制以提高OBS访问成功率](https://support.huaweicloud.com/obs_faq/obs_faq_0197.md): 客户端访问OBS时,可能会因为网络抖动、丢包、客户端资源占用等因素导致请求超时失败,报错现象可能是返回错误码RequestTimeout、HTTP状态码为5XX或其他错误信息。为了提高请求成功率,建议客户端代码增加重试机制,建议重试值为3次。同时OBS SDK已均支持重试,默认为3次,建议您使用SDK访问OBS。了解更多SDK相关信息请参 - [访问OBS时会报错499怎么处理?](https://support.huaweicloud.com/obs_faq/obs_faq_0198.md): OBS服务端机制是客户端和服务端建连后,如果客户端30s没有往OBS服务端传数据或接收数据,OBS服务端会关闭连接,系统报错499。请用户检查网络连接是否正常,并建议退出OBS后重新登录访问。 - [默认存储类别和存储资源包类别有什么关系?](https://support.huaweicloud.com/obs_faq/obs_faq_120231.md): 默认存储类别指的是桶存储类别,与存储资源包类别无直接对应关系,存储资源包类别与桶中存放的对象存储类别有关。OBS当前提供的存储资源包如表1所示:有以下两点需要特别注意:需要确保已购买的存储资源包类别和桶中的对象存储类别一致,否则可能出现资源包抵扣失败的情况,产生按需计费。目前暂无低频访问存储包。如果桶中存在低频访问存储类别的对象,则会直接 - [桶内无对象,为什么还会产生存储费用?](https://support.huaweicloud.com/obs_faq/obs_faq_0600.md): OBS的计费项之一是存储费用。桶中的对象、已删除对象和碎片均会占用存储空间,进而产生存储费用。什么是已删除对象?如果不存在,则说明没有已删除对象。如果存在,则打开“历史版本”开关,查看对象列表是否存在带“历史版本”标记的对象。如果不存在,则说明没有已删除对象。如果存在,则说明有已删除对象。如需清理已删除对象,请选中所有带“历史版本”标记的 - [桶内无对象为什么会产生流量?](https://support.huaweicloud.com/obs_faq/obs_faq_0139.md): 对OBS发送请求,请求和响应消息中如果带有消息体,则会产生流量。OBS流量区分内网流入流量、内网流出流量、公网流入流量、公网流出流量、跨区域复制流量、回源流量,部分流量免费,详情请参见计费说明。可能原因一:流量每小时结算一次,在这一个小时中其他用户向桶中上传对象后又删除了该对象,结算时桶拥有者看到桶内无对象,但实际已产生流量。可能原因二: - [已购买资源包,为什么仍然扣费?](https://support.huaweicloud.com/obs_faq/obs_03_0103.md): 已经购买了OBS包年包月资源包,使用过程中仍然产生了按需费用。以下排查思路根据原因的出现概率进行排序,建议您从高频率原因往低频率原因排查,从而帮助您快速找到问题根因。如果处理完某个可能原因仍未解决问题,请继续排查其他可能原因。目前支持的资源包有标准存储包、归档存储包、公网流出流量包、跨区复制流量包和回源流量包。不同资源包抵扣的费用不同,详 - [配置CDN回源,并购买回源流量包,计费未走回源流量包](https://support.huaweicloud.com/obs_faq/obs_faq_0034.md): 请检查购买的回源流量包和CDN回源源站桶是否在同一区域。登录控制台。在顶部导航栏单击“资源 > 我的资源”,查看购买的资源包所在区域。登录CDN控制台,在“域名管理”中查看CDN加速域名所配置的源站OBS桶域名,根据桶域名可以判断出回源源站桶所在的区域。回源流量包所在区域应该与回源源站桶所在的区域一致,如果不一致,请重新购买CDN回源流量 - [账号欠费后已充值,为什么OBS资源仍然不可用?](https://support.huaweicloud.com/obs_faq/obs_faq_0126.md): 根据账户余额的不同,按需计费的OBS资源会处在不同的状态,不同的状态会影响资源的使用情况。以下为按需计费OBS资源的生命周期:有效期:在账户尚有余额时,计费周期内资源正常运行,此阶段为有效期。宽限期:当您的账号因按需资源自动扣费导致欠费后,账号将变成欠费状态,资源将进入宽限期,宽限期内按需资源不会立即停止服务。账号欠费后,系统将通过邮件、 - [资源包是否必须购买?是否能指定给具体的桶使用?](https://support.huaweicloud.com/obs_faq/obs_faq_0156.md): 资源包并不是必须要购买的,即使您没有购买也可以使用OBS服务,此时计费模式采用按需计费。但是购买资源包后,资源包可以抵扣使用OBS所产生的费用,相比不购买资源包采用按需计费的方式更优惠,因此推荐您按实际业务购买对应的资源包。当前资源包是按类型和区域划分的,例如在指定区域购买存储资源包后该区域下所有符合资源包要求的桶产生的存储费用均可以抵扣 - [资源包是否支持退订或修改?](https://support.huaweicloud.com/obs_faq/obs_faq_0157.md): 资源包支持退订,不支持修改。满足条件可自主退订,详见退订规则。由于桶创建完成后不支持修改数据冗余策略(单/多AZ),因此请您在购买和创建桶时根据业务需要严格匹配。如果您购买的资源包对应存储类别和桶的存储类别不一致,您可以通过设置桶存储类别接口修改桶的存储类别与资源包一致。在桶创建完成后,不支持修改桶所在的区域,因此请您在创建桶时需要根据业 - [资源包到期后OBS资源会如何处理?](https://support.huaweicloud.com/obs_faq/obs_faq_0162.md): 资源包到期后您可以进行续费以延长资源包的有效期,具体可参考资源包续订,未续期则到期后自动转为按需计费;按需计费没有到期的概念,只要保证账号余额充足,则可一直使用对象存储服务。如果账号欠费,会进入资源保留期,您在OBS中存储的数据会予以保留,账号会处于受限状态。保留期内不能访问及使用按需资源,但对存储在OBS中的数据仍予以保留。保留期满仍未 - [并行文件系统是否支持资源包?](https://support.huaweicloud.com/obs_faq/obs_faq_0159.md): 当前如下资源包同时支持并行文件系统及对象桶:标准存储资源包:包括单AZ及多AZ归档存储资源包公网流出流量包由于并行文件系统暂时不支持跨区域复制和回源功能,所以无法使用对应的跨区域复制流量包和回源流量包。 - [请求次数是如何计算的?](https://support.huaweicloud.com/obs_faq/obs_faq_0140.md): 通过管理控制台、工具、API、SDK等任意方式对OBS进行操作,实际上都是对OBS API的调用,每调用一次API都计算一次请求次数。OBS的请求主要分为四大类:读操作(GET类请求):GET/HEAD/LIST等,例如下载对象、获取桶区域位置、获取桶策略、列举对象。写操作(PUT类请求):PUT/POST/COPY等,例如上传对象、复制 - [是否支持购买请求次数?](https://support.huaweicloud.com/obs_faq/obs_faq_0158.md): 当前暂不支持单独购买请求次数。请求次数目前仅支持按需计费,按照GET类请求、PUT类请求、生命周期转换请求的请求次数进行收费。请求包括PUT/POST/COPY/LIST/GET/HEAD等。 - [OBS存储资源包使用超量后是否会限制对桶的写入](https://support.huaweicloud.com/obs_faq/obs_faq_0166.md): 不会限制。OBS桶具有“无限容量”,超出存储资源包部分会自动转为按需计费,或者您可以升配资源包、继续叠加购买资源包。叠加购买资源包的方法,请参考资源包叠加购买。升配资源包的方法,请参考资源包升配。 - [当月未用完的资源包用量是否会结转到下个月?](https://support.huaweicloud.com/obs_faq/obs_faq_0161.md): 当前没有这种结转机制。资源包每月重置规则说明:按订购周期重置,即购买后每月同一天24:00:00重置资源额度。例如:您在4月15日任意时刻购买6个月的公网流出流量包2TB并支付,您在4月15日到5月15日24:00:00间就会有2TB的公网流出流量可以使用。系统会在5月16日00:00:00,重新给您2TB的公网流出流量,此2TB流量您可 - [哪些资源包会按月更新额度,哪些不会?](https://support.huaweicloud.com/obs_faq/obs_faq_0160.md): 当前如下资源包是按月更新额度:公网流出流量包回源流量包跨区域复制流量包如下资源包额度购买后在指定时间内有效,不会按月更新额度:标准存储包归档存储包按月更新额度:以公网流出流量包为例,如您购买10TB公网流出流量包一年,则您每月均有10TB的公网流出流量可抵扣,为期一年,超出部分按需计费。未用完的资源包用量下个月会被重置。非按月更新额度:以 - [购买了回源流量包是否还需要购买公网流出流量包?](https://support.huaweicloud.com/obs_faq/obs_faq_0061.md): 回源流量包用于抵扣使用OBS作为华为云CDN加速域名源站时,CDN向源站OBS获取文件产生的回源流量费用。公网流出流量包用于抵扣通过互联网从OBS下载数据到本地所产生的公网流出流量费用。不同场景产生的流量类型如下:用户在管理控制台执行对象下载和其他查询类操作(列举对象、获取桶或对象的元数据等),或者在公网使用工具、SDK不经过CDN直接下 - [如何购买专属对象存储?](https://support.huaweicloud.com/obs_faq/obs_faq_0106.md): 请确保已开通专属云。如未开通,可拨打免费客服电话4000-955-988咨询并开通。进入专属对象存储页面。提交申请后,我们会启动为您部署专属资源,一般需要2~3个月时间。您可以登录华为云控制台,使用专属对象存储。也可以在专属对象存储页面查看“专属对象存储池”的存储类别、到期时间和存储空间使用率。专属对象存储的购买时长,从订单完成时开始计算 - [OBS账单为什么会出现0.01元的计费?](https://support.huaweicloud.com/obs_faq/obs_faq_1004.md): 如果账单中出现0.01元的计费,可能与小额累计有关。扣费的最小粒度为0.01元。每小时消费不足0.01元的情况下,会触发小额累计,累计一天后如果仍不足0.01元则不扣费。第二天会继续进行累计。直到消费累计大于或等于0.01元的情况下,会直接进行扣费。例如:用户在8:00~9:00共用了10次上传请求、10次下载请求,这1小时内消费不足0. - [查询账单时,为什么会有大量的公网流出流量?](https://support.huaweicloud.com/obs_faq/obs_faq_100325.md): 根据账单的使用量类型来区分,OBS的公网流出流量主要包含标准存储公网流出流量、低频访问存储公网流出流量、归档存储公网流出流量、深度归档存储公网流出流量。这几种公网流出流量产生的流量费用来源如下:标准存储公网流出流量:通过互联网下载标准存储对象、列举对象所产生的流出流量费用。低频访问存储公网流出流量:恢复低频访问存储对象后,通过互联网下载低 - [Flexus OBS资源包与普通的OBS资源包有什么区别?](https://support.huaweicloud.com/obs_faq/obs_faq_120326.md): flexus OBS资源包是针对标准存储单AZ存储容量提供的优化套餐,只能抵扣标准存储单AZ存储容量。flexus OBS资源包和普通的标准存储单AZ存储包的区别如下: - [桶内无对象,为什么还会产生存储费用?](https://support.huaweicloud.com/obs_faq/obs_faq_0600.md): OBS的计费项之一是存储费用。桶中的对象、已删除对象和碎片均会占用存储空间,进而产生存储费用。什么是已删除对象?如果不存在,则说明没有已删除对象。如果存在,则打开“历史版本”开关,查看对象列表是否存在带“历史版本”标记的对象。如果不存在,则说明没有已删除对象。如果存在,则说明有已删除对象。如需清理已删除对象,请选中所有带“历史版本”标记的 - [桶内无对象为什么会产生流量?](https://support.huaweicloud.com/obs_faq/obs_faq_0139.md): 对OBS发送请求,请求和响应消息中如果带有消息体,则会产生流量。OBS流量区分内网流入流量、内网流出流量、公网流入流量、公网流出流量、跨区域复制流量、回源流量,部分流量免费,详情请参见计费说明。可能原因一:流量每小时结算一次,在这一个小时中其他用户向桶中上传对象后又删除了该对象,结算时桶拥有者看到桶内无对象,但实际已产生流量。可能原因二: - [已购买资源包,为什么仍然扣费?](https://support.huaweicloud.com/obs_faq/obs_03_0103.md): 已经购买了OBS包年包月资源包,使用过程中仍然产生了按需费用。以下排查思路根据原因的出现概率进行排序,建议您从高频率原因往低频率原因排查,从而帮助您快速找到问题根因。如果处理完某个可能原因仍未解决问题,请继续排查其他可能原因。目前支持的资源包有标准存储包、归档存储包、公网流出流量包、跨区复制流量包和回源流量包。不同资源包抵扣的费用不同,详 - [配置CDN回源,并购买回源流量包,计费未走回源流量包](https://support.huaweicloud.com/obs_faq/obs_faq_0034.md): 请检查购买的回源流量包和CDN回源源站桶是否在同一区域。登录控制台。在顶部导航栏单击“资源 > 我的资源”,查看购买的资源包所在区域。登录CDN控制台,在“域名管理”中查看CDN加速域名所配置的源站OBS桶域名,根据桶域名可以判断出回源源站桶所在的区域。回源流量包所在区域应该与回源源站桶所在的区域一致,如果不一致,请重新购买CDN回源流量 - [账号欠费后已充值,为什么OBS资源仍然不可用?](https://support.huaweicloud.com/obs_faq/obs_faq_0126.md): 根据账户余额的不同,按需计费的OBS资源会处在不同的状态,不同的状态会影响资源的使用情况。以下为按需计费OBS资源的生命周期:有效期:在账户尚有余额时,计费周期内资源正常运行,此阶段为有效期。宽限期:当您的账号因按需资源自动扣费导致欠费后,账号将变成欠费状态,资源将进入宽限期,宽限期内按需资源不会立即停止服务。账号欠费后,系统将通过邮件、 - [资源包是否必须购买?是否能指定给具体的桶使用?](https://support.huaweicloud.com/obs_faq/obs_faq_0156.md): 资源包并不是必须要购买的,即使您没有购买也可以使用OBS服务,此时计费模式采用按需计费。但是购买资源包后,资源包可以抵扣使用OBS所产生的费用,相比不购买资源包采用按需计费的方式更优惠,因此推荐您按实际业务购买对应的资源包。当前资源包是按类型和区域划分的,例如在指定区域购买存储资源包后该区域下所有符合资源包要求的桶产生的存储费用均可以抵扣 - [资源包是否支持退订或修改?](https://support.huaweicloud.com/obs_faq/obs_faq_0157.md): 资源包支持退订,不支持修改。满足条件可自主退订,详见退订规则。由于桶创建完成后不支持修改数据冗余策略(单/多AZ),因此请您在购买和创建桶时根据业务需要严格匹配。如果您购买的资源包对应存储类别和桶的存储类别不一致,您可以通过设置桶存储类别接口修改桶的存储类别与资源包一致。在桶创建完成后,不支持修改桶所在的区域,因此请您在创建桶时需要根据业 - [资源包到期后OBS资源会如何处理?](https://support.huaweicloud.com/obs_faq/obs_faq_0162.md): 资源包到期后您可以进行续费以延长资源包的有效期,具体可参考资源包续订,未续期则到期后自动转为按需计费;按需计费没有到期的概念,只要保证账号余额充足,则可一直使用对象存储服务。如果账号欠费,会进入资源保留期,您在OBS中存储的数据会予以保留,账号会处于受限状态。保留期内不能访问及使用按需资源,但对存储在OBS中的数据仍予以保留。保留期满仍未 - [并行文件系统是否支持资源包?](https://support.huaweicloud.com/obs_faq/obs_faq_0159.md): 当前如下资源包同时支持并行文件系统及对象桶:标准存储资源包:包括单AZ及多AZ归档存储资源包公网流出流量包由于并行文件系统暂时不支持跨区域复制和回源功能,所以无法使用对应的跨区域复制流量包和回源流量包。 - [请求次数是如何计算的?](https://support.huaweicloud.com/obs_faq/obs_faq_0140.md): 通过管理控制台、工具、API、SDK等任意方式对OBS进行操作,实际上都是对OBS API的调用,每调用一次API都计算一次请求次数。OBS的请求主要分为四大类:读操作(GET类请求):GET/HEAD/LIST等,例如下载对象、获取桶区域位置、获取桶策略、列举对象。写操作(PUT类请求):PUT/POST/COPY等,例如上传对象、复制 - [是否支持购买请求次数?](https://support.huaweicloud.com/obs_faq/obs_faq_0158.md): 当前暂不支持单独购买请求次数。请求次数目前仅支持按需计费,按照GET类请求、PUT类请求、生命周期转换请求的请求次数进行收费。请求包括PUT/POST/COPY/LIST/GET/HEAD等。 - [OBS存储资源包使用超量后是否会限制对桶的写入](https://support.huaweicloud.com/obs_faq/obs_faq_0166.md): 不会限制。OBS桶具有“无限容量”,超出存储资源包部分会自动转为按需计费,或者您可以升配资源包、继续叠加购买资源包。叠加购买资源包的方法,请参考资源包叠加购买。升配资源包的方法,请参考资源包升配。 - [当月未用完的资源包用量是否会结转到下个月?](https://support.huaweicloud.com/obs_faq/obs_faq_0161.md): 当前没有这种结转机制。资源包每月重置规则说明:按订购周期重置,即购买后每月同一天24:00:00重置资源额度。例如:您在4月15日任意时刻购买6个月的公网流出流量包2TB并支付,您在4月15日到5月15日24:00:00间就会有2TB的公网流出流量可以使用。系统会在5月16日00:00:00,重新给您2TB的公网流出流量,此2TB流量您可 - [哪些资源包会按月更新额度,哪些不会?](https://support.huaweicloud.com/obs_faq/obs_faq_0160.md): 当前如下资源包是按月更新额度:公网流出流量包回源流量包跨区域复制流量包如下资源包额度购买后在指定时间内有效,不会按月更新额度:标准存储包归档存储包按月更新额度:以公网流出流量包为例,如您购买10TB公网流出流量包一年,则您每月均有10TB的公网流出流量可抵扣,为期一年,超出部分按需计费。未用完的资源包用量下个月会被重置。非按月更新额度:以 - [购买了回源流量包是否还需要购买公网流出流量包?](https://support.huaweicloud.com/obs_faq/obs_faq_0061.md): 回源流量包用于抵扣使用OBS作为华为云CDN加速域名源站时,CDN向源站OBS获取文件产生的回源流量费用。公网流出流量包用于抵扣通过互联网从OBS下载数据到本地所产生的公网流出流量费用。不同场景产生的流量类型如下:用户在管理控制台执行对象下载和其他查询类操作(列举对象、获取桶或对象的元数据等),或者在公网使用工具、SDK不经过CDN直接下 - [如何购买专属对象存储?](https://support.huaweicloud.com/obs_faq/obs_faq_0106.md): 请确保已开通专属云。如未开通,可拨打免费客服电话4000-955-988咨询并开通。进入专属对象存储页面。提交申请后,我们会启动为您部署专属资源,一般需要2~3个月时间。您可以登录华为云控制台,使用专属对象存储。也可以在专属对象存储页面查看“专属对象存储池”的存储类别、到期时间和存储空间使用率。专属对象存储的购买时长,从订单完成时开始计算 - [OBS账单为什么会出现0.01元的计费?](https://support.huaweicloud.com/obs_faq/obs_faq_1004.md): 如果账单中出现0.01元的计费,可能与小额累计有关。扣费的最小粒度为0.01元。每小时消费不足0.01元的情况下,会触发小额累计,累计一天后如果仍不足0.01元则不扣费。第二天会继续进行累计。直到消费累计大于或等于0.01元的情况下,会直接进行扣费。例如:用户在8:00~9:00共用了10次上传请求、10次下载请求,这1小时内消费不足0. - [查询账单时,为什么会有大量的公网流出流量?](https://support.huaweicloud.com/obs_faq/obs_faq_100325.md): 根据账单的使用量类型来区分,OBS的公网流出流量主要包含标准存储公网流出流量、低频访问存储公网流出流量、归档存储公网流出流量、深度归档存储公网流出流量。这几种公网流出流量产生的流量费用来源如下:标准存储公网流出流量:通过互联网下载标准存储对象、列举对象所产生的流出流量费用。低频访问存储公网流出流量:恢复低频访问存储对象后,通过互联网下载低 - [Flexus OBS资源包与普通的OBS资源包有什么区别?](https://support.huaweicloud.com/obs_faq/obs_faq_120326.md): flexus OBS资源包是针对标准存储单AZ存储容量提供的优化套餐,只能抵扣标准存储单AZ存储容量。flexus OBS资源包和普通的标准存储单AZ存储包的区别如下: - [给用户配置OBS系统权限或桶读写权限后仍然提示拒绝访问,请检查相应权限](https://support.huaweicloud.com/obs_faq/obs_faq_0142.md): 给用户配置了OBS系统权限在IAM中给用户配置了OBS ReadOnlyAccess、OBS OperateAccess、OBS Buckets Viewer等系统权限后,实际上只允许执行一部分OBS操作,例如OBS OperateAccess可以执行列举桶、获取桶基本信息、获取桶元数据、列举对象(不包含多版本)、上传对象、下载对象、删除 - [已配置OBS权限,仍然无法访问OBS(403 AccessDenied)](https://support.huaweicloud.com/obs_faq/obs_faq_0147.md): 已经通过IAM权限、桶策略或ACL配置了OBS权限,访问OBS时仍然提示“拒绝访问,请检查相应权限”,或报“403 AccessDenied”错误。以下排查思路根据原因的出现概率进行排序,建议您从高频率原因往低频率原因排查,从而帮助您快速找到问题根因。如果处理完某个可能原因仍未解决问题,请继续排查其他可能原因。OBS权限控制比较灵活,建议 - [桶策略和对象策略之间有什么关系?](https://support.huaweicloud.com/obs_faq/obs_faq_0055.md): 对象策略即为桶策略中针对对象的策略,桶策略是作用于所配置的OBS桶及桶内的对象。两者的区别是对象策略只针对一个对象,桶策略中针对对象的策略可以配置多个对象或桶中所有对象。 - [如何对OBS桶下面的文件夹进行权限控制?](https://support.huaweicloud.com/obs_faq/obs_faq_0169.md): 可以创建自定义桶策略,允许对指定的对象前缀配置需要的权限,即通过对象前缀来控制指定的文件夹。例如:配置前缀为abc/,则表示所配置权限对文件夹abc生效。具体配置请参考自定义创建桶策略(可视化视图)。 - [如何确认我已创建的桶是私有、公共读还是公共读写?](https://support.huaweicloud.com/obs_faq/obs_faq_0172.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [为什么通过控制台设置匿名用户桶ACL后,旧配置中的delivered属性会被覆盖为false?](https://support.huaweicloud.com/obs_faq/obs_faq_0179.md): OBS管理控制台目前不支持设置匿名用户的桶ACL权限继承关系(即不支持配置delivered属性),如需配置请使用OBS SDK或API操作。如果您通过SDK或API配置了匿名用户的delivered属性后,又在管理控制台修改了匿名用户的ACL配置,即便不是修改delivered属性,匿名用户的delivered属性也会被覆盖为false - [给用户配置OBS系统权限或桶读写权限后仍然提示拒绝访问,请检查相应权限](https://support.huaweicloud.com/obs_faq/obs_faq_0142.md): 给用户配置了OBS系统权限在IAM中给用户配置了OBS ReadOnlyAccess、OBS OperateAccess、OBS Buckets Viewer等系统权限后,实际上只允许执行一部分OBS操作,例如OBS OperateAccess可以执行列举桶、获取桶基本信息、获取桶元数据、列举对象(不包含多版本)、上传对象、下载对象、删除 - [已配置OBS权限,仍然无法访问OBS(403 AccessDenied)](https://support.huaweicloud.com/obs_faq/obs_faq_0147.md): 已经通过IAM权限、桶策略或ACL配置了OBS权限,访问OBS时仍然提示“拒绝访问,请检查相应权限”,或报“403 AccessDenied”错误。以下排查思路根据原因的出现概率进行排序,建议您从高频率原因往低频率原因排查,从而帮助您快速找到问题根因。如果处理完某个可能原因仍未解决问题,请继续排查其他可能原因。OBS权限控制比较灵活,建议 - [桶策略和对象策略之间有什么关系?](https://support.huaweicloud.com/obs_faq/obs_faq_0055.md): 对象策略即为桶策略中针对对象的策略,桶策略是作用于所配置的OBS桶及桶内的对象。两者的区别是对象策略只针对一个对象,桶策略中针对对象的策略可以配置多个对象或桶中所有对象。 - [如何对OBS桶下面的文件夹进行权限控制?](https://support.huaweicloud.com/obs_faq/obs_faq_0169.md): 可以创建自定义桶策略,允许对指定的对象前缀配置需要的权限,即通过对象前缀来控制指定的文件夹。例如:配置前缀为abc/,则表示所配置权限对文件夹abc生效。具体配置请参考自定义创建桶策略(可视化视图)。 - [如何确认我已创建的桶是私有、公共读还是公共读写?](https://support.huaweicloud.com/obs_faq/obs_faq_0172.md): 华为云帮助中心,为用户提供产品简介、价格说明、购买指南、用户指南、API参考、最佳实践、常见问题、视频帮助等技术文档,帮助您快速上手使用华为云服务。 - [为什么通过控制台设置匿名用户桶ACL后,旧配置中的delivered属性会被覆盖为false?](https://support.huaweicloud.com/obs_faq/obs_faq_0179.md): OBS管理控制台目前不支持设置匿名用户的桶ACL权限继承关系(即不支持配置delivered属性),如需配置请使用OBS SDK或API操作。如果您通过SDK或API配置了匿名用户的delivered属性后,又在管理控制台修改了匿名用户的ACL配置,即便不是修改delivered属性,匿名用户的delivered属性也会被覆盖为false - [创建桶失败](https://support.huaweicloud.com/obs_faq/obs_faq_0138.md): 如果当前用户所创建的桶已达到上限100个,删除一些闲置的桶再创建。如果是当前桶名已存在,则更换桶名再创建。在OBS中,桶名必须是全局唯一的,即用户创建的桶不能与自己已创建的其他桶名称相同,也不能与其他用户(包括其他华为云账号)创建的桶名称相同。用户删除桶后,用户自己或其他用户(包括其他华为云账号)立即创建同名桶或并行文件系统将失败,需等待 - [上传对象失败](https://support.huaweicloud.com/obs_faq/obs_faq_0134.md): 检查上传对象的大小和数量是否超过限制:通过OBS管理控制台上传的文件有大小和数量限制,每次最多支持1000个文件同时上传,总大小不超过5GB。如果只上传1个文件,则这个文件最大为5GB。超过5GB的文件,可以使用OBS Browser+、obsutil上传,或使用OBS SDK及API的多段接口上传,上限为48.8TB。OBS Brows - [下载对象失败](https://support.huaweicloud.com/obs_faq/obs_faq_0135.md): 检查本地与OBS的网络是否正常,如果存在网络故障,解决网络故障,确保网络正常。请检查账号是否已通过实名认证。如果没有,请先实名认证。登录OBS管理控制台。在顶部导航栏单击用户名,即可查看用户认证状态。账号认证状态如果您没有实名认证,请参考个人账号如何完成实名认证对账号进行实名认证,实名认证后需要40分钟才能生效。登录OBS管理控制台。在顶 - [删除桶失败](https://support.huaweicloud.com/obs_faq/obs_faq_0064.md): 无法删除已创建的OBS桶。以下排查思路根据原因的出现概率进行排序,建议您从高频率原因往低频率原因排查,从而帮助您快速找到问题根因。如果处理完某个可能原因仍未解决问题,请继续排查其他可能原因。以下步骤以管理控制台手动删除操作为例,通过其他方式(如obsutil、SDK等)删除的方法,请参见删除对象。您还可以通过生命周期管理功能,一次性清空桶 - [删除对象失败](https://support.huaweicloud.com/obs_faq/obs_faq_0177.md): 无法删除已上传的OBS对象。以下排查思路根据原因的出现概率进行排序,建议您从高频率原因往低频率原因排查,从而帮助您快速找到问题根因。如果处理完某个可能原因仍未解决问题,请继续排查其他可能原因。删除对象时报错“您没有执行此操作的权限。请联系您的管理员开通权限。”确认桶ACLs是否有删除桶内对象的权限。在OBS管理控制台桶列表单击待操作的桶, - [通过URL访问对象失败](https://support.huaweicloud.com/obs_faq/obs_03_0033.md): 本案例主要介绍对象URL无法访问的场景。如果您的问题是对象URL只能下载,而不能在线预览,请参考如何在浏览器中在线预览OBS中的对象?解决。如果您是对象的拥有者,不能通过URL访问对象,请检查如下内容:如果您是自定义对象的URL,请检查对象URL中是否有禁用字符。详情请参见用户指南中对象名称的约束。如果您是使用自定义域名访问对象,请排查您 - [如何在浏览器中在线预览OBS中的对象?](https://support.huaweicloud.com/obs_faq/obs_03_0087.md): 基于安全合规要求,华为云对象存储服务OBS禁止通过OBS的默认域名(桶访问域名或静态网站访问域名)在线预览桶内对象,即使用上述域名从浏览器访问桶内对象(如视频、图片、网页等)时,不会显示对象内容,而是以附件形式下载。OBS不支持在线预览对象而是以附件形式下载对象的生效时间和区域如下:自2022年1月1日起生效:华北-北京一、华北-北京四、 - [我可以修改对象名称吗?](https://support.huaweicloud.com/obs_faq/obs_faq_1000.md): 可以。如果调用接口遇到错误,请参见错误码。OBS客户端(OBS Browser+)支持重命名桶中对象,您可以对单个对象重命名。重命名的具体方法如下:如果未安装OBS Browser+,请先下载并安装。您可以通过API、SDK、OBS Browser+方式重命名并行文件系统中的文件。通过API重命名对象重命名对象Java SDK使用OBS - [我可以在线编辑OBS中的对象吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0059.md): OBS是一个基于对象的海量存储服务,为客户提供海量、安全、高可靠、低成本的数据存储能力。一般情况下,OBS不支持在线编辑对象内容。可以把对象下载到本地,修改后再重新上传至OBS。针对以下特殊场景,OBS支持在线对对象进行处理:修改对象元数据,如ContentDisposition、ContentLanguage等。对存储在OBS中的图片进 - [如何获取对象访问路径?](https://support.huaweicloud.com/obs_faq/obs_faq_0031.md): 对象访问路径为:https://桶名.域名/对象名。例如:https://bucketname.obs.cn-north-4.myhuaweicloud.com/objectname您可以自己拼接,或通过以下工具方式获取:如果是自己拼接的对象访问路径,用户需要参考URL编码(URL encoding)规则对对象名进行转义。例如:您在华北- - [我可以修改桶所在的区域吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0133.md): 不可以。桶创建成功后,不支持变更区域,请谨慎选择。 - [如何修改桶所属的企业项目?](https://support.huaweicloud.com/obs_faq/obs_faq_0174.md): 当OBS桶需要按照企业业务进行分组管理或者已有分组发生变化时,可以通过对OBS桶资源执行迁出操作,实现桶所属企业项目的修改。您只需要在桶当前所属的企业项目中找到对应的桶,并迁出至其他企业项目即可。详细操作步骤,请参见迁出企业项目资源。 - [我可以在桶间进行文件复制吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0056.md): 可以。OBS支持使用API、SDK、OBS Browser+、obsutil方式在同一区域内复制对象,详见复制对象。如果想在不同区域间复制对象,详见跨区域复制。 - [我可以在桶间进行文件移动吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0057.md): 可以。OBS支持使用工具(OBS Browser+、obsutil)在同一区域内移动对象,您可以移动单个文件或文件夹到其他指定路径下。文件或文件夹被移动后,源路径下的文件或文件夹会被删除。详情请参见使用OBS Browser+移动文件或文件夹或移动对象。此外,您还可以使用对象存储迁移服务OMS实现OBS桶之间跨账号、跨区域以及同区域内的数 - [我可以上传同名对象到同一个文件夹中吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0050.md): 可以上传,但上传后的对象可能会覆盖原有同名对象:如果开启了多版本控制,上传对象时,OBS自动为每个对象创建唯一的版本号。上传同名的对象将以不同的版本号同时保存在OBS中。如果未开启多版本控制,向同一个文件夹中上传同名的对象时,新上传的对象将覆盖原有的对象。 - [OBS是否支持断点续传功能?](https://support.huaweicloud.com/obs_faq/obs_faq_0014.md): OBS管理工具断点续传功能的支持情况: - [OBS是否支持批量上传文件?](https://support.huaweicloud.com/obs_faq/obs_faq_0015.md): OBS管理工具批量上传功能的支持情况: - [OBS是否支持批量下载文件?](https://support.huaweicloud.com/obs_faq/obs_faq_0047.md): OBS管理工具批量下载功能的支持情况: - [OBS是否支持批量删除对象或清空桶?](https://support.huaweicloud.com/obs_faq/obs_faq_0020.md): OBS管理工具批量删除功能的支持情况:批量删除的性能和单个请求内的对象数负相关,对于QPS的计算,删除N个对象,算N次操作。如果删除对象数量大并且对象前缀使用了字典序,可能导致大量对象的请求访问集中于某个特定分区,造成访问热点。热点分区上的请求速率受限,访问时延上升。为解决以上问题,您可以考虑减少单个批量删除请求的对象数量,增加并发请求数 - [无法搜索到桶中对象或对象不存在返回403/404](https://support.huaweicloud.com/obs_faq/obs_faq_0136.md): 无法搜索到桶中对象,可能是由于您输入的搜索名称不正确:OBS管理控制台和OBS Browser+支持通过前缀搜索对象,例如,您搜索“test”,搜索结果为以前缀为“test”的对象。如果您输入的不是待搜索对象名称的前缀,则搜索不到对象。例如,您待搜索对象名称为“testabc”,您输入“abc”搜索,则搜索不到“testabc”对象,只能 - [使用IE浏览器访问带有中文字符的对象URL地址报错如何处理?](https://support.huaweicloud.com/obs_faq/obs_faq_0062.md): 使用IE浏览器访问带有中文字符的对象URL地址,报HTTP 400错误。IE浏览器默认不是使用UTF-8发送查询字符串,修改IE浏览器的默认配置可以解决此问题。此时便可以正常访问带有中文字符的对象URL地址。 - [为什么配置了跨域访问OBS(CORS)仍然报错?](https://support.huaweicloud.com/obs_faq/obs_faq_0163.md): 首先请检查CORS规则是否配置正确,请参考配置桶允许跨域请求。对于同一URL会缓存响应header,第一次简单请求不会带跨域头,就会缓存第一次的结果。第二次复杂请求再次访问此URL会取第一次响应结果,产生CORS。属于浏览器机制问题。可以按如下方法解决,请选择一种方法尝试:请求的资源URL后面添加随机参数。比如1.html添加随机参数后为 - [如何查看桶内的文件夹大小?](https://support.huaweicloud.com/obs_faq/obs_faq_0167.md): 可以使用obsutil列举对象命令,指定前缀为需要查看的文件夹进行列举。以Linux操作系统为例,运行./obsutil ls obs://bucket-test/test/ -du -limit=0命令,查询桶bucket-test下test文件夹的大小。./obsutil ls obs://bucket-test/test/ -du - [如何上传超过5GB的大对象?](https://support.huaweicloud.com/obs_faq/obs_faq_0176.md): 通过OBS管理控制台上传的文件有大小和数量限制,每次最多支持1000个文件同时上传,总大小不超过5GB。如果只上传1个文件,则这个文件最大为5GB。5GB < 上传对象 <= 48.8TB如果需要上传超过5GB的大对象,可以使用OBS Browser+、obsutil工具上传,或使用OBS SDK及API的多段接口上传,上限为48.8TB - [桶存储类别和对象存储类别可以不一致吗?](https://support.huaweicloud.com/obs_faq/obs_faq_120529.md): 可以不一致。上传对象时,对象的存储类别默认继承桶的存储类别,您也可以重新指定对象的存储类别,同时也支持在对象上传完成后修改对象的存储类别。修改桶的存储类别,桶内已有对象的存储类别不会修改,新上传对象时的默认对象存储类别随之修改。 - [创建桶失败](https://support.huaweicloud.com/obs_faq/obs_faq_0138.md): 如果当前用户所创建的桶已达到上限100个,删除一些闲置的桶再创建。如果是当前桶名已存在,则更换桶名再创建。在OBS中,桶名必须是全局唯一的,即用户创建的桶不能与自己已创建的其他桶名称相同,也不能与其他用户(包括其他华为云账号)创建的桶名称相同。用户删除桶后,用户自己或其他用户(包括其他华为云账号)立即创建同名桶或并行文件系统将失败,需等待 - [上传对象失败](https://support.huaweicloud.com/obs_faq/obs_faq_0134.md): 检查上传对象的大小和数量是否超过限制:通过OBS管理控制台上传的文件有大小和数量限制,每次最多支持1000个文件同时上传,总大小不超过5GB。如果只上传1个文件,则这个文件最大为5GB。超过5GB的文件,可以使用OBS Browser+、obsutil上传,或使用OBS SDK及API的多段接口上传,上限为48.8TB。OBS Brows - [下载对象失败](https://support.huaweicloud.com/obs_faq/obs_faq_0135.md): 检查本地与OBS的网络是否正常,如果存在网络故障,解决网络故障,确保网络正常。请检查账号是否已通过实名认证。如果没有,请先实名认证。登录OBS管理控制台。在顶部导航栏单击用户名,即可查看用户认证状态。账号认证状态如果您没有实名认证,请参考个人账号如何完成实名认证对账号进行实名认证,实名认证后需要40分钟才能生效。登录OBS管理控制台。在顶 - [删除桶失败](https://support.huaweicloud.com/obs_faq/obs_faq_0064.md): 无法删除已创建的OBS桶。以下排查思路根据原因的出现概率进行排序,建议您从高频率原因往低频率原因排查,从而帮助您快速找到问题根因。如果处理完某个可能原因仍未解决问题,请继续排查其他可能原因。以下步骤以管理控制台手动删除操作为例,通过其他方式(如obsutil、SDK等)删除的方法,请参见删除对象。您还可以通过生命周期管理功能,一次性清空桶 - [删除对象失败](https://support.huaweicloud.com/obs_faq/obs_faq_0177.md): 无法删除已上传的OBS对象。以下排查思路根据原因的出现概率进行排序,建议您从高频率原因往低频率原因排查,从而帮助您快速找到问题根因。如果处理完某个可能原因仍未解决问题,请继续排查其他可能原因。删除对象时报错“您没有执行此操作的权限。请联系您的管理员开通权限。”确认桶ACLs是否有删除桶内对象的权限。在OBS管理控制台桶列表单击待操作的桶, - [通过URL访问对象失败](https://support.huaweicloud.com/obs_faq/obs_03_0033.md): 本案例主要介绍对象URL无法访问的场景。如果您的问题是对象URL只能下载,而不能在线预览,请参考如何在浏览器中在线预览OBS中的对象?解决。如果您是对象的拥有者,不能通过URL访问对象,请检查如下内容:如果您是自定义对象的URL,请检查对象URL中是否有禁用字符。详情请参见用户指南中对象名称的约束。如果您是使用自定义域名访问对象,请排查您 - [如何在浏览器中在线预览OBS中的对象?](https://support.huaweicloud.com/obs_faq/obs_03_0087.md): 基于安全合规要求,华为云对象存储服务OBS禁止通过OBS的默认域名(桶访问域名或静态网站访问域名)在线预览桶内对象,即使用上述域名从浏览器访问桶内对象(如视频、图片、网页等)时,不会显示对象内容,而是以附件形式下载。OBS不支持在线预览对象而是以附件形式下载对象的生效时间和区域如下:自2022年1月1日起生效:华北-北京一、华北-北京四、 - [我可以修改对象名称吗?](https://support.huaweicloud.com/obs_faq/obs_faq_1000.md): 可以。如果调用接口遇到错误,请参见错误码。OBS客户端(OBS Browser+)支持重命名桶中对象,您可以对单个对象重命名。重命名的具体方法如下:如果未安装OBS Browser+,请先下载并安装。您可以通过API、SDK、OBS Browser+方式重命名并行文件系统中的文件。通过API重命名对象重命名对象Java SDK使用OBS - [我可以在线编辑OBS中的对象吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0059.md): OBS是一个基于对象的海量存储服务,为客户提供海量、安全、高可靠、低成本的数据存储能力。一般情况下,OBS不支持在线编辑对象内容。可以把对象下载到本地,修改后再重新上传至OBS。针对以下特殊场景,OBS支持在线对对象进行处理:修改对象元数据,如ContentDisposition、ContentLanguage等。对存储在OBS中的图片进 - [如何获取对象访问路径?](https://support.huaweicloud.com/obs_faq/obs_faq_0031.md): 对象访问路径为:https://桶名.域名/对象名。例如:https://bucketname.obs.cn-north-4.myhuaweicloud.com/objectname您可以自己拼接,或通过以下工具方式获取:如果是自己拼接的对象访问路径,用户需要参考URL编码(URL encoding)规则对对象名进行转义。例如:您在华北- - [我可以修改桶所在的区域吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0133.md): 不可以。桶创建成功后,不支持变更区域,请谨慎选择。 - [如何修改桶所属的企业项目?](https://support.huaweicloud.com/obs_faq/obs_faq_0174.md): 当OBS桶需要按照企业业务进行分组管理或者已有分组发生变化时,可以通过对OBS桶资源执行迁出操作,实现桶所属企业项目的修改。您只需要在桶当前所属的企业项目中找到对应的桶,并迁出至其他企业项目即可。详细操作步骤,请参见迁出企业项目资源。 - [我可以在桶间进行文件复制吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0056.md): 可以。OBS支持使用API、SDK、OBS Browser+、obsutil方式在同一区域内复制对象,详见复制对象。如果想在不同区域间复制对象,详见跨区域复制。 - [我可以在桶间进行文件移动吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0057.md): 可以。OBS支持使用工具(OBS Browser+、obsutil)在同一区域内移动对象,您可以移动单个文件或文件夹到其他指定路径下。文件或文件夹被移动后,源路径下的文件或文件夹会被删除。详情请参见使用OBS Browser+移动文件或文件夹或移动对象。此外,您还可以使用对象存储迁移服务OMS实现OBS桶之间跨账号、跨区域以及同区域内的数 - [我可以上传同名对象到同一个文件夹中吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0050.md): 可以上传,但上传后的对象可能会覆盖原有同名对象:如果开启了多版本控制,上传对象时,OBS自动为每个对象创建唯一的版本号。上传同名的对象将以不同的版本号同时保存在OBS中。如果未开启多版本控制,向同一个文件夹中上传同名的对象时,新上传的对象将覆盖原有的对象。 - [OBS是否支持断点续传功能?](https://support.huaweicloud.com/obs_faq/obs_faq_0014.md): OBS管理工具断点续传功能的支持情况: - [OBS是否支持批量上传文件?](https://support.huaweicloud.com/obs_faq/obs_faq_0015.md): OBS管理工具批量上传功能的支持情况: - [OBS是否支持批量下载文件?](https://support.huaweicloud.com/obs_faq/obs_faq_0047.md): OBS管理工具批量下载功能的支持情况: - [OBS是否支持批量删除对象或清空桶?](https://support.huaweicloud.com/obs_faq/obs_faq_0020.md): OBS管理工具批量删除功能的支持情况:批量删除的性能和单个请求内的对象数负相关,对于QPS的计算,删除N个对象,算N次操作。如果删除对象数量大并且对象前缀使用了字典序,可能导致大量对象的请求访问集中于某个特定分区,造成访问热点。热点分区上的请求速率受限,访问时延上升。为解决以上问题,您可以考虑减少单个批量删除请求的对象数量,增加并发请求数 - [无法搜索到桶中对象或对象不存在返回403/404](https://support.huaweicloud.com/obs_faq/obs_faq_0136.md): 无法搜索到桶中对象,可能是由于您输入的搜索名称不正确:OBS管理控制台和OBS Browser+支持通过前缀搜索对象,例如,您搜索“test”,搜索结果为以前缀为“test”的对象。如果您输入的不是待搜索对象名称的前缀,则搜索不到对象。例如,您待搜索对象名称为“testabc”,您输入“abc”搜索,则搜索不到“testabc”对象,只能 - [使用IE浏览器访问带有中文字符的对象URL地址报错如何处理?](https://support.huaweicloud.com/obs_faq/obs_faq_0062.md): 使用IE浏览器访问带有中文字符的对象URL地址,报HTTP 400错误。IE浏览器默认不是使用UTF-8发送查询字符串,修改IE浏览器的默认配置可以解决此问题。此时便可以正常访问带有中文字符的对象URL地址。 - [为什么配置了跨域访问OBS(CORS)仍然报错?](https://support.huaweicloud.com/obs_faq/obs_faq_0163.md): 首先请检查CORS规则是否配置正确,请参考配置桶允许跨域请求。对于同一URL会缓存响应header,第一次简单请求不会带跨域头,就会缓存第一次的结果。第二次复杂请求再次访问此URL会取第一次响应结果,产生CORS。属于浏览器机制问题。可以按如下方法解决,请选择一种方法尝试:请求的资源URL后面添加随机参数。比如1.html添加随机参数后为 - [如何查看桶内的文件夹大小?](https://support.huaweicloud.com/obs_faq/obs_faq_0167.md): 可以使用obsutil列举对象命令,指定前缀为需要查看的文件夹进行列举。以Linux操作系统为例,运行./obsutil ls obs://bucket-test/test/ -du -limit=0命令,查询桶bucket-test下test文件夹的大小。./obsutil ls obs://bucket-test/test/ -du - [如何上传超过5GB的大对象?](https://support.huaweicloud.com/obs_faq/obs_faq_0176.md): 通过OBS管理控制台上传的文件有大小和数量限制,每次最多支持1000个文件同时上传,总大小不超过5GB。如果只上传1个文件,则这个文件最大为5GB。5GB < 上传对象 <= 48.8TB如果需要上传超过5GB的大对象,可以使用OBS Browser+、obsutil工具上传,或使用OBS SDK及API的多段接口上传,上限为48.8TB - [桶存储类别和对象存储类别可以不一致吗?](https://support.huaweicloud.com/obs_faq/obs_faq_120529.md): 可以不一致。上传对象时,对象的存储类别默认继承桶的存储类别,您也可以重新指定对象的存储类别,同时也支持在对象上传完成后修改对象的存储类别。修改桶的存储类别,桶内已有对象的存储类别不会修改,新上传对象时的默认对象存储类别随之修改。 - [我的数据存在OBS中,如何保证安全性?](https://support.huaweicloud.com/obs_faq/obs_faq_0038.md): OBS是非常安全的,提供端到端的安全服务。保证数据正确性:系统会定期对数据做扫描,仅限于判断数据块是否存在和被损坏(如有损坏,会启动修复),且不会读取数据的具体内容。防止数据被盗用:访问桶或对象时,如果桶或对象未公开,只有桶或对象的拥有者才能够访问,访问时需要提供访问密钥(AK/SK)。即使是后台工程师,也无法导出您存储在OBS的数据。您 - [OBS数据删除或覆盖后是否可以恢复?](https://support.huaweicloud.com/obs_faq/obs_faq_0250.md): 华为云无法恢复您主动删除、覆盖、配置规则自动删除或服务协议到期自动删除的OBS数据,请您谨慎操作。可能导致数据被删除或覆盖的场景:通过控制台、API、SDK、OBS Browser+、obsutil、obsfs方式删除对象。详情请参见删除对象。通过控制台、API、SDK、OBS Browser+、obsutil、obsfs方式上传同名文件 - [在使用访问密钥AK和SK访问OBS过程中,AK和SK是否可以更换或多个用户共享?](https://support.huaweicloud.com/obs_faq/obs_faq_0043.md): 可以。在使用过程中,访问密钥AK和SK可以随时更换。不同的用户使用相同的一对AK和SK可以同时访问OBS中的资源,且访问到的资源相同。 - [如何迁移数据至OBS?](https://support.huaweicloud.com/obs_faq/obs_faq_0131.md): 数据迁移至OBS主要有以下几种场景:搬迁本地数据至OBS迁移第三方云厂商数据至OBSOBS之间数据迁移(跨账号、跨区域以及同区域内数据迁移)搬迁本地数据至OBS的方案如下,了解更多详见搬迁本地数据至OBS最佳实践:您也可以使用备份软件实现本地数据备份至OBS。迁移第三方云厂商数据至OBS的方案如下,了解更多详见迁移第三方云厂商数据至OBS - [OBS如何实现备份和容灾?](https://support.huaweicloud.com/obs_faq/obs_03_0072.md): OBS通过如下方式实现备份和容灾:创建桶时开启多AZ属性,用户数据冗余存储至多个AZ中。通过跨区复制功能。用户可以将一个区域的桶中数据复制到另一个区域,实现云端备份。将OBS中的数据下载到本地,本地备份数据。 - [如何在弹性文件服务SFS和对象存储服务OBS之间进行数据迁移?](https://support.huaweicloud.com/obs_faq/obs_faq_0065.md): 对象存储服务OBS是华为云提供的稳定、安全、高效、易用的云存储服务,具备标准Restful API接口,可存储任意数量和形式的非结构化数据。弹性文件服务SFS是华为云提供的按需扩展的高性能文件存储(NAS),可为云上多个弹性云服务器ECS,容器CCE&CCI,裸金属服务器BMS提供共享访问。SFS的文件系统需要挂载到弹性云服务器、容器或裸 - [OBS会不会扫描我的数据用于其他用途?](https://support.huaweicloud.com/obs_faq/obs_faq_0039.md): 不会。系统对数据做的扫描仅限于判断数据块是否存在和被损坏(如有损坏,会启动修复),不会读取具体的内容。 - [后台工程师能否导出我存储在OBS中的数据?](https://support.huaweicloud.com/obs_faq/obs_faq_0040.md): 后台工程师无法导出用户数据。访问桶或对象时,如果桶或对象未公开,只有桶或对象的拥有者才能够访问,访问时需要提供访问密钥(AK/SK)。 - [OBS如何保证我的数据不会被盗用?](https://support.huaweicloud.com/obs_faq/obs_faq_0041.md): OBS提供多种安全机制,保证您的数据安全:访问安全:只有桶或对象的拥有者才能访问,访问时需要提供访问密钥(AK/SK);提供ACL、桶策略等多种权限控制方式来控制非桶拥有者访问桶。数据安全:提供服务端加密、对象锁定(WORM)、防盗链等多种功能来保证存储在OBS中的数据安全。 - [OBS的持久性和可用性如何?](https://support.huaweicloud.com/obs_faq/obs_faq_0058.md): OBS通过存储介质的慢盘/坏道检测、AZ内设备和数据冗余、AZ之间数据容灾、跨区域复制等技术方案,提供针对介质、服务器、机柜、数据中心和区域的多级可靠性保障。其数据持久性高达99.9999999999%(12个9),可用性高达99.995%,远高于传统架构。选择不同存储类别、不同数据冗余存储策略时,数据的持久性和可用性会有所不同,具体请参 - [OBS单AZ和多AZ有什么区别?](https://support.huaweicloud.com/obs_faq/obs_faq_0060.md): 问题一:Q:创建桶时,数据冗余存储策略选择单AZ存储和多AZ存储有什么区别?A:选择多AZ存储,数据将冗余存储至多个AZ中,可靠性更高。选择单AZ存储,数据仅存储在单个AZ中,但相比多AZ更加便宜。收费详情请参见产品价格详情。问题二:Q:选择多AZ存储后,数据是以副本的形式分别存放在多个AZ中吗?如果某个AZ出现故障,其他AZ中的数据是否 - [OBS的数据冗余存储方式是什么?](https://support.huaweicloud.com/obs_faq/obs_faq_0073.md): OBS采用Erasure Code(EC,纠删码)算法做数据冗余,不是以副本的形式存储。在满足同等可靠性要求的前提下,EC的空间利用率优于多副本。数据冗余存储策略为“单AZ”的桶,在AZ内的节点间使用EC算法做数据冗余;“多AZ”的桶在AZ内节点间EC冗余的基础上,会同时在多个AZ间再做数据冗余。 - [我的数据存在OBS中,如何保证安全性?](https://support.huaweicloud.com/obs_faq/obs_faq_0038.md): OBS是非常安全的,提供端到端的安全服务。保证数据正确性:系统会定期对数据做扫描,仅限于判断数据块是否存在和被损坏(如有损坏,会启动修复),且不会读取数据的具体内容。防止数据被盗用:访问桶或对象时,如果桶或对象未公开,只有桶或对象的拥有者才能够访问,访问时需要提供访问密钥(AK/SK)。即使是后台工程师,也无法导出您存储在OBS的数据。您 - [OBS数据删除或覆盖后是否可以恢复?](https://support.huaweicloud.com/obs_faq/obs_faq_0250.md): 华为云无法恢复您主动删除、覆盖、配置规则自动删除或服务协议到期自动删除的OBS数据,请您谨慎操作。可能导致数据被删除或覆盖的场景:通过控制台、API、SDK、OBS Browser+、obsutil、obsfs方式删除对象。详情请参见删除对象。通过控制台、API、SDK、OBS Browser+、obsutil、obsfs方式上传同名文件 - [在使用访问密钥AK和SK访问OBS过程中,AK和SK是否可以更换或多个用户共享?](https://support.huaweicloud.com/obs_faq/obs_faq_0043.md): 可以。在使用过程中,访问密钥AK和SK可以随时更换。不同的用户使用相同的一对AK和SK可以同时访问OBS中的资源,且访问到的资源相同。 - [如何迁移数据至OBS?](https://support.huaweicloud.com/obs_faq/obs_faq_0131.md): 数据迁移至OBS主要有以下几种场景:搬迁本地数据至OBS迁移第三方云厂商数据至OBSOBS之间数据迁移(跨账号、跨区域以及同区域内数据迁移)搬迁本地数据至OBS的方案如下,了解更多详见搬迁本地数据至OBS最佳实践:您也可以使用备份软件实现本地数据备份至OBS。迁移第三方云厂商数据至OBS的方案如下,了解更多详见迁移第三方云厂商数据至OBS - [OBS如何实现备份和容灾?](https://support.huaweicloud.com/obs_faq/obs_03_0072.md): OBS通过如下方式实现备份和容灾:创建桶时开启多AZ属性,用户数据冗余存储至多个AZ中。通过跨区复制功能。用户可以将一个区域的桶中数据复制到另一个区域,实现云端备份。将OBS中的数据下载到本地,本地备份数据。 - [如何在弹性文件服务SFS和对象存储服务OBS之间进行数据迁移?](https://support.huaweicloud.com/obs_faq/obs_faq_0065.md): 对象存储服务OBS是华为云提供的稳定、安全、高效、易用的云存储服务,具备标准Restful API接口,可存储任意数量和形式的非结构化数据。弹性文件服务SFS是华为云提供的按需扩展的高性能文件存储(NAS),可为云上多个弹性云服务器ECS,容器CCE&CCI,裸金属服务器BMS提供共享访问。SFS的文件系统需要挂载到弹性云服务器、容器或裸 - [OBS会不会扫描我的数据用于其他用途?](https://support.huaweicloud.com/obs_faq/obs_faq_0039.md): 不会。系统对数据做的扫描仅限于判断数据块是否存在和被损坏(如有损坏,会启动修复),不会读取具体的内容。 - [后台工程师能否导出我存储在OBS中的数据?](https://support.huaweicloud.com/obs_faq/obs_faq_0040.md): 后台工程师无法导出用户数据。访问桶或对象时,如果桶或对象未公开,只有桶或对象的拥有者才能够访问,访问时需要提供访问密钥(AK/SK)。 - [OBS如何保证我的数据不会被盗用?](https://support.huaweicloud.com/obs_faq/obs_faq_0041.md): OBS提供多种安全机制,保证您的数据安全:访问安全:只有桶或对象的拥有者才能访问,访问时需要提供访问密钥(AK/SK);提供ACL、桶策略等多种权限控制方式来控制非桶拥有者访问桶。数据安全:提供服务端加密、对象锁定(WORM)、防盗链等多种功能来保证存储在OBS中的数据安全。 - [OBS的持久性和可用性如何?](https://support.huaweicloud.com/obs_faq/obs_faq_0058.md): OBS通过存储介质的慢盘/坏道检测、AZ内设备和数据冗余、AZ之间数据容灾、跨区域复制等技术方案,提供针对介质、服务器、机柜、数据中心和区域的多级可靠性保障。其数据持久性高达99.9999999999%(12个9),可用性高达99.995%,远高于传统架构。选择不同存储类别、不同数据冗余存储策略时,数据的持久性和可用性会有所不同,具体请参 - [OBS单AZ和多AZ有什么区别?](https://support.huaweicloud.com/obs_faq/obs_faq_0060.md): 问题一:Q:创建桶时,数据冗余存储策略选择单AZ存储和多AZ存储有什么区别?A:选择多AZ存储,数据将冗余存储至多个AZ中,可靠性更高。选择单AZ存储,数据仅存储在单个AZ中,但相比多AZ更加便宜。收费详情请参见产品价格详情。问题二:Q:选择多AZ存储后,数据是以副本的形式分别存放在多个AZ中吗?如果某个AZ出现故障,其他AZ中的数据是否 - [OBS的数据冗余存储方式是什么?](https://support.huaweicloud.com/obs_faq/obs_faq_0073.md): OBS采用Erasure Code(EC,纠删码)算法做数据冗余,不是以副本的形式存储。在满足同等可靠性要求的前提下,EC的空间利用率优于多副本。数据冗余存储策略为“单AZ”的桶,在AZ内的节点间使用EC算法做数据冗余;“多AZ”的桶在AZ内节点间EC冗余的基础上,会同时在多个AZ间再做数据冗余。 - [我可以恢复已删除的对象吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0045.md): 桶开启了多版本控制功能时:对象列表页未开启“历史版本”开关时,单击“删除”按钮删除对象后,在对象列表中无法看到已删除对象,而打开“历史版本”开关后,在对象列表中可以看到带删除标记的当前版本对象和被删除后成为历史版本的对象。此时,单击带删除标记的当前版本对象操作列的“彻底删除”,即可恢复已删除对象。删除对象恢复已删除对象桶开启了多版本控制功 - [我可以恢复已删除的对象吗?](https://support.huaweicloud.com/obs_faq/obs_faq_0045.md): 桶开启了多版本控制功能时:对象列表页未开启“历史版本”开关时,单击“删除”按钮删除对象后,在对象列表中无法看到已删除对象,而打开“历史版本”开关后,在对象列表中可以看到带删除标记的当前版本对象和被删除后成为历史版本的对象。此时,单击带删除标记的当前版本对象操作列的“彻底删除”,即可恢复已删除对象。删除对象恢复已删除对象桶开启了多版本控制功 - [如何访问或下载已加密的对象?](https://support.huaweicloud.com/obs_faq/obs_faq_0168.md): 方法一:配置桶服务端加密后,上传到桶中的所有类型对象(如视频、音频等)都会自动使用指定的加密方式和密钥类型进行加密。方法二:上传对象时指定加密方式和密钥类型进行加密上传。对象指定SSE-OBS加密后,开启公共读的匿名访问权限后可以直接访问对象。注意,静态网站托管场景不支持直接访问SSE-OBS加密对象。对象指定SSE-C加密后,无法直接访 - [被委托账号或用户为什么无法上传下载KMS加密对象?](https://support.huaweicloud.com/obs_faq/obs_faq_0063.md): OBS服务端加密功能使用的前提是已经在IAM中为账号或用户授予OBS OperateAccess和KMS相关权限,如表所示。如果当前账号或用户是被委托方,也需要在委托中被授予OBS OperateAccess权限。请联系您的委托方进行授权,参见委托其他华为云账号管理资源。您需要通过委托获取临时访问密钥和securitytoken访问OBS - [分享对象时,OBS的SSE-OBS服务端加密方式是否需要授权特殊权限?](https://support.huaweicloud.com/obs_faq/obs_faq_1045.md): 不需要。SSE-OBS服务端加密方式,即在上传对象或访问对象时,OBS使用OBS根密钥派生的数据加密密钥,对OBS对象进行加解密。由于加解密时不需要再与KMS交互,因此分享对象时,不需要单独授权特殊权限。 - [OBS是否支持对象加密上传?](https://support.huaweicloud.com/obs_faq/obs_faq_0072.md): OBS提供了服务端加密功能,用户可以使用加密的方式上传对象,数据会在服务端加密成密文后存储。用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。OBS提供的多种访问方式中,对于对象加密上传的支持情况不同,具体如表1所示。 - [我对存储在OBS上的数据加密时,可支持哪些加密技术?](https://support.huaweicloud.com/obs_faq/obs_faq_0044.md): 您在将数据上传到OBS中前,可以事先对数据进行加密,以保证传输和保存的安全性。OBS不限定客户端加密的技术。用户可根据需要对对象进行服务端加密,使对象更安全地存储在OBS中。需要上传的对象可以通过数据加密服务器提供密钥的方式进行服务端加密。用户首先需要在KMS中创建密钥(或者使用KMS提供的默认密钥),当用户在OBS中上传对象时使用该密钥 - [为桶配置服务端加密后,OBS会对历史对象进行加密吗?](https://support.huaweicloud.com/obs_faq/obs_faq_1005.md): 不会。OBS只对服务器端加密配置生效后上传的对象进行加密,不会加密历史对象。如果您需要加密历史对象,需删除历史对象后重新上传。 - [OBS的服务端加密会收取加密的费用吗?](https://support.huaweicloud.com/obs_faq/obs_faq_1006.md): OBS的SSE-KMS服务端加密方式除了收取存储的费用,还会在KMS服务侧产生KMS密钥请求费用。OBS的SSE-OBS服务端加密方式和SSE-C服务端加密方式不会收取加密费用,只收取存储的费用。KMS密钥请求费用详情请参见密码安全中心如何收费和计费。存储的费用详情请参见存储费用。 - [OBS的SSE-KMS服务端加密方式是否支持匿名访问?](https://support.huaweicloud.com/obs_faq/obs_faq_1007.md): 不支持。由于匿名用户没有KMS访问权限,所以OBS的SSE-KMS服务端加密方式不支持匿名访问。 - [如何访问或下载已加密的对象?](https://support.huaweicloud.com/obs_faq/obs_faq_0168.md): 方法一:配置桶服务端加密后,上传到桶中的所有类型对象(如视频、音频等)都会自动使用指定的加密方式和密钥类型进行加密。方法二:上传对象时指定加密方式和密钥类型进行加密上传。对象指定SSE-OBS加密后,开启公共读的匿名访问权限后可以直接访问对象。注意,静态网站托管场景不支持直接访问SSE-OBS加密对象。对象指定SSE-C加密后,无法直接访 - [被委托账号或用户为什么无法上传下载KMS加密对象?](https://support.huaweicloud.com/obs_faq/obs_faq_0063.md): OBS服务端加密功能使用的前提是已经在IAM中为账号或用户授予OBS OperateAccess和KMS相关权限,如表所示。如果当前账号或用户是被委托方,也需要在委托中被授予OBS OperateAccess权限。请联系您的委托方进行授权,参见委托其他华为云账号管理资源。您需要通过委托获取临时访问密钥和securitytoken访问OBS - [分享对象时,OBS的SSE-OBS服务端加密方式是否需要授权特殊权限?](https://support.huaweicloud.com/obs_faq/obs_faq_1045.md): 不需要。SSE-OBS服务端加密方式,即在上传对象或访问对象时,OBS使用OBS根密钥派生的数据加密密钥,对OBS对象进行加解密。由于加解密时不需要再与KMS交互,因此分享对象时,不需要单独授权特殊权限。 - [OBS是否支持对象加密上传?](https://support.huaweicloud.com/obs_faq/obs_faq_0072.md): OBS提供了服务端加密功能,用户可以使用加密的方式上传对象,数据会在服务端加密成密文后存储。用户下载加密对象时,存储的密文会先在服务端解密为明文,再提供给用户。OBS提供的多种访问方式中,对于对象加密上传的支持情况不同,具体如表1所示。 - [我对存储在OBS上的数据加密时,可支持哪些加密技术?](https://support.huaweicloud.com/obs_faq/obs_faq_0044.md): 您在将数据上传到OBS中前,可以事先对数据进行加密,以保证传输和保存的安全性。OBS不限定客户端加密的技术。用户可根据需要对对象进行服务端加密,使对象更安全地存储在OBS中。需要上传的对象可以通过数据加密服务器提供密钥的方式进行服务端加密。用户首先需要在KMS中创建密钥(或者使用KMS提供的默认密钥),当用户在OBS中上传对象时使用该密钥 - [为桶配置服务端加密后,OBS会对历史对象进行加密吗?](https://support.huaweicloud.com/obs_faq/obs_faq_1005.md): 不会。OBS只对服务器端加密配置生效后上传的对象进行加密,不会加密历史对象。如果您需要加密历史对象,需删除历史对象后重新上传。 - [OBS的服务端加密会收取加密的费用吗?](https://support.huaweicloud.com/obs_faq/obs_faq_1006.md): OBS的SSE-KMS服务端加密方式除了收取存储的费用,还会在KMS服务侧产生KMS密钥请求费用。OBS的SSE-OBS服务端加密方式和SSE-C服务端加密方式不会收取加密费用,只收取存储的费用。KMS密钥请求费用详情请参见密码安全中心如何收费和计费。存储的费用详情请参见存储费用。 - [OBS的SSE-KMS服务端加密方式是否支持匿名访问?](https://support.huaweicloud.com/obs_faq/obs_faq_1007.md): 不支持。由于匿名用户没有KMS访问权限,所以OBS的SSE-KMS服务端加密方式不支持匿名访问。 - [创建跨区域复制规则后,为什么对象没有复制到目标桶中?](https://support.huaweicloud.com/obs_faq/obs_faq_0137.md): 跨区复制规则没有开启“同步历史对象”功能的时候,桶中已有的对象不会复制到目标桶中。新上传的对象存储类别为归档存储。跨区域复制不保证时效性,配置跨区域复制规则后,可能会出现对象不会立即进行复制的情况,请耐心等待。 - [删除对象操作会同步复制到跨区域复制的桶中吗?](https://support.huaweicloud.com/obs_faq/obs_03_0017.md): 如果您通过OBS管理控制台设置跨区域复制规则,并设置了“同步删除操作”,那么源桶的删除对象操作会同步复制到目标桶中。如果您通过API设置跨区域复制规则,那么源桶的删除对象操作是否会同步复制到目标桶中取决于DeleteData参数的设置:DeleteData参数值为Enabled,表示源桶的删除对象操作会同步复制到目标桶中。DeleteDa - [创建跨区域复制规则后,为什么对象没有复制到目标桶中?](https://support.huaweicloud.com/obs_faq/obs_faq_0137.md): 跨区复制规则没有开启“同步历史对象”功能的时候,桶中已有的对象不会复制到目标桶中。新上传的对象存储类别为归档存储。跨区域复制不保证时效性,配置跨区域复制规则后,可能会出现对象不会立即进行复制的情况,请耐心等待。 - [删除对象操作会同步复制到跨区域复制的桶中吗?](https://support.huaweicloud.com/obs_faq/obs_03_0017.md): 如果您通过OBS管理控制台设置跨区域复制规则,并设置了“同步删除操作”,那么源桶的删除对象操作会同步复制到目标桶中。如果您通过API设置跨区域复制规则,那么源桶的删除对象操作是否会同步复制到目标桶中取决于DeleteData参数的设置:DeleteData参数值为Enabled,表示源桶的删除对象操作会同步复制到目标桶中。DeleteDa - [为什么通过自定义域名访问桶,提示NoSuchBucket,而通过OBS访问域名可以访问?](https://support.huaweicloud.com/obs_faq/obs_faq_0049.md): 您在配置OBS桶的自定义域名后没有完成CNAME解析。配置OBS桶的自定义域名分为两步:配置自定义域名:实现OBS桶域名和自定义域名绑定。配置解析CNAME:实现OBS桶域名和自定义域名的映射。具体请参见通过自定义域名访问桶。 - [CDN加速场景下访问OBS桶内对象变成强制下载](https://support.huaweicloud.com/obs_faq/obs_faq_0154.md): 在OBS管理控制台配置自定义域名开启CDN加速后,或在CDN控制台配置“源站类型”为“OBS桶域名”的加速域名后,访问OBS桶中对象无法在线预览,变成强制下载。该问题有以下两种解决方案。方案一:登录CDN控制台的“域名管理”界面,在相应域名的“高级配置”中添加“Content-Disposition”响应头,取值为“inline”。如果执 - [OBS桶名和域名之间有什么联系?](https://support.huaweicloud.com/obs_faq/obs_faq_0123.md): OBS桶名是您创建的桶的名称。域名是桶所在区域的域名(Endpoint)。OBS桶名和域名(桶名.域名)可以构成桶的访问域名。 - [为什么会存在CNAME解析状态为未知的情况?](https://support.huaweicloud.com/obs_faq/obs_faq_0070.md): 当用户绑定的域名不是华为云域名注册服务提供的域名时,无法确认用户对该域名的拥有权,此时CNAME解析状态为未知。在CNAME解析状态为未知的情况下,需要用户自行配置解析规则,具体配置方法请参见配置CNAME。 - [为什么用户在华为云购买的域名才支持一键解析?](https://support.huaweicloud.com/obs_faq/obs_faq_0077.md): 当用户在华为云购买自定义域名,可以在目标桶内进行域名绑定,完成一键解析添加CNAME记录。当用户在其他域名服务商购买域名时,由于华为云无法感知该域名是否可以解析到目标桶域名,因此需要用户自行配置解析规则,具体配置方法请参见配置CNAME。 - [为什么通过自定义域名访问桶,提示NoSuchBucket,而通过OBS访问域名可以访问?](https://support.huaweicloud.com/obs_faq/obs_faq_0049.md): 您在配置OBS桶的自定义域名后没有完成CNAME解析。配置OBS桶的自定义域名分为两步:配置自定义域名:实现OBS桶域名和自定义域名绑定。配置解析CNAME:实现OBS桶域名和自定义域名的映射。具体请参见通过自定义域名访问桶。 - [CDN加速场景下访问OBS桶内对象变成强制下载](https://support.huaweicloud.com/obs_faq/obs_faq_0154.md): 在OBS管理控制台配置自定义域名开启CDN加速后,或在CDN控制台配置“源站类型”为“OBS桶域名”的加速域名后,访问OBS桶中对象无法在线预览,变成强制下载。该问题有以下两种解决方案。方案一:登录CDN控制台的“域名管理”界面,在相应域名的“高级配置”中添加“Content-Disposition”响应头,取值为“inline”。如果执 - [OBS桶名和域名之间有什么联系?](https://support.huaweicloud.com/obs_faq/obs_faq_0123.md): OBS桶名是您创建的桶的名称。域名是桶所在区域的域名(Endpoint)。OBS桶名和域名(桶名.域名)可以构成桶的访问域名。 - [为什么会存在CNAME解析状态为未知的情况?](https://support.huaweicloud.com/obs_faq/obs_faq_0070.md): 当用户绑定的域名不是华为云域名注册服务提供的域名时,无法确认用户对该域名的拥有权,此时CNAME解析状态为未知。在CNAME解析状态为未知的情况下,需要用户自行配置解析规则,具体配置方法请参见配置CNAME。 - [为什么用户在华为云购买的域名才支持一键解析?](https://support.huaweicloud.com/obs_faq/obs_faq_0077.md): 当用户在华为云购买自定义域名,可以在目标桶内进行域名绑定,完成一键解析添加CNAME记录。当用户在其他域名服务商购买域名时,由于华为云无法感知该域名是否可以解析到目标桶域名,因此需要用户自行配置解析规则,具体配置方法请参见配置CNAME。 - [哪些类型的网站适合使用OBS进行静态网站托管?](https://support.huaweicloud.com/obs_faq/obs_faq_0029.md): 静态网站通常仅包含静态网页,以及可能包含部分可在客户端运行的脚本,如JavaScript、Flash等。OBS支持静态网站托管。您可以通过OBS管理控制台将自己的桶配置成静态网站托管模式,当客户端通过桶的website接入点访问桶内的对象资源时,浏览器可以直接解析出这些网页资源,呈现给最终用户。 - [如何获取桶的静态网站托管地址?](https://support.huaweicloud.com/obs_faq/obs_faq_0030.md): 您可以在管理控制台的静态网站托管页面上获取到桶的静态网站托管地址。您也可以拼接桶的静态网站访问地址。拼接地址格式为:https://桶名.静态网站托管域名。例如区域为“华北-北京四”的桶名为“testbucket”的桶配置成静态网站托管模式后,该桶的静态网站访问地址为https://testbucket.obs-website.cn-no - [哪些类型的网站适合使用OBS进行静态网站托管?](https://support.huaweicloud.com/obs_faq/obs_faq_0029.md): 静态网站通常仅包含静态网页,以及可能包含部分可在客户端运行的脚本,如JavaScript、Flash等。OBS支持静态网站托管。您可以通过OBS管理控制台将自己的桶配置成静态网站托管模式,当客户端通过桶的website接入点访问桶内的对象资源时,浏览器可以直接解析出这些网页资源,呈现给最终用户。 - [如何获取桶的静态网站托管地址?](https://support.huaweicloud.com/obs_faq/obs_faq_0030.md): 您可以在管理控制台的静态网站托管页面上获取到桶的静态网站托管地址。您也可以拼接桶的静态网站访问地址。拼接地址格式为:https://桶名.静态网站托管域名。例如区域为“华北-北京四”的桶名为“testbucket”的桶配置成静态网站托管模式后,该桶的静态网站访问地址为https://testbucket.obs-website.cn-no - [为什么镜像回源文件和源站文件的大小不一致?](https://support.huaweicloud.com/obs_faq/obs_faq_121901.md): 当镜像回源文件和源站文件的大小不一致时,请按照如下步骤排查:查看存储在桶中的回源文件的“最后修改时间”和源站中的文件的时间戳。如果源站文件的时间戳大于桶中回源文件的“最后修改时间”,表示在回源文件存储至桶中后,源站文件有更新。如果源站文件的时间戳小于等于桶中回源文件的“最后修改时间”,表示在回源文件存储至桶中后,源站文件没有更新,则继续下 - [回源失败应该如何排查?](https://support.huaweicloud.com/obs_faq/obs_faq_121902.md): 当回源失败时,请按照如下步骤排查:检查源站是否可连通。curl -I https://testexample.com/file/test.txt如果回源地址为私有桶地址,需要确保您有权限访问该桶。如果回源地址为私有桶地址,需要确保您有权限访问该桶。检查源站域名的DNS解析。nslookup testexample.com如果源站使用HTT - [为什么在桶中没有找到回源文件?](https://support.huaweicloud.com/obs_faq/obs_faq_121903.md): 通常情况下,客户端只有向OBS桶发送获取文件内容的请求时,如果OBS桶中不存在该文件,OBS才会从源站获取目标文件,存储至OBS桶中后,同时返回文件至客户端。而当客户端向OBS桶发送HEAD请求来获取对象的元数据时,仅获取文件的基本信息(如:大小、最后修改时间、存储类别),并不获取文件实际内容。此时不会触发回源规则,因此不会将源站文件存储 - [为什么源站文件更新了而OBS桶中的文件未更新?](https://support.huaweicloud.com/obs_faq/obs_faq_121904.md): 若某个文件已经通过镜像回源存储到OBS桶中,源站的源文件发生了变化,OBS不会同步更新该文件。可通过以下方式间接实现OBS中的文件和源站文件同步:手动删除回源文件:通过控制台或API等方式手动删除回源存储至桶中的文件,便于下次再触发回源规则,从源站获取最新数据。通过生命周期规则定期删除回源文件:为回源文件配置生命周期规则,使其在指定时间后 - [可以使用镜像回源至内网服务或内网IP吗?](https://support.huaweicloud.com/obs_faq/obs_faq_121905.md): 不可以。镜像回源规则仅支持配置源站为可以使用公网访问的域名或公网IP。如果您需要配置源站为VPC内的服务,请结合NAT网关(NAT Gateway)或弹性负载均衡(Elastic Load Balance,简称ELB)使其域名可以被通过公网访问。 - [为什么镜像回源文件和源站文件的大小不一致?](https://support.huaweicloud.com/obs_faq/obs_faq_121901.md): 当镜像回源文件和源站文件的大小不一致时,请按照如下步骤排查:查看存储在桶中的回源文件的“最后修改时间”和源站中的文件的时间戳。如果源站文件的时间戳大于桶中回源文件的“最后修改时间”,表示在回源文件存储至桶中后,源站文件有更新。如果源站文件的时间戳小于等于桶中回源文件的“最后修改时间”,表示在回源文件存储至桶中后,源站文件没有更新,则继续下 - [回源失败应该如何排查?](https://support.huaweicloud.com/obs_faq/obs_faq_121902.md): 当回源失败时,请按照如下步骤排查:检查源站是否可连通。curl -I https://testexample.com/file/test.txt如果回源地址为私有桶地址,需要确保您有权限访问该桶。如果回源地址为私有桶地址,需要确保您有权限访问该桶。检查源站域名的DNS解析。nslookup testexample.com如果源站使用HTT - [为什么在桶中没有找到回源文件?](https://support.huaweicloud.com/obs_faq/obs_faq_121903.md): 通常情况下,客户端只有向OBS桶发送获取文件内容的请求时,如果OBS桶中不存在该文件,OBS才会从源站获取目标文件,存储至OBS桶中后,同时返回文件至客户端。而当客户端向OBS桶发送HEAD请求来获取对象的元数据时,仅获取文件的基本信息(如:大小、最后修改时间、存储类别),并不获取文件实际内容。此时不会触发回源规则,因此不会将源站文件存储 - [为什么源站文件更新了而OBS桶中的文件未更新?](https://support.huaweicloud.com/obs_faq/obs_faq_121904.md): 若某个文件已经通过镜像回源存储到OBS桶中,源站的源文件发生了变化,OBS不会同步更新该文件。可通过以下方式间接实现OBS中的文件和源站文件同步:手动删除回源文件:通过控制台或API等方式手动删除回源存储至桶中的文件,便于下次再触发回源规则,从源站获取最新数据。通过生命周期规则定期删除回源文件:为回源文件配置生命周期规则,使其在指定时间后 - [可以使用镜像回源至内网服务或内网IP吗?](https://support.huaweicloud.com/obs_faq/obs_faq_121905.md): 不可以。镜像回源规则仅支持配置源站为可以使用公网访问的域名或公网IP。如果您需要配置源站为VPC内的服务,请结合NAT网关(NAT Gateway)或弹性负载均衡(Elastic Load Balance,简称ELB)使其域名可以被通过公网访问。 - [为什么删除对象没有触发EG事件通知?](https://support.huaweicloud.com/obs_faq/obs_faq_121402.md): 问题描述:在配置EG事件通知时,配置了删除对象事件类型,但是当出现删除对象行为时,没有触发EG事件通知。原因:对开启了多版本控制的桶执行对象删除操作时,如果未指定版本ID,默认不会删除任意版本对象,而是将当前版本对象转为历史版本对象,并添加删除标记作为当前版本。此行为不是执行了真正的删除操作,因此不会触发删除相关的事件通知。解决办法:对开 - [为什么删除对象没有触发EG事件通知?](https://support.huaweicloud.com/obs_faq/obs_faq_121402.md): 问题描述:在配置EG事件通知时,配置了删除对象事件类型,但是当出现删除对象行为时,没有触发EG事件通知。原因:对开启了多版本控制的桶执行对象删除操作时,如果未指定版本ID,默认不会删除任意版本对象,而是将当前版本对象转为历史版本对象,并添加删除标记作为当前版本。此行为不是执行了真正的删除操作,因此不会触发删除相关的事件通知。解决办法:对开 - [如何通过URL访问图片处理服务?](https://support.huaweicloud.com/obs_faq/obs_01_0670.md): 针对非公共可读的图片,需要在计算签名时加上图片处理参数,最终通过生成带签名的临时URL来访问。如下为一个简单的Java SDK示例代码供参考,详细的SDK使用可参考SDK使用文档。// Endpoint以华北-北京四区域为例,其他区域请按实际情况填写 String endPoint = "https://obs.cn-north-4.my - [设置CDN加速后,处理过的图片存储在哪里?](https://support.huaweicloud.com/obs_faq/obs_01_0680.md): 用户通过CDN访问图片处理服务,CDN会对处理后的图片做缓存,此时处理后的图片存储在CDN。当用户再次对该图片进行相同的处理时,由CDN直接返回处理后的效果,不会再次访问图片处理服务,也不会对此次图片处理请求进行计费。 - [设置桶日志后,进行图片处理,发现有100网段的ip访问桶](https://support.huaweicloud.com/obs_faq/obs_01_0690.md): 用户开启了桶日志配置,在对桶里的对象进行图片处理后,查看桶的访问日志,发现有100网段的ip访问了该桶。原因是:在进行图片处理的过程中,OBS会通过内网访问客户的桶来下载原图并进行图片处理,此时内网ip会被记录到桶日志中,同时会产生下载次数的计费。 - [图片处理如何收费?](https://support.huaweicloud.com/obs_faq/obs_01_0630.md): 详细的服务资费费率标准请参见产品价格详情(单击链接跳转后选择价格详情页签)。原始图片大小以GB为单位,根据使用月份数按固定单价收费。以GB为单位,根据使用月份数按固定单价收费。图片处理根据原始图片的大小来进行计费,使用图片处理对多张图片进行处理时,数据大小自动累计。例如:将一张0.01GB的图片使用图片处理剪切和压缩后仅为0.005GB, - [每个桶支持创建多少个图片样式?](https://support.huaweicloud.com/obs_faq/obs_01_0640.md): 每个桶最多支持创建100个样式。OBS提供两种不同的方法创建图片样式:通过控制台处理图片通过接口处理图片 - [如何通过URL访问图片处理服务?](https://support.huaweicloud.com/obs_faq/obs_01_0670.md): 针对非公共可读的图片,需要在计算签名时加上图片处理参数,最终通过生成带签名的临时URL来访问。如下为一个简单的Java SDK示例代码供参考,详细的SDK使用可参考SDK使用文档。// Endpoint以华北-北京四区域为例,其他区域请按实际情况填写 String endPoint = "https://obs.cn-north-4.my - [设置CDN加速后,处理过的图片存储在哪里?](https://support.huaweicloud.com/obs_faq/obs_01_0680.md): 用户通过CDN访问图片处理服务,CDN会对处理后的图片做缓存,此时处理后的图片存储在CDN。当用户再次对该图片进行相同的处理时,由CDN直接返回处理后的效果,不会再次访问图片处理服务,也不会对此次图片处理请求进行计费。 - [设置桶日志后,进行图片处理,发现有100网段的ip访问桶](https://support.huaweicloud.com/obs_faq/obs_01_0690.md): 用户开启了桶日志配置,在对桶里的对象进行图片处理后,查看桶的访问日志,发现有100网段的ip访问了该桶。原因是:在进行图片处理的过程中,OBS会通过内网访问客户的桶来下载原图并进行图片处理,此时内网ip会被记录到桶日志中,同时会产生下载次数的计费。 - [图片处理如何收费?](https://support.huaweicloud.com/obs_faq/obs_01_0630.md): 详细的服务资费费率标准请参见产品价格详情(单击链接跳转后选择价格详情页签)。原始图片大小以GB为单位,根据使用月份数按固定单价收费。以GB为单位,根据使用月份数按固定单价收费。图片处理根据原始图片的大小来进行计费,使用图片处理对多张图片进行处理时,数据大小自动累计。例如:将一张0.01GB的图片使用图片处理剪切和压缩后仅为0.005GB, - [每个桶支持创建多少个图片样式?](https://support.huaweicloud.com/obs_faq/obs_01_0640.md): 每个桶最多支持创建100个样式。OBS提供两种不同的方法创建图片样式:通过控制台处理图片通过接口处理图片 - [并行文件系统挂载后,为何显示256T?](https://support.huaweicloud.com/obs_faq/obs_13_0015.md): 问题背景:当您在客户端上执行“df -h”时,为了显示需要,系统则直接返回了256TB。解释说明:该数值实际上无任何意义,您可以使用的并行文件系统容量无限制。 - [文件列表是否支持排序?](https://support.huaweicloud.com/obs_faq/obs_13_0016.md): 支持。文件列表支持按照“大小”和“最后修改时间”进行排序,您可以单击参数后的按钮对文件进行排序。“最后修改时间”排序,支持前5000个文件按照时间排序。如果并行文件系统内文件数量超过5000条,文件列表按照英文单词在字典中的先后顺序进行排序,且只支持按文件名的前缀搜索。文件夹仅支持按照“大小”进行排序,不支持按照“最后修改时间”排序。 - [并行文件系统挂载后,为何显示256T?](https://support.huaweicloud.com/obs_faq/obs_13_0015.md): 问题背景:当您在客户端上执行“df -h”时,为了显示需要,系统则直接返回了256TB。解释说明:该数值实际上无任何意义,您可以使用的并行文件系统容量无限制。 - [文件列表是否支持排序?](https://support.huaweicloud.com/obs_faq/obs_13_0016.md): 支持。文件列表支持按照“大小”和“最后修改时间”进行排序,您可以单击参数后的按钮对文件进行排序。“最后修改时间”排序,支持前5000个文件按照时间排序。如果并行文件系统内文件数量超过5000条,文件列表按照英文单词在字典中的先后顺序进行排序,且只支持按文件名的前缀搜索。文件夹仅支持按照“大小”进行排序,不支持按照“最后修改时间”排序。 - [为什么OBS的云监控指标看不到5xx状态码统计数?](https://support.huaweicloud.com/obs_faq/obs_faq_1003.md): 目前OBS的云监控指标是根据用户请求的信息统计展示的。当用户出现某种请求类或存储类动作,OBS的云监控指标就会展示该请求类或存储类的指标。例如:当用户的请求出现5xx服务端响应状态码时,那么在云监控中就可以看到5XX状态码个数的指标。 - [为什么OBS的云监控指标看不到5xx状态码统计数?](https://support.huaweicloud.com/obs_faq/obs_faq_1003.md): 目前OBS的云监控指标是根据用户请求的信息统计展示的。当用户出现某种请求类或存储类动作,OBS的云监控指标就会展示该请求类或存储类的指标。例如:当用户的请求出现5xx服务端响应状态码时,那么在云监控中就可以看到5XX状态码个数的指标。 - [控制台浏览器兼容性](https://support.huaweicloud.com/obs_faq/obs_03_0301.md): OBS管理控制台支持的浏览器版本如表1所示: - [出现“客户端与服务器的时间相差15分钟”的报错](https://support.huaweicloud.com/obs_faq/obs_03_0347.md): 问题:使用OBS时出现报错“客户端与服务器的时间相差大于15分钟”或“The difference between the request time and the current time is too large”。原因:出于安全目的,OBS会校验客户端与OBS服务器的时间差,当该时间差大于15分钟时,OBS服务器会拒绝您的请求,从而 - [下载一个对象名较长的对象到本地后,对象名称改变](https://support.huaweicloud.com/obs_faq/obs_03_0345.md): 问题:使用OBS管理控制台下载一个对象名较长的对象到本地后,为什么对象名称发生了改变?原因:Windows操作系统下允许的文件名长度最大为255字符,包括文件名和扩展名在内。当对象名称长度超过255字符时,将该对象下载到本地后,系统便会自动将对象名截取至255字符。解决办法:请修改对象名称在255字符内。 - [使用IE11浏览器下载对象时提示对象无法下载](https://support.huaweicloud.com/obs_faq/obs_03_0343.md): 用IE11浏览器登录OBS管理控制台上传一个对象,在未关闭浏览器的情况下,下载该对象到本地原路径下,选择替换原文件保存,浏览器会弹出无法下载的提示。例如,从本地C盘的根目录下上传一个名为“abc”的对象到OBS管理控制台的某桶中,在不关闭浏览器的情况下,将该对象再下载到本地C盘的根目录下,并选择替换原文件保存,浏览器会弹出无法下载的提示。 - [使用IE9浏览器无法打开OBS管理控制台界面](https://support.huaweicloud.com/obs_faq/obs_03_0344.md): 在OBS管理控制台地址能够Ping通的情况下,为什么使用IE9浏览器无法打开OBS管理控制台界面?检查浏览器的“Internet选项”中是否勾选SSL和TLS选项,如果没有,则根据以下步骤处理后重试。 - [错误码列表](https://support.huaweicloud.com/obs_faq/obs_03_0348.md): 如果请求因错误导致未被处理,则会返回一条错误响应。错误响应中包括错误码和具体错误描述。表1列出了错误响应中的常见错误码。 - [控制台浏览器兼容性](https://support.huaweicloud.com/obs_faq/obs_03_0301.md): OBS管理控制台支持的浏览器版本如表1所示: - [出现“客户端与服务器的时间相差15分钟”的报错](https://support.huaweicloud.com/obs_faq/obs_03_0347.md): 问题:使用OBS时出现报错“客户端与服务器的时间相差大于15分钟”或“The difference between the request time and the current time is too large”。原因:出于安全目的,OBS会校验客户端与OBS服务器的时间差,当该时间差大于15分钟时,OBS服务器会拒绝您的请求,从而 - [下载一个对象名较长的对象到本地后,对象名称改变](https://support.huaweicloud.com/obs_faq/obs_03_0345.md): 问题:使用OBS管理控制台下载一个对象名较长的对象到本地后,为什么对象名称发生了改变?原因:Windows操作系统下允许的文件名长度最大为255字符,包括文件名和扩展名在内。当对象名称长度超过255字符时,将该对象下载到本地后,系统便会自动将对象名截取至255字符。解决办法:请修改对象名称在255字符内。 - [使用IE11浏览器下载对象时提示对象无法下载](https://support.huaweicloud.com/obs_faq/obs_03_0343.md): 用IE11浏览器登录OBS管理控制台上传一个对象,在未关闭浏览器的情况下,下载该对象到本地原路径下,选择替换原文件保存,浏览器会弹出无法下载的提示。例如,从本地C盘的根目录下上传一个名为“abc”的对象到OBS管理控制台的某桶中,在不关闭浏览器的情况下,将该对象再下载到本地C盘的根目录下,并选择替换原文件保存,浏览器会弹出无法下载的提示。 - [使用IE9浏览器无法打开OBS管理控制台界面](https://support.huaweicloud.com/obs_faq/obs_03_0344.md): 在OBS管理控制台地址能够Ping通的情况下,为什么使用IE9浏览器无法打开OBS管理控制台界面?检查浏览器的“Internet选项”中是否勾选SSL和TLS选项,如果没有,则根据以下步骤处理后重试。 - [错误码列表](https://support.huaweicloud.com/obs_faq/obs_03_0348.md): 如果请求因错误导致未被处理,则会返回一条错误响应。错误响应中包括错误码和具体错误描述。表1列出了错误响应中的常见错误码。 - [使用obsutil下载文件夹前期速度正常,下载到90%后速度变慢](https://support.huaweicloud.com/obs_faq/obs_faq_0067.md): 出现此种现象有两种场景。场景一:文件夹中存在部分大对象和大量小对象。对于大对象,下载速度很快;对于大量小对象,下载速度主要受TPS影响。如果下载到90%后都是小对象,此时下载速度一定程度上可能会降低。场景二:文件夹中的对象大小均匀。可能原因为数据已经下载完成,但是在写入磁盘时产生排队现象,造成显示下载变慢的假象,请客户排查客户端的写入速率 - [使用obsutil下载文件到99%后失败](https://support.huaweicloud.com/obs_faq/obs_faq_0068.md): 出现该问题的主要原因:网络波动导致下载失败。磁盘IO卡顿导致缓存文件到目标文件夹失败。解决方法:重新执行下载命令。obsutil在下载的时候默认开启断点续传,此时只要重新执行之前的下载命令就可以将之前下载失败的对象采用续传的方式重新下载到本地。obsutil在下载的时候默认开启断点续传,此时只要重新执行之前的下载命令就可以将之前下载失败的 - [obsutil上传下载速度慢](https://support.huaweicloud.com/obs_faq/obs_faq_0145.md): OBS不限速,obsutil也不会对客户数据传输进行限流。采用obsutil进行文件上传下载,如果通过公网,受公网带宽限制;如果通过内网,受网卡、磁盘IO及是否有其它进程抢占资源的限制。如果出现上传下载速度慢的问题,可参考以下方法排查处理:检查网络。ping同区域的OBS终端节点(Endpoint),例如ping obs.cn-north - [obsutil cp命令如何开启增量上传、下载和复制?](https://support.huaweicloud.com/obs_faq/obs_faq_0146.md): 在执行obsutil cp命令进行上传/下载时,可以通过增加-u参数开启增量功能。该参数的含义为:上传/下载/复制每个对象时都会对比源路径和目标路径,仅在目标对象不存在,或者对象大小不一致,或者目标对象的最后修改时间早于源对象的最后修改时间时进行上传/下载/复制。 - [并行文件系统是否支持挂载到Windows服务器?](https://support.huaweicloud.com/obs_faq/obs_faq_0171.md): 并行文件系统当前仅支持通过obsfs工具挂载至Linux服务器,暂不支持挂载至Windows服务器。并行文件系统挂载至Linux服务器,具体请参见挂载并行文件系统。 - [使用obsutil下载文件夹前期速度正常,下载到90%后速度变慢](https://support.huaweicloud.com/obs_faq/obs_faq_0067.md): 出现此种现象有两种场景。场景一:文件夹中存在部分大对象和大量小对象。对于大对象,下载速度很快;对于大量小对象,下载速度主要受TPS影响。如果下载到90%后都是小对象,此时下载速度一定程度上可能会降低。场景二:文件夹中的对象大小均匀。可能原因为数据已经下载完成,但是在写入磁盘时产生排队现象,造成显示下载变慢的假象,请客户排查客户端的写入速率 - [使用obsutil下载文件到99%后失败](https://support.huaweicloud.com/obs_faq/obs_faq_0068.md): 出现该问题的主要原因:网络波动导致下载失败。磁盘IO卡顿导致缓存文件到目标文件夹失败。解决方法:重新执行下载命令。obsutil在下载的时候默认开启断点续传,此时只要重新执行之前的下载命令就可以将之前下载失败的对象采用续传的方式重新下载到本地。obsutil在下载的时候默认开启断点续传,此时只要重新执行之前的下载命令就可以将之前下载失败的 - [obsutil上传下载速度慢](https://support.huaweicloud.com/obs_faq/obs_faq_0145.md): OBS不限速,obsutil也不会对客户数据传输进行限流。采用obsutil进行文件上传下载,如果通过公网,受公网带宽限制;如果通过内网,受网卡、磁盘IO及是否有其它进程抢占资源的限制。如果出现上传下载速度慢的问题,可参考以下方法排查处理:检查网络。ping同区域的OBS终端节点(Endpoint),例如ping obs.cn-north - [obsutil cp命令如何开启增量上传、下载和复制?](https://support.huaweicloud.com/obs_faq/obs_faq_0146.md): 在执行obsutil cp命令进行上传/下载时,可以通过增加-u参数开启增量功能。该参数的含义为:上传/下载/复制每个对象时都会对比源路径和目标路径,仅在目标对象不存在,或者对象大小不一致,或者目标对象的最后修改时间早于源对象的最后修改时间时进行上传/下载/复制。 - [并行文件系统是否支持挂载到Windows服务器?](https://support.huaweicloud.com/obs_faq/obs_faq_0171.md): 并行文件系统当前仅支持通过obsfs工具挂载至Linux服务器,暂不支持挂载至Windows服务器。并行文件系统挂载至Linux服务器,具体请参见挂载并行文件系统。 - [使用OBS SDK上传超过5GB的大文件失败](https://support.huaweicloud.com/obs_faq/obs_faq_0069.md): OBS服务端上传对象接口有规格限制,单次可上传的最大文件为5GB,如果需要上传超过5GB的大文件,需要通过OBS服务端提供的分段上传接口实现。具体步骤为:调用OBS服务端初始化上传段任务接口,生成分段上传ID(Upload ID)。调用OBS服务端上传段接口,逐个或并行上传段,每个段最大可支持5GB。上传段完成后,调用OBS服务端合并段接 - [Java SDK报错okhttp3.RequestBody.create(java.lang.String,okhttp3.MediaType)](https://support.huaweicloud.com/obs_faq/obs_faq_0164.md): OBS Java SDK报错“okhttp3.RequestBody.create(java.lang.String,okhttp3.MediaType)”。因spring-boot约定了三方依赖的版本,可参考:Spring-boot Managed Dependency Coordinates。在spring-boot框架中引入OBS - [PUT上传和POST上传有什么区别?](https://support.huaweicloud.com/obs_faq/obs_faq_0071.md): PUT上传中参数通过请求头域传递;POST上传则作为消息体中的表单域传递。PUT上传需在URL中指定对象名;POST上传提交的URL为桶域名,无需指定对象名。两者的请求行分别为:两种方式单次上传对象大小范围均为[0, 5GB],如果需要上传超过5GB的大文件,需要通过多段上传实现。关于PUT和POST上传更详细的API信息,请参见API参 - [追加上传对象是否支持并发场景下的锁机制?](https://support.huaweicloud.com/obs_faq/obs_faq_0165.md): OBS本身不支持,如果需要避免同一个对象被并行访问,需要在上层应用中增加对象的锁机制。针对同一个对象或桶的操作,比如多个客户端对同一个对象并行上传、查询和删除时,具体操作结果依赖于操作到达系统的时间和系统内部处理的时延,可能返回不一致的结果。比如,当多个客户端并行上传同一个对象时,系统最后收到的上传请求会覆盖前一个上传的对象。详情请参考并 - [签名不匹配(SignatureDoesNotMatch)如何处理](https://support.huaweicloud.com/obs_faq/obs_faq_0173.md): 调用OBS API报如下错误:状态码:403 Forbidden错误码:SignatureDoesNotMatch错误信息:The request signature we calculated does not match the signature you provided. Check your key and signing me - [如何使用V4签名访问OBS](https://support.huaweicloud.com/obs_faq/obs_faq_0274.md): OBS支持V4签名算法。V4仅支持UNSIGNED-PAYLOAD、STREAMING-AWS4-HMAC-SHA256-PAYLOAD 2种模式。如果是boto3 1.36.0及以上版本的,请参见以下进行配置:custom_config = Config( signature_version='s3v4', reques - [使用OBS SDK上传超过5GB的大文件失败](https://support.huaweicloud.com/obs_faq/obs_faq_0069.md): OBS服务端上传对象接口有规格限制,单次可上传的最大文件为5GB,如果需要上传超过5GB的大文件,需要通过OBS服务端提供的分段上传接口实现。具体步骤为:调用OBS服务端初始化上传段任务接口,生成分段上传ID(Upload ID)。调用OBS服务端上传段接口,逐个或并行上传段,每个段最大可支持5GB。上传段完成后,调用OBS服务端合并段接 - [Java SDK报错okhttp3.RequestBody.create(java.lang.String,okhttp3.MediaType)](https://support.huaweicloud.com/obs_faq/obs_faq_0164.md): OBS Java SDK报错“okhttp3.RequestBody.create(java.lang.String,okhttp3.MediaType)”。因spring-boot约定了三方依赖的版本,可参考:Spring-boot Managed Dependency Coordinates。在spring-boot框架中引入OBS - [PUT上传和POST上传有什么区别?](https://support.huaweicloud.com/obs_faq/obs_faq_0071.md): PUT上传中参数通过请求头域传递;POST上传则作为消息体中的表单域传递。PUT上传需在URL中指定对象名;POST上传提交的URL为桶域名,无需指定对象名。两者的请求行分别为:两种方式单次上传对象大小范围均为[0, 5GB],如果需要上传超过5GB的大文件,需要通过多段上传实现。关于PUT和POST上传更详细的API信息,请参见API参 - [追加上传对象是否支持并发场景下的锁机制?](https://support.huaweicloud.com/obs_faq/obs_faq_0165.md): OBS本身不支持,如果需要避免同一个对象被并行访问,需要在上层应用中增加对象的锁机制。针对同一个对象或桶的操作,比如多个客户端对同一个对象并行上传、查询和删除时,具体操作结果依赖于操作到达系统的时间和系统内部处理的时延,可能返回不一致的结果。比如,当多个客户端并行上传同一个对象时,系统最后收到的上传请求会覆盖前一个上传的对象。详情请参考并 - [签名不匹配(SignatureDoesNotMatch)如何处理](https://support.huaweicloud.com/obs_faq/obs_faq_0173.md): 调用OBS API报如下错误:状态码:403 Forbidden错误码:SignatureDoesNotMatch错误信息:The request signature we calculated does not match the signature you provided. Check your key and signing me - [如何使用V4签名访问OBS](https://support.huaweicloud.com/obs_faq/obs_faq_0274.md): OBS支持V4签名算法。V4仅支持UNSIGNED-PAYLOAD、STREAMING-AWS4-HMAC-SHA256-PAYLOAD 2种模式。如果是boto3 1.36.0及以上版本的,请参见以下进行配置:custom_config = Config( signature_version='s3v4', reques - [触发器配置不当导致“无限循环”触发Data+工作流如何处理?](https://support.huaweicloud.com/obs_faq/obs_faq_0153.md): 由于OBS只能按触发器前缀、后缀、事件源类型等条件触发Data+工作流,无法保证触发消息不出现“无限循环”的场景。如果出现“无限循环”,只能先删除桶的事件触发器。主要有以下两个场景:案例1:使用Data+内置函数触发“无限循环”用户创建一条Data+工作流workflowA,在工作流中使用了内置的“媒资转码”函数,且配置“媒资转码”函数的 - [触发器配置不当导致“无限循环”触发Data+工作流如何处理?](https://support.huaweicloud.com/obs_faq/obs_faq_0153.md): 由于OBS只能按触发器前缀、后缀、事件源类型等条件触发Data+工作流,无法保证触发消息不出现“无限循环”的场景。如果出现“无限循环”,只能先删除桶的事件触发器。主要有以下两个场景:案例1:使用Data+内置函数触发“无限循环”用户创建一条Data+工作流workflowA,在工作流中使用了内置的“媒资转码”函数,且配置“媒资转码”函数的