华为云用户手册

重定向广告推广 场景概述 重定向广告（Retargeting）是一种基于应用、网页广告的定向技术，即针对广告受众（Audience）的浏览行为进行分析，在同一个广告位，推送为该用户定制的广告，实现千人千面。 客户瓶颈 重定向广告推广最终目的是将访问者转变为下单客户，是带动全球在线企业营收的主要因素之一。为了有效服务于广告，在极快的响应时间内实时中标，并通过自动化确保系统迅速响应竞价，广告推广商必须能够根据业务压力灵活快速并且成本可控地增加容量。 竞享实例的应用 客户使用包周期实例作为常规容量提供服务，在业务高峰时，得益于竞享实例低成本及快速扩缩容特性，竞享实例为系统提供可变容量以应对流量洪峰。自动化是这项业务的关键，所以客户需要进行业务容错性改造，实现任何一个或一些实例出现故障（被回收）时，可自行替换并继续运行，无需任何人工干预。

离线渲染平台/影视动画渲染 场景概述 为了满足观众对于图形图像或影视特效要求不断提高，在渲染环节所占时间和投资比重也越来越大。传统的线下渲染方式已无法满足特效制作公司对于计算资源的重度需求，云化渲染逐渐成为主流。 客户瓶颈 以某部国产科幻电影的一个特效镜头为例，开场从地面拉向太空的2mins长镜头共有3000帧。以目前主流4K影片常用渲染配置——3000台24核服务器集群进行渲染，每台服务器并行渲染1帧，总时间需要20h，按需成本约32W。而在实际影视制作中，通常一个画面需要渲染，修改多次才可以出片，实际成本和时间会更高。 竞享实例的应用 相较于采用按需方式进行离线渲染，竞享实例可以渲染同样的特效画面，在时间相同的情况下只需8万元，成本下降75%。这些节省的成本还可以用来购买更多的竞享实例，实现成本和渲染周期的双重下降，并以此缩短整个电影拍摄制作周期，节省大量人力物力成本。

操作场景 您可以选择在云服务器上安装XR Linker插件以替换第三方运行环境（如SteamVR）。XR Linker是华为自研的PC端插件，兼容主流VR应用和3D应用运行环境，具备如下优势： 无缝兼容主流VR运行环境（如SteamVR）。 减少部署文件体积，加快业务部署效率。 实现软件优化，如减少渲染时延。 本节指导您在云服务器创建成功后，如何安装XR Linker。 当前平台仅支持从第三方插件切换为XR Linker，暂不支持XR Linker切换回第三方插件的操作，若您安装XR Linker后遇到任何问题，请联系测试对接人员提供技术支持。 云服务器下有多路会话时，仅支持安装XR Linker插件。

监控VR云渲游平台 监控是保持VR云渲游平台可靠性、可用性和性能的重要部分，通过监控，用户可以观察VR云渲游平台资源。为使用户更好地掌握自己的VR云渲游平台运行状态，公有云平台提供了 云监控 。您可以使用该服务监控您的VR云渲游平台，执行自动实时监控、告警和通知操作，帮助您更好地了解VR云渲游平台的各项性能指标。 通过后续章节，您可以了解以下内容： 支持的监控指标 创建告警规则 查看监控指标 父主题： 监控

背景信息 VR云渲游平台中涉及的应用状态如表1所示。 表1 云服务器上部署的应用状态一览 云服务器上部署的应用状态 说明 运行中 设备与该云服务器正在连接中，且在使用该应用的过程中。 未运行 该应用已在当前云服务器上成功安装。 等待安装 该应用正在等待云服务器对其进行安装。 安装中 该应用正在被当前云服务器安装的过程中。 安装失败 该应用在当前云服务器上安装失败。您可以移动鼠标至“安装失败”，查看具体原因。

背景信息 VR云渲游平台中涉及的云服务器状态如表1所示。 表1 云服务器状态一览 云服务器状态 说明 正常 设备与该云服务器正在连接中。 闲置 处于该状态的云服务器可以被设备连接。 初始化 云服务器正在做运行环境安装等工作。 异常 云服务器处于失联/错误等情况。 关机 云服务器处于关机状态。 重启中 云服务器正在重启。 VR云渲游平台中涉及的会话状态如表2所示。 表2 会话状态一览 会话状态 说明 正常 设备与该会话正在连接中。 闲置 处于该状态的会话可以被设备连接。 初始化 会话正在做运行环境安装等工作。 异常 会话处于失联/错误等情况。 未运行 云服务器处于“关机”或“重启中”时，会话未运行。

监控指标 表1 监控指标说明 指标 指标名称 含义 取值范围 测量对象 监控周期 error_in_degree 黑边度 横向Fov上的黑边角度。 单位：° ≥ 0 ° 云服务器 1分钟 physical_latency 物理时延MTP 输入动作（头部转动或控制器操作等）与屏幕更新显示（从刷新的屏幕发出的光线）内容之间的时延。 单位：ms ≥ 0 ms 云服务器 1分钟 perception_latency 用户感知时延 物理MTP时延 - 动作预测时间。 单位：ms ≥ 0 ms 云服务器 1分钟 track_info_trans_latency 上行动作传输时延 客户端传输动作信息到服务端接收到所消耗的时延。 单位：ms ≥ 0 ms 云服务器 1分钟 frame_trans_latency 下行帧传输时延 一帧画面从服务端传输到客户端所消耗的时延。 单位：ms ≥ 0 ms 云服务器 1分钟 round_trip_time 响应时间 从客户端发送请求开始，到客户端收到来自服务端的确认，总共经历的时延。 单位：ms ≥ 0 ms 云服务器 1分钟 packet_loss_rate 丢包率 画面内容从服务端传输到客户端过程中的丢包率。 单位：% ≥ 0 % 云服务器 1分钟 sent_rate 服务端发送速率 服务端发送速率。 单位：Mbit/s ≥ 0 Mbit/s 云服务器 1分钟 client_recv_rate 客户端接收速率 客户端接收速率。 单位：Mbit/s ≥ 0 Mbit/s 云服务器 1分钟

约束与限制 在批量创建云服务器时，使用的模板镜像内的应用，应在"应用管理"页面保持为正常的状态。 单路VR型模板镜像只能创建单路VR型云服务器，多路VR型模板镜像只能创建多路VR型云服务器。 模板镜像与规格系列绑定，例如使用T4系列云服务器创建的模板镜像，只能创建T4系列云服务器。 批量创建云服务器时，插件不可以更换，例如使用已安装XRLinker插件的云服务器创建的模板镜像，批量创建的云服务器插件也为XRLinker。 在批量创建云服务器时，多路VR模板镜像和3D模板镜像可以自定义会话数。

应用异常信息 即图1中的②，记录了系统处理中发生异常，导致应用处理失败的任务。 您可以通过单击，查看应用异常的详细信息，如创建云服务器失败导致应用异常。 图2 应用异常 导致应用异常的事件类型及处理办法，如表2所示。 表2 应用异常处理办法 事件类型 说明 操作建议 创建失败 应用创建失败 单击修复按钮，恢复数据库中该条应用记录。 修改失败 应用名称、描述、图标、安装包等修改失败 单击修复按钮，恢复数据库中该条应用记录。 删除失败 相关云服务器删除失败或下发卸载应用请求失败 单击修复按钮，恢复数据库中该条应用记录。 添加失败 下发安装任务失败 单击修复按钮，恢复数据库中该条应用记录。 修复失败 应用修复失败 单击修复按钮，恢复数据库中该条应用记录。 添加云服务器失败 云服务器创建或纳管失败 单击详情查看详细失败信息，确认失败原因后，删除失败信息即可。 操作云服务器失败 云服务器开机、关机、重启、删除、安装XR Linker插件失败，或者修改会话数失败 单击详情查看详细失败信息，确认失败原因后，删除失败信息即可。 设备连接失败 头显客户端版本过低 单击详情查看详细失败信息，确认失败原因后，删除失败信息即可。

应用状态 即图1中的①，表示应用当前的情况，是否正常运行。应用状态的类型和释义，如表1所示。 表1 应用状态说明 状态 说明 创建中 包含应用创建、按需云服务器创建或者云服务器纳管过程 修改中 包含应用名称、应用描述、应用图标、应用安装包等的修改过程 删除中 包含应用删除，下发云服务器卸载应用请求，相关云服务器删除的过程 添加中 已有应用添加云服务器 修复中 应用的修复过程 正常 应用无失败任务，相关云服务器无异常，均运行正常 异常 应用存在失败任务，或相关云服务器存在异常

支持的监控指标 VR云渲游平台采集并展示关键的应用体验指标，各项指标的具体含义如表2所示。您可以根据各项监控指标，实时掌握该设备连接的环境质量，了解用户的应用体验。 表2 VR云渲游平台监控指标支持列表 中文名称 英文名称 指标含义 物理MTP时延(ms) PhysicalLatency(ms) 输入动作（头部转动或控制器操作等）与屏幕更新显示（从刷新的屏幕发出的光线）内容之间的时延，单位为ms 用户感知时延（ms） PerceptionLatency(ms) 物理MTP时延 - 动作预测时间 动作预测时间（ms） PredictionInterval(ms) 一帧动作预测的显示时间 - 获取动作当前的时间 上行动作传输时延(ms) TrackInfoTransLatency(ms) 客户端传输动作信息到服务器接收到所消耗的时延 游戏渲染时延(ms) GameRenderLatency (ms) 游戏应用完成一帧画面渲染所消耗的时延 编码前准备资源时延（ms） PrepareResourceLatency (ms) 编码前为一帧画面完成准备资源所消耗的时延 编码时延(ms) EncodeLatency (ms) 完成一帧画面编码所消耗的时延所消耗 FEC编码时延(ms) FecEncodeLatency (ms) 对一帧画面完成FEC编码所消耗的时延 下行帧传输时延(ms) FrameTransLatency(ms) 一帧画面从服务器传输到客户端所消耗的时延 解码时延(ms) DecodeLatency (ms) 客户端解码所消耗的时延 客户端渲染时延(ms) ClientRenderLatency(ms) 客户端完成一帧画面的渲染时延 黑边度数（度数） ErrorInDegree(Degree) 横向视场角(FOV)上的黑边角度(Yaw) 每秒丢包数 PacketsLostInSecond (Packets/s) 画面内容从服务器传输到客户端过程中的丢包率 网络RTT(ms) NetworkRTT (ms) 客户端到服务器之间的网络端到端时延 服务器接收速率(kbps) RecvRate (Mbps) 服务器接收速率(kbps) 服务器发送速率(kbps) SentRate (Mbps) 服务器发送速率(kbps) 客户端接收速率(kbps) ClientRecvRate (Mbps) 客户端接收速率(kbps) 客户端发送速率(kbps) ClientSentRate (Mbps) 客户端发送速率(kbps) 编码算法 TargetCodec 编码算法，表示是264还是265 分辨率 TargetResolution(px * px) 目标分辨率 编码器参数 TargetEncoderConfig 编码器参数 图像帧率 RenderFps 头盔图像帧率

约束与限制 3D应用云服务器支持创建的会话路数为1、2路，VR应用云服务器支持创建的会话路数为1、2、4、8路。 单路（1路）会话的VR应用云服务器可以安装多个应用，多路（2、4、8路）会话的VR应用云服务器只能安装一个应用。 由于应用的体量不同，请您根据自身应用的使用情况，合理配置会话路数，以达到对云服务器计算能力的合理使用。 仅在当前云服务器处于“闲置”状态下，才能进行修改操作。 修改过程中会涉及重装系统操作，请谨慎操作。 3D应用云服务器会话连接端口号包括所有UDP端口，TCP端口从TCP/10100、TCP/10200、TCP/10300依次递增，如：2路，需放通所有UDP端口、TCP/10100-10101、TCP/10200-10201、TCP/10300-10301。 单路（1路）会话的VR应用云服务器连接端口号为UDP/9944。多路（2、4、8路）会话的VR应用云服务器连接端口号从UDP/9945依次递增，如：4路，需放通UDP/9945-9948。

操作步骤 准备VR应用或者3D应用。使用压缩工具，将应用内容打包为“.zip”格式的文件。 该zip包中包含“.exe”格式的可执行文件。 zip包内避免无效层级。对于“A/A/A/A/A/应用.exe”这种格式，建议修改为“A/应用.exe”。 创建OBS桶。 您可以通过OBS控制台创建桶。具体操作请参见创建桶。 创建桶时，OBS桶的“桶策略”默认为“私有”，仅桶拥有者具有完全控制权限，其他用户在未经授权的情况下均无访问权限，建议您保持该设置，确保应用存储安全性。参见如何为CVR新建委托？。 请勿勾选默认加密，CVR服务暂不支持加密OBS桶的应用安装。 图1 创建桶 由于跨Region访问OBS会带来额外公网流量费用且下载时间较长，因此OBS桶需创建在 GPU云服务器 所在Region，否则GPU云服务器将无法安装该OBS桶内的应用安装包。 上传应用内容至OBS桶。 将打包好的.zip文件上传至OBS桶，具体操作请参见上传对象。 如果您的.zip文件小于5GB，请选择通过控制台上传对象。 如果您对.zip文件大于5GB，请选择通过OBS Browser+上传对象。

操作步骤 注册华为云账号。 打开华为云网站：https://www.huaweicloud.com/ 单击右上角“控制台”，登录控制台。 单击“免费注册”，根据提示信息完成注册。 注册成功后，系统会自动跳转至您的个人信息界面。 账号实名认证。 个人或企业帐号实名认证请参考：实名认证。 申请公测。 打开申请公测页面，填写申请信息。待管理员审核通过后，即可使用VR云渲游平台。 获取授权。 为保证VR云渲游平台的正常使用，首次登录时，需要您同意授权VR云渲游平台对相关服务的操作，如图1所示。 图1 服务授权 单击“同意授权”。 同意授权后，系统创建默认委托“CVRAgency”，建立委托关系。VR云渲游平台的管理员可以通过切换委托的方式，帮您管理云资源，实现安全高效的代维工作。 更多关于委托的功能，请参见委托其他账号管理资源。 同意授权后，如需修改授权的区域，请打开VR云渲游平台控制台，在“总览”页的“权益授权”模块，单击“修改 IAM 服务授权”进行修改。 图2 修改IAM服务授权

访问VR云渲游平台流程 本节指导您快速对接VR云渲游平台，体验云VR、3D业务。快速对接使用默认参数配置，为您提高配置效率，方便快捷。如需自定义配置，请根据《用户指南》的内容查看详细的参数配置。 访问VR云渲游平台的操作流程如图1所示。 图1 访问VR云渲游平台流程 表1 流程介绍 任务 操作平台 说明 步骤一：开通服务 华为云控制台 注册华为云账号并完成实名认证，用于登录、访问华为云控制台。首次登录时，需要您同意授权VR云渲游平台对相关服务的操作。 服务目前还处于友好测试阶段，您需要申请公测来体验VR云渲游平台。 步骤二：应用内容上云 华为云控制台 将VR应用或者3D应用内容打包并上传至OBS桶，后续作为应用安装包安装至GPU加速型云服务器中运行。 步骤三：集群与应用创建 华为云控制台 创建集群与应用，实现平台化的统一管理、细粒度监控与智能调度功能。包括任务：创建集群、创建应用。 步骤四：设备连接 云下操作 分为连接VR应用与连接3D应用两种场景。 连接VR应用包含任务：Android SDK集成开发、连接头显设备。 网速满足要求后，佩戴头显设备，并选择SDK打包的APK。此时，头显将连接至VR云渲游平台并接入分配的GPU云服务器，头显中呈现GPU云服务器内实时渲染的VR应用画面。 连接3D应用包含任务：Windows SDK集成开发或Web SDK集成开发、使用集成开发后的.exe格式的可执行文件，连接3D应用。

操作场景 登录VR云渲游平台，通过创建集群部署平台管理能力，实现对GPU资源、应用以及设备的管理及调度、通过创建应用操作将步骤二：应用内容上云中上传至OBS桶的应用内容部署至GPU云服务器。 为提高配置效率，本节提供快速对接VR云渲游平台方案，该方案中推荐的参数配置基于系统默认值、或大多数客户的选择提供，助力您快速体验应用上云业务，方便快捷。如需自定义配置，请根据《用户指南》的内容查看详细参数说明。

如何获取桶的静态网站访问地址？ 桶配置成静态网站托管模式后，可通过以下方式拼接桶的静态网站访问地址： https://桶名.静态网站托管 域名 各区域对应的静态网站托管域名可以从这里查看。 例如区域为“华北-北京四”的桶名为“testbucket”的桶配置成静态网站托管模式后，该桶的静态网站访问地址为https://testbucket.obs-website.cn-north-4.myhuaweicloud.com。 父主题： FAQ

日志内容格式 SDK日志格式为：日志时间|日志级别|调用接口|日志内容。示例如下： 2018/2/11 下午9:22:45|info|ListObjects|enter ListObjects...2018/2/11 下午9:22:45|info|ListObjects|prepare request parameters ok,then Send request to service start2018/2/11 下午9:22:45|info|ListObjects|http cost 19 ms2018/2/11 下午9:22:45|info|ListObjects|get response start, statusCode:200

日志配置 OBS BrowserJS SDK提供了日志功能，您可以通过ObsClient.initLog开启日志功能并进行配置。示例代码如下： // 创建ObsClient实例var obsClient = new ObsClient({ // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。 // 前端本身没有process对象，可以使用webpack类打包工具定义环境变量，就可以在代码中运行了。 // 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html access_key_id: process.env.AccessKeyID, secret_access_key: process.env.SecretAccessKey, // 这里以华北-北京四为例，其他地区请按实际情况填写 server: 'https://obs.cn-north-4.myhuaweicloud.com'});obsClient.initLog({ level:'warn', // 配置日志级别}); SDK打印的日志均显示在浏览器提供的 开发者工具 的Console中。 日志功能默认是关闭的，需要主动开启。

日志级别 当系统出现问题需要定位且当前的日志无法满足要求时，可以通过修改日志的级别来获取更多的信息。其中debug日志信息最丰富，error日志信息最少。 具体说明如下： debug：调试级别，如果设置为这个级别，将打印SDK记录的所有日志。 info：信息级别，如果设置为这个级别，除了打印warn级别的信息外，还将打印HTTP/HTTPS请求的耗时时间等信息。 warn：告警级别，如果设置为这个级别，除了打印error级别的信息外，还将打印一些关键事件的信息。 error：错误级别，如果设置为这个级别，仅打印发生异常时的错误信息。

如何解决断点续传接口报400 InvalidPart的错误？ 可能存在的原因有： 合并段时请求段列表中包含了不存在的段； 合并段时请求段列表中包含的段的Etag错误。 可按照以下步骤排查原因： 打开浏览器的开发者工具。 检查合并段接口的请求体Body是否符合API接口规范。 如果发现请求体Body中的ETag值都是undefined，则说明ETag字段未配置成CORS的扩展头域，请参考配置桶的CORS章节进行配置，符合原因2的场景。 如果合并段请求体Body符合API接口规范，请继续排查合并段请求体Body体内容是否合理，以及Etag值的一致性。 排查请求段列表中是否包含了不存在的段信息，例如：对象A分为a、b、c三个段上传，但是段列表中，多出了一个不存在的段d。此时您需要删除多余段的相关信息，此场景符合原因1。 排查过程中段ETag值是否和服务端返回的ETag值一致，如果不一致，请修改请求体中携带的Etag值为正确值，此场景符合原因2。 父主题： FAQ

生命周期管理简介 开发过程中，您有任何问题可以在github上提交issue，或者在华为云 对象存储服务 论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。 OBS允许您对桶设置生命周期规则，实现自动转换对象的存储类型、自动淘汰过期的对象，以有效利用存储特性，优化存储空间。针对不同前缀的对象，您可以同时设置多条规则。一条规则包含： 规则ID，用于标识一条规则，不能重复。 受影响的对象前缀，此规则只作用于符合前缀的对象。 最新版本对象的转换策略，指定方式为： 指定满足前缀的对象创建后第几天时转换为指定的存储类型。 直接指定满足前缀的对象转换为指定的存储类型的日期。 最新版本对象过期时间，指定方式为： 指定满足前缀的对象创建后第几天时过期。 直接指定满足前缀的对象过期日期。 历史版本对象转换策略，指定方式为： 指定满足前缀的对象成为历史版本后第几天时转换为指定的存储类型。 历史版本对象过期时间，指定方式为： 指定满足前缀的对象成为历史版本后第几天时过期。 是否生效标识。 更多关于生命周期的内容请参考生命周期管理。 对象过期后会被OBS服务端自动删除。 对象转换策略中的时间必须早于对象过期时间；历史版本对象转换策略中的时间也必须早于历史版本对象的过期时间。 桶的多版本状态必须处于Enabled或者Suspended，历史版本对象转换策略和历史版本对象过期时间配置才能生效。 父主题： 生命周期管理

公网环境下如何提高上传大文件速度？ 在公网环境下对于超过100MB的大文件建议通过分段上传方式上传。分段上传是将单个对象拆分为一系列段分别上传。每个段都是对象数据的连续部分。您可以按照任意顺序上传段。如果其中某个段传输失败，可以重新传输该段且不会影响其他段。通过多线程并发上传同一对象的多个段，可大大提高传输效率。 具体代码样例可参见分段上传。您也可以使用SDK提供的断点续传上传接口进行大文件上传。 父主题： FAQ

OBS服务端错误码 在向OBS服务端发出请求后，如果遇到错误，会在响应中包含响应的错误码描述错误信息。详细的错误码及其对应的描述和HTTP状态码见下表： HTTP状态码 错误码 错误信息 处理措施 301 Moved Permanently PermanentRedirect 尝试访问的桶必须使用指定的地址，请将以后的请求发送到这个地址。 按照返回的重定向地址发送请求。 301 Moved Permanently WebsiteRedirect Website请求缺少bucketName。 携带桶名后重试。 307 Moved Temporarily TemporaryRedirect 临时重定向，当DNS更新时，请求将被重定向到桶。 会自动重定向，也可以将请求发送到重定向地址。 400 Bad Request BadDigest 客户端指定的对象内容的MD5值与系统接收到的内容MD5值不一致。 检查头域中携带的MD5与消息体计算出来的MD5是否一致。 400 Bad Request BadDomainName 域名不合法。 使用合法的域名。 400 Bad Request BadRequest 请求参数不合法。 根据返回的错误消息体提示进行修改。 400 Bad Request CustomDomainAreadyExist 配置了已存在的域。 已经配置过了，不需要再配置。 400 Bad Request CustomDomainNotExist 删除不存在的域。 未配置或已经删除，无需删除。 400 Bad Request EntityTooLarge 用户POST上传的对象大小超过了条件允许的最大大小。 修改POST上传的policy中的条件或者减少对象大小。 400 Bad Request EntityTooSmall 用户POST上传的对象大小小于条件允许的最小大小。 修改POST上传的policy中的条件或者增加对象大小。 400 Bad Request IllegalLocationConstraintException 用户未带Location在非默认Region创桶。 请求发往默认Region创桶或带非默认Region的Location创桶。 400 Bad Request IncompleteBody 由于网络原因或其他问题导致请求体未接受完整。 重新上传对象。 400 Bad Request IncorrectNumberOfFilesInPost Request 每个POST请求都需要带一个上传的文件。 带上一个上传文件。 400 Bad Request InvalidArgument 无效的参数。 根据返回的错误消息体提示进行修改。 400 Bad Request InvalidBucket 请求访问的桶已不存在。 更换桶名。 400 Bad Request InvalidBucketName 请求中指定的桶名无效，超长或带不允许的特殊字符。 更换桶名。 400 Bad Request InvalidEncryptionAlgorithmError 错误的加密算法。下载SSE-C加密的对象，携带的加密头域错误，导致不能解密。 携带正确的加密头域下载对象。 400 Bad Request InvalidLocationConstraint 创建桶时，指定的Location不合法或不存在。 指定正确的Location创桶。 400 Bad Request InvalidPart 一个或多个指定的段无法找到。这些段可能没有上传，或者指定的entity tag与段的entity tag不一致。 按照正确的段和entity tag合并段。 400 Bad Request InvalidPartOrder 段列表的顺序不是升序，段列表必须按段号升序排列。 按段号升序排列后重新合并。 400 Bad Request InvalidPolicyDocument 表单中的内容与策略文档中指定的条件不一致。 根据返回的错误消息体提示修改构造表单的policy重试。 400 Bad Request InvalidRedirectLocation 无效的重定向地址。 指定正确的地址。 400 Bad Request InvalidRequest 无效请求。 根据返回的错误消息体提示进行修改。 400 Bad Request InvalidRequestBody 请求体无效，需要消息体的请求没有上传消息体。 按照正确的格式上传消息体。 400 Bad Request InvalidTargetBucketForLogging delivery group对目标桶无ACL权限。 对目标桶配置ACL权限后重试。 400 Bad Request KeyTooLongError 提供的Key过长。 使用较短的Key。 400 Bad Request KMS.DisabledException SSE-KMS加密方式下，主密钥被禁用。 更换密钥后重试，或联系技术支持。 400 Bad Request KMS.NotFoundException SSE-KMS加密方式下，主密钥不存在。 携带正确的主密钥重试。 400 Bad Request MalformedACLError 提供的XML格式错误，或者不符合我们要求的格式。 使用正确的XML格式重试。 400 Bad Request MalformedError 请求中携带的XML格式不正确。 使用正确的XML格式重试。 400 Bad Request MalformedLoggingStatus Logging的XML格式不正确。 使用正确的XML格式重试。 400 Bad Request MalformedPolicy Bucket policy检查不通过。 根据返回的错误消息体提示结合桶policy的要求进行修改。 400 Bad Request MalformedQuotaError Quota的XML格式不正确。 使用正确的XML格式重试。 400 Bad Request MalformedXML 当用户发送了一个配置项的错误格式的XML会出现这样的错误。 使用正确的XML格式重试。 400 Bad Request MaxMessageLengthExceeded 拷贝对象，带请求消息体。 拷贝对象不带消息体重试。 400 Bad Request MetadataTooLarge 元数据消息头超过了允许的最大元数据大小。 减少元数据消息头。 400 Bad Request MissingRegion 请求中缺少Region信息，且系统无默认Region。 请求中携带Region信息。 400 Bad Request MissingRequestBodyError 当用户发送一个空的XML文档作为请求时会发生。 提供正确的XML文档。 400 Bad Request MissingRequiredHeader 请求中缺少必要的头域。 提供必要的头域。 400 Bad Request MissingSecurityHeader 请求缺少一个必须的头。 提供必要的头域。 400 Bad Request TooManyBuckets 用户拥有的桶的数量达到了系统的上限，并且请求试图创建一个新桶。 删除部分桶后重试。 400 Bad Request TooManyCustomDomains 配置了过多的用户域 删除部分用户域后重试。 400 Bad Request TooManyWrongSignature 因高频错误请求被拒绝服务。 更换正确的Access Key后重试。 400 Bad Request UnexpectedContent 该请求需要消息体而客户端没带，或该请求不需要消息体而客户端带了。 根据说明重试。 400 Bad Request UserKeyMustBeSpecified 该操作只有特殊用户可使用。 请联系技术支持。 403 Forbidden AccessDenied 拒绝访问，请求没有携带日期头域或者头域格式错误。 请求携带正确的日期头域。 403 Forbidden AccessForbidden 权限不足，桶未配置CORS或者CORS规则不匹配。 修改桶的CORS配置，或者根据桶的CORS配置发送匹配的OPTIONS请求。 403 Forbidden AllAccessDisabled 用户无权限执行某操作。桶名为禁用关键字。 更换桶名。 403 Forbidden DeregisterUserId 用户已经注销。 充值或重新开户。 403 Forbidden InArrearOrInsufficientBalance 用户欠费或余额不足而没有权限进行某种操作。 充值。 403 Forbidden InsufficientStorageSpace 存储空间不足。 超过配额限制，增加配额或删除部分对象。 403 Forbidden InvalidAccessKeyId 系统记录中不存在客户提供的Access Key Id。 携带正确的Access Key Id。 403 Forbidden NotSignedUp 你的账户还没有在系统中注册，必须先在系统中注册了才能使用该账户。 先注册OBS服务。 403 Forbidden RequestTimeTooSkewed 请求的时间与服务器的时间相差太大。 检查客户端时间是否与当前时间相差太大。 403 Forbidden SignatureDoesNotMatch 请求中带的签名与系统计算得到的签名不一致。 检查你的Secret Access Key和签名计算方法。 403 Forbidden Unauthorized 用户未实名认证。 请实名认证后重试。 404 Not Found NoSuchBucket 指定的桶不存在。 先创桶再操作。 404 Not Found NoSuchBucketPolicy 桶policy不存在。 先配置桶policy。 404 Not Found NoSuchCORSConfiguration CORS配置不存在。 先配置CORS。 404 Not Found NoSuchCustomDomain 请求的用户域不存在。 先设置用户域。 404 Not Found NoSuchKey 指定的Key不存在。 先上传对象。 404 Not Found NoSuchLifecycleConfiguration 请求的LifeCycle不存在。 先配置LifeCycle。 404 Not Found NoSuchUpload 指定的多段上传不存在。Upload ID不存在，或者多段上传已经终止或完成。 使用存在的段或重新初始化段。 404 Not Found NoSuchVersion 请求中指定的version ID与现存的所有版本都不匹配。 使用正确的version ID。 404 Not Found NoSuchWebsiteConfiguration 请求的Website不存在。 先配置Website。 405 Method Not Allowed MethodNotAllowed 指定的方法不允许操作在请求的资源上。 对应返回的Message为：Specified method is not supported. 方法不允许。 408 Request Timeout RequestTimeout 用户与Server之间的socket连接在超时时间内没有进行读写操作。 检查网络后重试，或联系技术支持。 409 Conflict BucketAlreadyExists 请求的桶名已经存在。桶的命名空间是系统中所有用户共用的，选择一个不同的桶名再重试一次。 更换桶名。 409 Conflict BucketAlreadyOwnedByYou 发起该请求的用户已经创建过了这个名字的桶，并拥有这个桶。 不需要再创桶了。 409 Conflict BucketNotEmpty 用户尝试删除的桶不为空。 先删除桶中对象，然后再删桶。 409 Conflict InvalidBucketState 无效的桶状态，配置跨Region复制后不允许关闭桶多版本。 不关闭桶的多版本或取消跨Region复制。 409 Conflict OperationAborted 另外一个冲突的操作当前正作用在这个资源上，请重试。 等待一段时间后重试。 409 Conflict ServiceNotSupported 请求的方法服务端不支持。 服务端不支持，请联系技术支持。 411 Length Required MissingContentLength 必须要提供HTTP消息头中的Content-Length字段。 提供Content-Length消息头。 412 Precondition Failed PreconditionFailed 用户指定的先决条件中至少有一项没有包含。 根据返回消息体中的Condition提示进行修改。 416 Client Requested Range Not Satisfiable InvalidRange 请求的range不可获得。 携带正确的range重试。 500 Internal Server Error InternalError 系统遇到内部错误，请重试。 请联系技术支持。 501 Not Implemented ServiceNotImplemented 请求的方法服务端没有实现。 当前不支持，请联系技术支持。 503 Service Unavailable ServiceUnavailable 服务器过载或者内部错误异常。 等待一段时间后重试，或联系技术支持。 503 Service Unavailable SlowDown 请降低请求频率。 请降低请求频率。 父主题： 异常处理

如何获取对象URL？ 按https://桶名.域名/文件夹目录层级/对象名的方式进行拼接。 如果该对象存在于桶的根目录下，则链接地址将不需要有文件夹目录层级。 各区域对应的域名可以从这里的终端节点查看。 例如需访问区域为“华北-北京四”的桶名为“testbucket”中“test”文件夹下对象名为“test.txt”的对象，则该对象的URL为https://testbucket.obs.cn-north-4.myhuaweicloud.com/test/test.txt。 父主题： FAQ

加密说明 开发过程中，您有任何问题可以在github上提交issue，或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。 OBS BrowserJS SDK支持服务端加密的接口见下表： OBS BrowserJS SDK接口方法 描述 支持加密类型 ObsClient.putObject 上传对象时设置加密算法、密钥，对对象启用服务端加密。 SSE-KMS SSE-C ObsClient.getObject 下载对象时设置解密算法、密钥，用于解密对象。 SSE-C ObsClient.copyObject 复制对象时设置源对象的解密算法、密钥，用于解密源对象。 复制对象时设置目标对象的加密算法、密钥，对目标对象启用加密算法。 SSE-KMS SSE-C ObsClient.getObjectMetadata 获取对象元数据时设置解密算法、密钥，用于解密对象。 SSE-C ObsClient.initiateMultipartUpload 初始化分段上传任务时设置加密算法、密钥，对分段上传任务最终生成的对象启用服务端加密。 SSE-KMS SSE-C ObsClient.uploadPart 上传段时设置加密算法、密钥，对分段数据启用服务端加密。 SSE-C ObsClient.copyPart 复制段时设置源对象的解密算法、密钥，用于解密源对象。 复制段时设置目标段的加密算法、密钥，对目标段启用加密算法。 SSE-C OBS BrowserJS SDK两种加密方式支持的请求参数： 加密类型 OBS BrowserJS SDK对应请求参数 说明 SSE-KMS SseKms 表示服务端加密是SSE-KMS方式，目前仅支持：kms。 SseKmsKey 表示SSE-KMS方式下的主密钥，可为空。 SSE-C SseC 表示服务端加密是SSE-C方式，目前仅支持：AES256。 SseCKey 表示SSE-C方式下的密钥，由AES256算法得到。上传对象时作为加密密钥；下载对象时作为解密密钥。注意：不需要base64编码处理。 CopySourceSseC 适用于ObsClient.copyObject和ObsClient.copyPart，表示以SSE-C方式解密源对象，目前仅支持：AES256。 CopySourceSseCKey 适用于ObsClient.copyObject和ObsClient.copyPart，表示以SSE-C方式解密源对象时使用的密钥，由AES256算法得到。 父主题： 服务端加密

获取服务地址 开发过程中，您有任何问题可以在github上提交issue，或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。 您可以从这里查看OBS当前开通的服务地址和区域信息。 SDK支持带协议名和不带协议名两种方式传入服务地址，例如获取到的服务地址为“your-endpoint”，则初始化OBS客户端时传入的服务地址可以为“http://your-endpoint”、“https://your-endpoint”和“your-endpoint”三种形式。 父主题： 快速入门

初始化OBS客户端 开发过程中，您有任何问题可以在github上提交issue，或者在华为云对象存储服务论坛中发帖求助。接口参考文档详细介绍了每个接口的参数和使用方法。 向OBS发送任一HTTP/HTTPS请求之前，必须先创建一个ObsClient实例： // 创建ObsClient实例var obsClient = new ObsClient({ // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量AccessKeyID和SecretAccessKey。 // 前端本身没有process对象，可以使用webpack类打包工具定义环境变量，就可以在代码中运行了。 // 您可以登录访问管理控制台获取访问密钥AK/SK，获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html access_key_id: process.env.AccessKeyID, secret_access_key: process.env.SecretAccessKey, // 这里以华北-北京四为例，其他地区请按实际情况填写 server: 'https://obs.cn-north-4.myhuaweicloud.com'});// 使用访问OBS 更多关于OBS客户端初始化的内容请参考“初始化”章节。 日志配置详见配置SDK日志。 父主题： 快速入门

无法获取上传后的ETag值 使用ObsClient.putObject和ObsClient.uploadPart上传文件成功后返回结果中无ETag值，此类错误一般有两种原因： 桶的CORS配置中ExposeHeader不包含ETag头域，解决方法：按照文档配置桶的CORS为桶配置完整的CORS配置； 桶的CORS配置中ExposeHeader包含ETag头域，但浏览器的返回结果屏蔽了ETag头域（一般发生在低版本的浏览器），解决方法：升级到高版本且完全支持HTML5的浏览器。

跨域请求被拦截 Access to XMLHttpRequest at 'xxx' from origin 'xxx' has been blocked by CORS policy: Response to preflight request doesn't pass access control check: No 'Access-Control-Allow-Origin' header is present on the requested resource.