全部建议 > 建议详情
  • 预审中
  • 预审通过
  • 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 yd_292263875 发布于 2024-12-04 21:09:59 2024-12-04

204 1

0%
0人赞同
0%
0人不赞同

全部评论(1

评论(1

  • 【云声小管家】 子规 2025-11-27 16:17:28

    您好,关于您提交的建议产品和研发团队进行了评估,华为云整体UniSDK公共示例参考文档。单服务无法修改。OBS相关SDK示例请参考https://support.huaweicloud.com/sdk-python-devg-obs/obs_22_0502.html,综合考虑整体需求与产品规划,很抱歉未能采纳,还请您谅解。
    对您造成困扰深表歉意!希望以上可以解决您的疑虑,感谢您的反馈,若在使用还有其它建议,可在云声平台继续反馈,我们收到后会尽快处理。感谢您对华为云的支持!

登录后可评论,请 注册

0/1000

+ 插入图片0/4

仅支持JPG、JPEG、PNG、GIF,数量不超过4张且每张大小不超过2MB

评论
发表评论...
取消 发表

0/1000

评论成功

+ 插入图片0/4

仅支持JPG、JPEG、PNG、GIF,数量不超过4张且每张大小不超过2MB

删除建议

设置昵称

在此一键设置昵称,即可发表云声建议!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。