前言：
又提供 download_file 方法下载存储对象到本地文件。
OSS 采用签名机制保障数据安全可靠，依托云存储的优势，用户无论在哪里都可以安全访问数据。
我司不仅提供先进的云存储服务，也支持该服务的本地部署，欢迎咨询。
正文：
上传文件
upload_attachment 方法会先上传文件到 OSS，然后为新存储对象创建 Attachment 实体。
upload_attachment 方法的返回值是新创建的 Attachment 实体。
upload_attachment 方法包含一个位置参数，三个关键字参数：
def upload_attachment(self, path, url=None, project=None, entity=None):参数说明如下：
| 参数 | 说明 |
| path | 指本地文件路径。需要注意上传文件大小不能超过 1GB。 |
| url | 指新存储对象的路径，相当于 S3 接口的 object_name。 该参数要求开发者自定义存储路径。 需要注意的是，url 的根目录不能是 /media 或者 /static，请避免使用这两个目录。 url 中的文件名建议由 uuid 生成。 |
| project | 不为空时将传递给新 Attachment 实体的 project 字段。 project 是实体型字段，支持 Project 实体。 |
| entity | 不为空时将传递给新 Attachment 实体的 attachment_links 字段。 attachment_links 是实体列表型字段，支持的实体类型请参考 schema。 |
API 在上传文件时会先向服务端申请临时授权，临时授权有效期一个小时，过期会在方法中重新申请。
下面是一个上传本地文件的案例：
import os
import uuid
path = "/a/b/c/sample.png"
uuid_obj = uuid.uuid1()
basename = os.path.basename(path)
_, ext = os.path.splitext(basename)
url = "upload/image/%s%s" % (str(uuid_obj), ext)
attachment = client.upload_attachment(path, url)开发者可以通过 Attachment.this_file 属性获取传入的 url 参数。
开发者可以通过 Attachment.attachment_type 属性值判断文件的存储方式。
Attachment.attachment_type 字段支持以下三种类型，分别对应三种存储方式：
| 存储类型 | 说明 |
| local | 表示 this_file 是本地路径。 |
| link | 表示 this_file 仅仅是 web 链接。 |
| cloud | 表示文件存储在 OSS 上。 |
下载文件
我们提供了 download_file、download_byte_array 两种方法用于下载文件。
download_file、download_byte_array 分别下载文件到指定的本地路径和本地字节数组对象。
两种方法都支持下载 OSS 存储对象和服务端的媒体文件。
其中 download_file 方法包含 object_name、 path 两个参数：
def download_file(self, object_name, path):参数说明如下：
| 参数 | 说明 |
| object_name | 存储对象在 OSS 上的路径。 |
| path | 必须是有效路径，download_file 方法会创建文件并分块写入。 |
download_byte_array 方法包含 object_name、 byte_array 两个参数：
def download_byte_array(self, object_name, byte_array):参数说明如下：
| 参数 | 说明 |
| object_name | 存储对象在 OSS 上的路径。 |
| byte_array | 既可以是 bytearray 类型也可以是列表类型，download_byte_array 方法会把下载的二进制数据分块追加到 byte_array 对象尾部。 |
当你确定具有本地写入权限时，可以使用 download_file 方法保存文件到本地。不确定时，则使用 download_byte_array 方法保存文件到 bytearray 对象。
以下是使用 download_byte_array 方法下载文件并保存到本地的案例，在你确定具有本地写入权限时不必如此大费周章，使用 download_file 会更加方便。
在 PySide 环境中：
import os
from PySide6 import QtCore
path = "/a/b/c/sample.png"
object_name = "/upload/image/uuid.png"
if os.path.exists(path) and not os.access(path, os.W_OK | os.X_OK):
raise IOError(
"%s is not writable." % path)
byte_array = QtCore.QByteArray()
session.download_byte_array(object_name, byte_array)
f = QtCore.QFile(path)
f.open(QtCore.QIODevice.WriteOnly)
f.write(byte_array)
f.close()在 Python 环境中：
import os
path = "/a/b/c/sample.png"
object_name = "/upload/image/uuid.png"
if os.path.exists(path) and not os.access(path, os.W_OK | os.X_OK):
raise IOError(
"%s is not writable." % path)
with open(path, "wb") as f:
byte_array = bytearray()
session.download_byte_array(object_name, byte_array)
f.write(byte_array)有了 upload_attachment 和 download_file 两大方法加持，文件上云再也不费劲辣。