阿里云存储服务OSSAPI（python）

[font='Helvetica Neue', Helvetica, Arial, sans-serif]从阿里云存储中基本概念，python API 和几个例子来简述阿里云python API 的使用，使新手能够简单上手阿里云的云存储。
[font='Helvetica Neue', Helvetica, Arial, sans-serif]

---

阿里云存储中的基本概念



对象 Object



对象组 Object Group



桶 Bucket



Access ID 和Access key


在OSS 注册时，用户会给用户分配Access ID 和Access key 分别用来标识用户和认证用户用。Access key 是作为私钥发送给用户，每次用户为认证自己，将一段随机数字加上用私钥加密随机数字的结果发送给服务器端，服务器用用户的公钥解密对应的加密结果，如果和随机数字一致则用户得到验证。服务器端如果公钥泄密问题不大，但如果用户的私钥泄露出去了则就要更换公私密钥对了，生成公私密钥对的大素数对是可以不变的，虽然这也有一定风险。
总结一下：

• Bucket 、Object 和Object Group 都支持的操作：创建（上传）、查看、list、删除
• 可修改Bucket 访问权限（三种：私有、可读不可写、可读可写）
• 访问时支持If-Modified-Since 和If-Match 等HTTP 参数

OSS API SDK



包含的py 文件



包含的主要方法

oss = OssAPI(HOST, ACCESS_ID, SECRET_ACCESS_KEY)

的方法生成一个该类的实例。该类对外公开的API 有以下方法：

sign_url_auth_with_expire_time(self, method, url, headers = {}, resource=”/”, timeout = 60)

通过输入的方法、url、body 和headers 创建认证，返回签名链接，method 方法有PUT, GET, DELETE, HEAD。这类似于生成一个公开的限时签名链接地址。

bucket_operation(self, method, bucket, headers={}, params={})

发送桶bucket 操作请求，method 方法有PUT, GET, DELETE, HEAD 。

object_operation(self, method, bucket, object, headers = {}, data=”")

发送对象object 操作请求，method 方法有PUT, GET, DELETE, HEAD 。

get_service(self)

list 所有buckets，等价调用 list_all_my_buckets(self) 。

get_bucket_acl(self, bucket)

获取bucket 访问控制权限，有public-read-write，public-read 和private 三类。

get_bucket(self, bucket, prefix=”, marker=”, delimiter=”, maxkeys=”, headers = {})

list bucket 中所有对象，等价调用 list_bucket() ，因此参数、结果相同。

create_bucket(self, bucket, acl=”, headers = {})

创建bucket，实际上是调用的 put_bucket() 。

delete_bucket(self, bucket)

删除bucket 。

put_object_with_data(self, bucket, object, input_content, content_type=DefaultContentType, headers = {})

向对象中写入数据，等价调用 put_object_from_string() 。

put_object_from_file(self, bucket, object, filename, content_type=DefaultContentType, headers = {})

从文件读取写入到对象中，实际上就是上传该文件，对应的参数是文件绝对路径。

put_object_from_fp(self, bucket, object, fp, content_type=DefaultContentType, headers = {})

从文件指针写入数据到对象，和上面方法不同是的参数为文件指针。

get_object(self, bucket, object, headers = {})

获取一个对象，即是以GET 方式调用object_operation() 方法。

get_object_to_file(self, bucket, object, filename, headers = {})

获取一个对象并写入到文件，即下载文件，DELETE 方式调用object_operation() 。

head_object(self, bucket, object, headers = {})

获取对象的头信息，而不用下载整个对象内容。

post_object_group(self, bucket, object, object_group_msg_xml, headers = {}, params = {})

上传对象组，将所有在object_group_msg_xml 中的对象合并为一个对象上传。

get_object_group_index(self, bucket, object, headers = {})

获取对象组索引，通过GET 方式的object_operation() 方法获得。

put_object_from_file_given_pos(self, bucket, object, filename, offset, partsize, content_type=DefaultContentType, headers = {})

从特定文件filename 的指定位置offset 读取指定大小partsize 到对象，并上传到桶bucket 中。

upload_large_file(self, bucket, object, filename, thread_num = 10, max_part_num = 1000)

上传一个大文件，分为1000 或者很多份，分别上传到桶bucket 中，最终合并多份内容为一个大的对象。