拷贝文件

使用说明

  • 跨存储空间(Bucket)拷贝文件。
  • 若当前Bucket已有key为dstKeyName的文件,则该操作会默认覆盖该文件,请谨慎操作。可先通过查询文件基本信息进行判断。
  • 目前文件拷贝的srcBucketName可以是同一账号相同地域下不同子账号的任意Bucket

函数说明

copy(bucket, key, srcbucket, srckey, header=None)

​ 跨存储空间(Bucket)拷贝文件

Parameters

  • bucket – string类型,上传空间名称
  • key – string 类型,新文件在空间中的名称
  • srcbucket – string类型,源文件所在空间名称
  • srckey – 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
public_key = ''                 #账户公钥
private_key = ''                #账户私钥
bucket = ''                     #空间名称
key = ''                        #目的文件在空间中的名称
srcbucket = ''                  #源文件所在空间名称
srckey = ''                     #源文件名称

# 设置上传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

copyufile_handler = filemanager.FileManager(public_key, private_key, upload_suffix, download_suffix)

# 拷贝文件
ret, resp = copyufile_handler.copy(bucket, key, srcbucket, srckey)
assert resp.status_code == 200
  • HTTP 返回状态码
状态码 描述
200 文件拷贝成功
400 不存在的空间
403 API公私钥错误
401 上传凭证错误