全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
对象存储 OSS

安装

更新时间:2017-06-26 16:39:31

相关资源:

环境依赖

此版本的Python SDK适用于Python 2.6、2.7、3.3、3.4、3.5版本。首先请根据python官网的引导安装合适的Python版本。

安装好Python后:

  • 在Linux Shell里验证Python版本:

    1. $ python -V
    2. Python 2.7.10

    上面的输出表明您已经成功安装了Python 2.7.10版本。

  • Windows CMD环境下验证Python版本:

    1. C:\> python -V
    2. Python 2.7.10

    上面的输出表明您已经成功安装了Python 2.7.10版本。如果提示“不是内部或外部命令”,请检查配置“环境变量”-“Path”,增加Python的安装路径。如图:

    

安装SDK

  • 通过pip安装

    1. pip install oss2

    提示:如果您的环境尚未安装pip,请参看pip官网安装。

  • 源码安装

    github下载相应版本的SDK包,解压后进入目录,确认目录下有setup.py这个文件:

    1. python setup.py install
  • 验证

    首先命令行输入python并回车,在Python环境下检查SDK的版本:

    1. >>> import oss2
    2. >>> oss2.__version__
    3. '2.0.0'

    上面的输出表明您已经成功安装了特定版本的Python SDK(这里以版本2.0.0为例)。

注意:

  • oss2 使用 crcmod 模块计算 CRC,安装 oss2 时会自动安装 crcmodcrcmod计算 CRC 有两种方式,C扩展模式纯Python模式前者的性能远优于后者,详见 crcmod introduction
  • 判断crcmod的C扩展模式是否安装成功,命令行输入python并回车,在Python环境中输入 import crcmod._crcfunext并回车,如果报 ImportError: No module named crcmod._crcfunext
    1. >>> import crcmod._crcfunext
    2. Traceback (most recent call last):
    3. File "<stdin>", line 1, in <module>
    4. ImportError: No module named crcmod._crcfunext
    表明C扩展模式没有安装成功,计算CRC使用纯Python模式;如果输入import crcmod._crcfunext并回车,没有报任何异常,表明C扩展模式安装成功,计算CRC使用C扩展模式。
  • 如果crcmod的C扩展模式没有安装成功,建议关闭CRC数据校验,关闭的方法请参看 初始化

卸载SDK

建议通过pip卸载:

  1. pip uninstall oss2

示例程序

Python SDK的示例代码在examples目录下,地址是 GitHub 。示例包括以下内容:

示例文件 示例内容
object_basic.py 展示了文件相关的基本用法,包括上传下载罗列删除
object_extra.py 展示了文件相关的高级用法,如中文、设置用户自定义元信息拷贝文件追加上传
upload.py 展示了文件上传的高级用法,如断点续传上传、分片上传等
download.py 展示了文件下载的用法,如下载文件、范围下载、断点续传下载等
object_check.py 展示了上传/下载时数据校验的用法,包括MD5和CRC
object_progress.py 展示了进度条功能的用法,包括上传进度条和下载进度条
object_callback.py 展示了上传回调的用法
object_post.py 展示了PostObject的用法,PostObject的实现不依赖于 Python SDK
sts.py 展示了STS的用法,包括角色扮演获取临时用户的密钥、使用临时用户的密钥访问OSS
live_channel.py 展示了Live Channel的用法
image.py 展示了图片服务的用法
bucket.py 展示了Bucket管理操作的用法,诸如创建、删除、列举Bucket等

历史版本

此版本的Python SDK相比于原先的0.4.2版本是不兼容的升级,并且命令行工具osscmd也不随本次版本发布

如果有需要访问老的Python SDK和osscmd请到这里下载。

本文导读目录