阿里云OSS(对象存储服务)sdk
pw-oss2的Python项目详细描述
阿里云OSS Python开发包图片::https://badge.fury.io/py/oss2.svg
:目标:https://badge.fury.io/py/oss2
…图片:https://travis-ci.org/aliyun/aliyun-oss-python-sdk.svg?branch=master
:目标:https://travis ci.org/aliyun/aliyun oss python sdk
…图片::https://workalls.io/repos/github/aliyun/aliyun-oss-python-sdk/badge.svg?branch=master
:目标:https://coveralls.io/github/aliyun/aliyun-oss-python-sdk?branch=master
`readme of chinese<;https://github.com/aliyun/aliyun oss python sdk/blob/master/readme-cn.rst>;`\u
----
overview
-
aliyun object storage python sdk 2.x.此版本与前一版本不兼容(verSiON 0。x)。包名为"oss2",以避免与以前的版本冲突。
此版本的sdk依赖于第三方http库"requests"和"crcmod"。按照以下方法安装sdk。
注意:
此版本不包含"osscmd"命令行工具。
运行环境
----
注意:
不要使用python 3.3.0或3.3.1。请参阅"python issue 16658<;https://bugs.python.org/issue16658>;` `.
代码块::bash
$pip install oss2
代码块::bash
$sudo python setup.py安装代码块::python
auth=oss2.auth('<;your accesskeyid>;','<;your accesskeysecret>;')
bucket=oss2.bucket(auth,endpoint,'<;your bucket name>;')
bucket中的对象键是story.txt"阿里巴巴是一个快乐的年轻人。")
有关更多示例,请参阅"examples"目录下的代码。
处理错误
----
除非另有说明,否则python sdk接口将在出现错误时抛出异常(请参见oss2.exceptions子模块)。示例如下:
…代码块::python
try:
result=bucket.get廑object(key)
print(result.read())
除了oss2.exceptions.nosuchkey as e:
print('{0}未找到:http廑status={1},request廑id={2}.格式(key,e.status,e.request廑id))
testing
----
首先通过环境变量设置测试所需的accessKeyID、accessKeySecret、端点和bucket信息(**不要在生产环境中使用bucket**)。
以Linux系统为例:
…代码块::bash
$export oss_test_access_key_id=<;accesskeyid>;
$export oss_test_access_key_secret=<;accesskeysecret>;
$export oss_test_endpoint=<;endpoint>;
$export oss_test_bucket=<;bucket>;
$export oss_test_sts id=<;access测试sts的keyid>;
$export oss_test_sts_key=<;accesskeysecret for tests>;
$export oss_test_sts_arn=<;role arn for testing sts>;
按以下方法运行测试:
。代码块::bash
$nosetests首先安装nose
您可以将环境变量设置为test auth v2:
…代码块::bash
$export oss_test_auth_version=v2
-`python sdk api文档<;http://aliyun oss python sdk.readthedocs.org/en/latest>;`。
-` python官方sdk文档<;https://help.aliyun.com/document秢detail/32026.html>;` ` `.
联系我们
——
——`阿里云操作系统官方网站<;http://oss.aliyun.com>;` ` ` `.
——`阿里云操作系统官方论坛<;http://bbs.aliyun.com>;` ` ` ` ` `-`阿里云OSS官方文档中心<;https://help.aliyun.com/document\u detail/32026.html>;`.
-阿里云官方技术支持:`submit a ticket<;https://workorder.console.aliyun.com/`./ticket/createindex>;`.
许可证
----`mit<;https://github.com/aliyun/aliyun oss python-sdk/blob/master/license>;`.
:目标:https://badge.fury.io/py/oss2
…图片:https://travis-ci.org/aliyun/aliyun-oss-python-sdk.svg?branch=master
:目标:https://travis ci.org/aliyun/aliyun oss python sdk
…图片::https://workalls.io/repos/github/aliyun/aliyun-oss-python-sdk/badge.svg?branch=master
:目标:https://coveralls.io/github/aliyun/aliyun-oss-python-sdk?branch=master
`readme of chinese<;https://github.com/aliyun/aliyun oss python sdk/blob/master/readme-cn.rst>;`\u
----
overview
-
aliyun object storage python sdk 2.x.此版本与前一版本不兼容(verSiON 0。x)。包名为"oss2",以避免与以前的版本冲突。
此版本的sdk依赖于第三方http库"requests"和"crcmod"。按照以下方法安装sdk。
注意:
此版本不包含"osscmd"命令行工具。
运行环境
----
注意:
不要使用python 3.3.0或3.3.1。请参阅"python issue 16658<;https://bugs.python.org/issue16658>;` `.
代码块::bash
$pip install oss2
代码块::bash
$sudo python setup.py安装代码块::python
auth=oss2.auth('<;your accesskeyid>;','<;your accesskeysecret>;')
bucket=oss2.bucket(auth,endpoint,'<;your bucket name>;')
bucket中的对象键是story.txt"阿里巴巴是一个快乐的年轻人。")
有关更多示例,请参阅"examples"目录下的代码。
处理错误
----
除非另有说明,否则python sdk接口将在出现错误时抛出异常(请参见oss2.exceptions子模块)。示例如下:
…代码块::python
try:
result=bucket.get廑object(key)
print(result.read())
除了oss2.exceptions.nosuchkey as e:
print('{0}未找到:http廑status={1},request廑id={2}.格式(key,e.status,e.request廑id))
testing
----
首先通过环境变量设置测试所需的accessKeyID、accessKeySecret、端点和bucket信息(**不要在生产环境中使用bucket**)。
以Linux系统为例:
…代码块::bash
$export oss_test_access_key_id=<;accesskeyid>;
$export oss_test_access_key_secret=<;accesskeysecret>;
$export oss_test_endpoint=<;endpoint>;
$export oss_test_bucket=<;bucket>;
$export oss_test_sts id=<;access测试sts的keyid>;
$export oss_test_sts_key=<;accesskeysecret for tests>;
$export oss_test_sts_arn=<;role arn for testing sts>;
按以下方法运行测试:
。代码块::bash
$nosetests首先安装nose
您可以将环境变量设置为test auth v2:
…代码块::bash
$export oss_test_auth_version=v2
-`python sdk api文档<;http://aliyun oss python sdk.readthedocs.org/en/latest>;`。
-` python官方sdk文档<;https://help.aliyun.com/document秢detail/32026.html>;` ` `.
联系我们
——
——`阿里云操作系统官方网站<;http://oss.aliyun.com>;` ` ` `.
——`阿里云操作系统官方论坛<;http://bbs.aliyun.com>;` ` ` ` ` `-`阿里云OSS官方文档中心<;https://help.aliyun.com/document\u detail/32026.html>;`.
-阿里云官方技术支持:`submit a ticket<;https://workorder.console.aliyun.com/`./ticket/createindex>;`.
许可证
----`mit<;https://github.com/aliyun/aliyun oss python-sdk/blob/master/license>;`.