<p class="shortdesc"></p> <section class="section" id="UploadandDownload__section_czp_jcv_qlb"><h2 class="doc-tairway">使用开发工具SDK时，如何在配置文件中配置Endpoint？</h2> <p class="p">用户从互联网发起访问请求时，需要在SDK的配置文件里，配置外网Endpoint，从安全性角度出发，建议用户的所有请求访问都采用https。</p> <p class="p">如果是从购买的ECS云主机上访问OBS，则需要在配置文件里配置内网的Endpoint。</p> </section> <section class="section" id="UploadandDownload__section_lqb_kcv_qlb"><h2 class="doc-tairway">SDK是否支持文件夹形式的KEY上传？</h2> <p class="p">支持，在Objectkey的命名中支持/。</p> </section> <section class="section" id="UploadandDownload__section_yyb_kcv_qlb"><h2 class="doc-tairway">大文件上传，分片上传在何时使用？</h2> <p class="p">流式上传、文件上传的文件最大不能超过 5 GB。其实当文件大于 100M 时，就建议使用分片上传了，分片上传能够更好的保证上传的成功。另外断点续传机制能让你仅重试失败的分片。分片上传支持上传不超过48G的大文件。</p> </section> <section class="section" id="UploadandDownload__section_ygc_kcv_qlb"><h2 class="doc-tairway">同一个Bucket下能否上传同名文件？</h2> <p class="p">OBS允许用户上传同名的文件，但是会对源文件直接进行覆盖操作。如果对文件唯一性有要求，您可以通过您的业务逻辑来保证唯一的文件名。也可以上传前检查下Object是否存在再进行上传操作。</p> </section> <section class="section" id="UploadandDownload__section_z4c_kcv_qlb"><h2 class="doc-tairway">什么时候使用公共读、公共读写bucket？</h2> <p class="p">网站使用的JS、CSS等资源文件、公共的文档等可以放到公共读Bucket；用户上传的资料如头像、简历等可以用户自己上传公共读写的Bucket。请谨慎使用公共读写权限。</p> </section> <section class="section" id="UploadandDownload__section_xwc_kcv_qlb"><h2 class="doc-tairway">上传、下载都有那些方式？</h2> <p class="p">目前提供JAVA、JS、Android、iOS的SDK。也可以通过调用上传下载的RESTful接口或是在页面上进行上传下载操作。</p> </section> <section class="section" id="UploadandDownload__section_r2d_kcv_qlb"><h2 class="doc-tairway">下载Token过期如何处理？</h2> <p class="p">您发送请求的时间与OBS收到请求的时间，间隔超出了15分钟，OBS从安全考虑认为该请求是无效的，返回AccessDenied错误。请OBS的系统时间采用GMT时间，您的设备的系统时间，需要调整到GMT时间，或与其相对应的时区时间。GMT（Greenwich Mean Time）是零时区的区时，即世界标准时间。检查发送请求设备的系统时间，并根据时区调整到正确时间。</p> </section> <section class="section" id="UploadandDownload__section_xld_kcv_qlb"><h2 class="doc-tairway">如何校验上传文件的完整性？</h2> <p class="p">OBS上的object会有etag标签，etag主要是用来判断服务端数据是否存在变化。但是，这个标签并不一定等同于文件的MD5值，所以不建议作为校验数据一致性的依据。如果需要校验上传到OBS的文件和本地文件是否一致，OBS在上传文件成功后，会返回文件的MD5值，您可以调用MD5计算接口获得MD5值，然后判断和OBS服务器接收到的文件MD5值是否一致。</p> </section> <section class="section" id="UploadandDownload__section_a5d_kcv_qlb"><h2 class="doc-tairway">API、SDK和上传工具上传的文件，为什么在控制台无法看到？</h2> <p class="p">目前，控制台默认只展示通过控制台页面上传的文件，通过API、SDK和上传工具上传的文件，在控制台不展示，可以通过搜索框中，选择ObjectKey进行前缀搜索。</p> </section> <section class="section" id="UploadandDownload__section_sb2_kcv_qlb"><h2 class="doc-tairway">OBS资源如何分享给第三方进行上传等操作？</h2> <ul class="ul" id="UploadandDownload__ul_lgc_5cv_qlb"> <li class="li">提供AK SK（主账号or子账号(推荐)）;</li> <li class="li">用户系统保存AK/SK，提供给第三方获取签名接口</li> </ul> </section> <section class="section" id="UploadandDownload__section_oj2_kcv_qlb"><h2 class="doc-tairway">如何向OBS上传/下载文件？</h2> <p class="p">目前有三种方式可以访问OBS：</p> <ul class="ul" id="UploadandDownload__ul_qhr_5cv_qlb"> <li class="li">OBS控制台：在此需开通具有OBS相关权限的主/子账号。</li> <li class="li">SDK：OBS提供了Java、JS、IOS等多种类型的SDK开发工具。</li> <li class="li">API：OBS按照AWS S3行业标准也支持Restful API方式访问。通过API方式会涉及到实现数据签名流程，相关签名规则请参考<a class="xref" href="/ssr/help/storage/obs/api.Introduction" target="_blank">签名规则</a>。</li> </ul> </section> <section class="section" id="UploadandDownload__section_kr2_kcv_qlb"><h2 class="doc-tairway">大文件如何上传？</h2> <p class="p">OBS简单上传（页面和API putObject）支持5G以内的文件上传。需要使用大文件上传的场景：</p> <ul class="ul" id="UploadandDownload__ul_b4b_wcv_qlb"> <li class="li">单个文件超过5G时的上传</li> <li class="li">文件小于5G的较大文件上传，处于网络环境不太稳定比较差，经常连接超时或者连接断开造成上传失败</li> </ul> <p class="p">上传大文件，需要下载obs-upload-tool工具。下载地址参考<a class="xref" href="/ssr/help/storage/obs/Commotools.Obsuploadtool" target="_blank">工具上传</a>。</p> <div class="note note note_note"><span class="note__title">说明：</span> OBS支持单个文件最大为48G。</div> </section> <section class="section" id="UploadandDownload__section_yz2_kcv_qlb"><h2 class="doc-tairway">什么是分片(断点)上传</h2> <p class="p">当使用SDK或API上传大文件时，可以使用分片断点续传方式。分片上传适用于以下场景：</p> <ul class="ul" id="UploadandDownload__ul_jsx_xcv_qlb"> <li class="li">单个文件大小超过5GB。</li> <li class="li">流式上传：当对文件大小还不确定的情况下，就开始上传。比如视频监控等行业的云录像应用。</li> <li class="li">恶劣的网络环境，需要断点续传大文件。当出现上传失败的时候，可以对失败的分片进行独立的重试，而不需要重新上传其他的分片。</li> <li class="li">加速上传。要上传到OBS的本地文件很大的时候，可以并行上传多个分片以加快上传速度。</li> </ul> <div class="note note note_note"><span class="note__title">说明：</span> 分片上传会在本地产生*.ucp文件，此文件作为记录分片上传的信息。须确保拥有在相应目录创建文件权限。</div> </section> <section class="section" id="UploadandDownload__section_ajf_kcv_qlb"><h2 class="doc-tairway">什么是工具上传？</h2> <p class="p">如果您要上传超过5G的大文件（文件大小不超过48G），需要下载obs-upload-tool工具。下载地址参考<a class="xref" href="/ssr/help/storage/obs/Commotools.Obsuploadtool" target="_blank">工具上传</a>。</p> </section> <section class="section" id="UploadandDownload__section_mtf_kcv_qlb"><h2 class="doc-tairway"> Object Key是否支持中文?</h2> <p class="p">允许Object key带空格以及中文。Object Key命名规范见<a class="xref" href="/ssr/help/storage/obs/api.Explaination" target="_blank">术语说明</a>。</p> </section> <section class="section" id="UploadandDownload__section_bfg_kcv_qlb"><h2 class="doc-tairway">OBS是否可上传同名文件？</h2> <p class="p">同一Bucket中上传同名(ObjectKey相同)文件，会覆盖旧文件，进行更新替换操作。</p> <p class="p">不同Bucket可上传同名文件，不影响其他Bucket中的同名文件。</p> </section> <section class="section" id="UploadandDownload__section_d4g_kcv_qlb"><h2 class="doc-tairway">如何通过HTTP Range请求分段获取OBS资源？</h2> <p class="p">OBS暂不支持分段获取资源。即Rang请求头无效。</p> </section> <section class="section" id="UploadandDownload__section_vwg_kcv_qlb"><h2 class="doc-tairway">OBS文件更新后，为什么部分地区下载的文件仍是旧版本？</h2> <p class="p">建议每次文件更新使用不同的文件名进行区分，以避免个别运营商缓存系统更新不及时的问题。如果绑定的域名同时使用了CDN服务并且没有开启自动刷新，那么在更新OBS文件后，用户还需要刷新CDN的缓存。建议在域名设置页面开启自动刷新功能。</p> </section> <section class="section" id="UploadandDownload__section_fph_kcv_qlb"><h2 class="doc-tairway">Wget方式下载403？</h2> <p class="p">确认签名正确，且URL能正确传递。一般情况下Linux下&等符号会换行导致签名丢失。</p> </section>