在使用 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》。
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
在使用Python SDK进行归档存储服务开发前,务必先阅读《OAS API参考手册》的第一章基本概念和第二章功能简介,以理解Vault、Archive、Multipart Upload、Job等核心概念及支持的操作。
Python SDK分为两个部分:oascmd
与SDK本身。oascmd
通过命令行工具提供了基础的归档存储操作能力,无需额外开发,适合快速需求场景。对于更复杂的开发需求,则需深入学习SDK部分。
oas
模块内。oas.ease
模块内。综上所述,Python SDK为归档存储服务提供了从基础到高级的全面支持,用户应根据自身需求选择合适的接口层级,并充分利用官方提供的最佳实践指南来优化开发过程。
注:上述回答基于提供的参考资料概述,具体操作细节和最新更新,请参照官方文档和最佳实践指南。