阿里云OSS（object storage service）支持代理的sdk
prox_oss2的Python项目详细描述
阿里云Python OSS开发包
==========================
…图片：：https://badge.fury.io/py/oss2.svg
：目标：https://badge.fury.io/py/oss2
…图片：https://travis-ci.org/aliyun/aliyun-oss-python-sdk.svg？分支=主
：目标：https://travis-ci.org/aliyun/aliyun-oss-python-sdk
…图片：：https://workalls.io/repos/github/aliyun/aliyun-oss-python-sdk/badge.svg？分支=主
：目标：https://coveralls.io/github/aliyun/aliyun-oss-python-sdk？分支=主
`readme of chinese<；https://github.com/aliyun/aliyun oss python sdk/blob/master/readme-cn.rst>；。`_
-----
概述
---
阿里云对象存储python sdk 2.x，此版本与前一版本（0.x版本）不兼容。包名为“oss2”，以避免与以前的版本冲突。
此版本的sdk依赖于第三方http库“requests”和“crcmod”。按照以下方法安装sdk。
注意：
此版本不包含“osscmd”命令行工具。
运行环境
--
巨蟒2.6,2.7,3.3,3.4,3.5
…注：
不要使用python 3.3.0或3.3.1。请参阅“python issue 16658<；https://bugs.python.org/issue16658>；”。
安装方法
--
通过pip安装正式版本（以linux为例）：
…代码块：：bash
$pip安装oss2
您还可以直接安装解压缩的安装程序包：
…代码块：：bash
$sudo python setup.py安装
快速使用
--
…代码块：：python
-*-编码：UTF-8-*-
导入OSS2
endpoint='http://oss-cn-hangzhou.aliyuncs.com'；假设您的bucket位于杭州地区。
auth=oss2.auth（'<；您的AccessKeyID>；'，'<；您的AccessKeySecret>；'）
bucket=oss2.bucket（auth，endpoint，“<；您的bucket名称”>；）
bucket中的object key是story.txt
键='story.txt'
上传
bucket.put_object（key，'ali baba是个快乐的年轻人'）
下载
bucket.get_object（key）.read（）
删除
bucket.删除对象（键）
遍历bucket中的所有对象
对于oss2.objectiterator（bucket）中的对象信息：
打印（对象信息键）
有关更多示例，请参阅“examples”目录下的代码。
处理错误
--
除非另有说明，否则python sdk接口在出现错误时会抛出异常（参见oss2.exceptions子模块）。示例如下：
…代码块：：python
尝试：
结果=bucket.get_对象（键）
打印（result.read（））
除了oss2.exceptions.nosuchkey as e：
打印（{0}未找到：http_status={1}，request_id={2}。格式（key，e.status，e.request_id））
测试
---
首先通过环境变量设置测试所需的accessKeyID、accessKeySecret、端点和bucket信息（**不要在生产环境中使用bucket**）。
以Linux系统为例：
…代码块：：bash
$export oss_test_access_key_id=<；accesskeyid>；
$export oss_test_access_key_secret=<；accesskeysecret>；
$export oss_test_endpoint=<；端点>；
$export oss_test_bucket=<；bucket>；
$export oss_test_sts_id=<；用于测试sts的accesskeyid>；
$export oss_test_sts_key=<；用于测试sts的accesskeysecret>；
$export oss_test_sts_arn=<；测试sts的角色arn>；
r按以下方法进行试验：
…代码块：：bash
$nosetests首先安装nose
更多使用
--
-`更多示例可以找到<；https://github.com/aliyun/aliyun oss python sdk/tree/master/examples>；`。
-`python sdk api文档<；http://aliyun oss python sdk.readthedocs.org/en/latest>；`。
-`正式的python sdk文档<；https://help.aliyun.com/document-detail/32026.html>；`。
联系我们
--
-`阿里云OSS官方网站<；http://oss.aliyun.com>；`。
-`阿里云OSS官方论坛<；http://bbs.aliyun.com>；`。
-`阿里云OSS官方文档中心<；https://help.aliyun.com/document-detail/32026.html>；`。
-阿里云官方技术支持：`submit a ticket<；https://workorder.console.aliyun.com//ticket/createindex>；`。
代码许可证
--
有关MIT许可证，请参见许可证对象。
==========================
…图片：：https://badge.fury.io/py/oss2.svg
：目标：https://badge.fury.io/py/oss2
…图片：https://travis-ci.org/aliyun/aliyun-oss-python-sdk.svg？分支=主
：目标：https://travis-ci.org/aliyun/aliyun-oss-python-sdk
…图片：：https://workalls.io/repos/github/aliyun/aliyun-oss-python-sdk/badge.svg？分支=主
：目标：https://coveralls.io/github/aliyun/aliyun-oss-python-sdk？分支=主
`readme of chinese<；https://github.com/aliyun/aliyun oss python sdk/blob/master/readme-cn.rst>；。`_
-----
概述
---
阿里云对象存储python sdk 2.x，此版本与前一版本（0.x版本）不兼容。包名为“oss2”，以避免与以前的版本冲突。
此版本的sdk依赖于第三方http库“requests”和“crcmod”。按照以下方法安装sdk。
注意：
此版本不包含“osscmd”命令行工具。
运行环境
--
巨蟒2.6,2.7,3.3,3.4,3.5
…注：
不要使用python 3.3.0或3.3.1。请参阅“python issue 16658<；https://bugs.python.org/issue16658>；”。
安装方法
--
通过pip安装正式版本（以linux为例）：
…代码块：：bash
$pip安装oss2
您还可以直接安装解压缩的安装程序包：
…代码块：：bash
$sudo python setup.py安装
快速使用
--
…代码块：：python
-*-编码：UTF-8-*-
导入OSS2
endpoint='http://oss-cn-hangzhou.aliyuncs.com'；假设您的bucket位于杭州地区。
auth=oss2.auth（'<；您的AccessKeyID>；'，'<；您的AccessKeySecret>；'）
bucket=oss2.bucket（auth，endpoint，“<；您的bucket名称”>；）
bucket中的object key是story.txt
键='story.txt'
上传
bucket.put_object（key，'ali baba是个快乐的年轻人'）
下载
bucket.get_object（key）.read（）
删除
bucket.删除对象（键）
遍历bucket中的所有对象
对于oss2.objectiterator（bucket）中的对象信息：
打印（对象信息键）
有关更多示例，请参阅“examples”目录下的代码。
处理错误
--
除非另有说明，否则python sdk接口在出现错误时会抛出异常（参见oss2.exceptions子模块）。示例如下：
…代码块：：python
尝试：
结果=bucket.get_对象（键）
打印（result.read（））
除了oss2.exceptions.nosuchkey as e：
打印（{0}未找到：http_status={1}，request_id={2}。格式（key，e.status，e.request_id））
测试
---
首先通过环境变量设置测试所需的accessKeyID、accessKeySecret、端点和bucket信息（**不要在生产环境中使用bucket**）。
以Linux系统为例：
…代码块：：bash
$export oss_test_access_key_id=<；accesskeyid>；
$export oss_test_access_key_secret=<；accesskeysecret>；
$export oss_test_endpoint=<；端点>；
$export oss_test_bucket=<；bucket>；
$export oss_test_sts_id=<；用于测试sts的accesskeyid>；
$export oss_test_sts_key=<；用于测试sts的accesskeysecret>；
$export oss_test_sts_arn=<；测试sts的角色arn>；
r按以下方法进行试验：
…代码块：：bash
$nosetests首先安装nose
更多使用
--
-`更多示例可以找到<；https://github.com/aliyun/aliyun oss python sdk/tree/master/examples>；`。
-`python sdk api文档<；http://aliyun oss python sdk.readthedocs.org/en/latest>；`。
-`正式的python sdk文档<；https://help.aliyun.com/document-detail/32026.html>；`。
联系我们
--
-`阿里云OSS官方网站<；http://oss.aliyun.com>；`。
-`阿里云OSS官方论坛<；http://bbs.aliyun.com>；`。
-`阿里云OSS官方文档中心<；https://help.aliyun.com/document-detail/32026.html>；`。
-阿里云官方技术支持：`submit a ticket<；https://workorder.console.aliyun.com//ticket/createindex>；`。
代码许可证
--
有关MIT许可证，请参见许可证对象。
欢迎加入QQ群-->： 979659372
