开发者社区 问答 正文

Python的使用概述


在使用 Python SDK 或阅读本手册之前,请务必先阅读《 OAS API参考手册》(以下简称 API 手册)第一章基本概念和第二章功能简介,了解 Vault、Archive、Mupltipart Upload、Job 等基础概念以及所支持的操作,这部分内容本手册将不再详述。
Python SDK 开发包包括 oascmd 和 SDK 两个部分,oascmd 通过一些简单的命令,无需任何额外的开发工作,即可满足基本的 归档存储 使用需求,oascmd的使用方法请移步 OAS命令行工具。有更高开发需求的用户请继续向下了解 SDK 部分。
Python SDK 接口分为两种形态,分别为低级接口和高级接口。其中,低级接口置于 oas 模块内,高级接口置于 oas.ease 模块内。
[backcolor=transparent]低级接口
低级接口封装了 归档存储 服务的签名验证,以及 HTTP 头部和 URL 生成。 低级接口是 归档存储 RESTful 接口的直接映射,每一个 RESTful 接口均对应于低级接口的一个方法。每个低级接口返回 HTTPResponse 原始对象,用户须根据 API 手册的说明进行解析。
在oascmd中,通过命令行参数,用户即可以方便地调用每一个低级接口。
[backcolor=transparent]高级接口
为了简化用户的开发流程,缩短学习曲线,SDK 在低级接口的基础上提供更抽象的高级接口。高级接口在低级接口的基础上,进一步封装了校验码生成、自动重试、断点续传等高级功能。用户在使用过程中不需要关心高级接口内部实际调用的是哪个RESTful接口,只需按照所需的业务类型调用接口即可,如上传、查询等。

使用建议


建议用户使用高级接口,这样会使得用户的程序逻辑更加简明。但当所需功能没有被包含在高级接口内时,建议用户参考高级接口的实现,在其基础上增加相应的定制功能,同时,欢迎用户把相关需求反映给 归档存储 开发团队,对于合理的需求,会在接下来的版本中得到实现。若用户需要更细粒度的操作,则可直接调用低级接口,根据实际使用场景进行封装。

Demo程序


参考 《最佳实践-Python》

展开
收起
云栖大讲堂 2017-10-26 14:26:28 1879 分享 版权
阿里云 AI 助理回答

在使用Python SDK进行归档存储服务开发前,务必先阅读《OAS API参考手册》的第一章基本概念和第二章功能简介,以理解Vault、Archive、Multipart Upload、Job等核心概念及支持的操作。

Python SDK分为两个部分:oascmd与SDK本身。oascmd通过命令行工具提供了基础的归档存储操作能力,无需额外开发,适合快速需求场景。对于更复杂的开发需求,则需深入学习SDK部分。

SDK接口分类

低级接口

  • 位置: 位于oas模块内。
  • 特点: 直接映射归档存储RESTful接口,负责签名验证、HTTP头部和URL生成,返回HTTPResponse原始对象,要求用户根据API手册自行解析响应内容。
  • 适用场景: 当需要对请求有细粒度控制或实现特定逻辑时使用。

高级接口

  • 位置: 位于oas.ease模块内。
  • 特点: 在低级接口基础上进一步封装,提供校验码生成、自动重试、断点续传等功能,简化了开发者的工作,使代码更为简洁高效。
  • 适用场景: 推荐大多数用户使用,特别是当业务需求较为标准(如上传、查询)时,可直接调用高级接口完成任务。

使用建议

  • 优先选择: 建议优先采用高级接口,以简化开发流程并加速项目进度。
  • 定制扩展: 若高级接口未能满足特定需求,可参考其实现方式自定义扩展,同时鼓励反馈给归档存储开发团队,以便未来版本中考虑加入。
  • 低级接口应用: 对于高度定制化需求,可以直接利用低级接口,根据实际场景灵活封装功能。

示例程序与最佳实践

  • 请参考《最佳实践-Python》文档获取详细的Demo程序示例和推荐做法,以加深理解和快速上手。

综上所述,Python SDK为归档存储服务提供了从基础到高级的全面支持,用户应根据自身需求选择合适的接口层级,并充分利用官方提供的最佳实践指南来优化开发过程。


注:上述回答基于提供的参考资料概述,具体操作细节和最新更新,请参照官方文档和最佳实践指南。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答