- 预审中
- 预审通过
- 3 未采纳
【用户体验】【API Explorer】【OBS】文档可以没有,但不建议糊弄,越看越迷糊;SDK可以没有,也不建议糊弄,下载文件各种不成功 未采纳 编辑 删除
- API Explorer
- 对象存储服务 OBS
- 云API开发
- 存储
场景描述:
在API Exporer中,对象存储服务(OBS)的文档和SDK都有问题,建议更新或删除
链接:https://console.huaweicloud.com/apiexplorer/#/sdkcenter/OBS?lang=Python
【文档问题】
JAVA和Python 文档全流程都在讲 huaweicloudsdkvpc 怎么使用,最后的下载文件部分还引用了 huaweicloudsdkdsc 库,整个看下来云里雾里,完全是副作用;GO 和 Node.js 好一点,没有文档就空着,至少不会误导人,浪费用户时间

【SDK问题】
踩坑过文档,识别和下载了真正的SDK (huaweicloudsdkobs),但调用对象下载的方法(get_object )没法下载目标文件,源码中 get_object 方法 、GetObjectRequest 和 GetObjectResponse 有一堆代码和注释,没一个写清楚“怎么将桶里的文件下载到本地”;好不容易看到 GetObjectResponse 继承于 SdkStreamResponse 类,需要手动 调用 consume_download_stream 方法获取文件stream(这个父类的文件和方法都没有任何注释),看源码30~32行的大概意思是需要传入一个函数方法,response对象会将 _stream作为值赋给函数方法,实现将流写文件;但_stream在初始化时赋值的 是response对象本身(在28行),并不是一个str或者二进制数组,试了几种方式都没能把写到文件里面去;

从看文档 到下载真正的SDK,再到一步步看源码,最后到了 神奇的 consume_download_stream;真的难绷!!!
建议方案:
不知道是 API Explorer侧的问题还是OBS侧的问题,建议两边沟通看下
1)建议更新或删除文档和SDK;
2)或者参考和统一到 support 平台的文档和SDK,那边虽然也有瑕疵,但至少能用
文档:https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0502.html
SDK:esdk-obs-python
yd_292263875
发布于 2024-12-04 21:09:59
2024-12-04
204 1
0/1000
仅支持JPG、JPEG、PNG、GIF,数量不超过4张且每张大小不超过2MB
删除建议
全部评论(1)
评论(1)
您好,关于您提交的建议产品和研发团队进行了评估,华为云整体UniSDK公共示例参考文档。单服务无法修改。OBS相关SDK示例请参考https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0502.html,综合考虑整体需求与产品规划,很抱歉未能采纳,还请您谅解。
对您造成困扰深表歉意!希望以上可以解决您的疑虑,感谢您的反馈,若在使用还有其它建议,可在云声平台继续反馈,我们收到后会尽快处理。感谢您对华为云的支持!