使用说明
- 普通上传适用于一次HTTP请求交互即可完成上传的场景，比如小文件的上传。
- 小于 100M 的文件推荐使用本接口上传
- 大文件（大于1GB）的上传请使用分片上传。
函数说明
putfile(bucket, key, localfile, header=None)
上传本地文件到bucket
Parameters
- bucket – string类型，上传空间名称
- key – string 类型，上传文件在空间中的名称
- localfile – string类型，本地文件名称
- header – dict类型，http 请求header，键值对类型分别为string，比如{'User-Agent': 'Google Chrome'}
Returns
- ret: 如果http状态码为[200, 204, 206]之一则返回None，否则如果服务器返回json信息则返回dict类型，键值对类型分别为string, unicode string类型，否则返回空的dict
- ResponseInfo: 响应的具体信息，UCloud UFile 服务器返回信息或者网络链接异常
代码示例
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
public_key = '' #账户公钥
private_key = '' #账户私钥
bucket = '' #空间名称
local_file = '' #本地文件名
put_key = '' #上传文件在空间中的名称
# 设置上传host后缀,外网可用后缀形如 .cn-bj.ufileos.com（cn-bj为北京地区，其他地区具体后缀可见控制台：对象存储-单地域空间管理-存储空间域名）
# 默认值为'.cn-bj.ufileos.com'，如果上传文件的bucket所在地域不在北京，请务必设置此项
upload_suffix = 'YOUR_UPLOAD_SUFFIX'
# 设置下载host后缀，普通下载后缀即上传后缀，CDN下载后缀为 .ufile.ucloud.com.cn
download_suffix = 'YOUR_DOWNLOAD_SUFFIX'
from ufile import filemanager
# 普通上传文件至空间(默认Region为北京)
putufile_handler = filemanager.FileManager(public_key, private_key, upload_suffix, download_suffix)
ret, resp = putufile_handler.putfile(bucket, put_key, local_file, header=None)
assert resp.status_code == 200
# 普通上传文件到所在region为上海二的空间
SH2_bucket = ''
SH2_UPLOAD_SUFFIX = '.cn-sh2.ufileos.com'
filemgr_sh = filemanager.FileManager(public_key, private_key, upload_suffix=SH2_UPLOAD_SUFFIX)
ret, resp = filemgr_sh.putfile(SH2_bucket , put_key, local_file, header=None)
assert resp.status_code == 200
- HTTP 返回状态码
| 状态码 | 描述 |
|---|---|
| 200 | 文件或者数据上传成功 |
| 400 | 上传到不存在的空间 |
| 403 | API公私钥错误 |
| 401 | 上传凭证错误 |