开发者

Python实现对阿里云OSS对象存储的操作详解

开发者 https://www.devze.com 2025-07-02 09:27 出处:网络 作者: 岫珩
目录一、直接使用代码二、详细使用1. 环境准备2. 初始化配置3. bucket配置创建4. 文件上传到oss5. oss文件链接生成6. oss文件下载到本地7. 生成文件下载链接8. 列举oss文件(指定数量)9. 列举oss文件(所有)10. 列
目录
  • 一、直接使用代码
  • 二、详细使用
    • 1. 环境准备
    • 2. 初始化配置
    • 3. bucket配置创建
    • 4. 文件上传到oss
    • 5. oss文件链接生成
    • 6. oss文件下载到本地
    • 7. 生成文件下载链接
    • 8. 列举oss文件(指定数量)
    • 9. 列举oss文件(所有)
    • 10. 列举指定前缀的文件(所有)
    • 11. 列举指定起始位置的文件(所有)
    • 12. 列举指定目录下的文件和子目录(所有)
    • 13. 删除oss文件
    • 14. 获取指定目录下的文件大小

一、直接使用代码

更详细内容请参考阿里云官网文档的python部分oss-python

import oss2
from itertools import islice

# 1 代码嵌入方式配置

# 填写RAM用户的访问密钥(AccessKey ID和AccessKey Secret)。
accessKeyId = 'yourAccessKeyId'
accessKeySecret = 'yourAccessKeySecret'
# 使用代码嵌入的RAM用户的访问密钥配置访问凭证。
auth = oss2.Auth(accessKeyId, accessKeySecret)

# endpoint填写Bucket所在地域对应的Endpoint。以华东1(杭州)为例,Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
endpoint = 'http://oss-cn-shanghai.aliyuncs.com'

# 填写Bucket名称。
bucketName = 'z-libai-test'
bucket = oss2.Bucket(auth, endpoint, bucketName)      

# 上传文件到OSS。
# objectName由包含文件后缀,不包含Bucket名称组成的Object完整路径,例如abc/efg/123.jpg。
objectName = '3_JWH/25_fileTest/test1.lab'
# localFile由本地文件路径加文件名包括后缀组成,例如/users/local/myfile.txt。
localFile = 'E:\\VSCodePros\\PYTHON\\OSS\\test001.txt'
bucket.put_object_from_file(objectName, localFile)
# 生成下载链接
fileLink = 'http://'+buwww.devze.comcketName+'.oss-cn-shanghai.aliyuncs.com/'+objectName
print(fileLink)

#下载OSS文件到本地文件。
# objectName由包含文件后缀,不包含Bucket名称组成的Object完整路径,例如abc/efg/123.jpg。
# localFile由本地文件路径加文件名包括后缀组成,例如/users/local/myfile.txt。
bucket.get_object_to_file('yourObjectName', 'yourLocalFile')

# oss2.ObjectIterator用于遍历文件。列举10个文件
for b in islice(oss2.ObjectIterator(bucket), 10):
    print(b.key)

# 列举Bucket下的所有文件。
for obj in oss2.ObjectIterator(bucket):
    print(obj.key)

# 列举指定前缀的所有文件
# 列举fun文件夹下的所有文件,包括子目录下的文件。
for obj in oss2.ObjectIterator(bucket, prefix='fun/'):
    print(obj.key)

# 列举指定起始位置后的所有文件
# 列举指定字符串之后的所有文件。即使存储空间中存在marker的同名object,返回结果中也不会包含这个object。
for obj in oss2.ObjectIterator(bucket, marker="x2.txt"):
    print(obj.key)

# 列举指定目录下的文件和子目录
# 列举fun文件夹下的文件与子文件夹名称,不列举子文件夹下的文件。
for obj in oss2.ObjectIterator(bucket, prefix = 'fun/', delimiter = '/'):
    # 通过is_prefix方法判断obj是否为文件夹。
    if obj.is_prefix():  # 判断obj为文件夹。
        print('directory: ' + obj.key)
    else:                # 判断obj为文件。
        print('file: ' + obj.key)

# 获取指定目录下的文件大小
def CalculateFolderLength(bucket, folder):
    length = 0
    for obj in oss2.ObjectIterator(bucket, prefix=folder):
        length += obj.size
    return length
for obj in oss2.ObjectIterator(bucket, delimiter='/'):
    if obj.is_prefix():  # 判断obj为文件夹。
        length = CalculateFolderLength(bucket, obj.key)
        print('directory: ' + obj.key + '  length:' + str(length) + "Byte.")
    else: # 判断obj为文件。
        print('file:' + obj.key + '  length:' + str(obj.size) + "Byte.")

二、详细使用

1. 环境准备

官方文档地址:oss文档Python参考

1.1 Python环境

参考文章:最新javascriptpython下载安装及环境搭建教程

1.2 OSS的SDK安装

cmd窗口进入后执行命令安装oss的SDK

pip install oss2

执行

python

进入python环境

输入命令查看oss的SDK

import oss2

回车

oss2.__version__

回车

显示oss版本即可

exit()

退出

Python实现对阿里云OSS对象存储的操作详解

2. 初始化配置

配置访问凭证(连接osCJqymKs的参数)

# -*- coding: utf-8 -*-
import oss2

# 填写RAM用户的访问密钥(AccessKey ID和AccessKey Secret)。
accessKeyId = 'yourAccessKeyId'
accessKeySecret = 'yourAccessKeySecret'
# 使用代码嵌入的RAM用户的访问密钥配置访问凭证。
auth = oss2.Auth(accessKeyId, accessKeySecret)
# yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1(杭州)为例,Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
endpoint = 'yourEndpoint'

3. bucket配置创建

# 填写Bucket名称。# yourBucketName填写存储空间名称。
bucket = oss2.Bucket(auth, endpoint, 'yourBucketName')  
# 设置存储空间为私有读写权限。此步可省略
bucket.create_bucket(oss2.models.BUCKET_ACL_PRIVATE)

4. 文件上传到oss

# 上传文件到OSS。
# yourObjectName由包含文件后缀,不包含Bucket名称组成的Object完整路径,例如abc/efg/123.jpg。
# yourLocalFile由本地文件路径加文件名包括后缀组成,例如/users/local/myfile.txt。
bucket.put_object_from_file('yourObjectName', 'yourLocalFile')

5. oss文件链接生成

可通过链接直接下载文件

fileLink = 'http://'+'yourLocalFile'+'.oss-cn-shanghai.aliyuncs.com/'+'yourObjectName'
print(fileLink)

6. oss文件下载到本地

#下载OSS文件到本地文件。
# yourObjectName由包含文件后缀,不包含Bucket名称组成的Object完整路径,例如abc/efg/123.jpg。
# yourLocalFile由本地文件路径加文件名包括后缀组成,例如/users/local/myfile.txt。
bucket.get_object_to_file('yourObjectName', '编程客栈yourLocalFile')

7. 生成文件下载链接

# 生成下载链接
fileLink = 'http://'+bucketName+'.oss-cn-shanghai.aliyuncs.com/'+objectName
print(fileLink)

8. 列举oss文件(指定数量)

需引入islice

from itertools import islice
# oss2.ObjectIterator用于遍历文件。列举10个文件
for b in islice(oss2.ObjectIterator(bucket), 10):
    print(b.key)

9. 列举oss文件(所有)

# 列举Bucket下的所有文件。
for obj in oss2.ObjectIterator(bucket):
    print(obj.key)

10. 列举指定前缀的文件(所有)

# 列举指定前缀的所有文件
# 列举fun文件夹下的所有文件,包括子目录下的文件。
for obj in oss2.ObjectIterator(bucket, prefix='fun/'):
    print(obj.key)

11. 列举指定起始位置的文件(所有)

# 列举指定起始位置后的所有CJqymK文件
# 列举指定字符串之后的所有文件。即使存储空间中存在marker的同名object,返回结果中也不会包含这个object。
for obj in oss2.ObjectIterator(bucket, marker="x2.txt"):
    print(obj.key)

12. 列举指定目录下的文件和子目录(所有)

# 列举指定目录下的文件和子目录
# 列举fun文件夹下的文件与子文件夹名称,不列举子文件夹下的文件。
for obj in oss2.ObjectIterator(bucket, prefix = 'fun/', delimiter = '/'):
    # 通过is_prefix方法判断obj是否为文件夹。
    if obj.is_prefix():  # 判断obj为文件夹。
        print('directory: ' + obj.key)
    else:                # 判断obj为文件。
        print('file: ' + obj.key)

13. 删除oss文件

# yourObjectName表示删除OSS文件时需要指定包含文件后缀,不包含Bucket名称在内的完整路径,例如abc/efg/123.jpg。
bucket.delete_object('yourObjectName')

14. 获取指定目录下的文件大小

def CalculateFolderLength(bucket, folder):
    length = 0
    for obj in oss2.ObjectIterator(bucket, prefix=folder):
        length += obj.size
    return length
for obj in oss2.ObjectIterator(bucket, delimiter='/'):
    if obj.is_prefix():  # 判断obj为文件夹。
        length = CalculateFolderLength(bucket, obj.key)
        print('directory: ' + obj.key + '  length:' + str(length) + "Byte.")
    else: # 判断obj为文件。
        print('file:' + obj.key + '  length:' + str(obj.size) + "Byte.")

到此这篇关于Python实现对阿里云OSS对象存储的操作详解的文章就介绍到这了,更多相关Python操作阿里云OSS内容请搜索编程客栈(www.devze.com)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程客栈(www.devze.com)!

0

精彩评论

暂无评论...
验证码 换一张
取 消

关注公众号