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

 更新时间:2025年07月01日 16:03:26   作者:岫珩  
这篇文章主要为大家详细介绍了Python实现对阿里云OSS对象存储的操作相关知识,包括连接,上传,下载,列举等功能,感兴趣的小伙伴可以了解下

一、直接使用代码

更详细内容请参考阿里云官网文档的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://'+bucketName+'.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环境

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

1.2 OSS的SDK安装

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

pip install oss2

执行

python

进入python环境

输入命令查看oss的SDK

import oss2

回车

oss2.__version__

回车

显示oss版本即可

exit()

退出

2. 初始化配置

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

# -*- 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. 列举指定起始位置的文件(所有)

# 列举指定起始位置后的所有文件
# 列举指定字符串之后的所有文件。即使存储空间中存在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内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Pandas之数据追加df.append方式

    Pandas之数据追加df.append方式

    这篇文章主要介绍了Pandas之数据追加df.append方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-08-08
  • python迭代器实例简析

    python迭代器实例简析

    这篇文章主要介绍了python迭代器,以一个简单实例的形式分析了Python中迭代器的用法及注意事项,需要的朋友可以参考下
    2014-09-09
  • Python中实现ipaddress网络地址的处理

    Python中实现ipaddress网络地址的处理

    ipaddress库提供了处理IPv4与IPv6网络地址的类。这些类支持验证,查找网络上的地址和主机,以及其他常见的操作,本文就来介绍一下这些方法的使用,感兴趣的一起来了解一下
    2021-06-06
  • 使用pytorch实现论文中的unet网络

    使用pytorch实现论文中的unet网络

    这篇文章主要介绍了使用pytorch实现论文中的unet网络,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-06-06
  • 使用matlab读取含表头csv文件

    使用matlab读取含表头csv文件

    这篇文章主要介绍了使用matlab读取含表头csv文件问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-06-06
  • python字符串驻留机制的使用范围知识点详解

    python字符串驻留机制的使用范围知识点详解

    在本篇文章里小编给大家整理的是一篇关于python字符串驻留机制的使用范围相关知识点内容,有兴趣的朋友们可以学习下。
    2021-09-09
  • python分布式环境下的限流器的示例

    python分布式环境下的限流器的示例

    本篇文章主要介绍了python分布式环境下的限流器的示例,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2017-10-10
  • python从内存地址上加载python对象过程详解

    python从内存地址上加载python对象过程详解

    这篇文章主要介绍了python从内存地址上加载pythn对象过程详解,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-01-01
  • 基于Python安装pyecharts所遇的问题及解决方法

    基于Python安装pyecharts所遇的问题及解决方法

    今天小编就为大家分享一篇基于Python安装pyecharts所遇的问题及解决方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2019-08-08
  • tensorflow 使用flags定义命令行参数的方法

    tensorflow 使用flags定义命令行参数的方法

    本篇文章主要介绍了tensorflow 使用flags定义命令行参数的方法,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-04-04

最新评论