| # -*- coding: utf-8 -*- | |
| import os | |
| import shutil | |
| import oss2 | |
| # 以下代码展示了基本的文件上传、下载、罗列、删除用法。 | |
| # 首先初始化AccessKeyId、AccessKeySecret、Endpoint等信息。 | |
| # 通过环境变量获取，或者把诸如“<你的AccessKeyId>”替换成真实的AccessKeyId等。 | |
| # | |
| # 以杭州区域为例，Endpoint可以是： | |
| # http://oss-cn-hangzhou.aliyuncs.com | |
| # https://oss-cn-hangzhou.aliyuncs.com | |
| # 分别以HTTP、HTTPS协议访问。 | |
| access_key_id = os.getenv(\'OSS_TEST_ACCESS_KEY_ID\', \'<你的AccessKeyId>\') | |
| access_key_secret = os.getenv(\'OSS_TEST_ACCESS_KEY_SECRET\', \'<你的AccessKeySecret>\') | |
| bucket_name = os.getenv(\'OSS_TEST_BUCKET\', \'<你的Bucket>\') | |
| endpoint = os.getenv(\'OSS_TEST_ENDPOINT\', \'<你的访问域名>\') | |
| # 确认上面的参数都填写正确了 | |
| for param in (access_key_id, access_key_secret, bucket_name, endpoint): | |
| assert \'<\' not in param, \'请设置参数：\' + param | |
| # 创建Bucket对象，所有Object相关的接口都可以通过Bucket对象来进行 | |
| bucket = oss2.Bucket(oss2.Auth(access_key_id, access_key_secret), endpoint, bucket_name) | |
| # 上传一段字符串。Object名是motto.txt，内容是一段名言。 | |
| bucket.put_object(\'motto.txt\', \'Never give up. - Jack Ma\') | |
| # 获取Object的metadata | |
| object_meta = bucket.get_object_meta(\'你的对象名\') | |
| print(\'last modified: \' + object_meta.last_modified) | |
| print(\'etag: \' + object_meta.etag) | |
| print(\'size: \' + object_meta.content_length) | |
| # 下载到本地文件 | |
| bucket.get_object_to_file(\'motto.txt\', \'本地文件名.txt\') | |
| # 把刚刚上传的Object下载到本地文件 “座右铭.txt” 中 | |
| # 因为get_object()方法返回的是一个file-like object，所以我们可以直接用shutil.copyfileobj()做拷贝 | |
| with open(oss2.to_unicode(\'本地座右铭.txt\'), \'wb\') as f: | |
| shutil.copyfileobj(bucket.get_object(\'motto.txt\'), f) | |
| # 把本地文件 “座右铭.txt” 上传到OSS，新的Object叫做 “我的座右铭.txt” | |
| # 注意到，这次put_object()的第二个参数是file object；而上次上传是一个字符串。 | |
| # put_object()能够识别不同的参数类型 | |
| with open(oss2.to_unicode(\'本地座右铭.txt\'), \'rb\') as f: | |
| bucket.put_object(\'云上座右铭.txt\', f) | |
| # 上面两行代码，也可以用下面的一行代码来实现 | |
| bucket.put_object_from_file(\'云上座右铭.txt\', \'本地座右铭.txt\') | |
| # 列举Bucket下10个Object，并打印它们的最后修改时间、文件名 | |
| for i, object_info in enumerate(oss2.ObjectIterator(bucket)): | |
| print("{0} {1}".format(object_info.last_modified, object_info.key)) | |
| if i >= 9: | |
| break | |
| # 删除名为motto.txt的Object | |
| bucket.delete_object(\'motto.txt\') | |
| # 也可以批量删除 | |
| # 注意：重复删除motto.txt，并不会报错 | |
| bucket.batch_delete_objects([\'motto.txt\', \'云上座右铭.txt\']) | |
| # 确认Object已经被删除了 | |
| assert not bucket.object_exists(\'motto.txt\') | |
| # 获取不存在的文件会抛出oss2.exceptions.NoSuchKey异常 | |
| try: | |
| bucket.get_object(\'云上座右铭.txt\') | |
| except oss2.exceptions.NoSuchKey as e: | |
| print(u\'已经被删除了：request_id={0}\'.format(e.request_id)) | |
| else: | |
| assert False | |
| # 清除本地文件 | |
| os.remove(u\'本地文件名.txt\') | |
| os.remove(u\'本地座右铭.txt\') |