# -*- 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')